Enum RelayError 

pub enum RelayError {
    BadHost {
        host: String,
        reason: String,
    },
    Transport {
        host: String,
        reason: String,
    },
    Http {
        host: String,
        status: StatusCode,
        error: String,
    },
    RateLimited {
        host: String,
        retry_after: Option<u64>,
    },
    Malformed {
        host: String,
        reason: String,
    },
    TimedOut {
        host: String,
        after: Duration,
    },
}

Why a relay query failed. Every variant carries host, so a fan-out failure is attributable without the caller threading context back in.

Note the deliberate absence of a field named source: thiserror treats that name as #[source], which requires std::error::Error + 'static — which anyhow::Error (what crate::net::guarded_get_no_privacy returns) does not implement. Transport failures are therefore flattened to a String built with anyhow’s alternate formatter, which preserves the whole context chain in the one place it is consumed: the log line.

Variants

BadHost

The configured host is not a usable http(s) target.

Fields

host: String

The offending configured value.

reason: String

Why it was rejected.

Transport

The request never produced a response (DNS, TLS, connect, SSRF refusal).

Fields

host: String

The relay base URL.

reason: String

The flattened anyhow context chain.

Http

The relay answered with a non-2xx status.

Fields

host: String

The relay base URL.

status: StatusCode

The HTTP status.

error: String

A short snippet of the body (the atproto error envelope, usually).

RateLimited

The relay rate-limited us. Distinct from RelayError::Http because the required behaviour differs: abort the run, log Retry-After, never retry tighter.

retry_after is rendered INTO the Display string rather than only held as a field. The scheduler logs err.to_string(), so a field the message omits is unreachable — the value was parsed, stored, and then silently dropped, leaving the operator with no idea how long to back off and NETWORK-SPEC §4.6 (“warn! with Retry-After if present”) unmet.

Fields

host: String

The relay base URL.

retry_after: Option<u64>

Retry-After in seconds, when the delta-seconds form was sent. None covers both “absent” and “sent as an HTTP-date”, which is deliberately not parsed — see [retry_after_secs].

Malformed

The body was not the expected JSON envelope.

Fields

host: String

The relay base URL.

reason: String

The serde error.

TimedOut

The whole walk against one host blew its deadline.

Fields

host: String

The relay base URL.

after: Duration

The deadline that was exceeded.

Trait Implementations

impl Debug for RelayError

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

Formats the value using the given formatter.

impl Display for RelayError

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

Formats the value using the given formatter.

impl Error for RelayError

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.