Struct HttpConfig 

pub struct HttpConfig {

    pub timeout: Duration,
    pub connect_timeout: Duration,
    pub max_retries: u32,
    pub verbose: bool,
    pub user_agent: String,
    pub return_response_headers: bool,
    pub proxy: Option<ProxyConfig>,
    pub enable_rate_limit: bool,
    pub retry_config: Option<RetryConfig>,
    pub max_response_size: usize,
    pub max_request_size: usize,
    pub circuit_breaker: Option<CircuitBreakerConfig>,
    pub pool_max_idle_per_host: usize,
    pub pool_idle_timeout: Duration,
}

HTTP request configuration

Fields

timeout: Duration

Request timeout

connect_timeout: Duration

TCP connection timeout (default: 10 seconds)

max_retries: u32

👎Deprecated: Use retry_config instead

Maximum retry attempts (deprecated, use retry_config instead)

verbose: bool

Whether to enable verbose logging

user_agent: String

Default User-Agent header value

return_response_headers: bool

Whether to include response headers in the result

proxy: Option<ProxyConfig>

Optional proxy configuration

enable_rate_limit: bool

Whether to enable rate limiting

retry_config: Option<RetryConfig>

Optional retry configuration (uses default if None)

max_response_size: usize

Maximum response body size in bytes (default: 10MB)

Responses exceeding this limit will be rejected with an InvalidRequest error. This protects against malicious or abnormal responses that could exhaust memory.

max_request_size: usize

Maximum request body size in bytes (default: 10MB)

Request bodies exceeding this limit will be rejected BEFORE serialization. This protects against DoS attacks via oversized request payloads.

circuit_breaker: Option<CircuitBreakerConfig>

Optional circuit breaker configuration.

When enabled, the circuit breaker will track request failures and automatically block requests to failing endpoints, allowing the system to recover.

Default: None (disabled for backward compatibility)

pool_max_idle_per_host: usize

Maximum number of idle connections per host in the connection pool.

This controls how many keep-alive connections are maintained for each host. Higher values improve performance for repeated requests to the same host but consume more resources.

Default: 10

pool_idle_timeout: Duration

Timeout for idle connections in the pool.

Connections that have been idle longer than this duration will be closed. This helps free up resources and avoid stale connections.

Default: 90 seconds

Implementations

impl HttpConfig

pub fn validate(&self) -> Result<ValidationResult, ConfigValidationError>

Validates the HTTP configuration parameters.

Returns

Returns Ok(ValidationResult) if the configuration is valid. The ValidationResult may contain warnings for suboptimal but valid configurations.

Returns Err(ConfigValidationError) if the configuration is invalid.

Validation Rules

• timeout > 5 minutes returns an error (excessive timeout)
• timeout < 1 second generates a warning (may cause frequent timeouts)

Example

use ccxt_core::http_client::HttpConfig;
use std::time::Duration;

let config = HttpConfig::default();
let result = config.validate();
assert!(result.is_ok());

let invalid_config = HttpConfig {
    timeout: Duration::from_secs(600), // 10 minutes - too long
    ..Default::default()
};
let result = invalid_config.validate();
assert!(result.is_err());

Trait Implementations

impl Clone for HttpConfig

fn clone(&self) -> HttpConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HttpConfig

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

Formats the value using the given formatter.

impl Default for HttpConfig

fn default() -> HttpConfig

Returns the “default value” for a type.