Struct ArbitrumExtraData 

pub struct ArbitrumExtraData {
    pub unexpected_balance_delta: i128,
    pub user_wasms: HashMap<B256, ActivatedWasm>,
    pub open_wasm_pages: u16,
    pub ever_wasm_pages: u16,
    pub activated_wasms: HashMap<B256, ActivatedWasm>,
    pub recent_wasms: RecentWasms,
    pub arb_tx_filter: bool,
    pub zombie_accounts: HashSet<Address>,
}

Extra per-block state tracked during Arbitrum execution.

In geth this is ArbitrumExtraData on StateDB. In reth it lives alongside the block executor as mutable state.

Fields

unexpected_balance_delta: i128

Net balance change across all accounts (tracks ETH minting/burning).

user_wasms: HashMap<B256, ActivatedWasm>

WASM modules encountered during execution (for recording).

open_wasm_pages: u16

Number of WASM memory pages currently open (Stylus).

ever_wasm_pages: u16

Peak number of WASM memory pages allocated during this tx.

activated_wasms: HashMap<B256, ActivatedWasm>

Newly activated WASM modules during this block.

recent_wasms: RecentWasms

Recently activated WASM modules (LRU).

arb_tx_filter: bool

Whether transaction filtering is active.

zombie_accounts: HashSet<Address>

Zombie accounts: addresses that were self-destructed then touched by a zero-value transfer on pre-Stylus ArbOS (< v30). These must be preserved as empty accounts during finalization to match canonical behavior.

Implementations

impl ArbitrumExtraData

pub fn activate_wasm( &mut self, module_hash: B256, asm: HashMap<String, Vec<u8>>, module: Vec<u8>, ) -> Result<(), String>

Record a WASM activation for the given module hash.

Validates that if the same module hash was already activated in this block, the new activation has the same set of targets. This prevents inconsistent compilations for different architectures within a single block.

pub fn expect_balance_burn(&mut self, amount: u128)

Register a balance burn from SELFDESTRUCT or native token burn.

Adjusts unexpected_balance_delta so that post-block balance verification accounts for the burned amount (adds to delta).

pub fn expect_balance_mint(&mut self, amount: u128)

Register a balance mint from native token minting.

Adjusts unexpected_balance_delta so that post-block balance verification accounts for the minted amount (subtracts from delta).

pub fn unexpected_balance_delta(&self) -> i128

Returns the current unexpected balance delta.

pub fn get_stylus_pages(&self) -> (u16, u16)

Returns (open_pages, ever_pages) for Stylus memory accounting.

pub fn get_stylus_pages_open(&self) -> u16

Returns the current number of open WASM memory pages.

pub fn set_stylus_pages_open(&mut self, pages: u16)

Sets the current number of open WASM memory pages.

pub fn add_stylus_pages(&mut self, new_pages: u16) -> (u16, u16)

Adds WASM pages, saturating at u16::MAX. Returns the previous (open, ever) values.

pub fn add_stylus_pages_ever(&mut self, new_pages: u16)

Adds to the ever-pages high watermark, saturating at u16::MAX.

pub fn reset_stylus_pages(&mut self)

Resets per-transaction Stylus page counters (called at tx start).

pub fn filter_tx(&mut self)

Mark transaction as filtered (will be excluded at commit).

pub fn clear_tx_filter(&mut self)

Clear the transaction filter flag.

pub fn is_tx_filtered(&self) -> bool

Returns whether a transaction is currently filtered.

pub fn create_zombie(&mut self, addr: Address)

On pre-Stylus ArbOS (< v30), a zero-value transfer touching a self-destructed address creates a “zombie” empty account that must survive finalization. Call this when the condition is met.

pub fn is_zombie(&self, addr: &Address) -> bool

Returns whether the address is a zombie that should be preserved.

pub fn start_recording(&mut self)

Begin recording WASM modules for block validation.

pub fn record_program(&mut self, module_hash: B256, wasm: ActivatedWasm)

Record a WASM module’s compiled ASM for persistence.

Trait Implementations

impl Clone for ArbitrumExtraData

fn clone(&self) -> ArbitrumExtraData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArbitrumExtraData

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

Formats the value using the given formatter.

impl Default for ArbitrumExtraData

fn default() -> ArbitrumExtraData

Returns the “default value” for a type.