Struct NodeCandidate 

pub struct NodeCandidate {
    pub node_id: PublicKey,
    pub eth_address: Address,
    pub region_hint: Option<Region>,
    pub multiaddrs: Bytes,
}

A node the client may fetch from, distilled from a registry NodeInfo. Dialing is by node_id; the registry-published multiaddrs ride along as iroh direct-address hints so a reachable peer connects without a relay (see module docs and NodeCandidate::dial_addrs).

Serializable so the resolved set can be projected into [crate::PeerStore] identity records and reloaded from the store when the registry is unreachable (ADR 012 § Bootstrap step 4).

That encoding is a private implementation detail of the peer store, not a stable format: the JSON keys are the field names, and the bytes are codec-dependent (iroh renders PublicKey as z-base-32 under a human-readable codec and as raw bytes otherwise).

Fields

node_id: PublicKey

iroh endpoint id — dialed via discovery, never needs an explicit addr.

eth_address: Address

The node’s Ethereum address — the --provider-address discovery derives (the channel is opened/reused against it and the slash_sig verified against it).

region_hint: Option<Region>

The node’s self-attested region (ADR 030), used for locality-aware selection. None when the node registered without one, or with a code outside Region’s accepted set.

An unrecognized code parses to None and sorts into the “rest” bucket rather than dropping the candidate: CapacityBond permits any string up to 16 bytes and ADR 030 § Cross-ADR Impact explicitly declines to tighten it, so rejecting a node over a purely advisory field would be stricter than the source of truth and would silently shrink the fetchable set. Parsing at this boundary is what makes the derived Eq above correct and keeps an unbounded operator-submitted string off the peer-store read path (#1348).

multiaddrs: Bytes

The node’s registry-published, packed multiaddrs field (pack_multiaddrs framing), decoded on demand by Self::dial_addrs into iroh direct-address hints. Self-attested and additive: it can only add a direct dial path, never gate one. Carried through the peer store, so a candidate rebuilt on a registry outage keeps the last-seen addresses and can dial a reachable peer directly, without iroh discovery.

Implementations

impl NodeCandidate

pub fn dial_addrs(&self) -> Vec<SocketAddr>

Registry-published direct dial addresses, decoded leniently from the packed on-chain multiaddrs field for use as iroh direct-address hints (ADR 001 § Node Discovery). Empty when the node published none or the field is malformed. A returned address is only ever one dial path among discovery and the relay fallback, so a stale entry loses the path race but never fails the connection.

Trait Implementations

impl Clone for NodeCandidate

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeCandidate

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NodeCandidate

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for NodeCandidate

impl PartialEq for NodeCandidate

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for NodeCandidate

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 NodeCandidate