Struct PeerAddress 

pub struct PeerAddress {
    pub transport: String,
    pub addr: String,
    pub priority: u8,
    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.

seen_at_ms: Option<u64>

Wall-clock observation timestamp (Unix ms) for ranking by recency.

None means “no freshness signal” — typically an operator-edited static config. The dialer sorts candidates by this field descending (most recent first) and tries every address in one pass; None values sort last. 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 a new peer address.

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

Create a new peer address with priority.

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 PartialEq for PeerAddress

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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.

impl Eq for PeerAddress