Struct ArbPrecompileCtx 

pub struct ArbPrecompileCtx {
    pub block: Arc<BlockCtx>,
    pub tx: Arc<Mutex<TxCtx>>,
    pub evm_depth: Arc<AtomicUsize>,
    pub caller_stack: Arc<Mutex<Vec<Address>>>,
    pub stylus_frame_depth: Arc<AtomicUsize>,
}

Handle threaded into precompile handlers. Cheap to clone (all Arc).

Fields

block: Arc<BlockCtx>

tx: Arc<Mutex<TxCtx>>

evm_depth: Arc<AtomicUsize>

EVM call depth at the most recent precompile dispatch. Mirrors the journal depth surfaced by revm to the precompile provider.

caller_stack: Arc<Mutex<Vec<Address>>>

Caller addresses by depth, pushed at each frame boundary so that precompile handlers can resolve the on-chain caller at arbitrary depth (alloy-evm’s EvmInternals does not surface this).

stylus_frame_depth: Arc<AtomicUsize>

Number of Stylus program frames currently on the call stack. Lets a frame tell whether it has a Stylus ancestor.

Implementations

impl ArbPrecompileCtx

pub fn new() -> Self

pub fn with_block(block: Arc<BlockCtx>) -> Self

pub fn tx_snapshot(&self) -> TxCtx

Snapshot the current per-tx scratch.

pub fn reset_tx(&self)

Reset per-tx scratch between transactions.

pub fn set_sender(&self, sender: Address)

pub fn set_effective_gas_price(&self, price: u128)

pub fn set_poster_fee(&self, fee: u128)

pub fn set_poster_balance_correction(&self, correction: u128)

pub fn set_retryable_id(&self, id: B256)

pub fn set_redeemer(&self, redeemer: Address)

pub fn set_tx_is_aliased(&self, aliased: bool)

pub fn tx_is_aliased(&self) -> bool

pub fn set_evm_depth(&self, depth: usize)

pub fn evm_depth(&self) -> usize

pub fn enter_stylus_frame(&self) -> usize

Marks entry to a Stylus frame, returning the new Stylus call depth (1 for the outermost Stylus frame).

pub fn exit_stylus_frame(&self)

Marks exit from a Stylus frame.

pub fn push_caller(&self, caller: Address)

pub fn pop_caller(&self)

pub fn reset_caller_stack(&self)

pub fn caller_at_depth(&self, depth: usize) -> Option<Address>

Return the caller at the given depth (1-indexed). Mirrors the frame-depth conventions used by ArbSys.

pub fn set_stylus_activation_addr(&self, addr: Option<Address>)

pub fn take_stylus_activation_addr(&self) -> Option<Address>

pub fn set_cancel_escrow_sweep(&self, escrow: Address, beneficiary: Address)

pub fn take_cancel_escrow_sweep(&self) -> Option<(Address, Address)>

pub fn set_stylus_keepalive_hash(&self, hash: Option<B256>)

pub fn take_stylus_keepalive_hash(&self) -> Option<B256>

pub fn set_stylus_activation_data_fee(&self, fee: U256)

pub fn take_stylus_activation_data_fee(&self) -> U256

pub fn set_stylus_call_value(&self, value: U256)

pub fn stylus_call_value(&self) -> U256

pub fn add_stylus_multi_gas(&self, gas: MultiGas)

pub fn stylus_multi_gas(&self) -> MultiGas

pub fn add_stylus_upfront_oog_gas(&self, gas: u64)

pub fn stylus_upfront_oog_gas(&self) -> u64

pub fn add_precompile_multi_gas(&self, kind: ResourceKind, amount: u64)

Accumulate per-dimension gas for a precompile charge. The single-gas total still flows through the precompile’s own gas_used; this records only the resource breakdown for the v60 pricing backlog.

pub fn precompile_multi_gas(&self) -> MultiGas

pub fn snapshot_precompile_multi_gas(&self) -> MultiGas

Capture the current precompile_multi_gas so callers can later restore it. Used by precompiles whose body gas is intentionally discarded at the receipt (mirroring the reference, where access-controlled methods report zero gas) so the per-dimension contributions they recorded are dropped before the result is returned.

pub fn restore_precompile_multi_gas(&self, snapshot: MultiGas)

Restore precompile_multi_gas to a previously captured snapshot.

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

Increment the reentrancy counter for addr and return true if this is a reentrant entry (counter was already > 0).

pub fn stylus_program_count(&self, addr: Address) -> u32

pub fn pop_stylus_program(&self, addr: Address)

Trait Implementations

impl Clone for ArbPrecompileCtx

fn clone(&self) -> ArbPrecompileCtx

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArbPrecompileCtx

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

Formats the value using the given formatter.

impl Default for ArbPrecompileCtx

fn default() -> ArbPrecompileCtx

Returns the “default value” for a type.