eth_getTransactionByHash | Polygon

Polygon API method that returns the information about a transaction from the transaction hash. It is used to retrieve information about a specific transaction by its hash. The method returns an object with details about the transaction, such as the sender, recipient, gas used, transaction value, and more.

👍

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 identifying a transaction

Response

  • object — the 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. This field 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_getTransactionByHash code examples

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

async function getTransaction(transactionHash) {
 const transaction = await web3.eth.getTransaction(transactionHash)
 console.log(transaction)
}

getTransaction("0xcaed5e30e2ee09f7e9d8af1fad282924749e79ca1ed7598a4dce073b7443fcbe")
const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.providers.JsonRpcProvider(NODE_URL);

const getTransaction = async (transactionHash) => {
    const transaction = await provider.send("eth_getTransactionByHash", [transactionHash]);
    console.log(transaction);
  };

getTransaction("0xcaed5e30e2ee09f7e9d8af1fad282924749e79ca1ed7598a4dce073b7443fcbe")
from web3 import Web3  
node_url = "CHAINSTACK_NODE_URL" 

web3 = Web3(Web3.HTTPProvider(node_url)) 
print(web3.eth.get_transaction("0x4b22e75f12d8d68a8b3d174782b75bdbfa51f489cfd7127ecdd70d10483984c5")) 

Use case

One use case for eth_getTransactionByHash is to inspect a specific transaction and display information about it, such as the address that was sent, the block it was included in, and the number of transactions the sender sent so far (nonce). This information can be useful for monitoring and analyzing transactions.

Here's an example of how you can achieve this in web3.js:

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

async function getTransaction(transactionHash) {
  // Get the transaction using the provided transaction hash
  const transaction = await web3.eth.getTransaction(transactionHash)

	// Store the desired parameters in constants
  const sender = transaction.from;
  const block = transaction.blockNumber
  const transactionsCount = transaction.nonce

  // Log the transaction information to the console
  console.log(`Transaction ${transactionHash} was sent from address ${sender}`);
  console.log(`It was included in block ${block}`);
  console.log(`The sender has sent ${transactionsCount} transactions so far\n`);
 }
 
 getTransaction("0xcaed5e30e2ee09f7e9d8af1fad282924749e79ca1ed7598a4dce073b7443fcbe")

In this example, the program starts by connecting to a node endpoint. Then, call the eth_getTransactionByHash method and pass in the transaction hash as an argument. The method returns a Promise that resolves to a transaction object, which is used to retrieve the sender address, the block number the transaction was included in, and the address nonce.

The last step is to log the information to the console.

📘

Note that the desired parameters are stored in constants, so you can use them for further processing.

Try the eth_getTransactionByHash RPC method yourself

Language
Click Try It! to start a request and see the response here!