Struct BootstrapManager 

pub struct BootstrapManager { /* private fields */ }

Simplified bootstrap manager wrapping saorsa-transport’s cache

Provides Sybil protection via rate limiting and IP diversity enforcement while delegating core caching to saorsa-transport’s proven implementation.

Implementations

impl BootstrapManager

pub async fn new() -> Result<Self, P2PError>

Create a new bootstrap manager with default configuration

pub async fn with_config(config: BootstrapConfig) -> Result<Self, P2PError>

Create a new bootstrap manager with custom configuration

pub async fn with_node_config( config: BootstrapConfig, node_config: &NodeConfig, ) -> Result<Self, P2PError>

Create a new bootstrap manager from a BootstrapConfig and a NodeConfig.

Derives the loopback policy from node_config.allow_loopback and merges the node-level diversity_config (if set) so the transport and bootstrap layers stay consistent.

pub fn start_maintenance(&mut self) -> Result<(), P2PError>

Start background maintenance tasks (delegated to saorsa-transport)

pub async fn add_peer( &self, addr: &SocketAddr, addresses: Vec<SocketAddr>, ) -> Result<(), P2PError>

Add a peer to the cache with Sybil protection

Enforces:

1. Rate limiting (per-subnet temporal limits)
2. IP diversity (geographic/ASN limits)

pub async fn add_peer_trusted( &self, addr: &SocketAddr, addresses: Vec<SocketAddr>, )

Add a trusted peer bypassing Sybil protection

Use only for well-known bootstrap nodes or admin-approved peers.

pub async fn record_success(&self, addr: &SocketAddr, rtt_ms: u32)

Record a successful connection

pub async fn record_failure(&self, addr: &SocketAddr)

Record a failed connection

pub async fn select_peers(&self, count: usize) -> Vec<CachedPeer>

Select peers for bootstrap using epsilon-greedy strategy

pub async fn select_relay_peers(&self, count: usize) -> Vec<CachedPeer>

Select peers that support relay functionality

pub async fn select_coordinators(&self, count: usize) -> Vec<CachedPeer>

Select peers that support NAT coordination

pub async fn stats(&self) -> BootstrapStats

Get cache statistics

pub async fn peer_count(&self) -> usize

Get the number of cached peers

pub async fn save(&self) -> Result<(), P2PError>

Save cache to disk

pub async fn update_capabilities( &self, addr: &SocketAddr, capabilities: PeerCapabilities, )

Update peer capabilities

pub async fn contains(&self, addr: &SocketAddr) -> bool

Check if a peer exists in the cache

pub async fn get_peer(&self, addr: &SocketAddr) -> Option<CachedPeer>

Get a specific peer from the cache

pub fn diversity_config(&self) -> &IPDiversityConfig

Get the diversity config