Struct L2PricingState 

pub struct L2PricingState<D> {
    pub backing_storage: Storage<D>,
    pub arbos_version: u64,
    /* private fields */
}

L2 pricing state manages gas pricing for L2 execution.

Fields

backing_storage: Storage<D>

arbos_version: u64

Implementations

impl<D: Database> L2PricingState<D>

pub fn gas_model_to_use(&self) -> Result<GasModel, ()>

Determine which gas model to use based on ArbOS version and stored constraints.

pub fn grow_backlog( &self, used_gas: u64, used_multi_gas: MultiGas, ) -> Result<(), ()>

Grow the gas backlog for the active pricing model.

pub fn shrink_backlog( &self, used_gas: u64, used_multi_gas: MultiGas, ) -> Result<(), ()>

Shrink the gas backlog for the active pricing model.

pub fn update_pricing_model( &self, time_passed: u64, arbos_version: u64, ) -> Result<(), ()>

Update the pricing model for a new block.

pub fn calc_multi_gas_constraints_exponents(&self) -> Result<[u64; 9], ()>

Calculate exponent (in basis points) per resource kind across all constraints.

Aggregates weighted backlog contributions from each constraint into a per-resource-kind exponent array.

Uses signed saturation arithmetic with Bips (int64) computation: dividend = NaturalToBips(SaturatingCast]int64](SaturatingUMul(backlog, weight))) divisor = SaturatingCastToBips(SaturatingUMul(window, SaturatingUMul(target, maxWeight))) exp = dividend / divisor (signed int64 division)

pub fn calc_base_fee_from_exponent( &self, exponent_bips: u64, ) -> Result<U256, ()>

Calculate base fee from an exponent in basis points. base_fee = min_base_fee * exp(exponent_bips / 10000)

pub fn get_multi_gas_base_fee_per_resource(&self) -> Result<[U256; 9], ()>

pub fn get_current_multi_gas_fees(&self) -> Result<[U256; 9], ()>

Reads the 8 current-block multi-gas fees (non-SingleDim). Intended for block-level caching by the executor: these values are only written by commit_next_to_current, which runs before any tx in the block. Zero is kept (not substituted to base_fee_wei) so the caller can do the substitution with a fresh base_fee read on every use.

pub fn commit_multi_gas_fees(&self) -> Result<(), ()>

Rotate next-block multi-gas fees into current-block fees.

Called at block start before executing transactions.

pub fn backlog_update_cost(&self) -> Result<u64, ()>

Calculate the cost for a backlog update operation.

Version-gated cost accounting:

• v60+: static cost (StorageReadCost + StorageWriteCost)
• v51+: overhead for single-gas constraint traversal
• v50+: base overhead for GasModelToUse() read
• legacy: read + write for backlog

pub fn set_gas_constraints_from_legacy(&self) -> Result<(), ()>

Set gas constraints from legacy parameters (for upgrades).

pub fn set_multi_gas_constraints_from_single_gas_constraints( &self, ) -> Result<(), ()>

Convert single-gas constraints to multi-gas constraints (for upgrades).

Iterates existing single-gas constraints, reads their target/window/backlog, and creates corresponding multi-gas constraints with equal weights across all resource dimensions.

pub fn multi_dimensional_price_for_refund( &self, gas_used: MultiGas, ) -> Result<U256, ()>

Compute total cost for a multi-gas usage, for refund calculations.

Returns sum(gas_used[kind] * base_fee[kind]) across all resource kinds.

pub fn multi_dimensional_price_for_refund_with_fees( &self, gas_used: MultiGas, cached_fees: &[U256; 9], ) -> Result<U256, ()>

Variant of multi_dimensional_price_for_refund that uses precomputed current-block multi-gas fees (as returned by get_current_multi_gas_fees). base_fee_wei is still read from state to handle rare mid-block setL2BaseFee owner writes. Zero cached values are substituted with the live base_fee, matching get_multi_gas_base_fee_per_resource exactly.

impl<D: Database> L2PricingState<D>

pub fn open(sto: Storage<D>, arbos_version: u64) -> Self

pub fn initialize(sto: &Storage<D>)

pub fn base_fee_wei(&self) -> Result<U256, ()>

pub fn set_base_fee_wei(&self, val: U256) -> Result<(), ()>

pub fn min_base_fee_wei(&self) -> Result<U256, ()>

pub fn set_min_base_fee_wei(&self, val: U256) -> Result<(), ()>

pub fn speed_limit_per_second(&self) -> Result<u64, ()>

pub fn set_speed_limit_per_second(&self, limit: u64) -> Result<(), ()>

pub fn per_block_gas_limit(&self) -> Result<u64, ()>

pub fn set_max_per_block_gas_limit(&self, limit: u64) -> Result<(), ()>

pub fn per_tx_gas_limit(&self) -> Result<u64, ()>

pub fn set_max_per_tx_gas_limit(&self, limit: u64) -> Result<(), ()>

pub fn gas_backlog(&self) -> Result<u64, ()>

pub fn set_gas_backlog(&self, backlog: u64) -> Result<(), ()>

pub fn pricing_inertia(&self) -> Result<u64, ()>

pub fn set_pricing_inertia(&self, val: u64) -> Result<(), ()>

pub fn backlog_tolerance(&self) -> Result<u64, ()>

pub fn set_backlog_tolerance(&self, val: u64) -> Result<(), ()>

pub fn gas_constraints_length(&self) -> Result<u64, ()>

pub fn open_gas_constraint_at(&self, index: u64) -> GasConstraint<D>

pub fn add_gas_constraint( &self, target: u64, adjustment_window: u64, backlog: u64, ) -> Result<(), ()>

pub fn clear_gas_constraints(&self) -> Result<(), ()>

pub fn multi_gas_constraints_length(&self) -> Result<u64, ()>

pub fn open_multi_gas_constraint_at(&self, index: u64) -> MultiGasConstraint<D>

pub fn add_multi_gas_constraint( &self, target: u64, adjustment_window: u32, backlog: u64, weights: &[u64; 9], ) -> Result<(), ()>

pub fn clear_multi_gas_constraints(&self) -> Result<(), ()>

pub fn restrict(&self, _err: ())