Enum AptosError 

pub enum AptosError {
    RpcError(String),
    ResourceUsed(String),
    StateProofFailed(String),
    EventProofFailed(String),
    CheckpointFailed(String),
    TransactionFailed(String),
    SerializationError(String),
    ConfirmationTimeout {
        tx_hash: String,
        timeout_ms: u64,
    },
    ReorgDetected {
        version: u64,
    },
    NetworkMismatch {
        expected: u64,
        actual: u64,
    },
    CoreError(AdapterError),
}

Comprehensive error types for the Aptos adapter.

Each variant includes context for debugging and recovery guidance.

Variants

RpcError(String)

Error during RPC communication with Aptos node. Recovery: Retry with backoff, switch to fallback RPC endpoint.

ResourceUsed(String)

Seal resource has already been consumed. Recovery: This is a fatal error for seal replay attempts. Check seal state.

StateProofFailed(String)

State proof verification failed (Merkle proof against accumulator root). Recovery: Re-fetch proof from different RPC endpoint, check for reorg.

EventProofFailed(String)

Event proof verification failed (event emission verification). Recovery: Re-verify transaction, check event index and data.

CheckpointFailed(String)

Checkpoint certification verification failed. Recovery: Check validator signatures, verify epoch boundaries.

TransactionFailed(String)

Transaction submission or execution failed. Recovery: Check transaction simulation error, adjust gas parameters.

SerializationError(String)

Error during serialization/deserialization. Recovery: This is a programming error. Check data format compatibility.

ConfirmationTimeout

Timeout while waiting for transaction confirmation. Recovery: Resubmit transaction with higher gas, check mempool status.

Fields

tx_hash: String

timeout_ms: u64

ReorgDetected

Chain reorg detected affecting anchor validity. Recovery: Re-publish commitment at new chain tip.

Fields

version: u64

NetworkMismatch

Network mismatch (e.g., mainnet seal on testnet). Recovery: Ensure network configuration matches chain ID.

Fields

expected: u64

actual: u64

CoreError(AdapterError)

Core adapter error from csv-adapter-core.

Implementations

impl AptosError

pub fn is_transient(&self) -> bool

Returns true if this error is potentially transient and should be retried.

pub fn timeout(tx_hash: &str, timeout_ms: u64) -> Self

Construct an error for transaction timeout

pub fn reorg(version: u64) -> Self

Construct an error for chain reorg

Trait Implementations

impl Debug for AptosError

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

Formats the value using the given formatter.

impl Display for AptosError

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

Formats the value using the given formatter.

impl Error for AptosError

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<AdapterError> for AptosError

fn from(source: AdapterError) -> Self

Converts to this type from the input type.

impl From<AptosError> for AdapterError

fn from(err: AptosError) -> Self

Converts to this type from the input type.

impl From<Box<dyn Error + Sync + Send>> for AptosError

fn from(err: Box<dyn Error + Send + Sync>) -> Self

Converts to this type from the input type.