Struct StorageAccessList 

pub struct StorageAccessList {
    pub accounts: HashSet<Address>,
    pub slots: HashSet<(Address, U256)>,
}

Accounts and storage slots touched during EVM execution.

The shape is optimized for simulation bookkeeping: set union, overlap checks, warm-access gas estimation, and storage prefetching.

Fields

accounts: HashSet<Address>

Contract addresses touched during execution.

slots: HashSet<(Address, U256)>

(contract, slot) pairs read or written during execution.

Implementations

impl StorageAccessList

pub fn is_empty(&self) -> bool

Returns true when no accounts or storage slots were captured.

pub fn account_count(&self) -> usize

Number of distinct accounts touched by the execution.

pub fn slot_count(&self) -> usize

Number of distinct storage slots touched by the execution.

pub fn extend(&mut self, other: &Self)

Merge another touch set into this one (set union of accounts and slots).

Duplicate accounts and (account, slot) pairs already present are not counted twice, so StorageAccessList::account_count and StorageAccessList::slot_count reflect distinct entries after merging.

Examples

use evm_fork_cache::StorageAccessList;
use alloy_primitives::{Address, U256};

let acct_a = Address::repeat_byte(0x01);
let acct_b = Address::repeat_byte(0x02);

let mut base = StorageAccessList::default();
base.accounts.insert(acct_a);
base.slots.insert((acct_a, U256::from(1)));

let mut other = StorageAccessList::default();
other.accounts.insert(acct_a); // overlaps `base`, not double-counted
other.accounts.insert(acct_b);
other.slots.insert((acct_b, U256::from(2)));

base.extend(&other);

assert_eq!(base.account_count(), 2);
assert_eq!(base.slot_count(), 2);
assert!(!base.is_empty());

pub fn marginal_gas_savings(&self, warm: &Self) -> u64

Compute EIP-2929 gas saved when this touch set runs after warm.

Cold account access costs 2600 gas versus 100 gas when warm, saving 2500 gas. Cold SLOAD costs 2100 gas versus 100 gas when warm, saving 2000 gas.

pub fn to_eip2930(&self) -> AccessList

Convert this touch set into an EIP-2930 transaction access list.

Trait Implementations

impl Clone for StorageAccessList

fn clone(&self) -> StorageAccessList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StorageAccessList

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

Formats the value using the given formatter.

impl Default for StorageAccessList

fn default() -> StorageAccessList

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for StorageAccessList

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&StorageAccessList> for AccessList

fn from(value: &StorageAccessList) -> Self

Converts to this type from the input type.

impl Serialize for StorageAccessList

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.