Enum MirrorBondStatesUnknownReason 

pub enum MirrorBondStatesUnknownReason {
    ServedSetUnknown,
    ChainUnreadable,
    InFlightUnknown,
    ProvenanceUnknown,
}

Why a node cannot state its bond states AT ALL.

The “cannot tell” axis, and it is deliberately separate from every per-bond state, all of which are DEFINITE statements. A fact the node could not read makes the WHOLE answer MirrorBondStatesResult::Unknown rather than degrading individual rows: a partial list is indistinguishable from a complete one, and the rows a broken read would drop are exactly the bonds nobody is then watching.

The epoch requirement being unknown is NOT a member — that is a definite per-bond state (MirrorBondState::Deferred) and the node can still answer.

Variants

ServedSetUnknown

The node cannot enumerate the (store, root) pairs it holds, so it does not know which bonds exist to have a state. Nothing may be substituted: the census stores figure counts network-wide advertisements and is not this node’s set.

ChainUnreadable

The node cannot read mirror coins from chain, so it cannot tell a bonded pair from an unfunded one. Answering unfunded here would be a fabricated shortfall.

InFlightUnknown

The node cannot read its own in-flight creates, so it cannot tell Pending from Unfunded — a submitted create and no create at all look identical from chain alone during the gap.

ProvenanceUnknown

The node can enumerate the (store, root) pairs it holds, but cannot determine their PROVENANCE, so it cannot tell a Relayed capsule apart from one that is simply absent.

The one non-infrastructure reason, and it exists because the alternative is a lie. A derivation keyed on the desired-bond (Held) set enumerates perfectly well and yet can never emit Withheld, because a Relayed capsule is by construction absent from that set. Without this reason its only conforming-LOOKING answer is a known page with complete: true and every withheld row silently missing — the exact “no such row where the contract promises withheld on purpose” failure, wearing the shape of a complete answer. This reason is how such a node says so instead.

Implementations

impl MirrorBondStatesUnknownReason

pub const ALL: &'static [MirrorBondStatesUnknownReason]

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 MirrorBondStatesUnknownReason

fn clone(&self) -> MirrorBondStatesUnknownReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MirrorBondStatesUnknownReason

impl Debug for MirrorBondStatesUnknownReason

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MirrorBondStatesUnknownReason

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for MirrorBondStatesUnknownReason

impl PartialEq for MirrorBondStatesUnknownReason

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for MirrorBondStatesUnknownReason

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 MirrorBondStatesUnknownReason