Struct DefaultArbOsHooks 

pub struct DefaultArbOsHooks {
    pub tx_proc: TxProcessor,
    pub arbos_version: u64,
    pub network_fee_account: Address,
    pub infra_fee_account: Address,
    pub min_base_fee: U256,
    pub per_block_gas_limit: u64,
    pub per_tx_gas_limit: u64,
    pub coinbase: Address,
    pub is_eth_call: bool,
    pub l1_base_fee: U256,
    pub calldata_pricing_increase_enabled: bool,
    pub collect_tips_enabled: bool,
}

Concrete ArbOS hooks implementation backed by TxProcessor.

Bridges the ArbOsHooks trait to the arbos crate’s TxProcessor which contains the core fee accounting logic.

Fields

tx_proc: TxProcessor

Per-transaction processor state.

arbos_version: u64

Current ArbOS version.

network_fee_account: Address

Network fee account from ArbOS state.

infra_fee_account: Address

Infrastructure fee account from ArbOS state.

min_base_fee: U256

Minimum L2 base fee from L2 pricing state.

per_block_gas_limit: u64

Per-block gas limit from L2 pricing state.

per_tx_gas_limit: u64

Per-tx gas limit from L2 pricing state (ArbOS v50+).

coinbase: Address

Block coinbase (poster address).

is_eth_call: bool

Whether this is an eth_call (non-mutating).

l1_base_fee: U256

Cached L1 base fee for poster cost computation.

calldata_pricing_increase_enabled: bool

Whether calldata pricing increase feature is enabled (ArbOS >= 40 + feature flag).

collect_tips_enabled: bool

Whether tip collection is enabled (ArbOS >= 60 + state flag). When true, the priority-fee tip is paid to coinbase rather than dropped.

Implementations

impl DefaultArbOsHooks

pub fn new( coinbase: Address, arbos_version: u64, network_fee_account: Address, infra_fee_account: Address, min_base_fee: U256, per_block_gas_limit: u64, per_tx_gas_limit: u64, is_eth_call: bool, l1_base_fee: U256, calldata_pricing_increase_enabled: bool, collect_tips_enabled: bool, ) -> Self

pub fn compute_end_tx_fees(&self, ctx: &EndTxContext) -> EndTxFeeDistribution

Compute the end-of-tx fee distribution for a normal transaction.

Trait Implementations

impl ArbOsHooks for DefaultArbOsHooks

type Error = ArbHookError

fn start_tx(&mut self, ctx: &StartTxContext) -> Result<(), Self::Error>

Called before each transaction. Sets up gas accounting, processes deposits, and initializes retryable state.

fn gas_charging( &mut self, ctx: &GasChargingContext, ) -> Result<GasChargingResult, Self::Error>

Called after intrinsic gas calculation. Charges poster costs and manages L1 pricing.

fn end_tx(&mut self, _ctx: &EndTxContext) -> Result<(), Self::Error>

Called after transaction execution. Handles gas refunds, poster fee distribution, and state cleanup.

fn nonrefundable_gas(&self) -> u64

Returns the amount of gas that cannot be refunded.

fn held_gas(&self) -> u64

Returns the amount of gas held for compute.

fn scheduled_txs(&mut self) -> Vec<Vec<u8>>

Returns scheduled internal transactions generated during execution.

fn drop_tip(&self) -> bool

Whether the priority fee tip should be dropped (not sent to coinbase).

fn gas_price_op(&self, gas_price: U256, base_fee: U256) -> U256

The effective gas price for the GASPRICE opcode.

fn msg_is_non_mutating(&self) -> bool

Whether the message is non-mutating (eth_call).

fn is_calldata_pricing_increase_enabled(&self) -> bool

Whether EIP-7623 calldata pricing increase is enabled.

impl Debug for DefaultArbOsHooks

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

Formats the value using the given formatter.