models

Two commands list what is on chain: voynich models lists sealed models and voynich enclaves lists registered enclaves. Both read public state through the API and need no wallet. The same from code is Models and enclaves.

Two more commands change a model as its owner: voynich model price and voynich model retire.

voynich models#

Shell
voynich models

It takes no arguments. It prints one page of models, up to 24, ordered by calls:

FieldMeaning
itemsarray of Model

The models. Each has the fields below.

page.nextCursorstring or null

The position of the next page, or null on the last one.

page.hasMoreboolean

Whether more models follow this page.

asOfISO 8601 time

When the API read this state.

The output:

JSON
{
  "items": [
    {
      "address": "431poxuxU5h5BE4nxazgLfxVEdg1xjipQWknyVN8ZobW",
      "name": "sketch-32",
      "owner": "D2af6GLQbPYVeXJE8hsrwmsyeJrnbkbgFxha3zM6TxJx",
      "createdSlot": "107",
      "sealedSlot": "876",
      "sizeBytes": 252145,
      "plaintextSizeBytes": 252081,
      "ciphertextSha256": "ac7ab9c9ef38…59d8a3bc6b",
      "cipher": {
        "id": "xchacha20poly1305-64k-v1",
        "chunkSizeBytes": 65536,
        "noncePrefix": "oLJ6yV0e3e1FPcl7lfDCyg=="
      },
      "allowedMeasurements": [
        "5e7dc39b4770…d82100256b"
      ],
      "price": {
        "amount": "100000",
        "mint": null,
        "decimals": 9,
        "symbol": "SOL"
      },
      "operatorShareBps": 2500,
      "protocolShareBps": 500,
      "status": "live",
      "manifest": {
        "name": "sketch-32",
        "inputKind": "sketch",
        "inputShape": [
          1,
          1,
          28,
          28
        ],
        "labels": [
          "airplane",
          "apple",
          "banana",
          …
        ],
        "inputName": "input",
        "outputName": "logits",
        "preprocess": "Crop the drawing to its ink, scale the longer side to 24 px keeping aspect, center it in 28x28; float32, background 0, ink 1."
      },
      "weights": [
        {
          "address": "714ovNrHqQ4k6C1sMR6segvFd9cQcNEgdFQuMtoKfJg5",
          "model": "431poxuxU5h5BE4nxazgLfxVEdg1xjipQWknyVN8ZobW",
          "index": 0,
          "offset": 0,
          "sizeBytes": 252145,
          "writtenRanges": [
            {
              "offset": 0,
              "length": 252145
            }
          ]
        }
      ],
      "upload": null,
      "enclavesHolding": 1,
      "callsSettled": "3"
    }
  ],
  "page": {
    "nextCursor": null,
    "hasMore": false
  },
  "asOf": "2026-11-18T14:22:10.735Z"
}

Model fields#

What each field means on chain is told in Sealed models.

FieldMeaning
addressaddress

The Model account.

namestring

The model's name, such as sketch-32. Commands take the name or the address.

owneraddress

The wallet that sealed the model.

createdSlotinteger string

The slot the Model was created in.

sealedSlotinteger string or null

The slot the ciphertext hash was fixed in. null while the model is uploading.

sizeBytesinteger

The ciphertext's size.

plaintextSizeBytesinteger

The weights file's size before encryption.

ciphertextSha25664 hex characters or null

The SHA-256 of the ciphertext. null while the model is uploading.

cipherobject

id (xchacha20poly1305-64k-v1), chunkSizeBytes (65536) and noncePrefix (16 bytes, base64).

allowedMeasurementsarray of 96 hex characters

The measurements whose enclaves can be granted the model key.

priceobject

The price of one call: amount in base units as a string, mint (an address, or null for SOL), decimals and symbol.

operatorShareBpsinteger

The operator's share of each settled call, in basis points.

protocolShareBpsinteger or null

The protocol share, in basis points.

statusstring

uploading, sealed, live or retired.

manifestobject

name, inputKind (sketch or tensor), inputShape, labels, and inputName, outputName and preprocess: always for a sketch model, where the model states them for a tensor model.

weightsarray

The model's Weights accounts in order. Each has address, model, index, offset (where its bytes start in the ciphertext), sizeBytes and writtenRanges (a list of offset and length).

uploadobject or null

The upload: uploadKey, bytesWritten, transactionsWritten, writtenRanges and closed. upload is null from sealing on.

enclavesHoldinginteger

How many enclaves hold a grant for the model that is not revoked, with an attestation record in force.

callsSettledinteger string

How many calls to the model have settled.

voynich enclaves#

Shell
voynich enclaves

It takes no arguments. It prints one page of enclaves, up to 24, live and reachable ones first, in the same envelope as voynich models: items, page.nextCursor, page.hasMore and asOf.

The output:

JSON
{
  "items": [
    {
      "address": "5pTHrf9HYoq7unNVbvsL4kd6zWcwWXqH4HQ7JPQi5Ft6",
      "signingKey": "8kgSuH3dc4GSKonVRzzm8aFkpLaVhETp6CkapFFSSCYw",
      "encryptionKey": "gSVLLAd5h2nbrc00+ABwNfAq7xO5RLq/Rv5Vy5wak1U=",
      "hardwareType": "dev",
      "measurement": "5e7dc39b4770…d82100256b",
      "expiresAtSlot": "3391",
      "operator": "A4rxgQ3uAJpNMCMhX4UiESkDUBgQ2dAQ828dT4h1uTcV",
      "endpoint": "https://<enclave host>",
      "relayPath": "/v1/calls/{call}/input",
      "status": "live",
      "reachable": true,
      "lastSeen": "2026-11-18T14:21:59.190Z",
      "modelsHeld": 1,
      "callsSettled": "3",
      "attestation": {
        "address": "28rrLu5p3xtXXAsRLBoq8cNvQvHzaeb7QUoDWfmV8dyS",
        "signingKey": "8kgSuH3dc4GSKonVRzzm8aFkpLaVhETp6CkapFFSSCYw",
        "encryptionKey": "gSVLLAd5h2nbrc00+ABwNfAq7xO5RLq/Rv5Vy5wak1U=",
        "hardwareType": "dev",
        "measurement": "5e7dc39b4770…d82100256b",
        "recordedSlot": "1891",
        "expiresAtSlot": "3391",
        "layoutVersion": 1
      }
    }
  ],
  "page": {
    "nextCursor": null,
    "hasMore": false
  },
  "asOf": "2026-11-18T14:22:10.215Z"
}

Enclave fields#

What each field means is told in Enclaves and attestation.

FieldMeaning
addressaddress

The Enclave account. voynich grant and voynich seal --enclave take it.

signingKeyaddress

The enclave's Ed25519 key. It signs every receipt.

encryptionKey32 bytes, base64

The enclave's X25519 key. Inputs and the model key are encrypted to it.

hardwareTypestring

dev, tdx or sev-snp.

measurement96 hex characters

The measurement of the software the enclave runs. An owner allows it with voynich seal --measurement.

expiresAtSlotinteger string

The slot the enclave's attestation record expires at.

operatoraddress

The operator's wallet. It receives the operator share.

endpointURL

Where the enclave runtime listens.

relayPathstring

/v1/calls/{call}/input: the path, on the API and on the enclave's endpoint alike, that takes a call's encrypted input.

statusstring

live or expired.

reachableboolean

Whether the enclave's endpoint answered the API's last health request as this enclave. Callers are sent to live, reachable enclaves. See Reachability.

lastSeenISO 8601 time or null

When the endpoint last answered as this enclave. null until it first does.

modelsHeldinteger

How many models the enclave holds a grant for.

callsSettledinteger string

How many calls the enclave has settled.

attestationobject

The enclave's attestation record: address, signingKey, encryptionKey, hardwareType, measurement, recordedSlot, expiresAtSlot and layoutVersion.

voynich model price#

Shell
voynich model price <model> --price <base units>

Sets a model's price and operator share with set_price, signed by the owner's wallet. Calls that open after it pay the new price. The same from code is setPrice.

FieldMeaning
modelname or address, argumentrequired

The model to price.

--priceinteger stringrequired

The price of one call, in base units of the price's unit: lamports for SOL, the mint's smallest unit for a mint.

--operator-share-bpsinteger, 0 to 10000

The operator's share of each settled call, in basis points. Left out, the model keeps its share.

--mintSOL or address

The unit of the price: SOL, or the address of an SPL Token mint. Left out, the model keeps its unit.

--decimalsinteger

The decimals of the price's unit. Required with a mint other than the model's. Left out, it is 9 for SOL and the model's decimals when the mint stays.

--symbolstring

The label shown beside the price. Left out, it is the model's symbol when the mint stays, SOL for SOL, and the mint's address for another mint.

The wallet is chosen as told in Install and has to be the model's owner. The command reads the model first to fill in what the flags leave out.

It prints the status of the transaction, as JSON on stdout: id, status (confirmed or finalized) and signature.

CodeMessageCause
Supply model. or Supply --price.A missing argument or flag.
Supply --decimals for a new SPL mint.--mint names a mint other than the model's, without --decimals.
MODEL_NOT_FOUNDThe API's messageNo model has this name or address.
VALIDATION_ERRORThe API's messageA value is not what its flag takes.
SIMULATION_FAILEDThe API's messageThe wallet is not the model's owner, or the operator share plus the protocol share is above 10,000.
TRANSACTION_FAILED, TRANSACTION_EXPIREDThe failure's own message, or The transaction did not land.set_price was refused, or did not land before its blockhash expired.

voynich model retire#

Shell
voynich model retire <model>

Retires a model with retire_model, signed by the owner's wallet. A retired model takes no new calls and no new grants. The same from code is retire.

FieldMeaning
modelname or address, argumentrequired

The model to retire.

It prints the status of the transaction: id, status and signature.

CodeMessageCause
Supply model.The argument is missing.
MODEL_NOT_FOUNDThe API's messageNo model has this name or address.
SIMULATION_FAILEDThe API's messageThe wallet is not the model's owner.
TRANSACTION_FAILED, TRANSACTION_EXPIREDThe failure's own message, or The transaction did not land.retire_model was refused, or did not land before its blockhash expired.

voynich model followed by another word fails with Use model price, model retire, or model revoke. The third of them, voynich model revoke, is on grant.

Failures#

The two list commands exit with code 1 and print the API's code and message when the API refuses the request. The API's codes are in the HTTP API overview.