Struct BlockCtx 

pub struct BlockCtx {
    pub arbos_version: u64,
    pub block_timestamp: u64,
    pub l1_block_number_for_evm: u64,
    pub l2_block_number: u64,
    pub allow_debug_precompiles: bool,
    pub current_gas_backlog: AtomicU64,
    pub state_params_dirty: AtomicBool,
    pub chain_caches: Arc<ChainCaches>,
    pub recent_wasms: Mutex<RecentWasms>,
    /* private fields */
}

Per-block parameters populated once at block start.

Fields

arbos_version: u64

block_timestamp: u64

l1_block_number_for_evm: u64

L1 block number observed by the EVM NUMBER opcode and precompiles that surface the recorded L1 height.

l2_block_number: u64

allow_debug_precompiles: bool

current_gas_backlog: AtomicU64

Live counter mutated by the executor between transactions in the same block.

state_params_dirty: AtomicBool

Set by an owner setter when a transaction changes a per-tx state parameter (fee collectors, minimum base fee, brotli level, calldata pricing); the executor refreshes its cached values after the transaction.

chain_caches: Arc<ChainCaches>

recent_wasms: Mutex<RecentWasms>

Implementations

impl BlockCtx

pub fn new( arbos_version: u64, block_timestamp: u64, l1_block_number_for_evm: u64, l2_block_number: u64, allow_debug_precompiles: bool, ) -> Self

pub fn new_with_caches( arbos_version: u64, block_timestamp: u64, l1_block_number_for_evm: u64, l2_block_number: u64, allow_debug_precompiles: bool, chain_caches: Arc<ChainCaches>, ) -> Self

pub fn arbos_state<S: SystemStateBackend>( &self, backend: &mut S, ) -> Result<&ArbosState<'static, Detached, SystemBurner>, ArbosStateError>

Borrow the cached ArbosState, constructing it on first call via arbos_from_input_system. Returns a clone of the cached error if the first call failed; the cache is not cleared on error since the version slot does not change within a single block.

pub fn current_gas_backlog(&self) -> u64

pub fn set_current_gas_backlog(&self, value: u64)

pub fn cache_l1_block_number(&self, l2_block: u64, l1_block: u64)

Insert an L1 block number into the cache, retaining a rolling window of recent L2 heights.

pub fn cached_l1_block_number(&self, l2_block: u64) -> Option<u64>

pub fn cache_l2_block_hash(&self, l2_block: u64, hash: B256)

pub fn cached_l2_block_hash(&self, l2_block: u64) -> Option<B256>

pub fn reset_recent_wasms(&self, capacity: usize)

pub fn insert_recent_wasm(&self, hash: B256) -> bool

Trait Implementations

impl Debug for BlockCtx

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

Formats the value using the given formatter.

impl Default for BlockCtx

fn default() -> Self

Returns the “default value” for a type.