Docs
Supported ChainsImmutableJSON-RPC APIAccount Methods

eth_getTransactionCount - Immutable RPC Method

Get account nonce on Immutable. Essential for transaction ordering for Web3 gaming (Gods Unchained, RavenQuest), gaming NFTs with enforced royalties, and cross-chain game assets.

Returns the number of transactions sent from an address on Immutable (the nonce).

Use Cases

  • Transaction building - Get correct nonce for new transactions
  • Account analysis - Count total outgoing transactions
  • Nonce management - Handle pending transaction queues
  • Wallet operations - Prepare transactions for Web3 gaming (Gods Unchained, RavenQuest), gaming NFTs with enforced royalties, and cross-chain game assets

Request Parameters

Request
addressDATA

20-byte address

blockParameterQUANTITY|TAG

Block number or tag (pending for next nonce)

Response Body

Response

Code Examples

Bash
curl -X POST https://api-immutable-zkevm-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionCount",
    "params": [
      "0x3A0C2Ba54D6CBd3121f01b96DFd20e99D1696c9D",
      "latest"
    ],
    "id": 1
  }'
JavaScript
import { JsonRpcProvider } from 'ethers';

const provider = new JsonRpcProvider('https://api-immutable-zkevm-mainnet.n.dwellir.com/YOUR_API_KEY');

const address = '0x3A0C2Ba54D6CBd3121f01b96DFd20e99D1696c9D';
const nonce = await provider.getTransactionCount(address);
console.log('Nonce:', nonce);

// Get pending nonce for new transaction
const pendingNonce = await provider.getTransactionCount(address, 'pending');
console.log('Next nonce:', pendingNonce);
Python
from web3 import Web3

w3 = Web3(Web3.HTTPProvider('https://api-immutable-zkevm-mainnet.n.dwellir.com/YOUR_API_KEY'))

address = '0x3A0C2Ba54D6CBd3121f01b96DFd20e99D1696c9D'
nonce = w3.eth.get_transaction_count(address)
print(f'Nonce: {nonce}')

# Get pending nonce
pending_nonce = w3.eth.get_transaction_count(address, 'pending')
print(f'Next nonce: {pending_nonce}')

eth_getStorageAt

Read contract storage on Immutable. Essential for analyzing contract state for Web3 gaming (Gods Unchained, RavenQuest), gaming NFTs with enforced royalties, and cross-chain game assets.

eth_accounts

Returns a list of addresses owned by the client on Immutable. Typically returns an empty array on public RPC endpoints.

On this page

Use Cases
Code Examples
Related Methods