Enum WormError 

#[non_exhaustive]
pub enum WormError {
    Archive(String),
    MissingChainStamp,
    MalformedChainRecord(String),
    UnsupportedChainRecordVersion {
        found: Option<String>,
    },
    Codec(String),
    MissingDigest {
        key: String,
    },
    MissingVersionId {
        key: String,
    },
    DeleteRefused {
        key: String,
    },
    ReadRefused,
    SigningKey(String),
}

A failure in the WORM archive layer.

The variants split into four groups: a broken or absent chain stamp, a manifest that does not encode or decode, a refusal that the archive policy demands, and an inability to reach the archive at all.

That last group is deliberately its own variant rather than a codec error. A verifier must be able to tell “I looked and the archive is broken” from “I could not look”, because only the first is evidence of tampering. The grading in krabka-worm-verify rests on that distinction.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Archive(String)

The archive could not be listed or read. Says nothing about the archive’s integrity — only that the store did not answer.

MissingChainStamp

The broker did not stamp a chain position on the segment metadata before the copy. A WORM backend refuses to write an unchained manifest.

MalformedChainRecord(String)

The chain record on the segment metadata is not decodable.

UnsupportedChainRecordVersion

The chain record has no "version", or one this build does not read. A record without one was written before krabka 1.0.

Fields

found: Option<String>

The "version" the record carries, as JSON text, or None when it has none.

Codec(String)

The manifest does not encode to, or decode from, its JSON form.

MissingDigest

An object reached the manifest with no SHA-256 digest recorded for it.

Fields

key: String

Object-store key of the object with no digest.

MissingVersionId

A multipart WORM write completed without a version id to pin.

Fields

key: String

Object-store key whose completed version could not be identified.

DeleteRefused

A delete was attempted against a write-once archive.

Fields

key: String

Object-store key the caller asked to delete.

ReadRefused

A remote fetch was attempted against a write-only archive.

SigningKey(String)

The configured signing key is missing, unreadable, or not a valid PKCS#8 Ed25519 key.

Trait Implementations

impl Debug for WormError

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

Formats the value using the given formatter.

impl Display for WormError

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

Formats the value using the given formatter.

impl Error for WormError

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<WormError> for RemoteStorageError

fn from(source: WormError) -> Self

Converts to this type from the input type.