thirdwebDocs
GitHub

eth_getTransactionReceipt

Retrieves the transaction receipt for a given transaction hash. Throws an error if the receipt is not found.

Example

import {
  getRpcClient,
  eth_getTransactionReceipt,
} from "thirdweb/rpc";
const rpcRequest = getRpcClient({ client, chain });
const transactionReceipt = await eth_getTransactionReceipt(
  rpcRequest,
  {
    hash: "0x...",
  },
);
function eth_getTransactionReceipt(
  request: EIP1193RequestFn<
    [
      {
        Method: "web3_clientVersion";
        Parameters?: undefined;
        ReturnType: string;
      },
      {
        Method: "web3_sha3";
        Parameters: [data: `0x${string}`];
        ReturnType: string;
      },
      {
        Method: "net_listening";
        Parameters?: undefined;
        ReturnType: boolean;
      },
      {
        Method: "net_peerCount";
        Parameters?: undefined;
        ReturnType: `0x${string}`;
      },
      {
        Method: "net_version";
        Parameters?: undefined;
        ReturnType: `0x${string}`;
      },
    ]
  >,
  params: GetTransactionReceiptParameters,
): Promise<TransactionReceipt>;

Parameters

The EIP1193 request function.

Type

let request: EIP1193RequestFn<
  [
    {
      Method: "web3_clientVersion";
      Parameters?: undefined;
      ReturnType: string;
    },
    {
      Method: "web3_sha3";
      Parameters: [data: `0x${string}`];
      ReturnType: string;
    },
    {
      Method: "net_listening";
      Parameters?: undefined;
      ReturnType: boolean;
    },
    {
      Method: "net_peerCount";
      Parameters?: undefined;
      ReturnType: `0x${string}`;
    },
    {
      Method: "net_version";
      Parameters?: undefined;
      ReturnType: `0x${string}`;
    },
  ]
>;

The parameters for retrieving the transaction receipt.

Type

let params: GetTransactionReceiptParameters;

Returns

let returnType: {
  blobGasPrice?: quantity;
  blobGasUsed?: quantity;
  blockHash: Hash;
  blockNumber: quantity;
  contractAddress: Address | null | undefined;
  cumulativeGasUsed: quantity;
  effectiveGasPrice: quantity;
  from: Address;
  gasUsed: quantity;
  logs: Array<Log<quantity, index, false>>;
  logsBloom: Hex;
  root?: Hash;
  status: status;
  to: Address | null;
  transactionHash: Hash;
  transactionIndex: index;
  type: type;
};

A promise that resolves to the transaction receipt.