Struct PeerAddress 

pub struct PeerAddress {
    pub transport: String,
    pub addr: String,
    pub priority: u8,
    pub provenance: PeerAddressProvenance,
    pub seen_at_ms: Option<u64>,
}

A transport-specific address for reaching a peer.

Each peer can have multiple addresses across different transports, allowing fallback if one transport is unavailable.

Fields

transport: String

Transport type (e.g., “udp”, “tor”, “ethernet”).

addr: String

Transport-specific address string.

Format depends on transport type:

• UDP/TCP: “host:port” — IP address or DNS hostname (e.g., “192.168.1.1:2121” or “peer1.example.com:2121”)
• Ethernet: “interface/mac” (e.g., “eth0/aa:bb:cc:dd:ee:ff”)

priority: u8

Priority for address selection (lower = preferred). When multiple addresses are available, lower priority addresses are tried first.

provenance: PeerAddressProvenance

Trust provenance for policies that distinguish operator routes from learned address hints.

Omission means configured for compatibility with existing config files. Learned runtime values retain their provenance when serialized.

seen_at_ms: Option<u64>

Wall-clock observation timestamp (Unix ms) for ranking by recency within the same priority.

None means “no freshness signal”. The dialer primarily honors explicit address priority and only uses this field to order otherwise-equal candidates. Skipped from serde so that round-tripping a config file doesn’t produce noisy empty fields.

Excluded from PartialEq: refreshing the timestamp on a peer that’s otherwise unchanged should not flag it as “updated” in crate::endpoint::FipsEndpoint::update_peers’s diff.

Implementations

impl PeerAddress

pub fn new(transport: impl Into<String>, addr: impl Into<String>) -> Self

Create an explicitly configured peer address.

pub fn with_priority( transport: impl Into<String>, addr: impl Into<String>, priority: u8, ) -> Self

Create an explicitly configured peer address with priority.

pub fn learned(self) -> Self

Mark this address as learned from discovery or an active path.

pub fn is_configured(&self) -> bool

Whether this address was explicitly operator-configured.

pub fn with_seen_at_ms(self, seen_at_ms: u64) -> Self

Tag this address with a freshness timestamp. Used by the dialer to rank candidates from multiple sources (overlay advert, recent-peers cache, operator hints) by recency without caring where they came from. See crate::config::PeerAddress::seen_at_ms.

Trait Implementations

impl Clone for PeerAddress

fn clone(&self) -> PeerAddress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerAddress

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PeerAddress

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PeerAddress

impl PartialEq for PeerAddress

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PeerAddress

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

where __S: Serializer,

Serialize this value into the given Serde serializer.