Enum VoxError 

#[repr(u8)]
pub enum VoxError<E = Infallible> {
    User(E),
    UnknownMethod,
    InvalidPayload(String),
    Cancelled,
    ConnectionClosed,
    SessionShutdown,
    SendFailed,
    Indeterminate,
}

Protocol-level error wrapper distinguishing application errors from vox infrastructure errors.

On the caller side, all return types are wrapped as Result<T, VoxError<E>>:

• Infallible fn foo() -> T becomes Result<T, VoxError>
• Fallible fn foo() -> Result<T, E> becomes Result<T, VoxError<E>>

Variants

User(E)

The handler ran and returned an application error.

UnknownMethod

No handler recognized the method ID.

InvalidPayload(String)

The arguments could not be deserialized.

Cancelled

The call was cancelled before completion (e.g. handler dropped without replying).

ConnectionClosed

The underlying connection closed while the call was in flight.

SessionShutdown

The session shut down while the call was in flight.

SendFailed

The call could not be sent because the transport is dead.

Indeterminate

The runtime refused to guess after recovery.

Implementations

impl<E> VoxError<E>

pub fn is_retryable(&self) -> bool

Returns true if retrying the same operation on a fresh connection may succeed.

InvalidPayload, UnknownMethod, User, Cancelled, and Indeterminate are permanent failures — retrying them against the same peer will reproduce the same outcome.

Trait Implementations

impl<E: Clone> Clone for VoxError<E>

fn clone(&self) -> VoxError<E>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<E: Debug> Debug for VoxError<E>

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

Formats the value using the given formatter.

impl<E: Display> Display for VoxError<E>

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

Formats the value using the given formatter.

impl<E: Debug + Display> Error for VoxError<E>

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<'ʄ, E> Facet<'ʄ> for VoxError<E>

where E: Facet<'ʄ>,

const SHAPE: &'static Shape

The shape of this type, including: whether it’s a Struct, an Enum, something else?