Chio/Docs
LOGIN · JOIN

chio anchor

Anchor receipt checkpoints to public ledgers, then prove and verify one receipt's inclusion offline.

Reference chio@5f63e6e

On this page

All command families · Global flags

chio anchor

Anchor receipt checkpoints to public ledgers and verify inclusion proofs offline.

Command synopsistext
chio anchor [OPTIONS] <COMMAND>
  • chio anchor batch Roll unanchored receipt checkpoints into a signed chio.anchor_batch.v1 and publish its root to the profile’s lanes.
  • chio anchor prove Build a chio.anchor-proof-bundle.v2 for one receipt: its checkpoint inclusion proof and every lane’s anchor record.
  • chio anchor verify Verify a proof bundle offline, lane by lane, failing closed on any lane the witness policy requires.

Example

Verify a receipt’s proof bundle offline against your kernel key.

Terminalbash
chio anchor verify proof.json --trusted-kernel-pubkey 4f1c…a2e9
Output
checkpoint  #12, inclusion verified
evm         ChioRootRegistry on Base, sequence 12, final
solana      memo confirmed
rekor       witness entry verified
verified

chio anchor batch

Roll unanchored receipt checkpoints into a signed chio.anchor_batch.v1 and publish its root to the profile’s lanes.

Command synopsistext
chio anchor batch [OPTIONS] --profile <FILE>
  • --profile <FILE> Anchor profile file. Required.
  • --through <CHECKPOINT_SEQ> Last checkpoint sequence to include.
Additional behavior

The anchor profile names the lanes: the EVM ChioRootRegistry, a Solana memo, OpenTimestamps, and a Rekor witness. A batch starts Pending and records each lane’s receipt as it lands.

chio anchor prove

Build a chio.anchor-proof-bundle.v2 for one receipt: its checkpoint inclusion proof and every lane’s anchor record.

Command synopsistext
chio anchor prove [OPTIONS] --output <FILE> <RECEIPT_ID>
  • <RECEIPT_ID> Receipt to prove. Required.
  • --output <FILE> Proof bundle file. Required.

chio anchor verify

Verify a proof bundle offline, lane by lane, failing closed on any lane the witness policy requires.

Command synopsistext
chio anchor verify [OPTIONS] --trusted-kernel-pubkey <HEX> <BUNDLE>
  • <BUNDLE> Proof bundle file. Required.
  • --trusted-kernel-pubkey <HEX> Kernel public key the checkpoints must verify under. Required.

Read more in Anchoring.