Enum BlockStoreError 

pub enum BlockStoreError {
    RocksDb(Error),
    Serialization(String),
    Compression(String),
    BlockNotFound(Bytes32),
    CheckpointNotFound(u64),
    BlockNotInStore(Bytes32),
    RollbackBelowMin {
        target: u64,
        min: u64,
    },
    RollbackAboveTip {
        target: u64,
        tip: u64,
    },
    NoTip,
    SchemaMismatch {
        expected: u32,
        found: u32,
    },
    NotInitialized,
    EmptyReorgChain,
    PipelineClosed,
}

Crate-level error for persistence, chain, and I/O boundaries (ERR-001).

Display: Each #[error("…")] attribute is the contract for logs and user-facing text (ERR-003).

Async: All variants are Send + Sync (see err_001_tests static assertions).

Variants

RocksDb(Error)

Wraps an underlying RocksDB error (rocksdb::Error).

#[source]: Preserves the inner error for Error::source() (ERR-001 test plan).

Serialization(String)

Bincode or other structural encode/decode failure (SER-001, SER-002).

Compression(String)

Zstd compress/decompress failure (SER-001).

BlockNotFound(Bytes32)

Requested block hash is not present (BLK-002).

CheckpointNotFound(u64)

No checkpoint row for the given epoch (CKP-002).

BlockNotInStore(Bytes32)

Chain / canonical operation referenced a hash that is not stored (CAN-003).

RollbackBelowMin

Rollback would violate the pruning floor (ROR-001).

Fields

target: u64

min: u64

RollbackAboveTip

Rollback target is above the current tip (ROR-001).

Fields

target: u64

tip: u64

NoTip

Metadata does not contain a tip (CAN-007).

SchemaMismatch

On-disk schema / version mismatch (TYP-002 metadata keys).

Fields

expected: u32

found: u32

NotInitialized

Operation requires genesis / initialized metadata (STR-004, BLK-013).

EmptyReorgChain

apply_reorg called with an empty new chain (ROR-003).

PipelineClosed

Async write pipeline channel is closed (BLK-008).

Implementations

impl BlockStoreError

pub fn compression_from_io(err: Error) -> Self

Maps an std::io::Error produced by zstd compress/decompress helpers (zstd::encode_all, zstd::decode_all, …) into BlockStoreError::Compression.

Rationale (ERR-002): We intentionally do not implement From<std::io::Error> on BlockStoreError. Plain filesystem I/O (for example create_dir_all) is surfaced as Serialization today (ERR-001 interim mapping); a blanket From<io::Error> would make those sites ambiguous or route the wrong variant. Callers that know the io::Error came from zstd should use this helper with Result::map_err or a closure.

Trait Implementations

impl Debug for BlockStoreError

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

Formats the value using the given formatter.

impl Display for BlockStoreError

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

Formats the value using the given formatter.

impl Error for BlockStoreError

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<Box<ErrorKind>> for BlockStoreError

fn from(err: Error) -> Self

Bincode encode/decode failures map one-to-one onto BlockStoreError::Serialization (ERR-002).

Note: std::io::Error is not covered here — use BlockStoreError::compression_from_io for zstd I/O.

impl From<Error> for BlockStoreError

fn from(source: Error) -> Self

Converts to this type from the input type.