Guides
Manage a model
A sealed model has four things its owner can change: its price, which enclaves hold it, whether a grant still stands, and whether it takes calls. Each is one transaction signed by the owner's wallet.
On the site, a model's page at /models/<name> shows an Owner panel when the connected wallet is the model's owner, with three actions: Set price, Grant an enclave and Retire. The CLI and the SDK sign with the owner's keypair and have all four.
Set the price#
The price, its mint and the operator share change together. New calls open on the new terms. Calls that are already open settle on the terms they opened with.
On the model's page, under Set price, enter Price a call in the model's unit and Operator share in percent, and press Set price. Approve the transaction. The panel reads "Price set". The price's mint stays the model's.
voynich model price sketch-32 --price 100000 --operator-share-bps 3000A flag left out keeps the model's value. Every flag is in CLI: models.
const price = { amount: '100000', mint: null, decimals: 9, symbol: 'SOL' }
const status = await voynich.setPrice('sketch-32', price, 3000)The operator share plus the protocol share is at most 10,000 basis points. See Fees and the token.
Grant another enclave#
Each grant lets one more enclave open the model and answer calls. The owner needs the model key from the sealing: the browser that sealed the model, the key file saved from it, the CLI's owner key file, or the SDK's saved state.
The enclave must be registered, its attestation record in force, and its measurement on the model's list. /enclaves shows each enclave's measurement and expiry.
On the model's page, under Grant an enclave, choose an enclave from the list of registered enclaves whose measurement the model allows, press Grant and approve the transaction. The panel reads "Granted". When the site has been reopened since, it asks for the sealing password to unlock the saved key first. In a browser that does not hold the key, it asks for the key file and then for that file's password.
voynich grant <model> <enclave> --state owner.enc.jsonconst status = await voynich.grant(model.address, enclave, resume.modelKey)The key is wrapped on the device to that enclave's encryption key, after the device has checked the enclave's record on chain. A granted enclave can also grant the next enclave itself, without the owner: see Grants.
Revoke a grant#
Revoking stops an enclave from taking new calls for the model and from passing its key on. Calls already open with it settle or refund as usual.
voynich model revoke <model> <enclave>const status = await voynich.revoke('sketch-32', enclave)enclave is the enclave's address or its signing key. The transaction is revoke_grant, and the grant then reads "Revoked" on the enclave's page, /enclaves/<key>. Granting the same enclave again lifts the revocation.
Retire the model#
Retiring closes the model to new calls and new grants. Calls that are open settle until their deadline and refund after it. The ciphertext and every receipt stay on chain.
On the model's page, under Retire, press Retire, then Retire <name> to confirm, and approve the transaction. Keep it steps back. The panel reads "Retired".
voynich model retire <model>const status = await voynich.retire('sketch-32')The owner's side#
/account shows the models the connected wallet owns and what they have earned, by mint. The same is voynich account <wallet> in the CLI and account() in the SDK.
Every option and failure of the four functions is in SDK: grant and refund. What each transaction checks and changes on chain is in Program: Instructions.