Enum GatewayError 

#[non_exhaustive]
pub enum GatewayError {
    Bind(String, Error),
    Server(Error),
    MissingAuthToken,
}

Errors that can be returned by the HTTP gateway.

All variants implement std::error::Error via thiserror.

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.

Bind(String, Error)

The server could not bind to the requested address.

The first field is the address string (e.g. "127.0.0.1:8080") and the second is the underlying I/O error.

Server(Error)

The axum server returned a fatal error after binding succeeded.

This typically indicates a listener failure or an OS-level socket error.

MissingAuthToken

The gateway is enabled but no bearer token was configured (#6487).

POST /webhook forwards its body directly into the agent’s turn loop as if it came from a trusted channel — starting without a token would let any local or network caller that can reach the listener inject arbitrary content. Set [gateway] auth_token (resolved from the age vault key ZEPH_GATEWAY_TOKEN) before starting the gateway.

Trait Implementations

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.