Enum BindingStatus 

pub enum BindingStatus {
    Bound,
    Mismatch,
    Unbound,
    Unknown,
}

Whether the node’s local iroh key is the one bound to its operator address on-chain (#1034).

This is a correctness signal, not a liveness one. SlashJudge resolves an accused node through CapacityBond.nodeIdOf, so a node serving under a key no binding points at is unslashable: it earns normally while its bond is unreachable, which is a protocol fault rather than an outage — and one with no symptom the operator would otherwise notice. A key rotation that swapped node.secret without submitting bindNodeId lands exactly here, which is why decdn node rotate-key orders its steps to make the state unreachable and why the daemon reports it when it happens anyway.

Advisory by construction. The check is one RPC at bring-up, and a daemon that refused to start on it would be brickable by a transient RPC failure and unable to run the very rotation that repairs it.

Variants

Bound

The on-chain binding names this node’s key. Nothing to do.

Mismatch

The operator is bound to a DIFFERENT node id than the local key — the un-slashable state. Either rotate on-chain to match the local key (decdn node rotate-key --key iroh --bind-existing) or restore the key the binding names. Sampled once at bring-up like every other variant here, so a live repair does not clear this to Bound until the daemon restarts — a mismatch seen right after running --bind-existing is not a failed repair, just a stale sample.

Unbound

The operator address has no binding at all: never registered, or the node id was reclaimed. decdn node register makes the initial binding.

Unknown

Not determined — no [blockchain] configuration to check against, or the read failed. Explicitly not a synonym for “fine”.

Trait Implementations

impl Clone for BindingStatus

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BindingStatus

impl Debug for BindingStatus

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BindingStatus

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for BindingStatus

impl PartialEq for BindingStatus

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for BindingStatus

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 BindingStatus