Struct TransactionReceipt 

pub struct TransactionReceipt {
    pub block_ref: BlockInfo,
    pub tx_ref: TransactionRef,
    /* private fields */
}

Detailed information about where a transaction was found on chain.

Fields

block_ref: BlockInfo

tx_ref: TransactionRef

Implementations

impl TransactionReceipt

pub fn new(client: Client, block: BlockInfo, tx: TransactionRef) -> Self

Wraps the provided block and transaction references without performing network IO.

pub async fn block_state(&self) -> Result<BlockState, Error>

Returns the current lifecycle state of the containing block.

Returns

• Ok(BlockState) on success.
• Err(Error) if the RPC request fails or the node cannot provide the block state.

pub async fn tx<T: HasHeader + Decode>( &self, ) -> Result<BlockTransaction<T>, Error>

Fetches and decodes the transaction at the recorded index within the block.

Returns

• Ok(BlockTransaction<T>) when the transaction exists and can be decoded as T.
• Err(Error) if the transaction is missing, cannot be decoded, or any RPC call fails.

pub async fn ext<T: HasHeader + Decode>( &self, ) -> Result<BlockExtrinsic<T>, Error>

Fetches and decodes the extrinsic at the recorded index within the block.

Returns

• Ok(BlockExtrinsic<T>) when the extrinsic exists and decodes as T.
• Err(Error) when the extrinsic is missing, cannot be decoded as T, or RPC access fails.

pub async fn call<T: HasHeader + Decode>(&self) -> Result<T, Error>

Fetches just the call payload for the extrinsic at the recorded index.

Returns

• Ok(T) when the extrinsic exists and its call decodes as T.
• Err(Error) otherwise (missing extrinsic, decode failure, or RPC error).

pub async fn raw_ext( &self, encode_as: EncodeSelector, ) -> Result<BlockRawExtrinsic, Error>

Returns the raw extrinsic bytes or a different encoding if requested.

Returns

• Ok(BlockRawExtrinsic) with the requested encoding.
• Err(Error) when the extrinsic cannot be found or an RPC failure occurs.

pub async fn events(&self) -> Result<ExtrinsicEvents, Error>

Fetches the events emitted as part of the transaction execution.

Returns

• Ok(ExtrinsicEvents) when the extrinsic exists and events are available.
• Err(Error) when the events cannot be located or fetched.

pub async fn from_range( client: Client, tx_hash: impl Into<HashString>, block_start: u32, block_end: u32, use_best_block: bool, ) -> Result<Option<TransactionReceipt>, Error>

Iterates block-by-block from block_start through block_end (inclusive) looking for an extrinsic whose hash matches tx_hash.

Returns Ok(Some(TransactionReceipt)) as soon as a match is found, Ok(None) when the entire range has been exhausted without a match, and bubbles up any RPC or subscription errors encountered along the way.

Fails fast with a validation error when block_start > block_end. When use_best_block is true, the search follows the node’s best chain; otherwise it restricts the iteration to finalized blocks only.

Trait Implementations

impl Clone for TransactionReceipt

fn clone(&self) -> TransactionReceipt

Returns a duplicate of the value.

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

Performs copy-assignment from source.