Enum StoreError 

pub enum StoreError {
    Decode {
        key: RecordKey,
        reason: String,
    },
    CodecOpen {
        key: RecordKey,
    },
    UnknownRecordLayout {
        key: RecordKey,
    },
}

Every error Store::load or a mutation can return. All three variants name the offending RecordKey — nothing here fails silently or points only at “a record”, ever.

Variants

Decode

The record’s own bytes (after a successful RecordCodec::open) don’t match what this key’s kind expects — non-UTF-8 bytes where a sync token string was expected, JSON that doesn’t parse as an [OutgoingRequest], and so on.

Fields

key: RecordKey

The record whose plaintext failed to decode.

reason: String

What about it was wrong.

CodecOpen

RecordCodec::open rejected a record’s sealed bytes outright — wrong key, corrupted bytes, or (for the real AES-GCM codec a later piece adds) an authentication failure.

Fields

key: RecordKey

The record the codec refused to open.

UnknownRecordLayout

The key’s kind segment (e.g. "olm_session") is recognized, but the rest of the key does not match that kind’s expected shape. Distinct from a genuinely unrecognized kind, which Store::load keeps verbatim rather than treating as an error — see the module doc’s “Forward compatibility” section.

Fields

key: RecordKey

The malformed record’s key.

Trait Implementations

impl Debug for StoreError

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

Formats the value using the given formatter.

impl Display for StoreError

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

Formats the value using the given formatter.

impl Error for StoreError

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<StoreError> for GroupDecryptError

fn from(source: StoreError) -> Self

Converts to this type from the input type.

impl From<StoreError> for OlmDecryptError

fn from(source: StoreError) -> Self

Converts to this type from the input type.

impl From<StoreError> for MessengerError

fn from(source: StoreError) -> Self

Converts to this type from the input type.