Struct PeerDiscoveryManager 

pub struct PeerDiscoveryManager {
    pub config: DiscoveryConfig,
    /* private fields */
}

Multi-strategy peer discovery manager.

Maintains a scored, deduplicated pool of PeerCandidates, drives the connection lifecycle, and provides ranked candidate selection with configurable backoff and stale eviction.

Fields

config: DiscoveryConfig

Configuration.

Implementations

impl PeerDiscoveryManager

pub fn new(config: DiscoveryConfig) -> Self

Create a new manager with the given configuration.

pub fn add_candidate(&mut self, candidate: PeerCandidate) -> bool

Add or update a candidate.

• If the peer is already tracked, the new addresses are merged (deduplicated) into the existing record and true is returned.
• If the candidate pool is at max_candidates, the lowest-scoring non-connected candidate is evicted first. If no eviction is possible (all slots are connected) false is returned.
• Otherwise the candidate is inserted and true is returned.

pub fn record_outcome( &mut self, peer_id: &str, outcome: ConnectOutcome, now: u64, ) -> bool

Record the outcome of a connection attempt.

Updates connect_score, attempted, connected, and counters. Returns false when the peer is not found.

pub fn mark_disconnected(&mut self, peer_id: &str) -> bool

Mark a peer as disconnected.

The peer remains in the candidate pool with a slightly reduced score so it can be re-tried later. Returns false when the peer is not found.

pub fn candidates_to_try(&self, n: usize, now: u64) -> Vec<&PeerCandidate>

Return up to n candidates that should be tried next.

Eligible candidates are those that:

• Are not currently connected.
• Have last_attempt == None or last_attempt is at least retry_backoff_ms before now.

Results are sorted by connect_score descending.

pub fn evict_stale(&mut self, now: u64) -> usize

Evict non-connected candidates that are considered stale.

A candidate is stale when both:

• discovered_at < now - stale_threshold_ms
• last_attempt < now - stale_threshold_ms or last_attempt == None

Returns the number of evicted candidates.

pub fn connected_peers(&self) -> Vec<&PeerCandidate>

All currently connected peer candidates.

pub fn peer_count(&self) -> usize

Total number of tracked candidates.

pub fn connected_count(&self) -> usize

Number of currently connected peers.

pub fn best_candidate(&self) -> Option<&PeerCandidate>

The highest-scoring candidate that is not currently connected.

pub fn candidates_by_method( &self, method: &DiscoveryMethod, ) -> Vec<&PeerCandidate>

All candidates discovered via the given method.

pub fn stats(&self) -> DiscoveryStats

A statistics snapshot covering the current pool state.