Enum PeerError 

pub enum PeerError {
    Unknown {
        peer: PeerId,
    },
    Delegation {
        peer: PeerId,
        source: Box<DelegationError>,
    },
    WrongAudience {
        peer: PeerId,
        held_for: PeerId,
    },
    NoSubject {
        peer: PeerId,
    },
    NoPlaneCredential {
        peer: PeerId,
    },
    NotGranted {
        peer: PeerId,
        capability: String,
    },
    Unreachable {
        peer: PeerId,
        detail: String,
    },
    Refused {
        peer: PeerId,
        detail: String,
    },
    TimedOut {
        peer: PeerId,
        detail: String,
    },
    InDoubt {
        peer: PeerId,
        detail: String,
    },
    InvalidResponse {
        peer: PeerId,
        detail: String,
    },
    Failed {
        peer: PeerId,
        detail: String,
    },
}

Why a peer call could not be made, or did not work.

Variants

Unknown

This peer is not in the registry.

Fields

peer: PeerId

Delegation

The hop would hand the peer authority the caller does not hold, or would take the request too far from the human who authorised it.

Fields

peer: PeerId

source: Box<DelegationError>

Boxed: the refusal names both links’ bounds, and every peer call’s Result would otherwise carry that width on its happy path.

WrongAudience

The credential on hand is for someone else.

Fields

peer: PeerId

held_for: PeerId

NoSubject

The peer is told who each call is for, and this run acts for nobody.

Refused rather than sent with the credential held for the peer: that credential names nobody, and presenting it for a run with no chain is the ambient authority a subject-bound peer was wired to rule out.

Fields

peer: PeerId

NoPlaneCredential

A run admitted as the plane called a subject-bound peer, and the grant holds no credential of the plane’s own for it.

Fields

peer: PeerId

NotGranted

The capability asked for is outside what this peer is granted.

The peer would refuse it at admission — the chain it receives permits only the grant’s scope — but a call that cannot succeed should not leave: it costs a round trip, lands in the peer’s journal as a refused admission, and reads to the operator as the peer declining rather than as this plane never having granted it.

Fields

peer: PeerId

capability: String

Unreachable

The call never left.

Fields

peer: PeerId

detail: String

Refused

The peer received it and declined without acting.

Fields

peer: PeerId

detail: String

TimedOut

Sent, and no answer came within the deadline.

Only for actual timeouts. Everything else that leaves the outcome unknown — an answered fault, an unreadable response, a connection that died mid-flight — is InDoubt, because “did not answer in time” is a false diagnosis of a peer that answered HTTP 500 promptly, and a false diagnosis is what an operator debugs first.

Fields

peer: PeerId

detail: String

InDoubt

The request may have reached the peer, and the outcome is unknown.

The in-doubt bucket stated honestly: an HTTP 5xx, a JSON-RPC internal error, a response that could not be read, a request that failed mid-flight. Each says the peer may have acted; none says it was slow.

Fields

peer: PeerId

detail: String

InvalidResponse

Sent, but the peer’s response did not conform to the negotiated protocol.

The request may already have caused work, so this is in doubt rather than a clean refusal.

Fields

peer: PeerId

detail: String

Failed

The peer acted and reported failure.

Fields

peer: PeerId

detail: String

Implementations

impl PeerError

pub const fn disposition(&self) -> Disposition

What this failure says about whether the request reached the peer.

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)>

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.