Enum ClobError 

#[non_exhaustive]
pub enum ClobError {
    Api(ApiError),
    Crypto(String),
    Alloy(String),
    InvalidTickSize(ParseTickSizeError),
    FakUnmatched {
        message: String,
    },
    FokUnfilled {
        message: String,
    },
}

Error types for CLOB API operations.

#[non_exhaustive]: downstream matches must carry a wildcard arm. Polymarket keeps introducing outcomes that are only distinguishable by prose (see ClobError::FakUnmatched), so this enum will keep growing, and each new variant should be a minor bump rather than a breaking one.

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.

Api(ApiError)

Core API error

Crypto(String)

Cryptographic operation failed

Alloy(String)

Alloy (Ethereum library) error

InvalidTickSize(ParseTickSizeError)

Invalid tick size

FakUnmatched

A Fill-And-Kill order was killed because nothing on the book matched it.

This is FAK’s defined outcome, not a fault: the order was accepted, evaluated against the book, found no counterparty, and was killed exactly as its time-in-force specifies. It is reported as an error only because Polymarket returns it as HTTP 400, in the same bucket as malformed payloads and banned addresses.

It is deterministic — resubmitting the identical order cannot change the answer — so ClobError::is_retriable returns false for it.

message carries the venue’s prose verbatim for logging. Match on the variant, not on the text.

Fields

message: String

FokUnfilled

A Fill-Or-Kill order was killed because it could not be filled in full.

The FOK counterpart of ClobError::FakUnmatched, and equally a defined outcome rather than a fault. Reached by crate::Clob::place_market_order, which defaults to crate::OrderKind::Fok.

Fields

message: String

Implementations

impl ClobError

pub fn is_retriable(&self) -> bool

Whether re-sending the same request could plausibly produce a different result.

Delegates to ApiError::is_retriable for transport and HTTP failures. The FAK/FOK kill outcomes and all local signing/encoding failures are deterministic and return false.

let killed = ClobError::FakUnmatched { message: "no orders found to match".into() };
assert!(!killed.is_retriable());

Trait Implementations

impl Debug for ClobError

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

Formats the value using the given formatter.

impl Display for ClobError

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

Formats the value using the given formatter.

impl Error for ClobError

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<ApiError> for ClobError

fn from(source: ApiError) -> Self

Converts to this type from the input type.

impl From<Error> for ClobError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ClobError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ClobError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<FromHexError> for ClobError

fn from(err: FromHexError) -> Self

Converts to this type from the input type.

impl From<ParseError> for ClobError

fn from(err: ParseError) -> Self

Converts to this type from the input type.

impl From<ParseTickSizeError> for ClobError

fn from(source: ParseTickSizeError) -> Self

Converts to this type from the input type.