Enum CollateralUnknownReason 

pub enum CollateralUnknownReason {
    NotCensused,
    BehindFinalityDepth,
    RecordUnreadable,
    NoChainSource,
    BalanceUnreadable,
}

Why a node cannot state this epoch’s collateral requirement.

Each variant names a DIFFERENT missing fact, because the remedies differ: a node that has not censused the epoch needs to run the census, whereas a node inside the finality depth needs only to wait for the chain to settle. Collapsing them into one “unavailable” would hand every client the same unactionable sentence.

Variants

NotCensused

This node has not censused the epoch, so it holds no record to answer from.

BehindFinalityDepth

The epoch’s census inputs are not yet final — the node is inside CENSUS_FINALITY_DEPTH_BLOCKS of the chain tip and any figure it derived could still move.

RecordUnreadable

The node holds a record for the epoch but could not read it.

NoChainSource

The node cannot see the chain at all, so it cannot know whether a record should exist.

BalanceUnreadable

The node can read the epoch’s record, but cannot read its OWN $DIG balance, so it cannot tell whether it could fund what the record prices.

The one WALLET-shaped reason, and it exists because every other reason in this enum points an operator at the census, the record, or the chain. A node whose census is healthy and whose wallet read failed, reported as RecordUnreadable, tells that operator to repair a census that is working — the same remedy misdirection the withheld/disabled/reclaiming split exists to prevent.

It is emphatically NOT a shortfall. Answering Unfunded here would assert a gap the node has no evidence for, on the surface an operator uses to decide whether to alarm.

Implementations

impl CollateralUnknownReason

pub const ALL: &'static [CollateralUnknownReason]

Every reason, for exhaustive rendering and for the wire-token uniqueness KAT.

pub const fn as_wire(self) -> &'static str

The stable snake_case wire token, matching the reason field.

Trait Implementations

impl Clone for CollateralUnknownReason

fn clone(&self) -> CollateralUnknownReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CollateralUnknownReason

impl Debug for CollateralUnknownReason

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CollateralUnknownReason

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CollateralUnknownReason

impl PartialEq for CollateralUnknownReason

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CollateralUnknownReason

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CollateralUnknownReason