Struct Discovery 

pub struct Discovery { /* private fields */ }

Implementations

impl Discovery

pub const TARGET: usize = 8

Connected peers the round tries to reach.

pub const DIALS_PER_ROUND: usize = 2

pub const OPERATIONS_PER_ROUND: usize = 3

pub const GOSSIP_EVERY: u64 = 30

Rounds between address requests to one random connected peer.

pub const GOSSIP_LIMIT: u32 = 32

pub const SEED_EVERY: u64 = 600

Rounds between seed passes while below target but connected.

pub const BOOTSTRAP_REACHED: u64 = 4

At startup seeds are dialed while fewer entries than this were ever reached.

pub const OPERATION_TIME: Duration

Wall-clock bound of one dial or address request.

pub fn new( network: Arc<PeerNetwork>, book: Arc<Mutex<PeerBook>>, path: PathBuf, ) -> Self

path is where the book is saved after a round changes it.

pub fn hold_off(&self, peers: Vec<String>) -> Result<(), Error>

Peers inventory sync is holding off (evicted, idle or blamed): neither seed passes nor candidate dials reconnect them until they leave this set.

pub fn step(&self, engine: &Engine, stop: &AtomicBool) -> Result<(), Error>

One bounded round: merge peers learned through identify, refresh the served gossip snapshot, seeds when due, up to two dials while below target, every thirtieth round one address request.

pub fn status(&self) -> Result<DiscoveryStatus, Error>

pub fn penalize(&self, peers: &[PeerId]) -> Result<(), Error>

Peers the inventory scheduler caught misbehaving back off in the book too, so discovery stops dialing them; the book is saved if it changed.

pub fn book(&self) -> Result<Vec<BookEntry>, Error>