Skip to main content

Module common

Module common 

Source
Expand description

Shared building blocks: RPC provider/session, state, env, error, output formatting, tracing, transaction utilities.

Structs§

AccountState
Account state information
BlockEnvArgs
Block environment configuration arguments
BuildProviderOutput
Return value of the RpcArgs::build_*_provider methods.
ChainArgs
Chain configuration arguments (spec and chain ID)
DecodedRawTx
Result of decoding a raw EIP-2718 transaction.
EnvArgs
Environment configuration arguments (chain config, block env, SALT bucket capacity)
EvmeOutcome
Common execution outcome for all evme commands
EvmeState
State database that can be backed by either EmptyDB or AlloyDB (forked from RPC)
ExecutionSummary
Serializable execution summary for JSON output
ExtEnvArgs
External environment configuration arguments (SALT bucket capacity)
ExternalEnvSnapshot
Snapshot of mega-evm external environment inputs not derivable from RPC.
FixedHardfork
Fixed hardfork configuration for replay
LogArgs
Logging configuration arguments.
OutputArgs
Output format configuration
OverriddenTx
A wrapper that applies overrides when converting to TxEnv.
PreStateArgs
Pre-execution state configuration arguments
RpcArgs
Configuration for building an RPC provider.
RpcCacheStore
Clean-exit cache persistence handle.
StateDumpArgs
State dump configuration arguments
TraceArgs
Trace configuration arguments
TxArgs
Transaction configuration arguments
TxOverrideArgs
Transaction override arguments for the replay command.
TxOverrides
Parsed transaction overrides.

Enums§

EvmeError
Error types for the replay command
TracerType
Tracer type for execution analysis

Constants§

DEFAULT_SENDER
Default sender address (Hardhat account #0).

Functions§

load_hex
Load hex-encoded bytes from an argument or a file. If the file is a dash (-), read from stdin. Priority: arg > file. Returns None if neither is provided.
op_receipt_to_tx_receipt
Convert an OpReceiptEnvelope to an OP transaction receipt.
parse_bucket_capacity
Parse bucket capacity string in format “bucket_id:capacity” Returns (bucket_id, capacity) tuple
parse_ether_value
Parse ether value string into wei (U256). Supports: plain number (wei), or number with suffix (ether, gwei, wei, etc). Examples: “1000000000000000000”, “1ether”, “100gwei”, “1000wei”
print_execution_summary
Print a human-readable execution summary.
print_execution_trace
Print execution trace to console or write to file.
print_receipt
Print a receipt as pretty-printed JSON.

Type Aliases§

EvmeExternalEnvs
External environment type for mega-evme using the real AHash-based SALT bucket hasher.
OpProvider
OP-stack provider type used throughout mega-evme.
OpTxReceipt
OP-stack transaction receipt type alias
Result
Result type for the mega-evme command