Struct NoopProvider

#[non_exhaustive]
pub struct NoopProvider;

Available on crate feature test-utils only.

Supports various api interfaces for testing purposes.

Trait Implementations

impl AccountReader for NoopProvider

fn basic_account(&self, _address: Address) -> ProviderResult<Option<Account>>

Get basic account information.

impl BlockHashReader for NoopProvider

Noop implementation for testing purposes

fn block_hash(&self, _number: u64) -> ProviderResult<Option<B256>>

Get the hash of the block with the given number. Returns None if no block with this number exists.

fn canonical_hashes_range( &self, _start: BlockNumber, _end: BlockNumber, ) -> ProviderResult<Vec<B256>>

Get headers in range of block hashes or numbers

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.

impl BlockIdReader for NoopProvider

fn pending_block_num_hash(&self) -> ProviderResult<Option<BlockNumHash>>

Get the current pending block number and hash.

fn safe_block_num_hash(&self) -> ProviderResult<Option<BlockNumHash>>

Get the current safe block number and hash.

fn finalized_block_num_hash(&self) -> ProviderResult<Option<BlockNumHash>>

Get the current finalized block number and hash.

fn convert_block_number( &self, num: BlockNumberOrTag, ) -> Result<Option<u64>, ProviderError>

Converts the BlockNumberOrTag variants to a block number.

fn block_hash_for_id( &self, block_id: BlockId, ) -> Result<Option<FixedBytes<32>>, ProviderError>

Get the hash of the block by matching the given id.

fn block_number_for_id( &self, block_id: BlockId, ) -> Result<Option<u64>, ProviderError>

Get the number of the block by matching the given id.

fn safe_block_number(&self) -> Result<Option<u64>, ProviderError>

Get the safe block number.

fn finalized_block_number(&self) -> Result<Option<u64>, ProviderError>

Get the finalized block number.

fn safe_block_hash(&self) -> Result<Option<FixedBytes<32>>, ProviderError>

Get the safe block hash.

fn finalized_block_hash(&self) -> Result<Option<FixedBytes<32>>, ProviderError>

Get the finalized block hash.

impl BlockNumReader for NoopProvider

fn chain_info(&self) -> ProviderResult<ChainInfo>

Returns the current info for the chain.

fn best_block_number(&self) -> ProviderResult<BlockNumber>

Returns the best block number in the chain.

fn last_block_number(&self) -> ProviderResult<BlockNumber>

Returns the last block number associated with the last canonical header in the database.

fn block_number(&self, _hash: B256) -> ProviderResult<Option<BlockNumber>>

Gets the BlockNumber for the given hash. Returns None if no block with this hash exists.

fn convert_hash_or_number( &self, id: HashOrNumber, ) -> Result<Option<u64>, ProviderError>

Gets the block number for the given BlockHashOrNumber. Returns None if no block with this hash exists. If the BlockHashOrNumber is a Number, it is returned as is.

fn convert_number( &self, id: HashOrNumber, ) -> Result<Option<FixedBytes<32>>, ProviderError>

Gets the block hash for the given BlockHashOrNumber. Returns None if no block with this number exists. If the BlockHashOrNumber is a Hash, it is returned as is.

impl BlockReader for NoopProvider

fn find_block_by_hash( &self, hash: B256, _source: BlockSource, ) -> ProviderResult<Option<Block>>

Tries to find in the given block source.

fn block(&self, _id: BlockHashOrNumber) -> ProviderResult<Option<Block>>

Returns the block with given id from the database.

fn pending_block(&self) -> ProviderResult<Option<SealedBlock>>

Returns the pending block if available

fn pending_block_with_senders( &self, ) -> ProviderResult<Option<SealedBlockWithSenders>>

Returns the pending block if available

fn pending_block_and_receipts( &self, ) -> ProviderResult<Option<(SealedBlock, Vec<Receipt>)>>

Returns the pending block and receipts if available.

fn ommers(&self, _id: BlockHashOrNumber) -> ProviderResult<Option<Vec<Header>>>

Returns the ommers/uncle headers of the given block from the database.

fn block_body_indices( &self, _num: u64, ) -> ProviderResult<Option<StoredBlockBodyIndices>>

Returns the block body indices with matching number from database.

fn block_with_senders( &self, _id: BlockHashOrNumber, _transaction_kind: TransactionVariant, ) -> ProviderResult<Option<BlockWithSenders>>

Returns the block with senders with matching number or hash from database.

fn sealed_block_with_senders( &self, _id: BlockHashOrNumber, _transaction_kind: TransactionVariant, ) -> ProviderResult<Option<SealedBlockWithSenders>>

Returns the sealed block with senders with matching number or hash from database.

fn block_range( &self, _range: RangeInclusive<BlockNumber>, ) -> ProviderResult<Vec<Block>>

Returns all blocks in the given inclusive range.

fn block_with_senders_range( &self, _range: RangeInclusive<BlockNumber>, ) -> ProviderResult<Vec<BlockWithSenders>>

Returns a range of blocks from the database, along with the senders of each transaction in the blocks.

fn sealed_block_with_senders_range( &self, _range: RangeInclusive<BlockNumber>, ) -> ProviderResult<Vec<SealedBlockWithSenders>>

Returns a range of sealed blocks from the database, along with the senders of each transaction in the blocks.

fn block_by_hash( &self, hash: FixedBytes<32>, ) -> Result<Option<Block>, ProviderError>

Returns the block with matching hash from the database.

fn block_by_number(&self, num: u64) -> Result<Option<Block>, ProviderError>

Returns the block with matching number from database.

impl BlockReaderIdExt for NoopProvider

fn block_by_id(&self, _id: BlockId) -> ProviderResult<Option<Block>>

Returns the block with the matching [BlockId] from the database.

fn sealed_header_by_id( &self, _id: BlockId, ) -> ProviderResult<Option<SealedHeader>>

Returns the sealed header with the matching BlockId from the database.

fn header_by_id(&self, _id: BlockId) -> ProviderResult<Option<Header>>

Returns the header with the matching BlockId from the database.

fn ommers_by_id(&self, _id: BlockId) -> ProviderResult<Option<Vec<Header>>>

Returns the ommers with the matching BlockId from the database.

fn block_by_number_or_tag( &self, id: BlockNumberOrTag, ) -> Result<Option<Block>, ProviderError>

Returns the block with matching tag from the database

fn pending_header(&self) -> Result<Option<SealedHeader>, ProviderError>

Returns the pending block header if available

fn latest_header(&self) -> Result<Option<SealedHeader>, ProviderError>

Returns the latest block header if available

fn safe_header(&self) -> Result<Option<SealedHeader>, ProviderError>

Returns the safe block header if available

fn finalized_header(&self) -> Result<Option<SealedHeader>, ProviderError>

Returns the finalized block header if available

fn block_with_senders_by_id( &self, id: BlockId, transaction_kind: TransactionVariant, ) -> Result<Option<BlockWithSenders>, ProviderError>

Returns the block with senders with matching [BlockId].

fn header_by_number_or_tag( &self, id: BlockNumberOrTag, ) -> Result<Option<Header>, ProviderError>

Returns the header with matching tag from the database

fn sealed_header_by_number_or_tag( &self, id: BlockNumberOrTag, ) -> Result<Option<SealedHeader>, ProviderError>

Returns the header with matching tag from the database

fn ommers_by_number_or_tag( &self, id: BlockNumberOrTag, ) -> Result<Option<Vec<Header>>, ProviderError>

Returns the ommers with the matching tag from the database.

impl CanonStateSubscriptions for NoopProvider

fn subscribe_to_canonical_state(&self) -> CanonStateNotifications

Get notified when a new canonical chain was imported.

fn canonical_state_stream(&self) -> CanonStateNotificationStream

Convenience method to get a stream of CanonStateNotification.

impl ChainSpecProvider for NoopProvider

type ChainSpec = ChainSpec

The chain spec type.

fn chain_spec(&self) -> Arc<ChainSpec>

Get an Arc to the chainspec.

impl ChangeSetReader for NoopProvider

fn account_block_changeset( &self, _block_number: BlockNumber, ) -> ProviderResult<Vec<AccountBeforeTx>>

Iterate over account changesets and return the account state from before this block.

impl Clone for NoopProvider

fn clone(&self) -> NoopProvider

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NoopProvider

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

Formats the value using the given formatter.

impl Default for NoopProvider

fn default() -> NoopProvider

Returns the “default value” for a type.

impl EvmEnvProvider for NoopProvider

fn fill_env_at<EvmConfig>( &self, _cfg: &mut CfgEnvWithHandlerCfg, _block_env: &mut BlockEnv, _at: BlockHashOrNumber, _evm_config: EvmConfig, ) -> ProviderResult<()>

where EvmConfig: ConfigureEvmEnv<Header = Header>,

Fills the [CfgEnvWithHandlerCfg] and [BlockEnv] fields with values specific to the given [BlockHashOrNumber].

fn fill_env_with_header<EvmConfig>( &self, _cfg: &mut CfgEnvWithHandlerCfg, _block_env: &mut BlockEnv, _header: &Header, _evm_config: EvmConfig, ) -> ProviderResult<()>

where EvmConfig: ConfigureEvmEnv<Header = Header>,

Fills the [CfgEnvWithHandlerCfg] and [BlockEnv] fields with values specific to the given [Header].

fn fill_cfg_env_at<EvmConfig>( &self, _cfg: &mut CfgEnvWithHandlerCfg, _at: BlockHashOrNumber, _evm_config: EvmConfig, ) -> ProviderResult<()>

where EvmConfig: ConfigureEvmEnv<Header = Header>,

Fills the [CfgEnvWithHandlerCfg] fields with values specific to the given [BlockHashOrNumber].

fn fill_cfg_env_with_header<EvmConfig>( &self, _cfg: &mut CfgEnvWithHandlerCfg, _header: &Header, _evm_config: EvmConfig, ) -> ProviderResult<()>

where EvmConfig: ConfigureEvmEnv<Header = Header>,

Fills the [CfgEnvWithHandlerCfg] fields with values specific to the given [Header].

fn env_with_header<EvmConfig>( &self, header: &Header, evm_config: EvmConfig, ) -> Result<(CfgEnvWithHandlerCfg, BlockEnv), ProviderError>

where EvmConfig: ConfigureEvmEnv<Header = Header>,

Fills the default [CfgEnvWithHandlerCfg] and [BlockEnv] fields with values specific to the given [Header].

impl ForkChoiceSubscriptions for NoopProvider

fn subscribe_safe_block(&self) -> ForkChoiceNotifications

Get notified when a new safe block of the chain is selected.

fn subscribe_finalized_block(&self) -> ForkChoiceNotifications

Get notified when a new finalized block of the chain is selected.

fn safe_block_stream(&self) -> ForkChoiceStream<SealedHeader>

Convenience method to get a stream of the new safe blocks of the chain.

fn finalized_block_stream(&self) -> ForkChoiceStream<SealedHeader>

Convenience method to get a stream of the new finalized blocks of the chain.

impl HeaderProvider for NoopProvider

fn header(&self, _block_hash: &BlockHash) -> ProviderResult<Option<Header>>

Get header by block hash

fn header_by_number(&self, _num: u64) -> ProviderResult<Option<Header>>

Get header by block number

fn header_td(&self, _hash: &BlockHash) -> ProviderResult<Option<U256>>

Get total difficulty by block hash.

fn header_td_by_number( &self, _number: BlockNumber, ) -> ProviderResult<Option<U256>>

Get total difficulty by block number.

fn headers_range( &self, _range: impl RangeBounds<BlockNumber>, ) -> ProviderResult<Vec<Header>>

Get headers in range of block numbers

fn sealed_header( &self, _number: BlockNumber, ) -> ProviderResult<Option<SealedHeader>>

Get a single sealed header by block number.

fn sealed_headers_while( &self, _range: impl RangeBounds<BlockNumber>, _predicate: impl FnMut(&SealedHeader) -> bool, ) -> ProviderResult<Vec<SealedHeader>>

Get sealed headers while predicate returns true or the range is exhausted.

fn is_known(&self, block_hash: &FixedBytes<32>) -> Result<bool, ProviderError>

Check if block is known

fn sealed_header_by_hash( &self, block_hash: FixedBytes<32>, ) -> Result<Option<SealedHeader>, ProviderError>

Retrieves the header sealed by the given block hash.

fn header_by_hash_or_number( &self, hash_or_num: HashOrNumber, ) -> Result<Option<Header>, ProviderError>

Get header by block number or hash

fn sealed_headers_range( &self, range: impl RangeBounds<u64>, ) -> Result<Vec<SealedHeader>, ProviderError>

Get headers in range of block numbers.

impl PruneCheckpointReader for NoopProvider

fn get_prune_checkpoint( &self, _segment: PruneSegment, ) -> ProviderResult<Option<PruneCheckpoint>>

Fetch the prune checkpoint for the given segment.

fn get_prune_checkpoints( &self, ) -> ProviderResult<Vec<(PruneSegment, PruneCheckpoint)>>

Fetch all the prune checkpoints.

impl ReceiptProvider for NoopProvider

fn receipt(&self, _id: TxNumber) -> ProviderResult<Option<Receipt>>

Get receipt by transaction number

fn receipt_by_hash(&self, _hash: TxHash) -> ProviderResult<Option<Receipt>>

Get receipt by transaction hash.

fn receipts_by_block( &self, _block: BlockHashOrNumber, ) -> ProviderResult<Option<Vec<Receipt>>>

Get receipts by block num or hash.

fn receipts_by_tx_range( &self, _range: impl RangeBounds<TxNumber>, ) -> ProviderResult<Vec<Receipt>>

Get receipts by tx range.

impl ReceiptProviderIdExt for NoopProvider

fn receipts_by_block_id( &self, block: BlockId, ) -> Result<Option<Vec<Receipt>>, ProviderError>

Get receipt by block id

fn receipts_by_number_or_tag( &self, number_or_tag: BlockNumberOrTag, ) -> Result<Option<Vec<Receipt>>, ProviderError>

Returns the block with the matching BlockId from the database.

impl StageCheckpointReader for NoopProvider

fn get_stage_checkpoint( &self, _id: StageId, ) -> ProviderResult<Option<StageCheckpoint>>

Fetch the checkpoint for the given stage.

fn get_stage_checkpoint_progress( &self, _id: StageId, ) -> ProviderResult<Option<Vec<u8>>>

Get stage checkpoint progress.

fn get_all_checkpoints(&self) -> ProviderResult<Vec<(String, StageCheckpoint)>>

Reads all stage checkpoints and returns a list with the name of the stage and the checkpoint data.

impl StateProofProvider for NoopProvider

fn proof( &self, _input: TrieInput, address: Address, _slots: &[B256], ) -> ProviderResult<AccountProof>

Get account and storage proofs of target keys in the HashedPostState on top of the current state.

fn multiproof( &self, _input: TrieInput, _targets: HashMap<B256, HashSet<B256>>, ) -> ProviderResult<MultiProof>

Generate [MultiProof] for target hashed account and corresponding hashed storage slot keys.

fn witness( &self, _input: TrieInput, _target: HashedPostState, ) -> ProviderResult<HashMap<B256, Bytes>>

Get trie witness for provided state.

impl StateProvider for NoopProvider

fn storage( &self, _account: Address, _storage_key: StorageKey, ) -> ProviderResult<Option<StorageValue>>

Get storage of given account.

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>

Get account code by its address.

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

Get account balance by its address.

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

Get account nonce by its address.

impl StateProviderFactory for NoopProvider

fn latest(&self) -> ProviderResult<StateProviderBox>

Storage provider for latest block.

fn state_by_block_number_or_tag( &self, number_or_tag: BlockNumberOrTag, ) -> ProviderResult<StateProviderBox>

Returns a StateProvider indexed by the given block number or tag.

fn history_by_block_number( &self, _block: BlockNumber, ) -> ProviderResult<StateProviderBox>

Returns a historical StateProvider indexed by the given historic block number.

fn history_by_block_hash( &self, _block: BlockHash, ) -> ProviderResult<StateProviderBox>

Returns a historical StateProvider indexed by the given block hash.

fn state_by_block_hash( &self, _block: BlockHash, ) -> ProviderResult<StateProviderBox>

Returns any StateProvider with matching block hash.

fn pending(&self) -> ProviderResult<StateProviderBox>

Storage provider for pending state.

fn pending_state_by_hash( &self, _block_hash: B256, ) -> ProviderResult<Option<StateProviderBox>>

Storage provider for pending state for the given block hash.

fn state_by_block_id( &self, block_id: BlockId, ) -> Result<Box<dyn StateProvider>, ProviderError>

Returns a StateProvider indexed by the given [BlockId].

impl StateRootProvider for NoopProvider

fn state_root(&self, _state: HashedPostState) -> ProviderResult<B256>

Returns the state root of the BundleState on top of the current state.

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.

fn state_root_with_updates( &self, _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.

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.

impl StaticFileProviderFactory for NoopProvider

type Primitives = ()

The network primitives type StaticFileProvider is using.

fn static_file_provider(&self) -> StaticFileProvider<Self::Primitives>

Create new instance of static file provider.

impl StorageRootProvider for NoopProvider

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.

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.

impl TransactionsProvider for NoopProvider

fn transaction_id(&self, _tx_hash: TxHash) -> ProviderResult<Option<TxNumber>>

Get internal transaction identifier by transaction hash.

fn transaction_by_id( &self, _id: TxNumber, ) -> ProviderResult<Option<TransactionSigned>>

Get transaction by id, computes hash every time so more expensive.

fn transaction_by_id_no_hash( &self, _id: TxNumber, ) -> ProviderResult<Option<TransactionSignedNoHash>>

Get transaction by id without computing the hash.

fn transaction_by_hash( &self, _hash: TxHash, ) -> ProviderResult<Option<TransactionSigned>>

Get transaction by transaction hash.

fn transaction_by_hash_with_meta( &self, _hash: TxHash, ) -> ProviderResult<Option<(TransactionSigned, TransactionMeta)>>

Get transaction by transaction hash and additional metadata of the block the transaction was mined in

fn transaction_block( &self, _id: TxNumber, ) -> ProviderResult<Option<BlockNumber>>

Get transaction block number

fn transactions_by_block( &self, _block_id: BlockHashOrNumber, ) -> ProviderResult<Option<Vec<TransactionSigned>>>

Get transactions by block id.

fn transactions_by_block_range( &self, _range: impl RangeBounds<BlockNumber>, ) -> ProviderResult<Vec<Vec<TransactionSigned>>>

Get transactions by block range.

fn transactions_by_tx_range( &self, _range: impl RangeBounds<TxNumber>, ) -> ProviderResult<Vec<TransactionSignedNoHash>>

Get transactions by tx range.

fn senders_by_tx_range( &self, _range: impl RangeBounds<TxNumber>, ) -> ProviderResult<Vec<Address>>

Get Senders from a tx range.

fn transaction_sender(&self, _id: TxNumber) -> ProviderResult<Option<Address>>

Get transaction sender.

impl WithdrawalsProvider for NoopProvider

fn withdrawals_by_block( &self, _id: BlockHashOrNumber, _timestamp: u64, ) -> ProviderResult<Option<Withdrawals>>

Get withdrawals by block id.

fn latest_withdrawal(&self) -> ProviderResult<Option<Withdrawal>>

Get latest withdrawal from this block or earlier .

impl Copy for NoopProvider

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: 0 bytes