Struct CachedPeer 

pub struct CachedPeer {
    pub peer_id: PeerId,
    pub addresses: Vec<SocketAddr>,
    pub capabilities: PeerCapabilities,
    pub first_seen: SystemTime,
    pub last_seen: SystemTime,
    pub last_attempt: Option<SystemTime>,
    pub stats: ConnectionStats,
    pub quality_score: f64,
    pub source: PeerSource,
    pub relay_paths: Vec<RelayPathHint>,
    pub token: Option<Vec<u8>>,
}

A cached peer entry with quality metrics

Fields

peer_id: PeerId

Unique peer identifier (serialized as bytes)

addresses: Vec<SocketAddr>

Known socket addresses for this peer

capabilities: PeerCapabilities

Peer capabilities and features

first_seen: SystemTime

When we first discovered this peer

last_seen: SystemTime

When we last successfully communicated with this peer

last_attempt: Option<SystemTime>

When we last attempted to connect (success or failure)

stats: ConnectionStats

Connection statistics

quality_score: f64

Computed quality score (0.0 to 1.0)

source: PeerSource

Source that added this peer

relay_paths: Vec<RelayPathHint>

Known relay paths for reaching this peer when direct connection fails

token: Option<Vec<u8>>

Persistent QUIC address validation token

Implementations

impl CachedPeer

pub fn new( peer_id: PeerId, addresses: Vec<SocketAddr>, source: PeerSource, ) -> Self

Create a new peer entry

pub fn record_success(&mut self, rtt_ms: u32, caps: Option<PeerCapabilities>)

Record a successful connection

pub fn record_failure(&mut self)

Record a failed connection attempt

pub fn calculate_quality(&mut self, weights: &QualityWeights)

Calculate quality score based on metrics

pub fn is_stale(&self, threshold: Duration) -> bool

Check if this peer is stale

pub fn success_rate(&self) -> f64

Get success rate

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

Return candidate addresses ordered by freshest reachability evidence first.

This prefers peer-verified reachable and externally observed addresses, but still falls back to the persisted addresses list so unverified peers remain dialable.

pub fn merge_addresses(&mut self, other: &CachedPeer)

Merge addresses from another peer entry

Trait Implementations

impl Clone for CachedPeer

fn clone(&self) -> CachedPeer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CachedPeer

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CachedPeer

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CachedPeer

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

where __S: Serializer,

Serialize this value into the given Serde serializer.