Enum AnvilNodeError

#[non_exhaustive]
#[repr(u32)]
pub enum AnvilNodeError {
    TransactionHalt {
        inner: Box<Halt>,
        transaction_hash: Box<H256>,
    },
    TransactionValidationFailed {
        inner: Box<TransactionValidation>,
        transaction_hash: Box<H256>,
    },
    TransactionGasEstimationFailed {
        inner: Box<GasEstimation>,
        transaction_data: Vec<u8>,
    },
    TimestampBackwardsError {
        timestamp_requested: U64,
        timestamp_now: U64,
    },
    SerializationError {
        transaction_type: String,
        from: Box<H256>,
        to: Box<H256>,
        reason: String,
    },
    GenericError {
        message: String,
    },
}

Domain: AnvilZKsync

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.

TransactionHalt

Summary

Transaction execution reverted and gas was burned.

Description

This error occurs when a transaction execution is reverted due to an error in the anvil-zksync virtual machine execution and all gas is burned. This is a wrapper error that contains a more specific error inside it.

The VM may fail for various reasons including:

• Account validation failures (signature issues, nonce mismatches)
• Paymaster-related errors (when testing account abstraction features)
• Gas limit exceedance
• Storage access limitations
• Contract execution failures

When using anvil-zksync for testing, these failures are valuable signals that help you identify issues with your contracts or transactions before deploying to the real ZKSync network.

Fields

inner: Box<Halt>

transaction_hash: Box<H256>

TransactionValidationFailed

Summary

Transaction validation failed in anvil-zksync.

Description

This error occurs when a transaction validation is failed and it is not executed. This is a wrapper error that contains a more specific validation error inside it, which provides details about the cause of failure.

The validation may fail for various reasons including:

• Gas limit exceedance
• Invalid gas limit value
• maxFeePerGas exceeding maxPriorityFeePerGas, and so on.

When using anvil-zksync for testing, these errors are valuable signals that help you identify issues with your contracts or transactions before deploying to the real ZKSync network.

Fields

inner: Box<TransactionValidation>

transaction_hash: Box<H256>

TransactionGasEstimationFailed

Summary

Transaction gas estimation failed in anvil-zksync.

Description

This error occurs when a gas estimation for transaction failed. This is a wrapper error that contains a more specific gas estimation error inside it, which provides details about the cause of failure.

Fields

inner: Box<GasEstimation>

transaction_data: Vec<u8>

TimestampBackwardsError

Summary

Requested block timestamp is earlier than the current timestamp.

Description

This error occurs when attempting to set a future block timestamp to a value that is earlier than the timestamp of the most recently mined block.

In anvil-zksync, block timestamps must always increase monotonically. This simulates the behavior of real blockchain networks where time only moves forward. Each new block must have a timestamp greater than its predecessor.

Anvil-zksync provides methods to manipulate time for testing purposes (like evm_increaseTime and evm_setNextBlockTimestamp), but these can only move time forward, never backward.

Block timestamps in anvil-zksync are used by:

• Smart contracts that rely on block.timestamp for time-dependent logic
• System contracts that need to track event timing
• Time-locked functionality in DeFi applications and governance protocols

When testing contracts that have time-dependent logic, it’s important to ensure that any manipulated timestamps move forward in time, not backward.

Fields

timestamp_requested: U64

timestamp_now: U64

SerializationError

Summary

Failed to serialize transaction request into a valid transaction.

Description

This error occurs when anvil-zksync is unable to convert a transaction request into a properly formatted transaction object. This typically happens during transaction creation or gas estimation when the request contains invalid or incompatible parameters.

Fields

transaction_type: String

from: Box<H256>

to: Box<H256>

reason: String

GenericError

Fields

message: String

Trait Implementations

impl AsRef<str> for AnvilNode

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for AnvilNode

fn clone(&self) -> AnvilNode

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl CustomErrorMessage for AnvilNode

fn get_message(&self) -> String

impl Debug for AnvilNode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AnvilNode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for AnvilNode

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

Formats the value using the given formatter.

impl Documented for AnvilNode

type Documentation = &'static ErrorDocumentation

fn get_documentation( &self, ) -> Result<Option<Self::Documentation>, DocumentationError>

impl Error for AnvilNode

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<'_enum> From<&'_enum AnvilNode> for AnvilNodeCode

fn from(val: &'_enum AnvilNode) -> AnvilNodeCode

Converts to this type from the input type.

impl From<AnvilNode> for AnvilNodeCode

fn from(val: AnvilNode) -> AnvilNodeCode

Converts to this type from the input type.

impl From<AnvilNode> for AnvilZksync

fn from(val: AnvilNode) -> Self

Converts to this type from the input type.

impl From<AnvilNode> for PackedError<ZksyncError>

fn from(value: AnvilNode) -> Self

Converts to this type from the input type.

impl From<AnvilNode> for SerializedError

fn from(value: AnvilNode) -> Self

Converts to this type from the input type.

impl From<AnvilNode> for ZksyncError

fn from(val: AnvilNode) -> Self

Converts to this type from the input type.

impl From<Error> for AnvilNode

fn from(value: Error) -> Self

Converts to this type from the input type.

impl ICustomError<ZksyncError, ZksyncError> for AnvilNode

fn to_unified(&self) -> ZksyncError

impl NamedError for AnvilNode

fn get_error_name(&self) -> String

impl PartialEq for AnvilNode

fn eq(&self, other: &AnvilNode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AnvilNode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AnvilNode

impl StructuralPartialEq for AnvilNode