Enum CommitmentFallback 

pub enum CommitmentFallback {
    Wait,
    FetchByRound {
        round: Round,
    },
    FetchByCommitment {
        height: Height,
    },
}

How a commitment-keyed block subscription should behave when the block is missing locally.

Variants

Wait

Wait for local availability only.

Use this for pending candidate proposal data before notarization.

FetchByRound

Request the notarized proposal for round from peers.

Use this when the caller knows a trusted notarized or certified round and commitment but not the proposal height, such as proposal construction, verification of a known child, or certification of a notarized candidate. Do not infer height from the finalized tip or another block: proposals may build on a certified parent that is not finalized locally yet, and an unverified child may lie about its height.

The returned block is heightable once decoded, but that is too late for the in-flight resolver key or retention bound.

Fields

round: Round

FetchByCommitment

Request the exact commitment from peers and prune the request at height.

Use this only when no certified parent round is available. The caller must have a locally validated resolver retention bound. Examples include repairing a finalized gap or walking an accepted ancestry stream. Do not use it for a candidate’s immediate parent when the consensus context supplies the parent round.

The height is not sent to peers. It is a local hint for request retention. It is not part of response validity. A fetched block is delivered if its commitment matches. A matching block above this bound is delivered but not cached.

Fields

height: Height

Trait Implementations

impl Clone for CommitmentFallback

fn clone(&self) -> CommitmentFallback

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CommitmentFallback

impl Debug for CommitmentFallback

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

Formats the value using the given formatter.

impl Eq for CommitmentFallback

impl From<DigestFallback> for CommitmentFallback

fn from(fallback: DigestFallback) -> Self

Converts to this type from the input type.

impl PartialEq for CommitmentFallback

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CommitmentFallback