Enum DecryptionFailureCode 

pub enum DecryptionFailureCode {
    InvalidPayload,
    NotInitialized,
    InvalidCiphertext,
    IdentityMismatch,
    CryptoFailure,
    PendingQueueDropped,
    Unknown,
}

Machine-readable reason taxonomy for inbound decryption failures.

Variants

InvalidPayload

Incoming encrypted payload is malformed and cannot be parsed.

NotInitialized

MLS subsystem is not initialized locally.

InvalidCiphertext

Ciphertext is invalid or cannot be decrypted.

IdentityMismatch

Sender identity/signature verification failed.

CryptoFailure

Cryptographic operation failed.

PendingQueueDropped

An encrypted message — a text frame or a media chunk — was evicted from the pending-decryption queue (overflow or TTL expiry, or it aged out of the persisted queue across restarts) before the sender’s session became ready. For a media chunk the file transfer it belongs to is currently stalled; for a text message the message itself is gone locally.

Under the deferred-ACK model this is advisory, not terminal: the evicted frame was never ACKed, so a sender still retrying resends it and a later resend re-enters the queue and can still complete once the session confirms. Treat this as “at risk, may need a resend”, not “permanently failed” — the terminal failure signal for media is FileReceiveFailed. It is emitted for text as well as for chunks: a relay that pushes ciphertext without store-and-forward has no second copy, so a silent text eviction was a lost message with no signal to the app. The same is true of a hard decrypt failure while crypto_recovery_enabled, which surfaces under its own code but is equally un-ACKed and equally recoverable by a resend; see the MessageDecryptionFailed docs.

Unknown

Failure class is unknown.

Trait Implementations

impl Clone for DecryptionFailureCode

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DecryptionFailureCode

impl Debug for DecryptionFailureCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DecryptionFailureCode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for DecryptionFailureCode

impl PartialEq for DecryptionFailureCode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for DecryptionFailureCode

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 DecryptionFailureCode