Enum TransportError 

#[non_exhaustive]
pub enum TransportError {
    Transport {
        class: TransportErrorClass,
        detail: Redacted<String>,
    },
    Configuration {
        message: Redacted<String>,
    },
    HttpStatus {
        status: u16,
        headers: Vec<(String, Redacted<String>)>,
        body: Redacted<String>,
    },
}

Production HTTP transport seam and its typed surfaces.

HttpTransport is the async injection point downstream clients consume; TransportResponse is its success envelope (2xx status, redacted headers, body); TransportError is its typed failure surface, and TransportErrorClass is the label telemetry and retry layers use to partition REST-transport failures without parsing error messages. The native default implementation is ReqwestTransport; the browser default lives in cow-sdk-core (transport::fetch). Typed error surface returned by every HttpTransport implementation.

Transport adapters funnel every failure into this enum so downstream telemetry, retry, and backoff layers observe a uniform classification without parsing free-form error strings. The Transport variant pairs a TransportErrorClass tag with a redacted detail string; the Configuration variant captures builder-time or input-validation failures that happen before a network request is dispatched; the HttpStatus variant captures a non-2xx response so the orderbook and subgraph layers receive the numeric status, response headers, and body together without rebuilding them from free-form error strings.

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.

Transport

Network or request-execution failure observed by the transport layer.

Fields

class: TransportErrorClass

Categorical failure mode taken from the documented is_timeout, is_connect, is_redirect, is_decode, is_body, is_builder, is_request, is_status, fallthrough partition.

detail: Redacted<String>

Redacted detail message with any URL stripped by the adapter before the wrap.

Configuration

Builder-time or input-validation failure that prevented a request from being dispatched.

Fields

message: Redacted<String>

Human-readable configuration-validation message.

HttpStatus

Non-2xx HTTP response returned by the remote endpoint.

Adapters surface the numeric status code and the raw response body together with the response headers through this variant so downstream orchestration can classify the outcome without re-reading the transport’s rendered error text.

Fields

status: u16

Numeric HTTP status code returned by the remote endpoint.

headers: Vec<(String, Redacted<String>)>

Response headers returned alongside the non-success status code.

body: Redacted<String>

Raw response body returned alongside the status code.

Implementations

impl TransportError

pub const fn class(&self) -> Option<TransportErrorClass>

Returns the TransportErrorClass for Transport variants and None for configuration and HTTP-status failures.

Trait Implementations

impl Debug for TransportError

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

Formats the value using the given formatter.

impl Display for TransportError

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

Formats the value using the given formatter.

impl Error for TransportError

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.