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.

Shell
voynich account <wallet>

Argument#

FieldMeaning
walletaddress, first argumentrequired

The 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:

JSON
{
  "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
    },
    …
  ]
}
FieldMeaning
walletaddress

The wallet that was read.

modelsarray of Model

The models this wallet owns, in every status. The fields are in Model fields.

ownerEarningsarray

What 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 Enclave

The enclaves this wallet operates. The fields are in Enclave fields.

operatorEarningsarray

What the wallet received as an operator across every enclave it operates, in the same form as ownerEarnings.

callsarray of Call

The 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#

FieldMeaning
addressaddress

The Call account. voynich refund and voynich verify take it.

calleraddress

The wallet that opened the call.

modeladdress

The model that was called.

modelNamestring

The model's name.

enclaveaddress

The enclave chosen to answer.

inputHash64 hex characters

The SHA-256 of the encrypted input.

priceobject

What the call put in escrow: amount, mint, decimals and symbol.

openedSlotinteger string

The slot the call opened in.

deadlineSlotinteger string

The slot after which the call can be refunded.

statusstring

open, settled, refundable or refunded.

receiptaddress or null

The call's receipt, once it has settled.

failureobject or null

For 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 outputNext
A call with the status refundablevoynich refund <call> returns its escrow.
A call with a receiptvoynich verify <call> checks it.
A model with the status sealedvoynich grant <model> <enclave> makes it live.
A model with the status livevoynich 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.