Trait ReceiptProvider

pub trait ReceiptProvider: Send + Sync {
    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", so this trait is not object safe.

Implementations on Foreign Types

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

where T: 'a + ReceiptProvider + ?Sized, &'a T: Send + Sync,

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, Arc<T>: Send + Sync,

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> ReceiptProvider for BlockchainProvider<N>

where N: ProviderNodeTypes,

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

impl<N> ReceiptProvider for StaticFileJarProvider<'_, N>

where N: NodePrimitives, <N as NodePrimitives>::SignedTx: Decompress + SignedTransaction, <N as NodePrimitives>::Receipt: Decompress,

type Receipt = <N as NodePrimitives>::Receipt

impl<N> ReceiptProvider for StaticFileProvider<N>

where N: NodePrimitives, <N as NodePrimitives>::SignedTx: Value + SignedTransaction, <N as NodePrimitives>::Receipt: Value,

type Receipt = <N as NodePrimitives>::Receipt

impl<N> ReceiptProvider for ProviderFactory<N>

where N: ProviderNodeTypes,

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

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

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

type Receipt = Receipt

impl<TX, N> ReceiptProvider for DatabaseProvider<TX, N>

where TX: DbTx + 'static, N: NodeTypesForProvider,

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