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#
voynich modelsIt takes no arguments. It prints one page of models, up to 24, ordered by calls:
itemsarray of ModelThe models. Each has the fields below.
page.nextCursorstring or nullThe position of the next page, or null on the last one.
page.hasMorebooleanWhether more models follow this page.
asOfISO 8601 timeWhen the API read this state.
The output:
{
"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.
addressaddressThe Model account.
namestringThe model's name, such as sketch-32. Commands take the name or the address.
owneraddressThe wallet that sealed the model.
createdSlotinteger stringThe slot the Model was created in.
sealedSlotinteger string or nullThe slot the ciphertext hash was fixed in. null while the model is uploading.
sizeBytesintegerThe ciphertext's size.
plaintextSizeBytesintegerThe weights file's size before encryption.
ciphertextSha25664 hex characters or nullThe SHA-256 of the ciphertext. null while the model is uploading.
cipherobjectid (xchacha20poly1305-64k-v1), chunkSizeBytes (65536) and noncePrefix (16 bytes, base64).
allowedMeasurementsarray of 96 hex charactersThe measurements whose enclaves can be granted the model key.
priceobjectThe price of one call: amount in base units as a string, mint (an address, or null for SOL), decimals and symbol.
operatorShareBpsintegerThe operator's share of each settled call, in basis points.
protocolShareBpsinteger or nullThe protocol share, in basis points.
statusstringuploading, sealed, live or retired.
manifestobjectname, 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.
weightsarrayThe 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 nullThe upload: uploadKey, bytesWritten, transactionsWritten, writtenRanges and closed. upload is null from sealing on.
enclavesHoldingintegerHow many enclaves hold a grant for the model that is not revoked, with an attestation record in force.
callsSettledinteger stringHow many calls to the model have settled.
voynich enclaves#
voynich enclavesIt 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:
{
"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.
addressaddressThe Enclave account. voynich grant and voynich seal --enclave take it.
signingKeyaddressThe enclave's Ed25519 key. It signs every receipt.
encryptionKey32 bytes, base64The enclave's X25519 key. Inputs and the model key are encrypted to it.
hardwareTypestringdev, tdx or sev-snp.
measurement96 hex charactersThe measurement of the software the enclave runs. An owner allows it with voynich seal --measurement.
expiresAtSlotinteger stringThe slot the enclave's attestation record expires at.
operatoraddressThe operator's wallet. It receives the operator share.
endpointURLWhere 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.
statusstringlive or expired.
reachablebooleanWhether 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 nullWhen the endpoint last answered as this enclave. null until it first does.
modelsHeldintegerHow many models the enclave holds a grant for.
callsSettledinteger stringHow many calls the enclave has settled.
attestationobjectThe enclave's attestation record: address, signingKey, encryptionKey, hardwareType, measurement, recordedSlot, expiresAtSlot and layoutVersion.
voynich model price#
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.
modelname or address, argumentrequiredThe model to price.
--priceinteger stringrequiredThe 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 10000The operator's share of each settled call, in basis points. Left out, the model keeps its share.
--mintSOL or addressThe unit of the price: SOL, or the address of an SPL Token mint. Left out, the model keeps its unit.
--decimalsintegerThe 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.
--symbolstringThe 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.
| Code | Message | Cause |
|---|---|---|
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_FOUND | The API's message | No model has this name or address. |
VALIDATION_ERROR | The API's message | A value is not what its flag takes. |
SIMULATION_FAILED | The API's message | The wallet is not the model's owner, or the operator share plus the protocol share is above 10,000. |
TRANSACTION_FAILED, TRANSACTION_EXPIRED | The 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#
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.
modelname or address, argumentrequiredThe model to retire.
It prints the status of the transaction: id, status and signature.
| Code | Message | Cause |
|---|---|---|
Supply model. | The argument is missing. | |
MODEL_NOT_FOUND | The API's message | No model has this name or address. |
SIMULATION_FAILED | The API's message | The wallet is not the model's owner. |
TRANSACTION_FAILED, TRANSACTION_EXPIRED | The 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.