Enum Error 

#[non_exhaustive]
pub enum Error {
    TransportNotAvailable(String),
    PeerNotReachable(String),
    SendFailed(String),
    ReceiveFailed(String),
    ConfigurationError(String),
    SerializationError(String),
    Core(Error),
    MessageTooLarge(usize, usize),
    CryptoError(String),
    Other(String),
}

Errors that can occur in the transport layer.

Display (the #[error(...)] text) is human-facing and free to change. Error::code is the stable, machine-readable contract — downstream telemetry classifies on the code, never on the Display wording.

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.

TransportNotAvailable(String)

Transport is not available or supported.

PeerNotReachable(String)

Recipient is not reachable via this transport. Unlike TransportNotAvailable, the transport itself is healthy – only this specific peer cannot be reached through it.

SendFailed(String)

Failed to send message.

ReceiveFailed(String)

Failed to receive message.

ConfigurationError(String)

Transport configuration error.

SerializationError(String)

Serialization/deserialization error.

Core(Error)

Core error propagated from offline-protocol-core.

MessageTooLarge(usize, usize)

Message exceeds the configured maximum size.

CryptoError(String)

Cryptographic operation failed (key derivation, signing).

Other(String)

Generic error.

Implementations

impl Error

pub fn code(&self) -> &'static str

Returns a stable, non-localized machine-readable error code.

Unlike Display, this value is a contract: downstream consumers (e.g. telemetry classifiers) switch on it instead of substring-matching human-readable error text. Keep these strings stable — changing one reclassifies every event that carries it.

The match is intentionally exhaustive (no wildcard arm) so that adding a new variant fails to compile until it is assigned a code.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl PartialEq for Error

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error