getTransactionCount

Returns the number of Transactions an Account has broadcast / sent.

Usage

example.tsclient.ts

import { publicClient } from './client'

const transactionCount = await publicClient.getTransactionCount({  
  address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
})
// 420

import { publicClient } from './client'

const transactionCount = await publicClient.getTransactionCount({  
  address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
})
// 420

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

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

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

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

Returns

number

The number of transactions an account has sent.

Parameters

address

Type: Address

The address of the account.

const transactionCount = await publicClient.getTransactionCount({
  address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e', 
})

const transactionCount = await publicClient.getTransactionCount({
  address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e', 
})

blockNumber

Type: bigint

Get the count at a block number.

const transactionCount = await publicClient.getTransactionCount({
  address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
  blockNumber: 69420n  
})

const transactionCount = await publicClient.getTransactionCount({
  address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
  blockNumber: 69420n  
})

blockTag

Type: bigint

Get the count at a block tag.

const transactionCount = await publicClient.getTransactionCount({
  address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
  blockTag: 'safe'  
})

const transactionCount = await publicClient.getTransactionCount({
  address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
  blockTag: 'safe'  
})

Notes

The transaction count of an account can also be used as a nonce.

Example

JSON-RPC Method

eth_getTransactionCount

getTransactionCount ​

Usage ​

Returns ​

Parameters ​

address ​

blockNumber ​

blockTag ​

Notes ​

Example ​

JSON-RPC Method ​