Enum Error 

#[non_exhaustive]
pub enum Error {
    Graphql {
        query_name: String,
        status: StatusCode,
        messages: String,
        errors: Vec<GraphqlErrorEntry>,
    },
    RateLimited {
        query_name: String,
        retry_after: Option<Duration>,
        limit: Option<u64>,
        remaining: Option<u64>,
        messages: String,
    },
    UnexpectedStatus {
        query_name: String,
        status: StatusCode,
        body: String,
    },
    Connection {
        query_name: String,
        attempts: u32,
        source: Error,
    },
    MissingField {
        query_name: String,
        field: String,
    },
    Decode {
        query_name: String,
        source: Error,
    },
    CurrencyUnderflow(u64, u64),
    InvalidCurrency(String),
}

Errors returned by the Mina Archive SDK.

#[non_exhaustive], so a match needs a _ arm. A new failure mode — a new server error class, a new transport condition — must not be an SDK major release, and adding a variant to an exhaustively matched enum is breaking.

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.

Graphql

The GraphQL endpoint returned one or more errors. Not retried.

Note status is almost always 200: the API answers every GraphQL-level error with HTTP 200 and a populated errors array. extensions.status is a payload field, not the HTTP status.

Fields

query_name: String

status: StatusCode

messages: String

errors: Vec<GraphqlErrorEntry>

RateLimited

The server’s rate limiter rejected the request with HTTP 429.

This is the only non-200 the API emits under normal operation, so unlike most 4xx it unambiguously means “slow down”, and it is the one case where retrying the identical request is correct.

Fields

query_name: String

retry_after: Option<Duration>

From the retry-after header, when the server sends one.

limit: Option<u64>

From x-ratelimit-limit.

remaining: Option<u64>

From x-ratelimit-remaining.

messages: String

UnexpectedStatus

A non-2xx response that is not GraphQL-shaped.

The usual cause is a URL pointing somewhere the server does not serve: the endpoint is the root path /, and /graphql returns 404 with an HTML or plain-text body.

Fields

query_name: String

status: StatusCode

body: String

Connection

Failed to connect after exhausting all retry attempts.

Fields

query_name: String

attempts: u32

source: Error

MissingField

A required field was missing in an otherwise-successful response — most likely a schema mismatch.

Fields

query_name: String

field: String

Decode

Failed to deserialize the response body.

Fields

query_name: String

source: Error

CurrencyUnderflow(u64, u64)

Currency subtraction would underflow.

InvalidCurrency(String)

String could not be parsed as a Mina/nanomina currency value.

Implementations

impl Error

pub fn graphql_codes(&self) -> Vec<&str>

The extensions.code values carried by a Error::Graphql, in order.

Empty for every other variant, and for masked errors, which arrive with no extensions at all — so an empty result means “no code was sent”, never “no error occurred”.

pub fn has_graphql_code(&self, code: &str) -> bool

True when any entry carries the given extensions.code.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.