Enum SolanaProviderError

pub enum SolanaProviderError {
    NetworkError(String),
    RpcError(String),
    RequestError {
        error: String,
        status_code: u16,
    },
    InvalidAddress(String),
    SelectorError(RpcSelectorError),
    NetworkConfiguration(String),
    InsufficientFunds(String),
    BlockhashNotFound(String),
    InvalidTransaction(String),
    AlreadyProcessed(String),
}

Errors that can occur when interacting with the Solana provider.

Use is_transient() to determine if an error should be retried.

Variants

NetworkError(String)

Network/IO error (transient - connection issues, timeouts)

RpcError(String)

RPC protocol error (transient - RPC-level issues like node lag, sync pending)

RequestError

HTTP request error with status code (transient/permanent based on status code)

Fields

error: String

status_code: u16

InvalidAddress(String)

Invalid address format (permanent)

SelectorError(RpcSelectorError)

RPC selector error (transient - can retry with different node)

NetworkConfiguration(String)

Network configuration error (permanent - missing data, unsupported operations)

InsufficientFunds(String)

Insufficient funds for transaction (permanent)

BlockhashNotFound(String)

Blockhash not found or expired (transient - can rebuild with fresh blockhash)

InvalidTransaction(String)

Invalid transaction structure or execution (permanent)

AlreadyProcessed(String)

Transaction already processed (permanent - duplicate)

Implementations

impl SolanaProviderError

pub fn is_transient(&self) -> bool

Determines if this error is transient (can retry) or permanent (should fail).

With comprehensive error code classification in from_rpc_response_error(), errors are properly categorized at the source, so we can simply match on variants.

Transient (can retry):

• NetworkError: IO/connection errors, timeouts, network unavailable
• RpcError: RPC protocol issues, node lag, sync pending (-32004, -32005, -32014, -32016)
• BlockhashNotFound: Can rebuild transaction with fresh blockhash (-32008)
• SelectorError: Can retry with different RPC node
• RequestError: HTTP errors with retriable status codes (5xx, 408, 425, 429)

Permanent (fail immediately):

• InsufficientFunds: Not enough balance for transaction
• InvalidTransaction: Malformed transaction, invalid signatures, version mismatch (-32002, -32003, -32013, -32015, -32602)
• AlreadyProcessed: Duplicate transaction already on-chain (-32009)
• InvalidAddress: Invalid public key format
• NetworkConfiguration: Missing data, unsupported operations (-32007, -32010)
• RequestError: HTTP errors with non-retriable status codes (4xx except 408, 425, 429)

pub fn from_rpc_error(error: ClientError) -> Self

Classifies a Solana RPC client error into the appropriate error variant.

Uses structured error types from the Solana SDK for precise classification, including JSON-RPC error codes for enhanced accuracy.

Trait Implementations

impl Debug for SolanaProviderError

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

Formats the value using the given formatter.

impl Display for SolanaProviderError

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

Formats the value using the given formatter.

impl Error for SolanaProviderError

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<SolanaProviderError> for ProviderError

fn from(source: SolanaProviderError) -> Self

Converts to this type from the input type.

impl From<SolanaProviderError> for RelayerError

fn from(source: SolanaProviderError) -> Self

Converts to this type from the input type.

impl From<SolanaProviderError> for SolanaRpcError

fn from(source: SolanaProviderError) -> Self

Converts to this type from the input type.

impl From<SolanaProviderError> for SolanaTransactionValidationError

fn from(source: SolanaProviderError) -> Self

Converts to this type from the input type.

impl From<SolanaProviderError> for TransactionError

fn from(source: SolanaProviderError) -> Self

Converts to this type from the input type.

impl From<String> for SolanaProviderError

fn from(s: String) -> Self

Converts to this type from the input type.

impl Serialize for SolanaProviderError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.