Enum zebra_network::peer::error::PeerError

pub enum PeerError {
    ConnectionClosed,
    ConnectionDropped,
    ClientDropped,
    ConnectionTaskExited,
    ClientCancelledHeartbeatTask,
    HeartbeatTaskExited(String),
    ConnectionSendTimeout,
    ConnectionReceiveTimeout,
    Serialization(SerializationError),
    DuplicateHandshake,
    Overloaded,
    NoReadyPeers,
    InboundTimeout,
    ServiceShutdown,
    NotFoundResponse(Vec<InventoryHash>),
    NotFoundRegistry(Vec<InventoryHash>),
}

An error related to peer connection handling.

Variants

ConnectionClosed

The remote peer closed the connection.

ConnectionDropped

Zebra dropped the Connection.

ClientDropped

Zebra dropped the Client.

ConnectionTaskExited

A Client’s internal connection task exited.

ClientCancelledHeartbeatTask

Zebra’s Client cancelled its heartbeat task.

HeartbeatTaskExited(String)

Zebra’s internal heartbeat task exited.

ConnectionSendTimeout

Sending a message to a remote peer took too long.

ConnectionReceiveTimeout

Receiving a response to a Client request took too long.

Serialization(SerializationError)

A serialization error occurred while reading or writing a message.

DuplicateHandshake

A badly-behaved remote peer sent a handshake message after the handshake was already complete.

Overloaded

This node’s internal services were overloaded, so the connection was dropped to shed load.

NoReadyPeers

There are no ready remote peers.

InboundTimeout

This peer request’s caused an internal service timeout, so the connection was dropped to shed load or prevent attacks.

ServiceShutdown

This node’s internal services are no longer able to service requests.

NotFoundResponse(Vec<InventoryHash>)

We requested data, but the peer replied with a notfound message. (Or it didn’t respond before the request finished.)

This error happens when the peer doesn’t have any of the requested data, so that the original request can be retried.

This is a temporary error.

Zebra can try different peers if the request is retried, or peers can download and verify the missing data.

If the peer has some of the data, the request returns an Ok response, with any notfound data is marked as Missing.

NotFoundRegistry(Vec<InventoryHash>)

We requested data, but all our ready peers are marked as recently Missing that data in our local inventory registry.

This is a temporary error.

Peers with the inventory can finish their requests and become ready, or other peers can download and verify the missing data.

Correctness

This error is produced using Zebra’s local inventory registry, without contacting any peers.

Client responses containing this error must not be used to update the inventory registry. This makes sure that we eventually expire our local cache of missing inventory, and send requests to peers again.

Implementations

impl PeerError

pub fn kind(&self) -> Cow<'static, str>

Returns the Zebra internal handler type as a string.

Trait Implementations

impl Debug for PeerError

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

Formats the value using the given formatter.

impl Display for PeerError

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

Formats the value using the given formatter.

impl Error for PeerError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports.

impl From<SerializationError> for PeerError

fn from(source: SerializationError) -> Self

Converts to this type from the input type.