Enum DigPeerError 

#[non_exhaustive]
pub enum DigPeerError {
    Transport(NatError),
    Io(Error),
    Rpc(Box<RpcError>),
    PeerNotSealable,
    NoSealingIdentity,
    Seal(String),
    Misdelivered,
    Codec(String),
    InvalidState(PeerState),
}

A failure of a DigPeer operation.

The variants are grouped by domain (transport / protocol / seal / state / codec) so a caller can distinguish “could not reach the peer” from “the peer refused the request” from “the message could not be sealed to the peer” — each of which warrants a different response.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Transport(NatError)

The transport could not establish (or lost) the connection — every NAT-traversal tier failed, no tier was composable, or the mux/stream I/O broke. Wraps the underlying NatError.

Io(Error)

Stream I/O failed while sending a request or receiving a response (the connection dropped mid-call, or a framed body exceeded the size bound).

Rpc(Box<RpcError>)

The peer answered with a JSON-RPC error envelope. Carries the peer’s canonical RpcError (code + message + origin) verbatim so the caller sees exactly what the peer reported. Boxed so the large error envelope does not bloat every Result on the hot path.

PeerNotSealable

A directed (sealed) RPC was requested but the connection has NO verified peer BLS-G1 key (a legacy/unbound peer, or binding verification was off). Sealing is fail-closed: without a verified recipient key dig-peer refuses to send, rather than fall back to an unsealed send.

NoSealingIdentity

A directed (sealed) RPC was requested but no local sealing identity was configured. Set one with DigPeer::with_sealing_identity before making directed calls.

Seal(String)

The §5.4 seal or open failed — the payload could not be sealed to the peer, or a received response failed authenticated decryption / signature / replay verification. Fail-closed: the call errors rather than surfacing unverified bytes.

Misdelivered

The peer delivered a sealed response that does not correlate with the request that was sent (wrong correlation id) — discarded rather than surfaced (a misdelivery cannot be trusted).

Codec(String)

A response body could not be (de)serialized into the expected typed shape.

InvalidState(PeerState)

The operation is invalid for the connection’s current lifecycle state (e.g. an RPC after disconnect).

Trait Implementations

impl Debug for DigPeerError

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

Formats the value using the given formatter.

impl Display for DigPeerError

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

Formats the value using the given formatter.

impl Error for DigPeerError

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

Returns 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<Error> for DigPeerError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<NatError> for DigPeerError

fn from(source: NatError) -> Self

Converts to this type from the input type.