Feature description
Parent epic: #289
PoI milestone: Milestone 1 - Proof contract
Define the first Proof of Inclusion proof envelope and public API surface.
The proof envelope should establish proof_format_version = 1 as the first durable verification contract. It should carry the target claim, chain or network identifier, checkpoint witness data, transaction witness data, optional object or event target data, and verification metadata needed to dispatch to the correct verifier rules.
Motivation
The rest of PoI depends on a stable proof contract. Starting with the envelope and API surface gives construction, verification, fixtures, and future compatibility work one shared shape to build against.
Requirements
- Add a versioned PoI proof envelope with
proof_format_version = 1.
- Represent transaction, object, and event targets in the proof model.
- Include chain or network identity in the proof data.
- Include certified checkpoint summary, checkpoint contents, transaction data, transaction effects, and events when present.
- Include target object contents for object proofs and target event contents for event proofs.
- Keep proof-format versioning limited to compatibility and verifier dispatch, not broad product naming.
- Return a clear unsupported-version error for unknown proof versions.
Open questions
- Which crate should expose the first public PoI types and constructors?
- Should the proof envelope be serialized with an existing repository format or a new PoI-specific encoding?
Are you planning to do it yourself in a pull request?
Yes
Feature description
Parent epic: #289
PoI milestone: Milestone 1 - Proof contract
Define the first Proof of Inclusion proof envelope and public API surface.
The proof envelope should establish
proof_format_version = 1as the first durable verification contract. It should carry the target claim, chain or network identifier, checkpoint witness data, transaction witness data, optional object or event target data, and verification metadata needed to dispatch to the correct verifier rules.Motivation
The rest of PoI depends on a stable proof contract. Starting with the envelope and API surface gives construction, verification, fixtures, and future compatibility work one shared shape to build against.
Requirements
proof_format_version = 1.Open questions
Are you planning to do it yourself in a pull request?
Yes