Enum StorageError 

pub enum StorageError {
    WriteError,
    Io(Error),
    UnexpectedEof,
    CorruptedRecord,
    TornWrite {
        reason: String,
    },
    InvalidRecordKind {
        byte: u8,
        offset: Offset,
    },
    ChainVerificationFailed {
        offset: Offset,
        expected: Option<ChainHash>,
        actual: Option<ChainHash>,
    },
    InvalidCheckpointPayload {
        offset: Offset,
        reason: String,
    },
    InvalidIndexMagic,
    UnsupportedIndexVersion(u8),
    IndexChecksumMismatch {
        expected: u32,
        actual: u32,
    },
    IndexTruncated {
        expected: usize,
        actual: usize,
    },
    CompressionFailed {
        codec: &'static str,
        reason: String,
    },
    DecompressionFailed {
        codec: &'static str,
        reason: String,
    },
    InvalidCompressionKind {
        byte: u8,
        offset: Offset,
    },
}

Errors that can occur during storage operations.

Variants

WriteError

Generic write error.

Io(Error)

Filesystem I/O error.

UnexpectedEof

The data was truncated (not enough bytes).

CorruptedRecord

CRC mismatch - the record data is corrupted.

TornWrite

Torn write detected - record was incompletely written (AUDIT-2026-03 M-8).

This occurs when power loss or crash happens during a write operation, leaving a record with missing or corrupted sentinel markers.

Fields

reason: String

InvalidRecordKind

Invalid record kind byte.

Fields

byte: u8

offset: Offset

ChainVerificationFailed

Hash chain verification failed.

Fields

offset: Offset

expected: Option<ChainHash>

actual: Option<ChainHash>

InvalidCheckpointPayload

Checkpoint payload is malformed.

Fields

offset: Offset

reason: String

InvalidIndexMagic

Index file has invalid magic bytes

UnsupportedIndexVersion(u8)

Index file has unsupported version

IndexChecksumMismatch

Index file checksum mismatch

Fields

expected: u32

actual: u32

IndexTruncated

Index file is truncated

Fields

expected: usize

actual: usize

CompressionFailed

Compression failed.

Fields

codec: &'static str

reason: String

DecompressionFailed

Decompression failed.

Fields

codec: &'static str

reason: String

InvalidCompressionKind

Invalid compression kind byte.

Fields

byte: u8

offset: Offset

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

fn from(source: Error) -> Self

Converts to this type from the input type.