Enum PublicErrorKind 

pub enum PublicErrorKind {
    Validation,
    IdempotencyKeyReuse,
    AuthorizationDenied,
    ConcurrencyDeadlineExceeded,
    ContractMismatch,
    StorageUnavailable,
    OutcomeUnknown,
    InternalDefect,
    CommandExecutionFailed,
    HistoryIncarnationMismatch,
    HistoryPruned,
    Overloaded,
    FollowerMode,
    PrimaryFenced,
}

The closed set of failures that RiffDB may expose to an untrusted caller.

Variants

Validation

A request failed bounded validation.

IdempotencyKeyReuse

An idempotency identity was reused with different canonical input.

AuthorizationDenied

Authorization denied the operation.

ConcurrencyDeadlineExceeded

Logical conflict acquisition exceeded its deadline, or the fixed v1 command reevaluation budget was exhausted.

ContractMismatch

The requested contract version or plan is not current.

StorageUnavailable

Authoritative storage is temporarily unavailable.

OutcomeUnknown

A submitted command may have completed, but its outcome is not known.

InternalDefect

An internal defect occurred and details were retained only internally.

CommandExecutionFailed

Deterministic evaluation failed before an application commit was formed.

HistoryIncarnationMismatch

Observed history predates a database restore.

HistoryPruned

Requested history was retired by retention prune.

Overloaded

The service is over capacity and rejected admission.

FollowerMode

This node is a follower and cannot execute a write operation.

PrimaryFenced

Durable source fencing permanently refuses new command admission.

Implementations

impl PublicErrorKind

pub const fn code(self) -> &'static str

Returns the stable ASCII identifier exposed by every transport.

pub const fn safe_message(self) -> &'static str

Returns the stable, caller-safe ASCII message for this failure.

pub const fn class(self) -> ErrorClass

Returns the protocol-neutral class for this failure.

pub const fn status_code(self) -> PublicErrorStatusCode

Returns the one authoritative public status code for this kind.

Server encoding and client validation must both use this mapping. Do not re-derive the wire code from Self::class alone: some kinds deliberately diverge (for example, overload keeps class ErrorClass::Unavailable while carrying [PublicErrorStatusCode::ResourceExhausted]).

This match is the sole wire-code authority and must remain exhaustive over every PublicErrorKind variant.

pub const fn recovery_action(self) -> RecoveryAction

Returns safe recovery guidance for this failure.

Trait Implementations

impl Clone for PublicErrorKind

fn clone(&self) -> PublicErrorKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for PublicErrorKind

impl Debug for PublicErrorKind

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

Formats the value using the given formatter.

impl Eq for PublicErrorKind

impl Hash for PublicErrorKind

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PublicErrorKind

fn eq(&self, other: &PublicErrorKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PublicErrorKind