Enum OnionRouteError 

pub enum OnionRouteError {
    RouteHasNoHops,
    EmptyRouteService,
    HopCountOutOfBounds {
        hop_count: usize,
        max_hops: u8,
    },
    NotEnoughRelays {
        hop_count: usize,
    },
    NoPermittedFirstHop,
    NoLiveExit {
        service: String,
    },
    NoExitWithTransport {
        service: String,
        transport: OnionExitTransport,
    },
    NoExitForProxyProtocol {
        service: String,
        protocol: String,
    },
    NoExitAllowsTarget {
        service: String,
        target: String,
    },
    DuplicateRouteHops,
    ExitHopMismatch,
    ExitServiceMismatch,
    PayloadServiceMismatch {
        payload_service: String,
        route_service: String,
    },
    MissingNextHop,
    CircuitPathLengthMismatch {
        hop_count: usize,
        edge_count: usize,
    },
    CellPayloadTooLarge,
    InvalidCell,
    ReturnEdgeConflict,
    RelayTableFull,
    RelayPeerTableFull,
    BackwardSignerMismatch,
    BackwardAccountKeyMismatch,
    BackwardSessionKeyMismatch,
    InvalidBackwardSignature,
    ForwardReplay,
    ForwardPayloadExpired,
    BackwardReplay,
    SequenceExhausted,
    BackwardReturnIdMismatch,
    UnexpectedBackwardPayload,
    CircuitIdAllocationFailed,
    LinkSendCancelled,
    TcpOpenResponseClosed,
    TcpOpenTimedOut,
    UnknownTcpStream,
    TcpStreamClosed,
    TcpStreamBackpressure,
    DuplicateTcpOpen,
    UnexpectedTcpReturnPeer {
        expected: Did,
        actual: Did,
    },
    UnexpectedTcpForwardPeer {
        expected: Did,
        actual: Did,
    },
    ExitFailure(OnionExitFailure),
}

Local route/circuit failure before any user-facing rendering.

Variants

RouteHasNoHops

A route or circuit was unexpectedly empty.

EmptyRouteService

The requested route service is empty after normalization.

HopCountOutOfBounds

The requested or constructed hop count is outside the circuit bound.

Fields

hop_count: usize

Requested or constructed hop count.

max_hops: u8

Maximum hop count accepted by this circuit implementation.

NotEnoughRelays

Route construction could not select enough relay hops.

Fields

hop_count: usize

Requested hop count including the exit.

NoPermittedFirstHop

Route construction could not select a first hop accepted by the caller.

NoLiveExit

No live exit descriptor offers the requested service.

Fields

service: String

Requested service name.

NoExitWithTransport

Live exits advertise the service name but none use the required transport.

Fields

service: String

Requested service name.

transport: OnionExitTransport

Required transport class.

NoExitForProxyProtocol

Live exits advertise the service transport, but none can serve the requested proxy protocol.

Fields

service: String

Requested service name.

protocol: String

Requested proxy protocol label.

NoExitAllowsTarget

Live exits advertise the service and transport, but no policy allows the target.

Fields

service: String

Requested service name.

target: String

Requested target authority.

DuplicateRouteHops

Route construction found duplicate DIDs.

ExitHopMismatch

The selected exit descriptor does not match the final encrypted hop.

ExitServiceMismatch

The selected exit does not offer the route service.

PayloadServiceMismatch

A payload service does not match its route service.

Fields

payload_service: String

Service label authenticated in the payload.

route_service: String

Service label selected by the route.

MissingNextHop

A relay layer references a missing next hop.

CircuitPathLengthMismatch

A constructed circuit path does not have exactly one edge id per hop.

Fields

hop_count: usize

Number of encrypted hops in the route.

edge_count: usize

Number of edge ids carried by the circuit path.

CellPayloadTooLarge

A message cannot fit in the largest supported encrypted cell class.

InvalidCell

A decrypted encrypted cell has an invalid length or internal framing.

ReturnEdgeConflict

A live relay return edge already belongs to another previous hop.

RelayTableFull

The relay return table is full.

RelayPeerTableFull

One authenticated previous hop exhausted its share of the relay return table.

BackwardSignerMismatch

A backward payload signer is not the selected exit DID.

BackwardAccountKeyMismatch

A backward payload signer account key is not the selected exit key.

BackwardSessionKeyMismatch

A backward payload session key is not the selected exit session key.

InvalidBackwardSignature

A backward payload signature or freshness proof is invalid.

ForwardReplay

A forward nonce has already authorized an exit-side action.

ForwardPayloadExpired

A forward payload reached the exit after its authenticated expiry.

BackwardReplay

A backward sequence number has already delivered a client-side action.

SequenceExhausted

A circuit direction exhausted its monotonic sequence space.

BackwardReturnIdMismatch

A backward payload carries a return id that does not belong to the local client state.

UnexpectedBackwardPayload

A backward payload decoded to a shape that no client adapter may accept.

CircuitIdAllocationFailed

The runtime could not allocate a unique circuit id.

LinkSendCancelled

A queued endpoint cell lost its drain task before the overlay reported a result.

TcpOpenResponseClosed

A TCP open response channel closed before an answer.

TcpOpenTimedOut

A TCP open request timed out before the exit answered.

UnknownTcpStream

A TCP stream key is unknown to this runtime.

TcpStreamClosed

A TCP stream channel has already closed.

TcpStreamBackpressure

A TCP stream’s bounded inbound queue cannot accept another frame.

DuplicateTcpOpen

A duplicate TCP open targeted a live circuit.

UnexpectedTcpReturnPeer

A received TCP return peer differs from the selected route peer.

Fields

expected: Did

Return peer selected by the client route.

actual: Did

Peer that delivered the backward payload.

UnexpectedTcpForwardPeer

A received TCP forward peer differs from the selected route peer.

Fields

expected: Did

Forward peer recorded when the exit accepted the circuit.

actual: Did

Peer that delivered the forward payload.

ExitFailure(OnionExitFailure)

An exit-reported failure reached the local route client.

Trait Implementations

impl Clone for OnionRouteError

fn clone(&self) -> OnionRouteError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OnionRouteError

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

Formats the value using the given formatter.

impl Display for OnionRouteError

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

Formats the value using the given formatter.

impl Eq for OnionRouteError

impl PartialEq for OnionRouteError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for OnionRouteError