Struct NoopProvider

#[non_exhaustive]
pub struct NoopProvider<ChainSpec = ChainSpec, N = EthPrimitives> { /* private fields */ }

Supports various api interfaces for testing purposes.

Implementations

impl<ChainSpec, N> NoopProvider<ChainSpec, N>

pub fn new(chain_spec: Arc<ChainSpec>) -> Self

Create a new instance for specific primitive types.

impl<ChainSpec> NoopProvider<ChainSpec>

pub fn eth(chain_spec: Arc<ChainSpec>) -> Self

Create a new instance of the NoopBlockReader.

impl NoopProvider

pub fn mainnet() -> Self

Create a new instance of the NoopProvider with the mainnet chain spec.

Trait Implementations

impl<C: Send + Sync, N: NodePrimitives> AccountReader for NoopProvider<C, N>

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

Get basic account information.

impl<C: Send + Sync, N: Send + Sync> BlockBodyIndicesProvider for NoopProvider<C, N>

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

Returns the block body indices with matching number from database.

impl<ChainSpec: Send + Sync, N: Send + Sync> BlockHashReader for NoopProvider<ChainSpec, N>

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: BlockHashOrNumber, ) -> ProviderResult<Option<B256>>

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

impl<C: Send + Sync, N: NodePrimitives> BlockIdReader for NoopProvider<C, N>

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, ) -> ProviderResult<Option<BlockNumber>>

Converts the BlockNumberOrTag variants to a block number.

fn block_hash_for_id(&self, block_id: BlockId) -> ProviderResult<Option<B256>>

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

fn block_number_for_id( &self, block_id: BlockId, ) -> ProviderResult<Option<BlockNumber>>

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

fn safe_block_number(&self) -> ProviderResult<Option<BlockNumber>>

Get the safe block number.

fn finalized_block_number(&self) -> ProviderResult<Option<BlockNumber>>

Get the finalized block number.

fn safe_block_hash(&self) -> ProviderResult<Option<B256>>

Get the safe block hash.

fn finalized_block_hash(&self) -> ProviderResult<Option<B256>>

Get the finalized block hash.

impl<ChainSpec: Send + Sync, N: Send + Sync> BlockNumReader for NoopProvider<ChainSpec, N>

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: BlockHashOrNumber, ) -> ProviderResult<Option<BlockNumber>>

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: BlockHashOrNumber) -> ProviderResult<Option<B256>>

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<C: Send + Sync, N: NodePrimitives> BlockReader for NoopProvider<C, N>

type Block = <N as NodePrimitives>::Block

The block type this provider reads.

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

Tries to find in the given block source.

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

Returns the block with given id from the database.

fn pending_block(&self) -> ProviderResult<Option<SealedBlockFor<Self::Block>>>

Returns the pending block if available

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

Returns the pending block if available

fn pending_block_and_receipts( &self, ) -> ProviderResult<Option<(SealedBlockFor<Self::Block>, Vec<Self::Receipt>)>>

Returns the pending block and receipts if available.

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

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<Self::Block>>>

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

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

Returns all blocks in the given inclusive range.

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

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<Self::Block>>>

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: B256) -> ProviderResult<Option<Self::Block>>

Returns the block with matching hash from the database.

fn block_by_number(&self, num: u64) -> ProviderResult<Option<Self::Block>>

Returns the block with matching number from database.

impl<C: Send + Sync, N: NodePrimitives> BlockReaderIdExt for NoopProvider<C, N>

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

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

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

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

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

Returns the header with the matching BlockId from the database.

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

Returns the ommers with the matching BlockId from the database.

fn block_by_number_or_tag( &self, id: BlockNumberOrTag, ) -> ProviderResult<Option<Self::Block>>

Returns the block with matching tag from the database

fn pending_header(&self) -> ProviderResult<Option<SealedHeader<Self::Header>>>

Returns the pending block header if available

fn latest_header(&self) -> ProviderResult<Option<SealedHeader<Self::Header>>>

Returns the latest block header if available

fn safe_header(&self) -> ProviderResult<Option<SealedHeader<Self::Header>>>

Returns the safe block header if available

fn finalized_header(&self) -> ProviderResult<Option<SealedHeader<Self::Header>>>

Returns the finalized block header if available

fn block_with_senders_by_id( &self, id: BlockId, transaction_kind: TransactionVariant, ) -> ProviderResult<Option<BlockWithSenders<Self::Block>>>

Returns the block with senders with matching [BlockId].

fn header_by_number_or_tag( &self, id: BlockNumberOrTag, ) -> ProviderResult<Option<Self::Header>>

Returns the header with matching tag from the database

fn sealed_header_by_number_or_tag( &self, id: BlockNumberOrTag, ) -> ProviderResult<Option<SealedHeader<Self::Header>>>

Returns the header with matching tag from the database

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

Returns the ommers with the matching tag from the database.

impl<ChainSpec: EthChainSpec + 'static, N: Send + Sync + 'static> ChainSpecProvider for NoopProvider<ChainSpec, N>

type ChainSpec = ChainSpec

The chain spec type.

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

Get an Arc to the chainspec.

impl<C: Send + Sync, N: NodePrimitives> ChangeSetReader for NoopProvider<C, N>

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<ChainSpec, N> Clone for NoopProvider<ChainSpec, N>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<ChainSpec: Debug, N: Debug> Debug for NoopProvider<ChainSpec, N>

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

Formats the value using the given formatter.

impl Default for NoopProvider

fn default() -> Self

Returns the “default value” for a type.

impl<C: Send + Sync, N: NodePrimitives> HashedPostStateProvider for NoopProvider<C, N>

fn hashed_post_state(&self, _bundle_state: &BundleState) -> HashedPostState

Returns the HashedPostState of the provided [BundleState].

impl<C: Send + Sync, N: NodePrimitives> HeaderProvider for NoopProvider<C, N>

type Header = <N as NodePrimitives>::BlockHeader

The header type this provider supports.

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

Get header by block hash

fn header_by_number(&self, _num: u64) -> ProviderResult<Option<Self::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<Self::Header>>

Get headers in range of block numbers

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

Get a single sealed header by block number.

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

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

fn is_known(&self, block_hash: &BlockHash) -> ProviderResult<bool>

Check if block is known

fn sealed_header_by_hash( &self, block_hash: BlockHash, ) -> ProviderResult<Option<SealedHeader<Self::Header>>>

Retrieves the header sealed by the given block hash.

fn header_by_hash_or_number( &self, hash_or_num: BlockHashOrNumber, ) -> ProviderResult<Option<Self::Header>>

Get header by block number or hash

fn sealed_headers_range( &self, range: impl RangeBounds<BlockNumber>, ) -> ProviderResult<Vec<SealedHeader<Self::Header>>>

Get headers in range of block numbers.

impl<C: Send + Sync, N: NodePrimitives> NodePrimitivesProvider for NoopProvider<C, N>

type Primitives = N

The node primitive types.

impl<C: Send + Sync, N: NodePrimitives> OmmersProvider for NoopProvider<C, N>

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

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

impl<C: Send + Sync, N: NodePrimitives> PruneCheckpointReader for NoopProvider<C, N>

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<C: Send + Sync, N: NodePrimitives> ReceiptProvider for NoopProvider<C, N>

type Receipt = <N as NodePrimitives>::Receipt

The receipt type.

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

Get receipt by transaction number

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

Get receipt by transaction hash.

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

Get receipts by block num or hash.

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

Get receipts by tx range.

impl<C: Send + Sync, N: NodePrimitives> ReceiptProviderIdExt for NoopProvider<C, N>

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

Get receipt by block id

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

Returns the block with the matching BlockId from the database.

impl<C: Send + Sync, N: NodePrimitives> StageCheckpointReader for NoopProvider<C, N>

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<C: Send + Sync, N: NodePrimitives> StateProofProvider for NoopProvider<C, N>

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: MultiProofTargets, ) -> ProviderResult<MultiProof>

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

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

Get trie witness for provided state.

impl<C: Send + Sync, N: NodePrimitives> StateProvider for NoopProvider<C, N>

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) -> ProviderResult<Option<Bytecode>>

Get account code by its address.

fn account_balance(&self, addr: Address) -> ProviderResult<Option<U256>>

Get account balance by its address.

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

Get account nonce by its address.

impl<C: Send + Sync + 'static, N: NodePrimitives> StateProviderFactory for NoopProvider<C, N>

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, ) -> ProviderResult<StateProviderBox>

Returns a StateProvider indexed by the given [BlockId].

impl<C: Send + Sync, N: NodePrimitives> StateRootProvider for NoopProvider<C, N>

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<C: Send + Sync, N: NodePrimitives> StorageRootProvider for NoopProvider<C, N>

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.

fn storage_multiproof( &self, _address: Address, _slots: &[B256], _hashed_storage: HashedStorage, ) -> ProviderResult<StorageMultiProof>

Returns the storage multiproof for target slots.

impl<C: Send + Sync, N: NodePrimitives> TransactionsProvider for NoopProvider<C, N>

type Transaction = <N as NodePrimitives>::SignedTx

The transaction type this provider reads.

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<Self::Transaction>>

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

fn transaction_by_id_unhashed( &self, _id: TxNumber, ) -> ProviderResult<Option<Self::Transaction>>

Get transaction by id without computing the hash.

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

Get transaction by transaction hash.

fn transaction_by_hash_with_meta( &self, _hash: TxHash, ) -> ProviderResult<Option<(Self::Transaction, 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<Self::Transaction>>>

Get transactions by block id.

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

Get transactions by block range.

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

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<C: Send + Sync, N: NodePrimitives> WithdrawalsProvider for NoopProvider<C, N>

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 .

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