pub struct HistoricalStateProviderRef<'b, Provider> { /* private fields */ }Expand description
State provider for a given block number which takes a tx reference.
Historical state provider accesses the state at the start of the provided block number. It means that all changes made in the provided block number are not included.
Historical state provider reads the following tables:
- [
tables::AccountsHistory] - [
tables::Bytecodes] - [
tables::StoragesHistory] - [
tables::AccountChangeSets] - [
tables::StorageChangeSets]
Implementations§
Source§impl<'b, Provider: DBProvider + BlockNumReader + StateCommitmentProvider> HistoricalStateProviderRef<'b, Provider>
impl<'b, Provider: DBProvider + BlockNumReader + StateCommitmentProvider> HistoricalStateProviderRef<'b, Provider>
Sourcepub fn new(provider: &'b Provider, block_number: BlockNumber) -> Self
pub fn new(provider: &'b Provider, block_number: BlockNumber) -> Self
Create new StateProvider for historical block number
Sourcepub const fn new_with_lowest_available_blocks(
provider: &'b Provider,
block_number: BlockNumber,
lowest_available_blocks: LowestAvailableBlocks,
) -> Self
pub const fn new_with_lowest_available_blocks( provider: &'b Provider, block_number: BlockNumber, lowest_available_blocks: LowestAvailableBlocks, ) -> Self
Create new StateProvider for historical block number and lowest block numbers at which
account & storage histories are available.
Sourcepub fn account_history_lookup(
&self,
address: Address,
) -> ProviderResult<HistoryInfo>
pub fn account_history_lookup( &self, address: Address, ) -> ProviderResult<HistoryInfo>
Lookup an account in the AccountsHistory table
Sourcepub fn storage_history_lookup(
&self,
address: Address,
storage_key: StorageKey,
) -> ProviderResult<HistoryInfo>
pub fn storage_history_lookup( &self, address: Address, storage_key: StorageKey, ) -> ProviderResult<HistoryInfo>
Lookup a storage key in the StoragesHistory table
Sourcepub const fn with_lowest_available_account_history_block_number(
self,
block_number: BlockNumber,
) -> Self
pub const fn with_lowest_available_account_history_block_number( self, block_number: BlockNumber, ) -> Self
Set the lowest block number at which the account history is available.
Sourcepub const fn with_lowest_available_storage_history_block_number(
self,
block_number: BlockNumber,
) -> Self
pub const fn with_lowest_available_storage_history_block_number( self, block_number: BlockNumber, ) -> Self
Set the lowest block number at which the storage history is available.
Trait Implementations§
Source§impl<Provider: DBProvider + BlockNumReader + StateCommitmentProvider> AccountReader for HistoricalStateProviderRef<'_, Provider>
impl<Provider: DBProvider + BlockNumReader + StateCommitmentProvider> AccountReader for HistoricalStateProviderRef<'_, Provider>
Source§fn basic_account(&self, address: Address) -> ProviderResult<Option<Account>>
fn basic_account(&self, address: Address) -> ProviderResult<Option<Account>>
Get basic account information.
Source§impl<Provider: DBProvider + BlockNumReader + BlockHashReader> BlockHashReader for HistoricalStateProviderRef<'_, Provider>
impl<Provider: DBProvider + BlockNumReader + BlockHashReader> BlockHashReader for HistoricalStateProviderRef<'_, Provider>
Source§fn block_hash(&self, number: u64) -> ProviderResult<Option<B256>>
fn block_hash(&self, number: u64) -> ProviderResult<Option<B256>>
Get block hash by number.
Source§fn canonical_hashes_range(
&self,
start: BlockNumber,
end: BlockNumber,
) -> ProviderResult<Vec<B256>>
fn canonical_hashes_range( &self, start: BlockNumber, end: BlockNumber, ) -> ProviderResult<Vec<B256>>
Get headers in range of block hashes or numbers Read more
§fn convert_block_hash(
&self,
hash_or_number: HashOrNumber,
) -> Result<Option<FixedBytes<32>>, ProviderError>
fn convert_block_hash( &self, hash_or_number: HashOrNumber, ) -> Result<Option<FixedBytes<32>>, ProviderError>
Get the hash of the block with the given number. Returns
None if no block with this number
exists.Source§impl<'b, Provider: Debug> Debug for HistoricalStateProviderRef<'b, Provider>
impl<'b, Provider: Debug> Debug for HistoricalStateProviderRef<'b, Provider>
Source§impl<Provider: StateCommitmentProvider> HashedPostStateProvider for HistoricalStateProviderRef<'_, Provider>
impl<Provider: StateCommitmentProvider> HashedPostStateProvider for HistoricalStateProviderRef<'_, Provider>
Source§fn hashed_post_state(&self, bundle_state: &BundleState) -> HashedPostState
fn hashed_post_state(&self, bundle_state: &BundleState) -> HashedPostState
Returns the
HashedPostState of the provided [BundleState].Source§impl<Provider: StateCommitmentProvider> StateCommitmentProvider for HistoricalStateProviderRef<'_, Provider>
impl<Provider: StateCommitmentProvider> StateCommitmentProvider for HistoricalStateProviderRef<'_, Provider>
Source§type StateCommitment = <Provider as StateCommitmentProvider>::StateCommitment
type StateCommitment = <Provider as StateCommitmentProvider>::StateCommitment
The [
StateCommitment] type that can be used to perform state commitment operations.Source§impl<Provider: DBProvider + BlockNumReader + StateCommitmentProvider> StateProofProvider for HistoricalStateProviderRef<'_, Provider>
impl<Provider: DBProvider + BlockNumReader + StateCommitmentProvider> StateProofProvider for HistoricalStateProviderRef<'_, Provider>
Source§fn proof(
&self,
input: TrieInput,
address: Address,
slots: &[B256],
) -> ProviderResult<AccountProof>
fn proof( &self, input: TrieInput, address: Address, slots: &[B256], ) -> ProviderResult<AccountProof>
Get account and storage proofs.
Source§fn multiproof(
&self,
input: TrieInput,
targets: MultiProofTargets,
) -> ProviderResult<MultiProof>
fn multiproof( &self, input: TrieInput, targets: MultiProofTargets, ) -> ProviderResult<MultiProof>
Generate [
MultiProof] for target hashed account and corresponding
hashed storage slot keys.Source§fn witness(
&self,
input: TrieInput,
target: HashedPostState,
) -> ProviderResult<B256HashMap<Bytes>>
fn witness( &self, input: TrieInput, target: HashedPostState, ) -> ProviderResult<B256HashMap<Bytes>>
Get trie witness for provided state.
Source§impl<Provider: DBProvider + BlockNumReader + BlockHashReader + StateCommitmentProvider> StateProvider for HistoricalStateProviderRef<'_, Provider>
impl<Provider: DBProvider + BlockNumReader + BlockHashReader + StateCommitmentProvider> StateProvider for HistoricalStateProviderRef<'_, Provider>
Source§fn storage(
&self,
address: Address,
storage_key: StorageKey,
) -> ProviderResult<Option<StorageValue>>
fn storage( &self, address: Address, storage_key: StorageKey, ) -> ProviderResult<Option<StorageValue>>
Get storage.
Source§fn bytecode_by_hash(&self, code_hash: B256) -> ProviderResult<Option<Bytecode>>
fn bytecode_by_hash(&self, code_hash: B256) -> ProviderResult<Option<Bytecode>>
Get account code by its hash
§fn account_code(&self, addr: Address) -> Result<Option<Bytecode>, ProviderError>
fn account_code(&self, addr: Address) -> Result<Option<Bytecode>, ProviderError>
Get account code by its address. Read more
§fn account_balance(
&self,
addr: Address,
) -> Result<Option<Uint<256, 4>>, ProviderError>
fn account_balance( &self, addr: Address, ) -> Result<Option<Uint<256, 4>>, ProviderError>
Get account balance by its address. Read more
§fn account_nonce(&self, addr: Address) -> Result<Option<u64>, ProviderError>
fn account_nonce(&self, addr: Address) -> Result<Option<u64>, ProviderError>
Get account nonce by its address. Read more
Source§impl<Provider: DBProvider + BlockNumReader + StateCommitmentProvider> StateRootProvider for HistoricalStateProviderRef<'_, Provider>
impl<Provider: DBProvider + BlockNumReader + StateCommitmentProvider> StateRootProvider for HistoricalStateProviderRef<'_, Provider>
Source§fn state_root(&self, hashed_state: HashedPostState) -> ProviderResult<B256>
fn state_root(&self, hashed_state: HashedPostState) -> ProviderResult<B256>
Returns the state root of the
BundleState on top of the current state. Read moreSource§fn state_root_from_nodes(&self, input: TrieInput) -> ProviderResult<B256>
fn state_root_from_nodes(&self, input: TrieInput) -> ProviderResult<B256>
Returns the state root of the
HashedPostState on top of the current state but re-uses the
intermediate nodes to speed up the computation. It’s up to the caller to construct the
prefix sets and inform the provider of the trie paths that have changes.Source§fn state_root_with_updates(
&self,
hashed_state: HashedPostState,
) -> ProviderResult<(B256, TrieUpdates)>
fn state_root_with_updates( &self, hashed_state: HashedPostState, ) -> ProviderResult<(B256, TrieUpdates)>
Returns the state root of the
HashedPostState on top of the current state with trie
updates to be committed to the database.Source§fn state_root_from_nodes_with_updates(
&self,
input: TrieInput,
) -> ProviderResult<(B256, TrieUpdates)>
fn state_root_from_nodes_with_updates( &self, input: TrieInput, ) -> ProviderResult<(B256, TrieUpdates)>
Returns state root and trie updates.
See
StateRootProvider::state_root_from_nodes for more info.Source§impl<Provider: DBProvider + BlockNumReader + StateCommitmentProvider> StorageRootProvider for HistoricalStateProviderRef<'_, Provider>
impl<Provider: DBProvider + BlockNumReader + StateCommitmentProvider> StorageRootProvider for HistoricalStateProviderRef<'_, Provider>
Source§fn storage_root(
&self,
address: Address,
hashed_storage: HashedStorage,
) -> ProviderResult<B256>
fn storage_root( &self, address: Address, hashed_storage: HashedStorage, ) -> ProviderResult<B256>
Returns the storage root of the
HashedStorage for target address on top of the current
state.Source§fn storage_proof(
&self,
address: Address,
slot: B256,
hashed_storage: HashedStorage,
) -> ProviderResult<StorageProof>
fn storage_proof( &self, address: Address, slot: B256, hashed_storage: HashedStorage, ) -> ProviderResult<StorageProof>
Returns the storage proof of the
HashedStorage for target slot on top of the current
state.Source§fn storage_multiproof(
&self,
address: Address,
slots: &[B256],
hashed_storage: HashedStorage,
) -> ProviderResult<StorageMultiProof>
fn storage_multiproof( &self, address: Address, slots: &[B256], hashed_storage: HashedStorage, ) -> ProviderResult<StorageMultiProof>
Returns the storage multiproof for target slots.
Auto Trait Implementations§
impl<'b, Provider> Freeze for HistoricalStateProviderRef<'b, Provider>
impl<'b, Provider> RefUnwindSafe for HistoricalStateProviderRef<'b, Provider>where
Provider: RefUnwindSafe,
impl<'b, Provider> Send for HistoricalStateProviderRef<'b, Provider>where
Provider: Sync,
impl<'b, Provider> Sync for HistoricalStateProviderRef<'b, Provider>where
Provider: Sync,
impl<'b, Provider> Unpin for HistoricalStateProviderRef<'b, Provider>
impl<'b, Provider> UnwindSafe for HistoricalStateProviderRef<'b, Provider>where
Provider: RefUnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
§impl<T> Conv for T
impl<T> Conv for T
§impl<T> EvmStateProvider for Twhere
T: StateProvider,
impl<T> EvmStateProvider for Twhere
T: StateProvider,
§fn basic_account(
&self,
address: Address,
) -> Result<Option<Account>, ProviderError>
fn basic_account( &self, address: Address, ) -> Result<Option<Account>, ProviderError>
Get basic account information. Read more
§fn block_hash(
&self,
number: u64,
) -> Result<Option<FixedBytes<32>>, ProviderError>
fn block_hash( &self, number: u64, ) -> Result<Option<FixedBytes<32>>, ProviderError>
Get the hash of the block with the given number. Returns
None if no block with this
number exists.§fn bytecode_by_hash(
&self,
code_hash: FixedBytes<32>,
) -> Result<Option<Bytecode>, ProviderError>
fn bytecode_by_hash( &self, code_hash: FixedBytes<32>, ) -> Result<Option<Bytecode>, ProviderError>
Get account code by hash.
§fn storage(
&self,
account: Address,
storage_key: FixedBytes<32>,
) -> Result<Option<Uint<256, 4>>, ProviderError>
fn storage( &self, account: Address, storage_key: FixedBytes<32>, ) -> Result<Option<Uint<256, 4>>, ProviderError>
Get storage of the given account.
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
Causes
self to use its Binary implementation when Debug-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
Causes
self to use its Display implementation when
Debug-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
Causes
self to use its LowerExp implementation when
Debug-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
Causes
self to use its LowerHex implementation when
Debug-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
Causes
self to use its Octal implementation when Debug-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
Causes
self to use its Pointer implementation when
Debug-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
Causes
self to use its UpperExp implementation when
Debug-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
Causes
self to use its UpperHex implementation when
Debug-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
Formats each item in a sequence. Read more
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Pipes by value. This is generally the method you want to use. Read more
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
Borrows
self and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
Mutably borrows
self and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
Borrows
self, then passes self.as_ref() into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
Mutably borrows
self, then passes self.as_mut() into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
Borrows
self, then passes self.deref() into the pipe function.§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Immutable access to the
Borrow<B> of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
Mutable access to the
BorrowMut<B> of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
Immutable access to the
AsRef<R> view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
Mutable access to the
AsMut<R> view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Immutable access to the
Deref::Target of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Mutable access to the
Deref::Target of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
Calls
.tap() only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
Calls
.tap_mut() only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
Calls
.tap_borrow() only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
Calls
.tap_borrow_mut() only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
Calls
.tap_ref() only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
Calls
.tap_ref_mut() only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
Calls
.tap_deref() only in debug builds, and is erased in release
builds.§impl<T> TryConv for T
impl<T> TryConv for T
§impl<T> WithSubscriber for T
impl<T> WithSubscriber for T
§fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
§fn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
impl<T> ErasedDestructor for Twhere
T: 'static,
impl<T> MaybeDebug for Twhere
T: Debug,
impl<T> MaybeSendSync for T
Layout§
Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.
Size: 48 bytes