Enum SDKError 

#[non_exhaustive]
pub enum SDKError {
    InvalidNetwork,
    InvalidPrivateKey(String),
    JsonSerializeError(Error),
    HttpError(Error),
    ApiError(Box<ApiErrorResponse>),
    RequestError(String),
    MissingKeypair,
    StringParseError(FromUtf8Error),
    ChainIdCastError(TryFromIntError),
    InvalidNetworkUrl,
    InvalidSchemaResponse(&'static str),
    InvalidChainHash(String),
    SerializationError(String),
    SystemTimeError,
    InvalidSignatureLength(usize),
    InvalidPublicKeyLength(usize),
    SchemaOutdated,
    UnsupportedCallMessage(String),
    TransactionOutdated,
    WebsocketError(Box<WSErrors>),
}

Errors that can occur when using the Trading SDK.

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.

InvalidNetwork

Invalid network configuration.

InvalidPrivateKey(String)

Invalid private key format or length.

JsonSerializeError(Error)

JSON serialization error.

HttpError(Error)

HTTP client error.

ApiError(Box<ApiErrorResponse>)

Structured API error from the trading API.

Boxed because ApiErrorResponse carries optional details + error_id strings and a nested enum, making the variant large enough to bloat every SDKResult<T> on the stack (clippy::result_large_err). Boxing pushes the cost to error-construction time (negligible — happy paths don’t allocate) and keeps Result types cheap to pass around.

RequestError(String)

Client-side request error (not from the server).

MissingKeypair

No keypair available for signing.

StringParseError(FromUtf8Error)

ChainIdCastError(TryFromIntError)

InvalidNetworkUrl

InvalidSchemaResponse(&'static str)

InvalidChainHash(String)

SerializationError(String)

SystemTimeError

InvalidSignatureLength(usize)

InvalidPublicKeyLength(usize)

SchemaOutdated

UnsupportedCallMessage(String)

TransactionOutdated

WebsocketError(Box<WSErrors>)

Implementations

impl SDKError

pub fn is_retryable(&self) -> bool

Whether this error is potentially transient and the operation could be retried with backoff.

pub fn api_error(&self) -> Option<&ApiErrorResponse>

If this is an API error, returns the structured response.

Trait Implementations

impl Debug for SDKError

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

Formats the value using the given formatter.

impl Display for SDKError

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

Formats the value using the given formatter.

impl Error for SDKError

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<Box<WSErrors>> for SDKError

fn from(source: Box<WSErrors>) -> Self

Converts to this type from the input type.

impl From<Error<ApiErrorResponse>> for SDKError

fn from(err: Error<ApiErrorResponse>) -> Self

Converts to this type from the input type.

impl From<Error> for SDKError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SDKError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for SDKError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<WSErrors> for SDKError

fn from(err: WSErrors) -> Self

Converts to this type from the input type.