Enum NetworkError 

#[non_exhaustive]
pub enum NetworkError {
    RequestFailed {
        status: u16,
        message: String,
    },
    Timeout,
    ConnectionFailed(String),
    DnsResolution(String),
    Ssl(String),
    Transport(Box<dyn StdError + Send + Sync + 'static>),
}

Encapsulated network errors hiding implementation details.

This type wraps all network-related errors without exposing third-party library types (like reqwest::Error) in the public API. This ensures API stability even when underlying HTTP libraries change.

Retryable Errors

The following variants are considered retryable:

• NetworkError::Timeout - Request timed out, may succeed on retry
• NetworkError::ConnectionFailed - Connection failed, may be transient

Example

use ccxt_core::error::{Error, NetworkError};

fn handle_network_error(err: NetworkError) {
    match &err {
        NetworkError::RequestFailed { status, message } => {
            println!("HTTP {}: {}", status, message);
        }
        NetworkError::Timeout => {
            println!("Request timed out, consider retrying");
        }
        NetworkError::ConnectionFailed(msg) => {
            println!("Connection failed: {}", msg);
        }
        _ => println!("Network error: {}", err),
    }
}

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.

RequestFailed

Request failed with HTTP status code.

Fields

status: u16

HTTP status code

message: String

Error message

Timeout

Request timed out.

ConnectionFailed(String)

Connection failed.

DnsResolution(String)

DNS resolution failed.

Ssl(String)

SSL/TLS error.

Transport(Box<dyn StdError + Send + Sync + 'static>)

Opaque transport error for underlying issues. Uses Box<dyn StdError> to hide implementation details while preserving the source.

Trait Implementations

impl Debug for NetworkError

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

Formats the value using the given formatter.

impl Display for NetworkError

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

Formats the value using the given formatter.

impl Error for NetworkError

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<Error> for NetworkError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<NetworkError> for Error

fn from(e: NetworkError) -> Self

Converts to this type from the input type.