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

The chain seesYou see
ContentCiphertextThe file
NameInside the ciphertextThe file name
TypeInside the ciphertextThe media type
SizeThe bucket, 64 KiB to 64 MiBThe exact size
KeyNot publishedThe file key, in your manifest
PayerThe pool, through the relayerYour shielded balance
Spent notesTwo nullifiersWhich of your notes paid
ChangeA commitment and an encrypted memoYour new note

Public on Solana: the pay transaction

FieldWhat it is
Signer and fee payerThe relayer. The holder's wallet is not in the transaction.
receiptThe receipt hash this payment is bound to. See The proof that pays.
ciphertextRootSHA-256 of the sealed bytes.
bucketThe bucket size in bytes.
term30d, 1y or permanent, carried in the PaidV2 event as a u8 code: 0 = 30d, 1 = 1y, 2 = permanent.
relayerThe relayer that signed, also bound into the proof.
rootTwo 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.
nullifiersTwo values marking the spent notes as spent. They do not say which commitments were spent.
outputCommitmentsTwo new commitments, the change note and a second output, each inserted as a leaf. A zero-valued output is a commitment like any other.
leafIndicesWhere the two new commitments sit in the tree.
price, fee, relayer_refundThe storage price, Geode's fee and the network refund.
MemosThe new notes' memos, encrypted under the holder's view key.
signature, slotWhere the transaction landed.

Public on Irys: the upload

FieldWhat it is
BytesThe ciphertext, exactly one bucket long.
IdThe Irys id, 43 characters of base64url.
Geode-Receipt tagThe receipt hash, linking the upload to its pay.
Geode-Locator tagOn a manifest only: the vault's locator. See The manifest.
UploaderThe 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.