Expand description
Merkle-committed receipt batch checkpointing.
Produces signed kernel checkpoint statements that commit a batch of receipts to a Merkle root. Inclusion proofs allow verifying that a specific receipt was part of a batch without replaying the entire log.
Issuance schema: “chio.checkpoint_statement.v2”
Structs§
- Checkpoint
Chain Frontier - Append-only frontier of the checkpoint-chain Merkle tree.
- Checkpoint
Consistency Proof - A Merkle consistency proof between two checkpoint-chain commitments.
- Checkpoint
Equivocation - A deterministic conflict record derived from multiple checkpoint statements.
- Checkpoint
Publication - A deterministic publication record derived from a signed checkpoint.
- Checkpoint
Transparency Summary - Derived transparency records for a set of checkpoints.
- Checkpoint
Witness - A deterministic witness record derived from a checkpoint’s predecessor digest.
- Kernel
Checkpoint - A signed kernel checkpoint statement.
- Kernel
Checkpoint Body - The signed body of a kernel checkpoint statement.
- Receipt
Inclusion Proof - A Merkle inclusion proof for a receipt within a checkpoint batch.
Enums§
- Checkpoint
Consistency Anchor - What ties the prefix below a consistency proof’s earlier endpoint to a history the verifier accepts.
- Checkpoint
Equivocation Kind - Classifies a conflicting checkpoint observation.
- Checkpoint
Error - Error type for checkpoint operations.
Constants§
- CHECKPOINT_
CONSISTENCY_ PROOF_ SCHEMA - Schema used for new consistency-proof issuance.
- CHECKPOINT_
CONSISTENCY_ PROOF_ SCHEMA_ V1 - Legacy metadata-only continuity record.
- CHECKPOINT_
CONSISTENCY_ PROOF_ SCHEMA_ V2 - Cryptographic checkpoint-chain consistency proof.
- CHECKPOINT_
EQUIVOCATION_ SCHEMA - CHECKPOINT_
PUBLICATION_ SCHEMA - CHECKPOINT_
SCHEMA - Schema used for new checkpoint issuance.
- CHECKPOINT_
SCHEMA_ V1 - Legacy checkpoint statement without a checkpoint-chain commitment.
- CHECKPOINT_
SCHEMA_ V2 - Checkpoint statement that may carry the signed checkpoint-chain commitment.
- CHECKPOINT_
WITNESS_ SCHEMA
Functions§
- bind_
checkpoint_ publication_ trust_ anchor - Attach a validated trust-anchor binding to an already-derived publication.
- build_
checkpoint - Build a signed kernel checkpoint from a batch of canonical receipt bytes.
- build_
checkpoint_ consistency_ proof - Build a Merkle consistency proof showing that
current’s chain commitment is an append-only extension ofprevious’s. - build_
checkpoint_ publication - Build a deterministic publication record from a signed checkpoint.
- build_
checkpoint_ transparency - Derive publication, witness, and equivocation records from a checkpoint set.
- build_
checkpoint_ with_ chain_ frontier - Build a signed kernel checkpoint from the chain frontier rather than from every prior leaf.
- build_
checkpoint_ with_ previous - Build a signed kernel checkpoint that explicitly links to the previous checkpoint when provided.
- build_
checkpoint_ witness - Build a deterministic witness record when
witness_checkpointcitescheckpoint. - build_
inclusion_ proof - Build an inclusion proof for a leaf in an already-built MerkleTree.
- build_
trust_ anchored_ checkpoint_ publication - Build a deterministic publication record that is explicitly bound to declared trust-anchor verifier material.
- checkpoint_
body_ sha256 - Return the canonical SHA-256 digest for a checkpoint body.
- checkpoint_
chain_ leaf_ hash - RFC 6962 leaf hash of a checkpoint body’s chain-commitment leaf.
- checkpoint_
chain_ leaf_ hash_ from_ parts - RFC 6962 leaf hash of one checkpoint’s chain-commitment leaf.
- checkpoint_
chain_ root - Chain-commitment root over an ordered, gap-free run of chain leaves starting at checkpoint_seq 1.
- checkpoint_
log_ id - checkpoint_
log_ tree_ size - describe_
checkpoint_ equivocation - Render a checkpoint conflict as a stable, human-readable description.
- detect_
checkpoint_ equivocation - Detect whether two checkpoints conflict under Chio transparency semantics.
- is_
supported_ checkpoint_ schema - validate_
checkpoint - Validate the integrity of a single checkpoint statement.
- validate_
checkpoint_ predecessor - Validate that
checkpointcleanly extendspredecessor. - validate_
checkpoint_ transparency - Validate that a checkpoint set is transparency-safe, fork-free, and connected to checkpoint 1.
- verify_
checkpoint_ consistency_ proof - Verify a genesis-anchored consistency proof against two signed checkpoints.
- verify_
checkpoint_ consistency_ proof_ with_ anchor - Verify a consistency proof against two signed checkpoints and an anchor for the prefix below the earlier endpoint.
- verify_
checkpoint_ continuity - Verify that
currentexplicitly extendsprevious. - verify_
checkpoint_ signature - Verify the signature on a KernelCheckpoint.
- verify_
checkpoint_ transparency_ records - Verify that supplied transparency records match the signed checkpoint set.