Struct PeerBanList 

pub struct PeerBanList { /* private fields */ }

Manages a list of banned peers with temporary and permanent ban support.

Bans are tracked using a logical tick counter rather than wall-clock time, allowing deterministic testing and integration with tick-based event loops.

Implementations

impl PeerBanList

pub fn new(config: BanConfig) -> Self

Create a new PeerBanList with the given configuration.

pub fn ban_temporary( &mut self, peer_id: &str, reason: &str, ttl_ticks: Option<u64>, )

Ban a peer temporarily. Uses default_temp_ttl_ticks when ttl_ticks is None.

If the ban list is at capacity, the ban is silently dropped. If the peer is already banned, the entry is updated (re-banned).

pub fn ban_permanent(&mut self, peer_id: &str, reason: &str)

Ban a peer permanently. The ban will not expire until explicitly removed via unban.

If the ban list is at capacity, the ban is silently dropped. If the peer is already banned, the entry is updated (re-banned).

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

Remove a ban for the given peer. Returns true if the peer was banned.

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

Check whether a peer is currently banned, respecting temporary ban expiry.

A temporary ban is considered expired if current_tick >= expires_tick. Expired entries are lazily removed on access.

pub fn get_ban(&self, peer_id: &str) -> Option<&BanEntry>

Get the ban entry for a peer, if it exists and is still active.

Note: This does not perform lazy expiry cleanup. Use is_banned for an expiry-aware check, or call tick_cleanup periodically.

pub fn tick_cleanup(&mut self)

Advance the current tick by one and remove all expired temporary bans.

pub fn banned_count(&self) -> usize

Return the number of currently active bans (including not-yet-cleaned expired ones).

pub fn list_banned(&self) -> Vec<&BanEntry>

Return references to all current ban entries.

pub fn stats(&self) -> BanListStats

Return aggregate statistics about the ban list.

pub fn current_tick(&self) -> u64

Return the current logical tick.

Trait Implementations

impl Clone for PeerBanList

fn clone(&self) -> PeerBanList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerBanList

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

Formats the value using the given formatter.