Enum ErrorClass 

#[non_exhaustive]
pub enum ErrorClass {
    Validation,
    Transport,
    Remote,
    RateLimited,
    Signing,
    Cancelled,
    Internal,
}

Coarse-grained failure classification, re-exported from cow-sdk-core.

Every public error type the facade aggregates exposes a matching class() accessor, so the classification is consistent whether a caller holds the facade CowError or a bare leaf error. Coarse-grained failure classification shared across the workspace error family.

Every public error type that the cow-sdk facade aggregates exposes a class(&self) -> ErrorClass accessor that resolves to one of these buckets, so downstream telemetry and retry layers can partition failures without pattern-matching every nested variant by hand. ErrorClass::Transport is the retryable class: the failure happened before a complete response arrived, so resending is safe. For ErrorClass::Remote the class alone is insufficient — a structured 4xx rejection is permanent while a 5xx outage is transient — so consult the concrete error’s is_retryable() / backoff_hint() accessors before retrying. The remaining classes signal caller-side or protocol-level conditions that benefit from different recovery paths.

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.

Validation

Caller-side input failed a client-side validation boundary.

Transport

A transport-layer failure occurred before a complete response was received.

Remote

The remote endpoint returned a structured error response.

RateLimited

The remote endpoint signalled rate limiting (HTTP 429) and the transport layer’s retry budget was exhausted before it cleared.

Transport retries already honor Retry-After, so reaching this class means the throttle outlived the retry policy rather than a transient spike the client absorbed.

Signing

A signing, provider, or cryptographic helper surfaced an error.

Cancelled

A long-running operation was cancelled through a cooperative token.

Internal

An internal invariant or helper contract was violated.

Implementations

impl ErrorClass

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

Returns the stable lowercase telemetry label for this class.

The label is a stability contract for telemetry partitioning, mirroring TransportErrorClass::as_str and the adapter class enums. Prefer it over {:?}, whose Debug output is not contractual.

Trait Implementations

impl Clone for ErrorClass

fn clone(&self) -> ErrorClass

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorClass

impl Debug for ErrorClass

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

Formats the value using the given formatter.

impl Display for ErrorClass

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

Formats the value using the given formatter.

impl Eq for ErrorClass

impl Hash for ErrorClass

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 ErrorClass

fn eq(&self, other: &ErrorClass) -> 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 ErrorClass