Enum CacheError 

pub enum CacheError {
    Io(Error),
    PathNotFound(String),
    Signing(String),
    NotImplemented(&'static str),
    NarInfo(String),
    TooLarge {
        limit: u64,
        at_least: u64,
    },
    SchemaMissing(String),
}

CacheError is now sui_castore::StoreError (same variants, same derives). This type alias preserves every existing sui_cache::CacheError use site. Error type for content-addressed store operations.

Variants

Io(Error)

An I/O operation failed.

PathNotFound(String)

A store path was not found on the local filesystem.

Signing(String)

A signing or verification operation failed.

NotImplemented(&'static str)

A feature is not yet implemented (missing Cargo feature flag).

NarInfo(String)

A narinfo could not be parsed or was invalid UTF-8.

TooLarge

A value exceeded a tier’s configured byte cap and was refused rather than buffered.

This is a bound, not a failure of the cache: the refusing tier is always a best-effort hot tier, and the durable tiers below it stream the same content without a cap. Refusing is the whole point — a tier that buffers whatever it is handed is exactly how a 6 GiB pod is killed by one large NAR.

at_least is a lower bound, not the true size: collection stops the moment the cap is crossed, so the rest of the value is never read.

Fields

limit: u64

The tier’s configured cap, in bytes.

at_least: u64

A lower bound on the value’s size, in bytes.

SchemaMissing(String)

The backend’s schema is absent — its tables do not exist (e.g. a durable tier came back up on a fresh volume, or its database was dropped/recreated under a live connection pool).

Kept as its own variant, distinct from Io, precisely because it is self-healable: the owning backend’s DDL is idempotent (CREATE TABLE IF NOT EXISTS), so a consumer that sees this can re-run it and retry rather than failing the request. A backend that cannot re-create its own schema must return Io instead — never round a permanent failure up into a healable one.

Trait Implementations

impl Debug for StoreError

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

Formats the value using the given formatter.

impl Display for StoreError

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

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

fn from(source: Error) -> StoreError

Converts to this type from the input type.