Enum CoreError 

#[non_exhaustive]
pub enum CoreError {
    NetworkError(String),
    SerializationError(String),
    Busy,
    ConfigError(String),
    CryptoError(String),
    ValidationError(String),
    RuntimeError(String),
    KeyDerivationError,
    RngError(String),
    InternalError(String),
    HandshakeError(String),
    StreamError(String),
    SessionNotFound(String),
    ConnectionClosed,
    Timeout,
    ReplayDetected(String),
    CipherSuiteUnavailable(String),
}

Universal Core Error Enum compatible with FFI exports

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.

NetworkError(String)

SerializationError(String)

Busy

ConfigError(String)

CryptoError(String)

ValidationError(String)

RuntimeError(String)

KeyDerivationError

RngError(String)

InternalError(String)

HandshakeError(String)

StreamError(String)

SessionNotFound(String)

ConnectionClosed

Timeout

ReplayDetected(String)

Sliding-window replay protection rejected a packet. The AEAD layer already cryptographically prevents replay (strict-counter nonces), but the explicit window catches duplicates earlier and gives operators a metric signal (replay_rejected_total).

CipherSuiteUnavailable(String)

A requested cipher suite is not available in the current build. Emitted under --features fips when a caller asks for a non-FIPS-approved primitive (today: ChaCha20-Poly1305). The variant is always compiled so error matching stays stable across feature configurations.

Trait Implementations

impl<UT> ConvertError<UT> for CoreError

fn try_convert_unexpected_callback_error( e: UnexpectedUniFFICallbackError, ) -> Result<Self>

impl Debug for CoreError

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

Formats the value using the given formatter.

impl Display for CoreError

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

Formats the value using the given formatter.

impl Error for CoreError

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<UT> FfiConverter<UT> for CoreError

const TYPE_ID_META: MetadataBuffer

Type ID metadata, serialized into a MetadataBuffer.

type FfiType = RustBuffer

The low-level type used for passing values of this type over the FFI.

fn lower(v: Self) -> RustBuffer

Lower a rust value of the target type, into an FFI value of type Self::FfiType.

fn try_lift(buf: RustBuffer) -> Result<Self>

Lift a rust value of the target type, from an FFI value of type Self::FfiType.

fn write(obj: Self, buf: &mut Vec<u8>)

Write a rust value into a buffer, to send over the FFI in serialized form.

fn try_read(buf: &mut &[u8]) -> Result<Self>

Read a rust value from a buffer, received over the FFI in serialized form.

impl From<Error> for CoreError

Available on crate feature std only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CoreError

Available on crate feature std only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CoreError

Available on crate feature std only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<HandshakeError> for CoreError

fn from(err: HandshakeError) -> Self

Converts to this type from the input type.

impl<UT> Lift<UT> for CoreError

type FfiType = <CoreError as FfiConverter<UT>>::FfiType

fn try_lift(v: Self::FfiType) -> Result<Self>

fn try_read(buf: &mut &[u8]) -> Result<Self>

fn try_lift_from_rust_buffer(v: RustBuffer) -> Result<Self, Error>

Convenience method

impl<UT> LiftRef<UT> for CoreError

type LiftType = CoreError

impl<UT> LiftReturn<UT> for CoreError

type ReturnType = <CoreError as Lift<UT>>::FfiType

FFI return type for trait interfaces

fn try_lift_successful_return(v: Self::ReturnType) -> Result<Self>

Lift a successfully returned value from a trait interface

fn lift_foreign_return( ffi_return: Self::ReturnType, call_status: RustCallStatus, ) -> Self

Lift a foreign returned value from a trait interface

fn lift_error(_buf: RustBuffer) -> Self

Lift a Rust value for a callback interface method error result

fn handle_callback_unexpected_error(e: UnexpectedUniFFICallbackError) -> Self

Lift a Rust value for an unexpected callback interface error

impl<UT> Lower<UT> for CoreError

type FfiType = <CoreError as FfiConverter<UT>>::FfiType

fn lower(obj: Self) -> Self::FfiType

fn write(obj: Self, buf: &mut Vec<u8>)

fn lower_into_rust_buffer(obj: Self) -> RustBuffer

Convenience method

impl<UT> LowerError<UT> for CoreError

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for CoreError

type ReturnType = <CoreError as Lower<UT>>::FfiType

The type that should be returned by scaffolding functions for this type.

fn lower_return(v: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl<UT> TypeId<UT> for CoreError

const TYPE_ID_META: MetadataBuffer