Enum ProxyError 

#[non_exhaustive]
pub enum ProxyError {
    PoolExhausted,
    AllProxiesUnhealthy,
    InvalidProxyUrl {
        url: String,
        reason: String,
    },
    HealthCheckFailed {
        proxy: String,
        message: String,
    },
    CircuitOpen {
        proxy: String,
    },
    StorageError(String),
    ConfigError(String),
    FetchFailed {
        origin: String,
        message: String,
    },
    NoCompatibleProxy,
    CoherenceMismatch {
        field: MismatchField,
        severity: MismatchSeverity,
    },
    InvalidGeoMetadata {
        field: String,
        reason: String,
    },
}

Errors that can occur within the stygian-proxy library.

Examples

use stygian_proxy::error::{ProxyError, ProxyResult};

fn example() -> ProxyResult<()> {
    Err(ProxyError::PoolExhausted)
}

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.

PoolExhausted

The proxy pool has no available proxies to hand out.

AllProxiesUnhealthy

Every proxy in the pool is currently unhealthy or has an open circuit.

InvalidProxyUrl

A supplied proxy URL failed validation.

Fields

url: String

The URL that was rejected.

reason: String

Human-readable explanation of the validation failure.

HealthCheckFailed

A health check request for a proxy failed.

Fields

proxy: String

Display form of the proxy URL (credentials redacted).

message: String

Description of the underlying error.

CircuitOpen

The circuit breaker for this proxy is open — calls are being rejected fast.

Fields

proxy: String

Display form of the proxy URL (credentials redacted).

StorageError(String)

An error from the underlying storage layer.

ConfigError(String)

A configuration error.

FetchFailed

A remote proxy list could not be fetched or parsed.

Fields

origin: String

URL or identifier of the remote source.

message: String

Human-readable description of the failure.

NoCompatibleProxy

No proxy in the pool satisfies the requested capability set.

CoherenceMismatch

Coherence validator emitted a hard mismatch on a field registered for hard-fail behaviour in crate::ports::coherence::CoherencePolicy.

Only emitted by [crate::manager::ProxyManager::acquire_proxy_with_coherence] when the coherence-validation cargo feature is enabled and the configured policy lists the offending field as a hard-fail vector.

Fields

field: MismatchField

Which vector disagreed (proxy geo vs DNS, WebRTC /16, …).

severity: MismatchSeverity

Severity classification from the validator.

InvalidGeoMetadata

A supplied geo-metadata field on crate::types::ProxyCapabilities failed ingest-time validation.

Emitted by the storage adapter’s add path (and by crate::manager::ProxyManager::add_proxy_with_metadata) when asn, city, or postal_code is malformed. Examples: asn = 0, asn = u32::MAX (both reserved), city = "", postal_code = "", or any field exceeding the documented length ceiling.

Fields

field: String

Which geo field was rejected ("asn", "city", or "postal_code").

reason: String

Human-readable explanation of the validation failure.

Trait Implementations

impl Debug for ProxyError

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

Formats the value using the given formatter.

impl Display for ProxyError

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

Formats the value using the given formatter.

impl Error for ProxyError

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.