Enum StoreError 

pub enum StoreError {
    Engine(String),
    ValueCodec(String),
    KeyDecode(String),
    Cold,
    Crypto(String),
    CollectionNotFound(String),
    ReservedName(String),
    SchemaTooNew {
        found: u32,
        supported: u32,
    },
    Schema(String),
}

Variants

Engine(String)

A failure originating in the underlying storage engine (redb I/O, a transaction/commit failure, a poisoned in-memory lock). The string is the engine’s own message, preserved for diagnostics.

ValueCodec(String)

A value failed to (de)serialize through the postcard codec. A decode failure here means stored bytes don’t match the caller’s value type — either a schema mismatch or corruption.

KeyDecode(String)

A key failed to decode from its order-preserving byte encoding. Indicates a malformed key on disk or a key/type mismatch at a Table<K, V> callsite.

Cold

The vault is locked, so no key material is available for the AEAD value boundary. Surfaced from crate::crypto::CryptoError::Cold; callers treat it as “unlock required”, not data loss.

Crypto(String)

An AEAD operation failed — corrupt ciphertext, a wrong key, or a row/DEK presented at the wrong location (AAD mismatch). Carries the underlying crate::crypto::CryptoError message.

CollectionNotFound(String)

A collection was opened that has no DEK wrapping yet (use the create-or-open path to provision one).

ReservedName(String)

A collection name collides with a reserved table (the _-prefixed names the store uses internally, e.g. _dek_wrappings, _meta).

SchemaTooNew

The on-disk store format is newer than this software supports. The store refuses to open rather than risk misreading a future format — the “never silently open a newer format” rule.

Fields

found: u32

supported: u32

Schema(String)

A schema/migration problem — e.g. an older store with no registered migration to bring it to the current format version.

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

fn from(e: CryptoError) -> Self

Converts to this type from the input type.