Enum CoreError 

pub enum CoreError {
    InvalidHeaderLength(usize),
    InvalidMagic,
    UnsupportedVersion(u8),
    UnsupportedProfile(u8),
    UnknownFlags(u8),
    CiphertextLengthMismatch {
        expected: usize,
        actual: usize,
    },
    Aead,
    Hkdf,
    InvalidKeyLength,
    UnexpectedKeyId {
        expected: u8,
        actual: u8,
    },
    InvalidControlMessage,
    UnexpectedControlMessage,
    InvalidSessionState,
    MissingSessionSecret,
    InvalidTlv,
    TlvTooLarge,
    Replay,
    ReplayWindowExceeded,
    FrameTooLarge,
    UnexpectedEof,
    Io(Error),
    InvalidSharedSecret,
    SequenceExhausted,
    KeyIdExhausted,
    MissingPeerAuthentication,
    InvalidPeerAuthentication,
    PeerIdentityMismatch,
}

Core protocol error type.

Variants

InvalidHeaderLength(usize)

Frame header length is not FRAME_HEADER_LEN.

InvalidMagic

Frame magic is invalid.

UnsupportedVersion(u8)

Protocol version is unsupported.

UnsupportedProfile(u8)

Crypto profile is unsupported.

UnknownFlags(u8)

Header flags contain unknown bits.

CiphertextLengthMismatch

Header ciphertext length does not match payload length.

Fields

expected: usize

Declared ciphertext length from frame header.

actual: usize

Actual ciphertext length found in frame body.

Aead

AEAD operation failed.

Hkdf

HKDF expansion failed.

InvalidKeyLength

Symmetric key length is invalid.

UnexpectedKeyId

Received key ID does not match expected one.

Fields

expected: u8

Locally expected active key id.

actual: u8

Key id found in the incoming frame.

InvalidControlMessage

Control payload is malformed.

UnexpectedControlMessage

Control payload is not valid for current protocol state.

InvalidSessionState

Session operation was called in an invalid state.

MissingSessionSecret

Session/shared secret is not available.

InvalidTlv

TLV payload is malformed.

TlvTooLarge

TLV payload exceeds configured limits.

Replay

Replay check detected a duplicate frame.

ReplayWindowExceeded

Frame sequence is outside replay window.

FrameTooLarge

Frame exceeds configured size limits.

UnexpectedEof

Unexpected EOF while reading/writing frame bytes.

Io(Error)

Underlying I/O error.

InvalidSharedSecret

X25519 produced a forbidden all-zero shared secret.

SequenceExhausted

Outbound sequence space is exhausted and must not wrap.

KeyIdExhausted

Rekey key identifier space is exhausted and must not wrap.

MissingPeerAuthentication

Peer authentication was required but not present.

InvalidPeerAuthentication

Peer authentication failed validation.

PeerIdentityMismatch

Peer identity did not match the pinned expectation.

Trait Implementations

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 From<CoreError> for Error

fn from(value: CoreError) -> Self

Converts to this type from the input type.

impl From<Error> for CoreError

fn from(source: Error) -> Self

Converts to this type from the input type.