Struct SmartAccessList 

pub struct SmartAccessList { /* private fields */ }

An EIP-2930 access list builder with L2 profitability accounting.

The caller decides which addresses/slots to add (via add_address / add_storage_key); the builder itself applies no per-entry selection. The into_access_list_* finalizers decide whether attaching the whole list is profitable, comparing its L1 data-posting cost against the L2 warm-access savings.

Implementations

impl SmartAccessList

pub fn new() -> Self

Create an empty smart access-list builder.

Populate it with SmartAccessList::add_address and SmartAccessList::add_storage_key, then finalize with one of the into_access_list_* methods.

pub fn from_items(items: Vec<AccessListItem>) -> Self

Create a builder from precomputed EIP-2930 items.

The items are taken as-is; this constructor does not deduplicate addresses or storage keys (unlike SmartAccessList::add_address and SmartAccessList::add_storage_key). Pass items that are already distinct, or rely on downstream encoders to fold duplicates.

pub fn add_address(&mut self, address: Address)

Add an address to the access list (address-only, no specific storage keys). Useful for contracts that are accessed on every call.

pub fn add_storage_key(&mut self, address: Address, storage_key: B256)

Add one storage key for an address, deduplicating both address and key.

pub fn into_access_list_always(self) -> Option<AccessList>

Return the access list unconditionally.

On L1 chains there is no L1 data posting overhead, so access lists always save gas (100 gas per warm-vs-cold SLOAD). Returns None only when the list is empty.

pub async fn into_access_list_if_profitable<P: Provider>( self, provider: &P, ) -> Result<Option<AccessList>>

Evaluate Arbitrum profitability against current L1/L2 gas prices and return the access list only if it saves money.

Queries the Arbitrum ArbGasInfo precompile for pricing, then compares the L2 execution savings against the estimated L1 data cost of posting the serialized list:

• L2 savings: 100 gas * entry_count * perArbGas, where each address and each storage key counts as one entry (the EIP-2929 warm-vs-cold access discount).
• L1 cost: l1_data_gas * l1_base_fee, where l1_data_gas is the exact per-byte calldata gas (l1_data_gas_for_bytes) of the EIP-2930 RLP-encoded access list.

Errors

Returns Err if the provider/pricing queries fail.

Returns Ok(None) when:

• the list is empty,
• either the L2 or L1 gas price reads as zero, or
• the estimated L1 cost meets or exceeds the L2 savings (not profitable).

Trait Implementations

impl Default for SmartAccessList

fn default() -> Self

Returns the “default value” for a type.