Enum CowError 

#[non_exhaustive]
pub enum CowError {
    Types(CoreError),
    Signing(SigningError),
    AppData(AppDataError),
    Contracts(ContractsError),
    Orderbook(OrderbookError),
    Trading(TradingError),
}

Aggregate error type for the root facade crate.

CowError is the convenience aggregate for consumers that ?-propagate every SDK call into one type; each leaf error converts in through #[from]. A consumer with its own error type, or that needs rejection-specific handling, can match the leaf error directly — every leaf exposes the same ErrorClass through class() (and the orderbook and trading errors also expose is_retryable() / backoff_hint()), so the verdict is identical whether a caller holds the facade error or a bare leaf.

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.

Types(CoreError)

Shared types, validation, or configuration error.

Signing(SigningError)

Signing or typed-data error.

AppData(AppDataError)

App-data generation, validation, or CID error.

Contracts(ContractsError)

Contract encoding, hashing, or provider interaction error.

Orderbook(OrderbookError)

Orderbook transport, decoding, or request error.

Trading(TradingError)

Trading workflow, quoting, or submission error.

Implementations

impl CowError

pub const fn class(&self) -> ErrorClass

Returns the coarse-grained class for this error.

The classification is exhaustive: every supported variant resolves to one of the ErrorClass buckets without falling through to a default arm, so downstream telemetry layers can rely on the mapping staying stable across releases.

pub const fn is_retryable(&self) -> bool

Returns true when retrying the same request may succeed.

The orderbook and trading errors carry the HTTP retry classification, so the verdict delegates to their is_retryable() accessors; every other facade variant is never retryable. Pair it with CowError::backoff_hint for the suggested wait before the next attempt.

pub fn backoff_hint(&self) -> Option<Duration>

Returns the server-suggested backoff before the next attempt, when the failing orderbook response carried a Retry-After header.

Delegates to the orderbook and trading errors; returns None for every other facade variant and for responses without a Retry-After header.

Trait Implementations

impl Debug for CowError

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

Formats the value using the given formatter.

impl Display for CowError

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

Formats the value using the given formatter.

impl Error for CowError

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<AppDataError> for CowError

fn from(source: AppDataError) -> Self

Converts to this type from the input type.

impl From<Cancelled> for CowError

fn from(cancelled: Cancelled) -> Self

Converts to this type from the input type.

impl From<ContractsError> for CowError

fn from(source: ContractsError) -> Self

Converts to this type from the input type.

impl From<CoreError> for CowError

fn from(source: CoreError) -> Self

Converts to this type from the input type.

impl From<OrderbookError> for CowError

fn from(source: OrderbookError) -> Self

Converts to this type from the input type.

impl From<SigningError> for CowError

fn from(source: SigningError) -> Self

Converts to this type from the input type.

impl From<TradingError> for CowError

fn from(source: TradingError) -> Self

Converts to this type from the input type.