Enum GatewayError 

pub enum GatewayError {
    Config(String),
    Storage(String),
    HttpClient(Error),
    Serialization(String),
    Io(Error),
    Auth(String),
    Provider(ProviderError),
    RateLimit {
        message: String,
        retry_after: Option<u64>,
        rpm_limit: Option<u32>,
        tpm_limit: Option<u32>,
    },
    Validation(String),
    Timeout(String),
    NotFound(String),
    Conflict(String),
    BadRequest(String),
    Internal(String),
    Unavailable(String),
    Network(String),
    Forbidden(String),
    NotImplemented(String),
}

Main error type for the Gateway

Consolidated from ~36 variants to 15 semantic categories. Each variant maps to a distinct HTTP status code or error class.

Variants

Config(String)

Configuration errors

Storage(String)

Storage errors (database, cache, Redis, vector DB, S3)

HttpClient(Error)

HTTP client errors

Serialization(String)

Serialization/deserialization errors (JSON, YAML, etc.)

Io(Error)

IO errors (file system, local file storage)

Auth(String)

Authentication and cryptographic errors (auth, JWT, crypto)

Provider(ProviderError)

Provider errors

RateLimit

Rate limiting errors with structured metadata

Fields

message: String

retry_after: Option<u64>

rpm_limit: Option<u32>

tpm_limit: Option<u32>

Validation(String)

Validation and parsing errors

Timeout(String)

Timeout errors

NotFound(String)

Not found errors

Conflict(String)

Conflict errors

BadRequest(String)

Bad request errors

Internal(String)

Internal server errors

Unavailable(String)

Service unavailable (provider unavailable, circuit breaker, no healthy providers)

Network(String)

Network errors (connectivity, external services, WebSocket)

Forbidden(String)

Forbidden errors

NotImplemented(String)

Not implemented errors

Implementations

impl GatewayError

Helper functions for creating specific errors

pub fn auth<S: Into<String>>(message: S) -> Self

pub fn authorization<S: Into<String>>(message: S) -> Self

pub fn bad_request<S: Into<String>>(message: S) -> Self

pub fn not_found<S: Into<String>>(message: S) -> Self

pub fn conflict<S: Into<String>>(message: S) -> Self

pub fn internal<S: Into<String>>(message: S) -> Self

pub fn validation<S: Into<String>>(message: S) -> Self

pub fn rate_limit<S: Into<String>>(message: S) -> Self

pub fn timeout<S: Into<String>>(message: S) -> Self

pub fn service_unavailable<S: Into<String>>(message: S) -> Self

pub fn server<S: Into<String>>(message: S) -> Self

pub fn network<S: Into<String>>(message: S) -> Self

pub fn external_service<S: Into<String>>(message: S) -> Self

pub fn invalid_request<S: Into<String>>(message: S) -> Self

pub fn parsing<S: Into<String>>(message: S) -> Self

pub fn alert<S: Into<String>>(message: S) -> Self

pub fn not_implemented<S: Into<String>>(message: S) -> Self

pub fn unauthorized<S: Into<String>>(message: S) -> Self

pub fn forbidden<S: Into<String>>(message: S) -> Self

pub fn external<S: Into<String>>(message: S) -> Self

pub fn invalid_request_error<S: Into<String>>(message: S) -> Self

pub fn no_providers_available<S: Into<String>>(message: S) -> Self

pub fn provider_not_found<S: Into<String>>(message: S) -> Self

pub fn no_providers_for_model<S: Into<String>>(message: S) -> Self

pub fn no_healthy_providers<S: Into<String>>(message: S) -> Self

impl GatewayError

pub fn api_error<S: Into<String>>( _status_code: u16, message: S, _provider: S, ) -> Self

pub fn unavailable<S: Into<String>>(message: S) -> Self

Trait Implementations

impl CanonicalError for GatewayError

fn canonical_code(&self) -> ErrorCode

fn canonical_retryable(&self) -> bool

impl Debug for GatewayError

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

Formats the value using the given formatter.

impl Display for GatewayError

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

Formats the value using the given formatter.

impl Error for GatewayError

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<A2AError> for GatewayError

fn from(err: A2AError) -> Self

Converts to this type from the input type.

impl From<DbErr> for GatewayError

Available on crate feature storage only.

fn from(err: DbErr) -> Self

Converts to this type from the input type.

impl From<Error> for GatewayError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GatewayError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GatewayError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GatewayError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GatewayError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<GatewayError> for AsyncBatchError

fn from(err: GatewayError) -> Self

Converts to this type from the input type.

impl From<GatewayError> for SDKError

Error

fn from(error: GatewayError) -> Self

Converts to this type from the input type.

impl From<McpError> for GatewayError

fn from(err: McpError) -> Self

Converts to this type from the input type.

impl From<ProviderError> for GatewayError

fn from(err: ProviderError) -> Self

Converts to this type from the input type.

impl From<RedisError> for GatewayError

Available on crate feature redis only.

fn from(err: RedisError) -> Self

Converts to this type from the input type.

impl ResponseError for GatewayError

fn error_response(&self) -> HttpResponse

Creates full response for error.

fn status_code(&self) -> StatusCode

Returns appropriate status code for error.