eth_getBlockReceipts | Polygon

​

Parameters

• quantity or tag — the block hash, block number encoded as hexadecimal, or the string with:
  • latest — the most recent block in the blockchain and the current state of the blockchain at the most recent block
  • earliest — the earliest available or genesis block
  • pending — the pending state and transactions block. The current state of transactions that have been broadcast to the network but have not yet been included in a block.

​

Response

• result — an array of objects with the following fields:
  • Transaction receipt — the object with:
    • blockHash — the block hash. Identifies the block in which the transaction was included. This field is null for transactions that have not yet been included in a block.
    • blockNumber — the number of the block in which the transaction was included. This field is null for transactions that have not yet been included in a block.
    • contractAddress — the address of the contract created by the transaction if it was a contract creation transaction. Otherwise, the value is null.
    • cumulativeGasUsed — the total amount of gas used in the block until this transaction was executed.
    • effectiveGasPrice — the actual value deducted from the sender’s account for this transaction.
    • from — the address of the sender who initiated the transaction.
    • gasUsed — the amount of gas used by this specific transaction alone.
    • logs — an array of log objects generated by this transaction, if any. Logs are generated by smart contracts.
    • logsBloom — the bloom filter used by light clients to quickly retrieve logs related to the transaction.
    • status — the success status of the transaction, represented as 1 for success or 0 for failure.
    • to — the address of the recipient of the transaction if it was a transaction to an address. For contract creation transactions, this field is null.
    • transactionHash — the hash that uniquely identifies the transaction.
    • transactionIndex — the index of the transaction within the block.
    • type — the type of the transaction. 0 indicates a regular transfer; 2 indicates a contract creation or smart contract function call.

​

eth_getBlockReceipts code examples

/* 
eth_getBlockReceipts is not available in Web3.js
Create a custom class using web3.extend to implement it
*/

const Web3 = require("web3");
const NODE_URL = "CHAINSTACK_NODE_URL";
const web3 = new Web3(NODE_URL);

web3.extend({
    property: 'eth',
    methods: [{
      name: 'getBlockReceipts',
      call: 'eth_getBlockReceipts',
      params: 1,
      inputFormatter: [web3.extend.formatters.inputDefaultBlockNumberFormatter],
      outputFormatter: null
    }]
  });

async function getBlockReceipts(blockId) {
  const receipts = await web3.eth.getBlockReceipts(blockId)
  console.log(receipts)
}
  
getBlockReceipts("latest")

​

Use case

const ethers = require('ethers');
const NODE_URL = 'CHAINSTACK_NODE_URL';
const provider = new ethers.JsonRpcProvider(NODE_URL);

async function retrieveTransactionLogs(blockNumber) {
  
    // Call the eth_getBlockReceipts method to retrieve the receipts for all transactions in the block
    let receipts = await provider.send('eth_getBlockReceipts', [blockNumber]);

    // Flatten the receipts array into a single array of logs
    let logs = receipts.flatMap(receipt => receipt.logs);

    // Return the logs
    return logs;
}

// call retrieveTransactionLogs on the latest block of the chain
async function main() {
     const blockNumber = 'latest';
    const logs = await retrieveTransactionLogs(blockNumber);
    console.log(logs);
}

main()