Protocol
Public fields
Every field a Geode upload makes public on Solana and Irys, beside everything that stays sealed.
A Geode upload leaves two public records: the pay transaction on Solana and the ciphertext with its tags on Irys. Both are permanent and readable by anyone. This page lists every field in them. /see shows them for any Irys id or pay signature.
One stored file
Public on Solana: the pay transaction
| Field | What it is |
|---|---|
| Signer and fee payer | The relayer. The holder's wallet is not in the transaction. |
receipt | The receipt hash this payment is bound to. See The proof that pays. |
ciphertextRoot | SHA-256 of the sealed bytes. |
bucket | The bucket size in bytes. |
term | 30d, 1y or permanent, carried in the PaidV2 event as a u8 code: 0 = 30d, 1 = 1y, 2 = permanent. |
relayer | The relayer that signed, also bound into the proof. |
root | Two values. The instruction argument is the root the proof was made against, one the pool has held. The PaidV2 event's root is the tree root after both new commitments are inserted. |
nullifiers | Two values marking the spent notes as spent. They do not say which commitments were spent. |
outputCommitments | Two new commitments, the change note and a second output, each inserted as a leaf. A zero-valued output is a commitment like any other. |
leafIndices | Where the two new commitments sit in the tree. |
price, fee, relayer_refund | The storage price, Geode's fee and the network refund. |
| Memos | The new notes' memos, encrypted under the holder's view key. |
signature, slot | Where the transaction landed. |
Public on Irys: the upload
| Field | What it is |
|---|---|
| Bytes | The ciphertext, exactly one bucket long. |
| Id | The Irys id, 43 characters of base64url. |
Geode-Receipt tag | The receipt hash, linking the upload to its pay. |
Geode-Locator tag | On a manifest only: the vault's locator. See The manifest. |
| Uploader | The relayer's Irys account. |
Sealed
What no public record holds: the file bytes, the file name, the file type, the exact file size, the file key, the spending key, and the link between the holder's wallet and any payment.
The one wallet transaction
shield is signed by the holder's wallet and is public like any Solana transaction: the wallet address, the amount deposited, two new commitments with their encrypted memos, and two nullifiers of the dummy notes the deposit spends. Nothing in it names a later pay. A pay spends notes by nullifier, and a nullifier does not reveal which commitment it spends, so no field connects the two.
unshield makes its recipient and amount public, since that is where the SOL goes.