pub trait StateProvider:
BlockHashReader
+ AccountReader
+ BytecodeReader
+ StateRootProvider
+ StorageRootProvider
+ StateProofProvider
+ HashedPostStateProvider {
// Required methods
fn storage(
&self,
account: Address,
storage_key: StorageKey,
) -> ProviderResult<Option<StorageValue>>;
fn storage_by_hashed_key(
&self,
address: Address,
hashed_storage_key: StorageKey,
) -> ProviderResult<Option<StorageValue>>;
// Provided methods
fn account_code(&self, addr: &Address) -> ProviderResult<Option<Bytecode>> { ... }
fn account_balance(&self, addr: &Address) -> ProviderResult<Option<U256>> { ... }
fn account_nonce(&self, addr: &Address) -> ProviderResult<Option<u64>> { ... }
}Expand description
An abstraction for a type that provides state data.
Required Methods§
Sourcefn storage(
&self,
account: Address,
storage_key: StorageKey,
) -> ProviderResult<Option<StorageValue>>
fn storage( &self, account: Address, storage_key: StorageKey, ) -> ProviderResult<Option<StorageValue>>
Get storage of given account.
When use_hashed_state is enabled, the account and storage_key are hashed internally
before lookup. Callers must pass unhashed (plain) values.
Sourcefn storage_by_hashed_key(
&self,
address: Address,
hashed_storage_key: StorageKey,
) -> ProviderResult<Option<StorageValue>>
fn storage_by_hashed_key( &self, address: Address, hashed_storage_key: StorageKey, ) -> ProviderResult<Option<StorageValue>>
Get storage using a pre-hashed storage key.
Unlike Self::storage, hashed_storage_key must already be keccak256-hashed.
The address remains unhashed (plain) since history indices are keyed by plain address.
This is used when changeset keys are pre-hashed (e.g., use_hashed_state mode)
to avoid double-hashing.
Provided Methods§
Sourcefn account_code(&self, addr: &Address) -> ProviderResult<Option<Bytecode>>
fn account_code(&self, addr: &Address) -> ProviderResult<Option<Bytecode>>
Get account code by its address.
Returns None if the account doesn’t exist or account is not a contract
Sourcefn account_balance(&self, addr: &Address) -> ProviderResult<Option<U256>>
fn account_balance(&self, addr: &Address) -> ProviderResult<Option<U256>>
Get account balance by its address.
Returns None if the account doesn’t exist
Sourcefn account_nonce(&self, addr: &Address) -> ProviderResult<Option<u64>>
fn account_nonce(&self, addr: &Address) -> ProviderResult<Option<u64>>
Get account nonce by its address.
Returns None if the account doesn’t exist