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 pruning 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 and the caller has a locally validated pruning bound, such as 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 pruning hint for request retention, not part of response validity: a fetched block is delivered if its commitment matches, and certified storage uses the decoded block height.

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 Debug for CommitmentFallback

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

Formats the value using the given formatter.

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

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 Copy for CommitmentFallback

impl Eq for CommitmentFallback

impl StructuralPartialEq for CommitmentFallback