Struct Peer

pub struct Peer {
    pub addr: PeerAddr,
    pub reputation: i32,
    pub state: PeerConnectionState,
    pub fork_id: Option<ForkId>,
    pub remove_after_disconnect: bool,
    pub kind: PeerKind,
    pub backed_off: bool,
    pub severe_backoff_counter: u8,
}

Tracks info about a single peer.

Fields

addr: PeerAddr

Where to reach the peer.

reputation: i32

Reputation of the peer.

state: PeerConnectionState

The state of the connection, if any.

fork_id: Option<ForkId>

The [ForkId] that the peer announced via discovery.

remove_after_disconnect: bool

Whether the entry should be removed after an existing session was terminated.

kind: PeerKind

The kind of peer

backed_off: bool

Whether the peer is currently backed off.

severe_backoff_counter: u8

Counts number of times the peer was backed off due to a severe BackoffKind.

Implementations

impl Peer

pub fn new(addr: PeerAddr) -> Self

Returns a new peer for given PeerAddr.

pub fn trusted(addr: PeerAddr) -> Self

Returns a new trusted peer for given PeerAddr.

pub const fn reputation(&self) -> i32

Returns the reputation of the peer

pub fn with_state(addr: PeerAddr, state: PeerConnectionState) -> Self

Returns a new peer for given PeerAddr and PeerConnectionState.

pub fn with_kind(addr: PeerAddr, kind: PeerKind) -> Self

Returns a new peer for given PeerAddr and PeerKind.

pub fn reset_reputation(&mut self) -> ReputationChangeOutcome

Resets the reputation of the peer to the default value. This always returns ReputationChangeOutcome::None.

pub fn apply_reputation(&mut self, reputation: i32) -> ReputationChangeOutcome

Applies a reputation change to the peer and returns what action should be taken.

pub const fn is_banned(&self) -> bool

Returns true if the peer’s reputation is below the banned threshold.

pub const fn is_backed_off(&self) -> bool

Returns true if peer is banned.

pub fn unban(&mut self)

Unbans the peer by resetting its reputation

pub const fn is_trusted(&self) -> bool

Returns whether this peer is trusted

pub const fn is_static(&self) -> bool

Returns whether this peer is static

Trait Implementations

impl Clone for Peer

fn clone(&self) -> Peer

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Peer

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

Formats the value using the given formatter.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 104 bytes