Trait reth::rpc::api::servers::eth::helpers::pending_block::LoadPendingBlock

pub trait LoadPendingBlock {
    // Required methods
    fn provider(
        &self,
    ) -> impl BlockReaderIdExt + EvmEnvProvider + ChainSpecProvider + StateProviderFactory;
    fn pool(&self) -> impl TransactionPool;
    fn pending_block(&self) -> &Mutex<Option<PendingBlock>>;
    fn evm_config(&self) -> &impl ConfigureEvm;

    // Provided methods
    fn pending_block_env_and_cfg(&self) -> Result<PendingBlockEnv, EthApiError> { ... }
    fn local_pending_block(
        &self,
    ) -> impl Future<Output = Result<Option<SealedBlockWithSenders>, EthApiError>> + Send
       where Self: SpawnBlocking { ... }
    fn assemble_receipt(
        &self,
        tx: &TransactionSignedEcRecovered,
        result: ExecutionResult,
        cumulative_gas_used: u64,
    ) -> Receipt { ... }
    fn receipts_root(
        &self,
        _block_env: &BlockEnv,
        execution_outcome: &ExecutionOutcome,
        block_number: u64,
    ) -> FixedBytes<32> { ... }
    fn build_block(
        &self,
        env: PendingBlockEnv,
    ) -> Result<SealedBlockWithSenders, EthApiError> { ... }
}

Loads a pending block from database.

Behaviour shared by several eth_ RPC methods, not exclusive to eth_ blocks RPC methods.

Required Methods

fn provider( &self, ) -> impl BlockReaderIdExt + EvmEnvProvider + ChainSpecProvider + StateProviderFactory

Returns a handle for reading data from disk.

Data access in default (L1) trait method implementations.

fn pool(&self) -> impl TransactionPool

Returns a handle for reading data from transaction pool.

Data access in default (L1) trait method implementations.

fn pending_block(&self) -> &Mutex<Option<PendingBlock>>

Returns a handle to the pending block.

Data access in default (L1) trait method implementations.

fn evm_config(&self) -> &impl ConfigureEvm

Returns a handle for reading evm config.

Data access in default (L1) trait method implementations.

Provided Methods

fn pending_block_env_and_cfg(&self) -> Result<PendingBlockEnv, EthApiError>

Configures the CfgEnvWithHandlerCfg and BlockEnv for the pending block

If no pending block is available, this will derive it from the latest block

fn local_pending_block( &self, ) -> impl Future<Output = Result<Option<SealedBlockWithSenders>, EthApiError>> + Send

where Self: SpawnBlocking,

Returns the locally built pending block

fn assemble_receipt( &self, tx: &TransactionSignedEcRecovered, result: ExecutionResult, cumulative_gas_used: u64, ) -> Receipt

Assembles a Receipt for a transaction, based on its ExecutionResult.

fn receipts_root( &self, _block_env: &BlockEnv, execution_outcome: &ExecutionOutcome, block_number: u64, ) -> FixedBytes<32>

Calculates receipts root in block building.

Panics if block is not in the ExecutionOutcome’s block range.

fn build_block( &self, env: PendingBlockEnv, ) -> Result<SealedBlockWithSenders, EthApiError>

Builds a pending block using the configured provider and pool.

If the origin is the actual pending block, the block is built with withdrawals.

After Cancun, if the origin is the actual pending block, the block includes the EIP-4788 pre block contract call using the parent beacon block root received from the CL.

Object Safety

This trait is not object safe.

Implementations on Foreign Types

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

where T: 'a + LoadPendingBlock + SpawnBlocking + ?Sized,

fn provider( &self, ) -> impl BlockReaderIdExt + EvmEnvProvider + ChainSpecProvider + StateProviderFactory

fn pool(&self) -> impl TransactionPool

fn pending_block(&self) -> &Mutex<Option<PendingBlock>>

fn evm_config(&self) -> &impl ConfigureEvm

fn pending_block_env_and_cfg(&self) -> Result<PendingBlockEnv, EthApiError>

fn local_pending_block( &self, ) -> impl Future<Output = Result<Option<SealedBlockWithSenders>, EthApiError>> + Send

where &'a T: SpawnBlocking,

fn assemble_receipt( &self, tx: &TransactionSignedEcRecovered, result: ExecutionResult, cumulative_gas_used: u64, ) -> Receipt

fn receipts_root( &self, _block_env: &BlockEnv, execution_outcome: &ExecutionOutcome, block_number: u64, ) -> FixedBytes<32>

fn build_block( &self, env: PendingBlockEnv, ) -> Result<SealedBlockWithSenders, EthApiError>

impl<T> LoadPendingBlock for Arc<T>

where T: LoadPendingBlock + SpawnBlocking + ?Sized,

fn provider( &self, ) -> impl BlockReaderIdExt + EvmEnvProvider + ChainSpecProvider + StateProviderFactory

fn pool(&self) -> impl TransactionPool

fn pending_block(&self) -> &Mutex<Option<PendingBlock>>

fn evm_config(&self) -> &impl ConfigureEvm

fn pending_block_env_and_cfg(&self) -> Result<PendingBlockEnv, EthApiError>

fn local_pending_block( &self, ) -> impl Future<Output = Result<Option<SealedBlockWithSenders>, EthApiError>> + Send

where Arc<T>: SpawnBlocking,

fn assemble_receipt( &self, tx: &TransactionSignedEcRecovered, result: ExecutionResult, cumulative_gas_used: u64, ) -> Receipt

fn receipts_root( &self, _block_env: &BlockEnv, execution_outcome: &ExecutionOutcome, block_number: u64, ) -> FixedBytes<32>

fn build_block( &self, env: PendingBlockEnv, ) -> Result<SealedBlockWithSenders, EthApiError>

Implementors

impl<Provider, Pool, Network, EvmConfig> LoadPendingBlock for EthApi<Provider, Pool, Network, EvmConfig>

where EthApi<Provider, Pool, Network, EvmConfig>: SpawnBlocking, Provider: BlockReaderIdExt + EvmEnvProvider + ChainSpecProvider + StateProviderFactory, Pool: TransactionPool, EvmConfig: ConfigureEvm,