Enum FetchError 

#[non_exhaustive]
pub enum FetchError {
    Rpc(Error),
    InvalidInput(String),
    AccountNotFound(Pubkey),
    AccountDecode(String),
}

Errors produced by I/O-bound fetch functions.

Fetch-layer code (anything in crate::fetch::* or crate::token::account_state) returns this. Wraps the underlying solana-client errors via anyhow so the plan layer never sees them.

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.

Rpc(Error)

An underlying RPC call failed.

InvalidInput(String)

Caller-supplied fetch input or the target resource is not valid for this operation (for example, an unsupported pool type).

AccountNotFound(Pubkey)

get_account / get_multiple_accounts returned None for an address we expected to exist.

AccountDecode(String)

Borsh / SPL deserialization of an account’s data field failed.

Trait Implementations

impl Debug for FetchError

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

Formats the value using the given formatter.

impl Display for FetchError

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

Formats the value using the given formatter.

impl Error for FetchError

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<Error> for FetchError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FetchError> for OrchestrateError

fn from(source: FetchError) -> Self

Converts to this type from the input type.

impl From<TokenError> for FetchError

Errors produced by orchestrate functions.

Orchestrate-layer code (anything in crate::orchestrate::*) returns this. It is the only layer where PlanError, FetchError, and transaction-send errors can meet via ? propagation.

The variants carry an explicit "<layer> layer failed:" prefix in their Display impl rather than using #[error(transparent)]. This trades one redundant word in the error message for the ability to grep "fetch layer" log scans and tell exactly which layer surfaced the failure — which is the entire selling point of having three distinct error types in the first place.

fn from(err: TokenError) -> Self

Converts to this type from the input type.