account
voynich account prints everything one wallet has on the protocol, in its three roles: the models it owns and what they earned, the enclaves it operates and what they earned, and the calls it made.
voynich account <wallet>Argument#
walletaddress, first argumentrequiredThe wallet to read. Any wallet can be read, and the command needs no keypair.
What it prints#
One JSON object on stdout. For a wallet that made calls, with one call shown:
{
"wallet": "89K627XNg94bDEETsQ6viQjCDB25iSYGDq1xKuqHB3jv",
"models": [],
"ownerEarnings": [],
"enclaves": [],
"operatorEarnings": [],
"calls": [
{
"address": "GyLvqRCFTWcsEcEr4jt8vuHZVKDvnyVwwW3Wwcav373U",
"caller": "89K627XNg94bDEETsQ6viQjCDB25iSYGDq1xKuqHB3jv",
"model": "431poxuxU5h5BE4nxazgLfxVEdg1xjipQWknyVN8ZobW",
"modelName": "sketch-32",
"enclave": "5pTHrf9HYoq7unNVbvsL4kd6zWcwWXqH4HQ7JPQi5Ft6",
"inputHash": "ee79690984ab…87b7bba43a",
"price": {
"amount": "100000",
"mint": null,
"decimals": 9,
"symbol": "SOL"
},
"openedSlot": "2325",
"deadlineSlot": "2625",
"status": "settled",
"receipt": "D949kMCmdYwMXvjYTM6BY9WUxuhjpz6bWVmZ4FxrpGnQ",
"failure": null
},
…
]
}walletaddressThe wallet that was read.
modelsarray of ModelThe models this wallet owns, in every status. The fields are in Model fields.
ownerEarningsarrayWhat the wallet received as an owner, one entry per unit it was paid in. Each entry has amount in base units as a string, mint (an address, or null for SOL), decimals and symbol.
enclavesarray of EnclaveThe enclaves this wallet operates. The fields are in Enclave fields.
operatorEarningsarrayWhat the wallet received as an operator across every enclave it operates, in the same form as ownerEarnings.
callsarray of CallThe calls this wallet made. Each has the fields below.
How a settled call's price is split between the owner, the operator and the protocol share is told in Fees and the token.
Call fields#
addressaddressThe Call account. voynich refund and voynich verify take it.
calleraddressThe wallet that opened the call.
modeladdressThe model that was called.
modelNamestringThe model's name.
enclaveaddressThe enclave chosen to answer.
inputHash64 hex charactersThe SHA-256 of the encrypted input.
priceobjectWhat the call put in escrow: amount, mint, decimals and symbol.
openedSlotinteger stringThe slot the call opened in.
deadlineSlotinteger stringThe slot after which the call can be refunded.
statusstringopen, settled, refundable or refunded.
receiptaddress or nullThe call's receipt, once it has settled.
failureobject or nullFor a call that is refundable or refunded: code, message and refundState (refundable or refunded). null for a call that is open or settled.
From the account to the next command#
| In the output | Next |
|---|---|
A call with the status refundable | voynich refund <call> returns its escrow. |
A call with a receipt | voynich verify <call> checks it. |
A model with the status sealed | voynich grant <model> <enclave> makes it live. |
A model with the status live | voynich model price <model> sets its price, voynich model retire <model> retires it. |
Failures#
The command prints one line to stderr and exits with code 1: Supply wallet address for account. without the argument, and the API's code and message when the API refuses the request, VALIDATION_ERROR for a value that is not an address.