Enum StorageError 

pub enum StorageError {
    BackendNoListSupport {
        tier: String,
    },
    CodecMismatch {
        expected: String,
        found: String,
    },
    Codec(CodecError),
    BackendError {
        message: String,
        source: Option<Box<dyn Error + Send + Sync + 'static>>,
    },
}

Tier-level preconditions surfaced by BaseStorageTier operations.

Variants

BackendNoListSupport

Caller invoked list_by_prefix on a backend that has no enumeration support. Lazy-thrown on first stream-yield, not at attach.

Fields

tier: String

CodecMismatch

Mixed codecs detected within a single WAL — replay refuses to proceed because frame deserialization would silently corrupt downstream state.

Fields

expected: String

found: String

Codec(CodecError)

Codec encode / decode failed (typed values that don’t round-trip through serde_json, version-mismatch decode, etc.).

BackendError

Wraps an underlying backend I/O failure (file system, redb transaction, network round-trip). The source chain preserves the original error.

Fields

message: String

source: Option<Box<dyn Error + Send + Sync + 'static>>

Trait Implementations

impl Debug for StorageError

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

Formats the value using the given formatter.

impl Display for StorageError

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

Formats the value using the given formatter.

impl Error for StorageError

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<ChecksumError> for StorageError

Convenience: wal_frame_checksum / verify_wal_frame_checksum failures bubble through ? at the tier-flush boundary without explicit mapping. ChecksumError::CanonicalJsonFailed was a serde_json::Error at root, which is a codec-encode failure — funnel through the Codec variant.

fn from(e: ChecksumError) -> Self

Converts to this type from the input type.

impl From<CodecError> for StorageError

fn from(source: CodecError) -> Self

Converts to this type from the input type.