Struct MmrInclusionProof 

pub struct MmrInclusionProof {
    pub mmr_size: u64,
    pub items: BoundedVec<Hash, ConstU32<MAX_INCLUSION_PROOF_ITEMS>>,
}

A single-leaf MMR inclusion proof: mmr_lib’s [MerkleProof] items (the sibling path plus the other peaks) and the node count it was generated against. Used by the event and register head read. Where MMRExtensionProof moves a frontier forward, this places one leaf under a fixed MMR. The root is derived, never declared.

Fields

mmr_size: u64

mmr_lib node count of the MMR the proof was generated against. With the leaf count it derives (get_peak_map), it pins a head read.

items: BoundedVec<Hash, ConstU32<MAX_INCLUSION_PROOF_ITEMS>>

The leaf’s sibling path plus the other peaks, in mmr_lib order.

Implementations

impl MmrInclusionProof

pub fn verify_head( &self, leaf: Hash, ) -> Result<(MessagePosition, MmrFrontier), ProofError>

Verify leaf (already hashed by crate::message::leaf_hash) as the last leaf of the proven MMR. Returns the head position and the frontier of that MMR; Err on any structural defect.

The expected shape is what gen_proof produces for the last leaf: the other peaks left to right, then the head’s left siblings bottom up. The item count is checked exactly.

Only reconstructs a frontier; does not bind it to any committed StreamsRoot. Ok is not authentication. Prefer crate::message::verify_event, which binds the result to a trusted under.

pub fn verify_leaf( &self, position: MessagePosition, leaf: Hash, ) -> Result<MmrRoot, ProofError>

Verify leaf (already hashed by crate::message::leaf_hash) at position and return the implied MmrRoot. Err if the position is out of range or the proof malformed. Only reconstructs the root; Ok is not authentication. Prefer crate::message::verify_event, which binds the result to a trusted under.

Trait Implementations

impl Clone for MmrInclusionProof

fn clone(&self) -> MmrInclusionProof

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MmrInclusionProof

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Decode for MmrInclusionProof

fn decode<__CodecInputEdqy: Input>( __codec_input_edqy: &mut __CodecInputEdqy, ) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self>, ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl Encode for MmrInclusionProof

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode_to<__CodecOutputEdqy: Output + ?Sized>( &self, __codec_dest_edqy: &mut __CodecOutputEdqy, )

Convert self to a slice and append it to the destination.

fn encode(&self) -> Vec<u8>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R

where F: FnOnce(&[u8]) -> R,

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl PartialEq for MmrInclusionProof

fn eq(&self, other: &MmrInclusionProof) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TypeInfo for MmrInclusionProof

type Identity = MmrInclusionProof

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl DecodeWithMemTracking for MmrInclusionProof

impl EncodeLike for MmrInclusionProof

impl Eq for MmrInclusionProof

impl StructuralPartialEq for MmrInclusionProof