Enum ResponseOutcome 

enum ResponseOutcome {
    Healthy,
    RateLimited {
        retry_after: Option<Duration>,
    },
    RequestRejected,
    Failed,
}

alloy returns a non-2xx response with a parseable JSON-RPC body as Ok, so the payload, not the Result arm, decides whether a provider is healthy.

This is a partial classification, deliberately. It covers only major error flavors the fleet dumps actually captured. Much remains open: handling the most common providers and RPC flavors, block ranges that adapt to what a provider will serve, separating a dead API key from a transient failure, etc.

Unless we’re fixing urgent bugs we should not add to this list until we have a satisfactory design for robust handling of the whole RPC spectrum, because every provider and RPC flavor has its own quirks.

Variants

Healthy

RateLimited

Provider is rate limiting. Back off rather than fail over, up to MAX_CONSECUTIVE_RATE_LIMITS.

Fields

retry_after: Option<Duration>

RequestRejected

The request earned the rejection on its own terms. Scores neither way: every backup rejects the same request identically, so failing over neither helps nor indicates anything about the provider.

Failed

Implementations

impl ResponseOutcome

fn classify( result: &StdResult<ResponsePacket, RpcError<TransportErrorKind>>, ) -> Self

Score a transport response for provider health. A batch is scored by the first error in it; no batch callers exist today.

Trait Implementations

impl Debug for ResponseOutcome

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

Formats the value using the given formatter.