Enum WiseGateError 

pub enum WiseGateError {
    InvalidIp(String),
    ConfigError(String),
    ProxyError(String),
    RateLimitExceeded(String),
    IpBlocked(String),
    PatternBlocked(String),
    MethodBlocked(String),
    AuthenticationRequired,
    InvalidCredentials,
    UpstreamConnectionFailed(String),
    UpstreamTimeout(String),
    BodyTooLarge {
        size: usize,
        max: usize,
    },
    BodyReadError(String),
    HttpClientError(Error),
    InvalidHeader(String),
}

Unified error type for WiseGate operations.

This enum covers all error cases that can occur during request processing, configuration, and proxying operations.

Example

use wisegate_core::error::{WiseGateError, Result};

fn validate_ip(ip: &str) -> Result<()> {
    if ip.is_empty() {
        return Err(WiseGateError::InvalidIp("IP address cannot be empty".into()));
    }
    Ok(())
}

Variants

InvalidIp(String)

Invalid IP address format or value.

ConfigError(String)

Configuration error (missing or invalid values).

ProxyError(String)

Error during request proxying.

RateLimitExceeded(String)

Rate limit exceeded for a client.

IpBlocked(String)

Request blocked by IP filter.

PatternBlocked(String)

Request blocked by URL pattern filter.

MethodBlocked(String)

Request blocked by HTTP method filter.

AuthenticationRequired

Authentication required but not provided.

InvalidCredentials

Invalid authentication credentials.

UpstreamConnectionFailed(String)

Upstream connection failed.

UpstreamTimeout(String)

Upstream request timed out.

BodyTooLarge

Request body too large.

Fields

size: usize

Actual body size in bytes.

max: usize

Maximum allowed size in bytes.

BodyReadError(String)

Failed to read request or response body.

HttpClientError(Error)

HTTP client error (from reqwest).

InvalidHeader(String)

Invalid HTTP header value.

Implementations

impl WiseGateError

pub fn status_code(&self) -> StatusCode

Returns the appropriate HTTP status code for this error.

Returns

The HTTP status code that should be returned to the client.

pub fn user_message(&self) -> &str

Returns a user-friendly error message suitable for HTTP responses.

This method returns a sanitized message that doesn’t expose internal details to clients.

pub fn is_server_error(&self) -> bool

Returns true if this error should be logged at error level.

Some errors (like rate limiting) are expected and should only be logged at debug/info level.

Trait Implementations

impl Debug for WiseGateError

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

Formats the value using the given formatter.

impl Display for WiseGateError

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

Formats the value using the given formatter.

impl Error for WiseGateError

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 WiseGateError

fn from(source: Error) -> Self

Converts to this type from the input type.