Enum PeerAddrState

pub enum PeerAddrState {
    Responded,
    NeverAttemptedGossiped,
    Failed,
    AttemptPending,
}

Peer connection state, based on our interactions with the peer.

Zebra also tracks how recently a peer has sent us messages, and derives peer liveness based on the current time. This derived state is tracked using maybe_connected_peers and reconnection_peers.

Variants

Responded

The peer has sent us a valid message.

Peers remain in this state, even if they stop responding to requests. (Peer liveness is derived from the last_seen timestamp, and the current time.)

NeverAttemptedGossiped

The peer’s address has just been fetched from a DNS seeder, or via peer gossip, or as part of a Version message, or guessed from an inbound remote IP, but we haven’t attempted to connect to it yet.

Failed

The peer’s TCP connection failed, or the peer sent us an unexpected Zcash protocol message, so we failed the connection.

AttemptPending

We just started a connection attempt to this peer.

Implementations

impl PeerAddrState

pub fn is_never_attempted(&self) -> bool

Return true if this state is a “never attempted” state.

fn connection_state_order(&self, other: &Self) -> Ordering

Returns the typical connection state machine order of self and other. Partially ordered states are sorted in connection attempt order.

See MetaAddrChange::apply_to_meta_addr() for more details.

Trait Implementations

impl Arbitrary for PeerAddrState

type Parameters = ()

The type of parameters that arbitrary_with accepts for configuration of the generated Strategy. Parameters must implement Default.

type Strategy = TupleUnion<((u32, Arc<fn() -> PeerAddrState>), (u32, Arc<fn() -> PeerAddrState>), (u32, Arc<fn() -> PeerAddrState>), (u32, Arc<fn() -> PeerAddrState>))>

The type of Strategy used to generate values of type Self.

fn arbitrary_with(_top: Self::Parameters) -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self). The strategy is passed the arguments given in args.

fn arbitrary() -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self).

impl Clone for PeerAddrState

fn clone(&self) -> PeerAddrState

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PeerAddrState

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

Formats the value using the given formatter.

impl Ord for PeerAddrState

fn cmp(&self, other: &Self) -> Ordering

PeerAddrStates are sorted in approximate reconnection attempt order, ignoring liveness.

See CandidateSet and MetaAddr::cmp for more details.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for PeerAddrState

fn eq(&self, other: &PeerAddrState) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for PeerAddrState

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for PeerAddrState

impl Eq for PeerAddrState

impl StructuralPartialEq for PeerAddrState