Enum Error 

pub enum Error {
    InvalidSignature,
    UnknownKey,
    UnknownAlg,
    InvalidPrior,
    TimestampPast,
    TimestampFuture,
    KeyRevoked,
    MalformedPayload,
    DuplicateKey,
    ThresholdNotMet,
    RecoveryNotDesignated,
    AccountRecoverable,
    UnrecoverablePrincipal,
    StateMismatch,
    ChainBroken,
    HashAlgMismatch,
    EmptyMultihash,
    UnauthorizedAction,
    NoActiveKeys,
    UnsupportedAlgorithm(String),
    EmptyCommit,
    CommitNotLast,
    MissingCommit,
    CommitMismatch,
    TransitoryStateReference,
    MalformedDigest(&'static str),
    DigestLengthMismatch {
        alg: HashAlg,
        expected: usize,
        actual: usize,
    },
    Coz(Error),
}

Cyphr error type covering all error conditions from SPEC §17.

Variants

InvalidSignature

Signature does not verify against claimed key.

UnknownKey

Referenced key (tmb or id) not in current KS.

UnknownAlg

Client doesn’t know or support the algorithm.

InvalidPrior

pre does not match current AS.

TimestampPast

now < latest known PS timestamp.

TimestampFuture

now > server time + tolerance.

KeyRevoked

Signing key has rvk ≤ now.

MalformedPayload

Missing required fields for coz type.

DuplicateKey

key/create for key already in KS.

ThresholdNotMet

Signing keys do not meet required weight (Level 5+).

RecoveryNotDesignated

Agent not registered via recovery/designate.

AccountRecoverable

Recovery attempted while regular keys are active.

UnrecoverablePrincipal

No active keys AND no designated recovery agents.

StateMismatch

Computed PS does not match claimed PS.

ChainBroken

pre references do not form valid chain to known state.

HashAlgMismatch

Multihash variant computed with wrong algorithm.

EmptyMultihash

MultihashDigest contains no variants (internal invariant violation).

UnauthorizedAction

Action typ not permitted for this key (Level 5+).

NoActiveKeys

No active keys remain in principal.

UnsupportedAlgorithm(String)

Algorithm not supported.

EmptyCommit

Attempted to finalize an empty commit (no cozies).

CommitNotLast

commit field appears on a non-terminal coz in the commit array.

Per SPEC §4.4, commit MUST only appear on the last coz.

MissingCommit

Terminal coz is missing the required commit field.

Per SPEC §4.4, the last coz MUST include "commit":<CS>.

CommitMismatch

commit field value does not match independently computed CS.

Per SPEC §4.4, the commit value must equal MR(AS, DS?).

TransitoryStateReference

External reference to transitory (unfinalized) state root.

Per SPEC §4.2.1, transitory state during a pending commit cannot be referenced by external cozies until the commit is finalized.

MalformedDigest(&'static str)

Malformed tagged digest string (missing separator, invalid base64).

DigestLengthMismatch

Digest length does not match the algorithm’s expected output size.

Fields

alg: HashAlg

The hash algorithm specified in the tagged digest.

expected: usize

Expected digest length in bytes for this algorithm.

actual: usize

Actual digest length in bytes received.

Coz(Error)

Underlying Coz error.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.