Trait ReceiptProvider 

pub trait ReceiptProvider {
    type Receipt: Receipt;

    // Required methods
    fn receipt(&self, id: u64) -> Result<Option<Self::Receipt>, ProviderError>;
    fn receipt_by_hash(
        &self,
        hash: FixedBytes<32>,
    ) -> Result<Option<Self::Receipt>, ProviderError>;
    fn receipts_by_block(
        &self,
        block: HashOrNumber,
    ) -> Result<Option<Vec<Self::Receipt>>, ProviderError>;
    fn receipts_by_tx_range(
        &self,
        range: impl RangeBounds<u64>,
    ) -> Result<Vec<Self::Receipt>, ProviderError>;
    fn receipts_by_block_range(
        &self,
        block_range: RangeInclusive<u64>,
    ) -> Result<Vec<Vec<Self::Receipt>>, ProviderError>;
}

Client trait for fetching receipt data.

Required Associated Types

type Receipt: Receipt

The receipt type.

Required Methods

fn receipt(&self, id: u64) -> Result<Option<Self::Receipt>, ProviderError>

Get receipt by transaction number

Returns None if the transaction is not found.

fn receipt_by_hash( &self, hash: FixedBytes<32>, ) -> Result<Option<Self::Receipt>, ProviderError>

Get receipt by transaction hash.

Returns None if the transaction is not found.

fn receipts_by_block( &self, block: HashOrNumber, ) -> Result<Option<Vec<Self::Receipt>>, ProviderError>

Get receipts by block num or hash.

Returns None if the block is not found.

fn receipts_by_tx_range( &self, range: impl RangeBounds<u64>, ) -> Result<Vec<Self::Receipt>, ProviderError>

Get receipts by tx range.

fn receipts_by_block_range( &self, block_range: RangeInclusive<u64>, ) -> Result<Vec<Vec<Self::Receipt>>, ProviderError>

Get receipts by block range.

Returns a vector where each element contains all receipts for a block in the range. The outer vector index corresponds to blocks in the range (block_range.start() + index). Empty blocks will have empty inner vectors.

This is more efficient than calling receipts_by_block multiple times for contiguous ranges because it can leverage the underlying receipts_by_tx_range for the entire transaction span.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

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

where T: 'a + ReceiptProvider + ?Sized,

type Receipt = <T as ReceiptProvider>::Receipt

fn receipt( &self, id: u64, ) -> Result<Option<<&'a T as ReceiptProvider>::Receipt>, ProviderError>

fn receipt_by_hash( &self, hash: FixedBytes<32>, ) -> Result<Option<<&'a T as ReceiptProvider>::Receipt>, ProviderError>

fn receipts_by_block( &self, block: HashOrNumber, ) -> Result<Option<Vec<<&'a T as ReceiptProvider>::Receipt>>, ProviderError>

fn receipts_by_tx_range( &self, range: impl RangeBounds<u64>, ) -> Result<Vec<<&'a T as ReceiptProvider>::Receipt>, ProviderError>

fn receipts_by_block_range( &self, block_range: RangeInclusive<u64>, ) -> Result<Vec<Vec<<&'a T as ReceiptProvider>::Receipt>>, ProviderError>

impl<T> ReceiptProvider for Arc<T>

where T: ReceiptProvider + ?Sized,

type Receipt = <T as ReceiptProvider>::Receipt

fn receipt( &self, id: u64, ) -> Result<Option<<Arc<T> as ReceiptProvider>::Receipt>, ProviderError>

fn receipt_by_hash( &self, hash: FixedBytes<32>, ) -> Result<Option<<Arc<T> as ReceiptProvider>::Receipt>, ProviderError>

fn receipts_by_block( &self, block: HashOrNumber, ) -> Result<Option<Vec<<Arc<T> as ReceiptProvider>::Receipt>>, ProviderError>

fn receipts_by_tx_range( &self, range: impl RangeBounds<u64>, ) -> Result<Vec<<Arc<T> as ReceiptProvider>::Receipt>, ProviderError>

fn receipts_by_block_range( &self, block_range: RangeInclusive<u64>, ) -> Result<Vec<Vec<<Arc<T> as ReceiptProvider>::Receipt>>, ProviderError>

Implementors

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

where C: Send + Sync, N: NodePrimitives,

type Receipt = <N as NodePrimitives>::Receipt

impl<N: NodePrimitives<SignedTx: Decompress + SignedTransaction, Receipt: Decompress>> ReceiptProvider for StaticFileJarProvider<'_, N>

type Receipt = <N as NodePrimitives>::Receipt

impl<N: NodePrimitives<SignedTx: Value + SignedTransaction, Receipt: Value>> ReceiptProvider for StaticFileProvider<N>

type Receipt = <N as NodePrimitives>::Receipt

impl<N: ProviderNodeTypes> ReceiptProvider for BlockchainProvider<N>

type Receipt = <<N as NodeTypes>::Primitives as NodePrimitives>::Receipt

impl<N: ProviderNodeTypes> ReceiptProvider for ProviderFactory<N>

type Receipt = <<N as NodeTypes>::Primitives as NodePrimitives>::Receipt

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

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

Available on crate features test-utils only.

type Receipt = <T as NodePrimitives>::Receipt

impl<TX: DbTx + 'static, N: NodeTypesForProvider> ReceiptProvider for DatabaseProvider<TX, N>

type Receipt = <<N as NodeTypes>::Primitives as NodePrimitives>::Receipt