Struct AddressStatus 

pub struct AddressStatus { /* private fields */ }

Address status Contains information about the number of bans and the time until the next ban is lifted.

Implementations

impl AddressStatus

pub fn ban(&mut self, base_ban_period: &Duration)

Ban the Address so it won’t be available through AddressList::get_live_address for some time.

Back-compat shim for AddressStatus::ban_with_reason with no reason.

pub fn ban_with_reason( &mut self, base_ban_period: &Duration, reason: Option<String>, )

Ban the Address and record the reason for the ban.

Applies exponential backoff: the ban window is base × e^ban_count (where ban_count is the value before this call), and banned_until is always re-based to now + window unconditionally, regardless of any existing active ban. Concretely, a health failure on a node that already holds a longer rate-limit window (set via AddressStatus::ban_for) will re-base banned_until to the exponential value, which may be shorter. This is intentional: the exponential health-ban ladder owns the window for genuinely-unhealthy nodes; the no-shorten guarantee is deliberately scoped to ban_for → ban_for sequences only.

ban_count is incremented and ban_reason is updated unconditionally. The counter resets to 0 on AddressStatus::unban.

pub fn ban_for(&mut self, period: Duration, reason: Option<String>)

Ban the address for an exact period (server-advertised), bypassing the exponential ladder used by AddressStatus::ban_with_reason.

The ban window is flat (not exponential). banned_until is advanced to now + period only when that timestamp is later than the current banned_until, so a short-reset call never shortens a longer active ban (health ban or a prior longer rate-limit ban). ban_reason is updated only when the window is extended. ban_count is raised to max(ban_count, 1) unconditionally so that is_banned() and ban_info() correctly report the node as banned. Side-effect: a previously-clean node (ban_count 0) enters the ladder at floor 1, meaning its next genuine health failure via AddressStatus::ban_with_reason uses 60 s × e¹ ≈ 163 s rather than the first-rung 60 s × e⁰ = 60 s. The counter resets to 0 on AddressStatus::unban.

Note: the no-shorten guard applies only to ban_for → ban_for call sequences. AddressStatus::ban_with_reason re-bases banned_until unconditionally — see its docs for the intentional cross-method semantics.

pub fn is_banned(&self) -> bool

Check if Address is banned.

pub fn unban(&mut self)

Clears ban record.

Trait Implementations

impl Clone for AddressStatus

fn clone(&self) -> AddressStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AddressStatus

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

Formats the value using the given formatter.

impl Default for AddressStatus

fn default() -> AddressStatus

Returns the “default value” for a type.