Enum E2eeError 

pub enum E2eeError {
    InvalidSignature,
    NonContributoryDh,
    Aead,
    Padding,
    TooManySkipped,
    CounterOverflow,
    NoChain,
    FingerprintChanged {
        previous: Fingerprint,
        current: Fingerprint,
    },
    WrongState,
    Fragmentation,
    Internal,
}

Everything that can go wrong here: a doomed handshake, a ratchet that refuses to advance, or a caller asking the state machine for a transition it does not allow.

Variants

InvalidSignature

A signature the protocol requires did not verify.

NonContributoryDh

A Diffie-Hellman output was non-contributory: a small-order or otherwise degenerate public key, which HKDF would otherwise turn into a predictable key.

Aead

An AEAD operation failed: on decrypt, a tampered, misrouted, or out-of-session ciphertext; on encrypt, only ever a coding error in this module.

Padding

A decrypted plaintext’s padding was not well-formed ISO/IEC 7816-4 padding.

TooManySkipped

A message implied a skip-ahead of more than MAX_SKIP messages in one jump.

CounterOverflow

A message counter would overflow u32, which cannot happen in a real conversation and therefore signals a malicious or corrupted counter.

NoChain

There is no established sending or receiving chain to use yet.

FingerprintChanged

The peer’s fingerprint changed since it was first pinned. The caller must call Session::confirm_fingerprint_change before the same operation can succeed.

Fields

previous: Fingerprint

The fingerprint pinned from an earlier conversation.

current: Fingerprint

The fingerprint just observed.

WrongState

The session is not in a state that allows this operation, such as decrypting content before the handshake’s ack has been received and decrypted.

Fragmentation

A frag set could not be reassembled: a mismatched id/n, a duplicate or out-of-range index, or a missing piece.

Internal

An underlying primitive rejected an input this module always constructs to be valid (an HMAC key length, an HKDF output length). Never expected to occur in practice.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Error

impl Debug for Error

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Error

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Error

impl PartialEq for Error

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Error

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Error