getTransaction #

Returns information about a Transaction given a hash or block identifier.

Usage #

import { publicClient } from './client'

const transaction = await publicClient.getTransaction({ 
  hash: '0x4ca7ee652d57678f26e887c149ab0735f41de37bcad58c9f6d3ed5824f15b74d'
})
/**
 * {
 *  blockHash: '0xaf1dadb8a98f1282e8f7b42cc3da8847bfa2cf4e227b8220403ae642e1173088',
 *  blockNumber: 15132008n,
 *  from: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
 *  ...
 * }
 */

import { createPublicClient, http } from 'viem'
import { mainnet } from 'viem/chains'

export const publicClient = createPublicClient({
  chain: mainnet,
  transport: http()
})

Returns #

Transaction

The transaction information.

Parameters #

hash (optional) #

• Type: '0x${string}'

Get information about a transaction given a transaction hash.

const transaction = await publicClient.getTransaction({
  hash: '0x4ca7ee652d57678f26e887c149ab0735f41de37bcad58c9f6d3ed5824f15b74d' 
})

blockHash (optional) #

• Type: '0x${string}'

Get information about a transaction given a block hash (and index).

const transaction = await publicClient.getTransaction({
  blockHash: '0x4ca7ee652d57678f26e887c149ab0735f41de37bcad58c9f6d3ed5824f15b74d', 
  index: 0
})

blockNumber (optional) #

• Type: '0x${string}'

Get information about a transaction given a block number (and index).

const transaction = await publicClient.getTransaction({
  blockNumber: 69420n, 
  index: 0
})

blockTag (optional) #

• Type: 'latest' | 'earliest' | 'pending' | 'safe' | 'finalized'

Get information about a transaction given a block tag (and index).

const transaction = await publicClient.getTransaction({
  blockTag: 'safe', 
  index: 0
})

index (optional) #

• Type: number

An index to be used with a block identifier (number, hash or tag).

const transaction = await publicClient.getTransaction({
  blockTag: 'safe',
  index: 0 
})

Example #

Check out the usage of getTransaction in the live Fetching Transactions Example below.

JSON-RPC Method #

eth_getTransactionByHash