Skip to content

getTransactionConfirmations

Returns the number of blocks passed (confirmations) since the transaction was processed on a block.

Usage

example.ts
import { publicClient } from './client'
 
const transactionReceipt = await publicClient.getTransactionReceipt({ hash: '...' })
const confirmations = await publicClient.getTransactionConfirmations({  
  transactionReceipt
})
// 15n

You can also fetch confirmations by Transaction hash:

example.ts
import { publicClient } from './client'
 
const confirmations = await publicClient.getTransactionConfirmations({  
  hash: '0x...'
})
15n

Returns

bigint

The number of blocks passed since the transaction was processed. If confirmations is 0, then the Transaction has not been confirmed & processed yet.

Parameters

transactionReceipt

The transaction receipt.

const balance = await publicClient.getTransactionConfirmations({
  transactionReceipt: { ... }, 
})

hash

The hash of the transaction.

const balance = await publicClient.getTransactionConfirmations({
  hash: '0x...'
})

Example

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

JSON-RPC Method

eth_getTransactionConfirmations