Struct ReachabilityInfo 

pub struct ReachabilityInfo {
    pub addresses: Vec<SocketAddr>,
    pub nat_type: Option<String>,
    pub can_receive_direct: Option<bool>,
    pub is_relay: Option<bool>,
    pub is_coordinator: Option<bool>,
    pub reachable_via: Vec<MachineId>,
    pub relay_candidates: Vec<MachineId>,
}

Summarises the connectivity properties of a discovered agent.

Built from a DiscoveredAgent and used to decide which connection strategy to attempt.

Fields

addresses: Vec<SocketAddr>

Agent’s known addresses.

nat_type: Option<String>

NAT type reported by the agent (e.g. “FullCone”, “Symmetric”). None when the agent has not yet reported NAT information.

This is informational only. Connection strategy should not infer direct reachability from NAT type alone.

can_receive_direct: Option<bool>

Whether the agent can receive direct inbound connections. None when not reported.

is_relay: Option<bool>

Whether the agent advertises relay service capability. None when not reported.

is_coordinator: Option<bool>

Whether the agent advertises coordinator capability. None when not reported.

reachable_via: Vec<MachineId>

Coordinator machines through which the advertising peer is reachable.

Prefer these when can_receive_direct == Some(false) — the peer has explicitly named who can hole-punch for them.

relay_candidates: Vec<MachineId>

Relay machines the peer proposes as a fallback.

Implementations

impl ReachabilityInfo

pub fn from_discovered(agent: &DiscoveredAgent) -> Self

Build from a DiscoveredAgent.

pub fn from_discovered_machine(machine: &DiscoveredMachine) -> Self

Build from a DiscoveredMachine.

pub fn likely_direct(&self) -> bool

Returns true if the remote agent has observer-verified direct reachability.

pub fn should_attempt_direct(&self) -> bool

Returns true if it is still worth attempting a direct connection.

Unknown reachability should still get a direct probe, especially for new networks where the first nodes have not yet accumulated observations.

pub fn needs_coordination(&self) -> bool

Returns true if coordinated NAT traversal may be needed to connect.

Any agent that is not positively known to be directly reachable may still need coordination after direct attempts are exhausted.

pub fn is_relay(&self) -> bool

Returns true if the agent advertises relay service capability.

pub fn is_coordinator(&self) -> bool

Returns true if the agent advertises coordinator capability.

Trait Implementations

impl Clone for ReachabilityInfo

fn clone(&self) -> ReachabilityInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReachabilityInfo

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

Formats the value using the given formatter.