Enum DeriveHttpError 

pub enum DeriveHttpError {
    Transport(String),
    Http {
        status: u16,
        message: String,
        retry_after: Option<Duration>,
    },
    JsonRpc {
        code: i64,
        message: String,
        data: Option<Value>,
        retry_after: Option<Duration>,
    },
    MissingResult {
        method: String,
    },
    Decode(String),
    Serde(Error),
    Retry(RetryError),
    Auth(AuthError),
    MissingCredentials {
        method: String,
    },
}

Errors raised by the Derive HTTP client.

Variants

Transport(String)

Network/transport failure with undefined venue outcome.

Http

HTTP-level failure (non-2xx without a JSON-RPC body, or 2xx without the expected envelope).

Fields

status: u16

HTTP status code.

message: String

Truncated body text or status reason.

retry_after: Option<Duration>

Minimum delay supplied by the response’s Retry-After header.

JsonRpc

JSON-RPC error envelope returned by the venue.

Fields

code: i64

Venue-defined error code.

message: String

Human-readable error message.

data: Option<Value>

Optional structured diagnostic payload.

retry_after: Option<Duration>

Minimum delay supplied by the response’s Retry-After header.

MissingResult

Successful envelope was missing the result field.

Fields

method: String

Method that returned an empty envelope.

Decode(String)

Response body could not be decoded as JSON-RPC.

Serde(Error)

JSON (de)serialization failed for a request or response payload.

Retry(RetryError)

Retry cancellation, timeout, budget, or configuration failure.

Auth(AuthError)

Auth header construction failed (e.g. clock skew, signer error).

MissingCredentials

Private endpoint invoked without credentials configured on the client.

Fields

method: String

Method that requires authentication.

Implementations

impl DeriveHttpError

pub fn transport(msg: impl Into<String>) -> Self

Constructs a DeriveHttpError::Transport error.

pub fn http(status: u16, message: impl Into<String>) -> Self

Constructs a DeriveHttpError::Http error.

pub fn decode(msg: impl Into<String>) -> Self

Constructs a DeriveHttpError::Decode error.

pub const fn retry_after(&self) -> Option<Duration>

Returns the response’s minimum retry delay, when present.

pub fn is_transport_error(&self) -> bool

Returns true for transport errors, including timeouts. This does not prove a request was unsent; callers reconciling order state should treat the outcome as unknown rather than rejected.

Trait Implementations

impl Debug for DeriveHttpError

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

Formats the value using the given formatter.

impl Display for DeriveHttpError

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

Formats the value using the given formatter.

impl Error for DeriveHttpError

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<AuthError> for DeriveHttpError

fn from(source: AuthError) -> Self

Converts to this type from the input type.

impl From<DeriveHttpError> for DeriveError

fn from(source: DeriveHttpError) -> Self

Converts to this type from the input type.

impl From<Error> for DeriveHttpError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<HttpClientError> for DeriveHttpError

fn from(value: HttpClientError) -> Self

Converts to this type from the input type.

impl From<RetryError> for DeriveHttpError

fn from(source: RetryError) -> Self

Converts to this type from the input type.