Trait StateProvider 

pub trait StateProvider:
    BlockHashReader
    + AccountReader
    + BytecodeReader
    + StateRootProvider
    + StorageRootProvider
    + StateProofProvider
    + HashedPostStateProvider {
    // Required methods
    fn storage(
        &self,
        account: Address,
        storage_key: FixedBytes<32>,
    ) -> Result<Option<Uint<256, 4>>, ProviderError>;
    fn storage_by_hashed_key(
        &self,
        address: Address,
        hashed_storage_key: FixedBytes<32>,
    ) -> Result<Option<Uint<256, 4>>, ProviderError>;

    // Provided methods
    fn account_code(
        &self,
        addr: &Address,
    ) -> Result<Option<Bytecode>, ProviderError> { ... }
    fn account_balance(
        &self,
        addr: &Address,
    ) -> Result<Option<Uint<256, 4>>, ProviderError> { ... }
    fn account_nonce(
        &self,
        addr: &Address,
    ) -> Result<Option<u64>, ProviderError> { ... }
}

An abstraction for a type that provides state data.

Required Methods

fn storage( &self, account: Address, storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

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.

fn storage_by_hashed_key( &self, address: Address, hashed_storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

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

fn account_code( &self, addr: &Address, ) -> Result<Option<Bytecode>, ProviderError>

Get account code by its address.

Returns None if the account doesn’t exist or account is not a contract

fn account_balance( &self, addr: &Address, ) -> Result<Option<Uint<256, 4>>, ProviderError>

Get account balance by its address.

Returns None if the account doesn’t exist

fn account_nonce(&self, addr: &Address) -> Result<Option<u64>, ProviderError>

Get account nonce by its address.

Returns None if the account doesn’t exist

Implementations on Foreign Types

impl<'a, N> StateProvider for MemoryOverlayStateProvider<N>

where N: NodePrimitives,

fn storage( &self, account: Address, storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

fn storage_by_hashed_key( &self, address: Address, hashed_storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

impl<'a, T> StateProvider for &'a T

where T: 'a + StateProvider + ?Sized, &'a T: BlockHashReader + AccountReader + BytecodeReader + StateRootProvider + StorageRootProvider + StateProofProvider + HashedPostStateProvider,

fn storage( &self, account: Address, storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

fn storage_by_hashed_key( &self, address: Address, hashed_storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

fn account_code( &self, addr: &Address, ) -> Result<Option<Bytecode>, ProviderError>

fn account_balance( &self, addr: &Address, ) -> Result<Option<Uint<256, 4>>, ProviderError>

fn account_nonce(&self, addr: &Address) -> Result<Option<u64>, ProviderError>

impl<N> StateProvider for MemoryOverlayStateProviderRef<'_, N>

where N: NodePrimitives,

fn storage( &self, address: Address, storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

fn storage_by_hashed_key( &self, address: Address, hashed_storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

impl<S> StateProvider for InstrumentedStateProvider<S>

where S: StateProvider,

fn storage( &self, account: Address, storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

fn storage_by_hashed_key( &self, address: Address, hashed_storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

impl<S, const PREWARM: bool> StateProvider for CachedStateProvider<S, PREWARM>

where S: StateProvider,

fn storage( &self, account: Address, storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

fn storage_by_hashed_key( &self, address: Address, hashed_storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

impl<T> StateProvider for Box<T>

where T: StateProvider + ?Sized, Box<T>: BlockHashReader + AccountReader + BytecodeReader + StateRootProvider + StorageRootProvider + StateProofProvider + HashedPostStateProvider,

fn storage( &self, account: Address, storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

fn storage_by_hashed_key( &self, address: Address, hashed_storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>

fn account_code( &self, addr: &Address, ) -> Result<Option<Bytecode>, ProviderError>

fn account_balance( &self, addr: &Address, ) -> Result<Option<Uint<256, 4>>, ProviderError>

fn account_nonce(&self, addr: &Address) -> Result<Option<u64>, ProviderError>

Implementors

impl StateProvider for StateProviderTest

impl StateProvider for StateProviderTraitObjWrapper

impl<'a, Provider> StateProvider for HistoricalStateProvider<Provider>

where Provider: DBProvider + BlockNumReader + BlockHashReader + ChangeSetReader + StorageChangeSetReader + StorageSettingsCache + RocksDBProviderFactory + NodePrimitivesProvider,

impl<'a, Provider> StateProvider for LatestStateProvider<Provider>

where Provider: DBProvider + BlockHashReader + StorageSettingsCache,

impl<C, N> StateProvider for NoopProvider<C, N>

where C: Send + Sync, N: NodePrimitives,

impl<Provider> StateProvider for HistoricalStateProviderRef<'_, Provider>

where Provider: DBProvider + BlockNumReader + BlockHashReader + ChangeSetReader + StorageChangeSetReader + StorageSettingsCache + RocksDBProviderFactory + NodePrimitivesProvider,

impl<Provider> StateProvider for LatestStateProviderRef<'_, Provider>

where Provider: DBProvider + BlockHashReader + StorageSettingsCache,

impl<T, ChainSpec> StateProvider for MockEthProvider<T, ChainSpec>

where T: NodePrimitives, ChainSpec: EthChainSpec + Send + Sync + 'static,