eth_getTransactionByBlockHashAndIndex | Ethereum

Ethereum API method that retrieves information about a specific transaction based on the block hash and the transaction index within the block. This information can be used to track transactions, debug issues, analyze data, and build decentralized applications on the Ethereum blockchain.

👍

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

• hash — the hash of the block
• quantity — the integer identifying the transaction index position within the block, encoded as hexadecimal

Response

• object — a transaction response object, or null if no transaction is found:
  • 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.
  • from — the address of the sender who initiated the transaction.
  • gas — the units of gas included in the transaction by the sender.
  • gasPrice — the price of gas in Wei included in the transaction by the sender.
  • maxFeePerGas — the maximum amount the sender of the transaction is willing to pay per unit of gas for the transaction to be executed.
  • maxPriorityFeePerGas — the maximum priority fee the sender of the transaction is willing to pay per unit of gas.
  • hash — the hash that uniquely identifies the transaction.
  • input — the optional input data sent with the transaction, usually used to interact with smart contracts.
  • nonce — a counter identifying the transaction's number sent by the sender wallet. It essentially identifies how many transactions an account has made. Used to ensure each transaction is executed only once.
  • 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.
  • transactionIndex — the index of the transaction within the block. It is null for transactions that have not yet been included in a block.
  • value — the value of the native token transferred along with the transaction, in Wei.
  • type — the type of the transaction. 0 indicates a regular transfer; 2 indicates a contract creation or smart contract function call.
  • accessList — a list of authorized addresses and storage keys the transaction plans to interact with.
  • v — the recovery parameter in the Ethereum Signature Algorithm (ECDSA).
  • r — the first component of the signature in the Ethereum Signature Algorithm (ECDSA).
  • s — the second component of the signature in the Ethereum Signature Algorithm (ECDSA).

eth_getTransactionByBlockHashAndIndex code examples

📘

Learn more about the ChainstackProvider in ethers.js: ethers ChainstackProvider Documentation.

const ethers = require("ethers");

// Create a ChainstackProvider instance for Ethereum mainnet
const chainstack = new ethers.ChainstackProvider("mainnet");

const getTransaction = async (blockHash, index) => {
  const transaction = await chainstack.send(
    "eth_getTransactionByBlockHashAndIndex",
    [blockHash, index]
  );
  console.log(transaction);
};

getTransaction(
  "0x6f5542b045b72ed449480bf363726e211635fe30702dafcd1907b93bd627b2e4",
  "0x3D"
);

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

async function getTransaction() {
  const transaction = await web3.eth.getTransactionFromBlock("0x6f5542b045b72ed449480bf363726e211635fe30702dafcd1907b93bd627b2e4", 22);
  console.log(transaction);
}

getTransaction();

from web3 import Web3  
node_url = "CHAINSTACK_NODE_URL" 

web3 = Web3(Web3.HTTPProvider(node_url)) 
print(web3.eth.get_transaction_by_block("0x6f5542b045b72ed449480bf363726e211635fe30702dafcd1907b93bd627b2e4", 22))

Use case

The eth_getTransactionByBlockHashAndIndex can be used to retrieve transaction details from a block. In the following example the getSendersInBlock checks how many transactions exist in a block, then receives the sender of each (from field) and displays it.

📘

Note that there are simpler ways to get this information, and this is only a practical example of how to use eth_getTransactionByBlockHashAndIndex, if the number of transactions in the block is already known, the first step can be skipped.

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

async function getSendersInBlock(blockHash) {
  const block = await web3.eth.getBlock(blockHash);
  const transactions = block.transactions;
  
  console.log(`Block ${blockHash} contains ${transactions.length} transactions`);

  for (let i = 0; i < transactions.length; i++) {
    const transaction = await web3.eth.getTransactionFromBlock(blockHash, i);
    console.log(`Sender of transaction at index ${i}:`, transaction.from);
  }
}

getSendersInBlock("0x6f5542b045b72ed449480bf363726e211635fe30702dafcd1907b93bd627b2e4");

The number of transactions in the block is determined using transactions.length and the total number of transactions logged to the console.

A for loop is then used to retrieve information about each transaction in the block. For each iteration of the loop, the code calls the web3.eth.getTransactionFromBlock method to retrieve information about the transaction at the current index. The from property of the returned transaction object is logged to the console to show the sender of the transaction.

Try the eth_getTransactionByBlockHashAndIndex RPC method yourself