Module bootstrap_cache 

Greedy Bootstrap Cache

Provides persistent peer caching with quality-based selection for network bootstrap.

Features

• Large capacity: 10,000-30,000 peer entries (configurable)
• Quality scoring: Success rate, RTT, age decay, capability bonuses
• Epsilon-greedy selection: Balances exploitation vs exploration
• Multi-process safe: Atomic writes with file locking (Unix)
• Background maintenance: Periodic save, cleanup, and quality updates

Example

use ant_quic::bootstrap_cache::{BootstrapCache, BootstrapCacheConfig};
use std::sync::Arc;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let config = BootstrapCacheConfig::builder()
        .cache_dir("/var/lib/ant-quic")
        .max_peers(20_000)
        .epsilon(0.1)
        .build();

    let cache = Arc::new(BootstrapCache::open(config).await?);

    // Start background maintenance
    let _maintenance = cache.clone().start_maintenance();

    // Get peers for bootstrap (epsilon-greedy selection)
    let peers = cache.select_peers(50).await;

    // Record connection results
    for peer in &peers {
        // ... attempt connection ...
        cache.record_success(&peer.peer_id, 100).await; // or record_failure
    }

    // Save periodically (also done by maintenance task)
    cache.save().await?;

    Ok(())
}

Structs

BootstrapCache

Greedy bootstrap cache with quality-based peer selection.

BootstrapCacheConfig

Configuration for the bootstrap cache

BootstrapCacheConfigBuilder

Builder for BootstrapCacheConfig

CacheStats

Cache statistics

CachedPeer

A cached peer entry with quality metrics

ConnectionOutcome

Result of a connection attempt

ConnectionStats

Connection statistics for quality scoring

PeerCapabilities

Peer capabilities and features

QualityWeights

Weights for quality score calculation

Enums

CacheEvent

Bootstrap cache event for notifications

NatType

NAT type classification

PeerSource

How we discovered this peer

SelectionStrategy

Peer selection strategy