eth_getTransactionCount | Plasma RPC Docs

Get the number of transactions sent from an address (nonce) on Plasma. Essential for nonce management, transaction signing, and detecting stuck transactions.

Returns the number of transactions sent from an address on Plasma, commonly known as the nonce. The nonce is required for every outbound transaction to ensure correct ordering and prevent replay attacks.

Why Plasma? Build on an EVM Layer 1 for stablecoin payments with PlasmaBFT consensus and Reth execution with 1 second blocks, XPL gas, full EVM JSON-RPC, and debug plus txpool on Dwellir.

When to Use This Method

eth_getTransactionCount is essential for payment app developers, wallet teams, and teams shipping Solidity contracts for dollar transfers:

Transaction Signing - Get the correct nonce before building and signing a new transaction on Plasma
Nonce Gap Detection - Compare latest and pending nonces to identify stuck or dropped transactions in the mempool
Account Activity Analysis - Track the total number of outgoing transactions from any address on stablecoin transfers, payment apps, and wallets that need 1 second confirmation
Batch Transaction Sequencing - Assign sequential nonces when submitting multiple transactions from the same address

JSON-RPC request

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
    "latest"
  ],
  "id": 1
}

Code Examples

Bash

curl -X POST https://api-plasma-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionCount",
    "params": [
      "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
      "latest"
    ],
    "id": 1
  }'

Common Use Cases

1. Safe Transaction Sender with Nonce Management

Build a transaction sender that handles nonces correctly on Plasma:

JavaScript

import { JsonRpcProvider, Wallet, parseEther } from 'ethers';

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

class TransactionSender {
  constructor(privateKey) {
    this.wallet = new Wallet(privateKey, provider);
    this.localNonce = null;
  }

  async getNextNonce() {
    // Get the pending nonce from the network
    const pendingNonce = await provider.getTransactionCount(
      this.wallet.address, 'pending'
    );

    // Use whichever is higher: local tracker or network pending
    if (this.localNonce === null || pendingNonce > this.localNonce) {
      this.localNonce = pendingNonce;
    }

    const nonce = this.localNonce;
    this.localNonce++;
    return nonce;
  }

  async sendTransaction(to, valueEth) {
    const nonce = await this.getNextNonce();

    const tx = await this.wallet.sendTransaction({
      to,
      value: parseEther(valueEth),
      nonce
    });

    console.log(`Sent tx ${tx.hash} with nonce ${nonce}`);
    return tx;
  }

  // Reset local nonce tracker (e.g., after errors)
  resetNonce() {
    this.localNonce = null;
  }
}

2. Stuck Transaction Detector

Detect and report stuck transactions by comparing nonces:

JavaScript

async function detectStuckTransactions(provider, address) {
  const confirmedNonce = await provider.getTransactionCount(address, 'latest');
  const pendingNonce = await provider.getTransactionCount(address, 'pending');

  const pendingCount = pendingNonce - confirmedNonce;

  if (pendingCount === 0) {
    console.log('No pending transactions');
    return { status: 'clear', pendingCount: 0 };
  }

  console.log(`${pendingCount} pending transaction(s) detected`);
  console.log(`Confirmed nonce: ${confirmedNonce}`);
  console.log(`Pending nonce: ${pendingNonce}`);
  console.log(`Stuck nonces: ${confirmedNonce} to ${pendingNonce - 1}`);

  return {
    status: 'stuck',
    pendingCount,
    confirmedNonce,
    pendingNonce,
    stuckNonces: Array.from(
      { length: pendingCount },
      (_, i) => confirmedNonce + i
    )
  };
}

// Usage
const result = await detectStuckTransactions(provider, '0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb');
if (result.status === 'stuck') {
  console.log('Consider replacing transactions at nonces:', result.stuckNonces);
}

3. Batch Transaction Submitter

Submit multiple transactions in sequence with correct nonce ordering:

JavaScript

async function sendBatchTransactions(wallet, transactions) {
  const startNonce = await provider.getTransactionCount(
    wallet.address, 'pending'
  );

  console.log(`Sending ${transactions.length} transactions starting at nonce ${startNonce}`);

  const receipts = [];
  for (let i = 0; i < transactions.length; i++) {
    const nonce = startNonce + i;
    const tx = await wallet.sendTransaction({
      ...transactions[i],
      nonce
    });

    console.log(`Tx ${i + 1}/${transactions.length} sent: ${tx.hash} (nonce: ${nonce})`);
    receipts.push(tx);
  }

  // Wait for all to confirm
  const confirmed = await Promise.all(
    receipts.map(tx => tx.wait())
  );

  console.log(`All ${confirmed.length} transactions confirmed`);
  return confirmed;
}

// Usage
const transactions = [
  { to: '0xRecipient1...', value: parseEther('0.1') },
  { to: '0xRecipient2...', value: parseEther('0.2') },
  { to: '0xRecipient3...', value: parseEther('0.05') }
];

await sendBatchTransactions(wallet, transactions);

Best Practices

Always use pending block tag when fetching the nonce for a new transaction to avoid nonce collisions
Track nonces locally with a monotonic counter that syncs with the pending nonce from the network on reset
If pending nonce equals latest nonce, no stuck transactions exist -- the account is clean
For high-throughput applications (multiple transactions per second), implement a local nonce manager with retry logic
The nonce starts at 0 for new accounts and increments by 1 for each confirmed outbound transaction

Error Handling

Common errors and solutions:

Error Code	Description	Solution
-32602	Invalid params	Verify the address is a valid 20-byte hex string and the block parameter is valid
-32603	Internal error	Retry with exponential backoff
-32000	Block not found	The requested block may be pruned - use `latest` or `pending`
-32005	Rate limit exceeded	Implement caching for nonce lookups

JavaScript

async function safeGetNonce(provider, address, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await provider.getTransactionCount(address, 'pending');
    } catch (error) {
      if (error.code === -32005) {
        await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000));
        continue;
      }
      if (i === maxRetries - 1) throw error;
      await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000));
    }
  }
}

eth_sendRawTransaction - Send a signed transaction to the network
eth_getBalance - Get the ETH balance of an address
eth_getTransactionByHash - Get transaction details by hash
eth_getTransactionReceipt - Get the receipt of a confirmed transaction

Why Plasma? Build on an EVM Layer 1 for stablecoin payments with PlasmaBFT consensus and Reth execution with 1 second blocks, XPL gas, full EVM JSON-RPC, and debug plus txpool on Dwellir.

When to Use This Method

eth_getTransactionCount is essential for payment app developers, wallet teams, and teams shipping Solidity contracts for dollar transfers:

Transaction Signing - Get the correct nonce before building and signing a new transaction on Plasma
Nonce Gap Detection - Compare latest and pending nonces to identify stuck or dropped transactions in the mempool
Account Activity Analysis - Track the total number of outgoing transactions from any address on stablecoin transfers, payment apps, and wallets that need 1 second confirmation
Batch Transaction Sequencing - Assign sequential nonces when submitting multiple transactions from the same address

JSON-RPC request

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
    "latest"
  ],
  "id": 1
}

Code Examples

Bash

curl -X POST https://api-plasma-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionCount",
    "params": [
      "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
      "latest"
    ],
    "id": 1
  }'

Common Use Cases

1. Safe Transaction Sender with Nonce Management

Build a transaction sender that handles nonces correctly on Plasma:

JavaScript

import { JsonRpcProvider, Wallet, parseEther } from 'ethers';

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

class TransactionSender {
  constructor(privateKey) {
    this.wallet = new Wallet(privateKey, provider);
    this.localNonce = null;
  }

  async getNextNonce() {
    // Get the pending nonce from the network
    const pendingNonce = await provider.getTransactionCount(
      this.wallet.address, 'pending'
    );

    // Use whichever is higher: local tracker or network pending
    if (this.localNonce === null || pendingNonce > this.localNonce) {
      this.localNonce = pendingNonce;
    }

    const nonce = this.localNonce;
    this.localNonce++;
    return nonce;
  }

  async sendTransaction(to, valueEth) {
    const nonce = await this.getNextNonce();

    const tx = await this.wallet.sendTransaction({
      to,
      value: parseEther(valueEth),
      nonce
    });

    console.log(`Sent tx ${tx.hash} with nonce ${nonce}`);
    return tx;
  }

  // Reset local nonce tracker (e.g., after errors)
  resetNonce() {
    this.localNonce = null;
  }
}

2. Stuck Transaction Detector

Detect and report stuck transactions by comparing nonces:

JavaScript

async function detectStuckTransactions(provider, address) {
  const confirmedNonce = await provider.getTransactionCount(address, 'latest');
  const pendingNonce = await provider.getTransactionCount(address, 'pending');

  const pendingCount = pendingNonce - confirmedNonce;

  if (pendingCount === 0) {
    console.log('No pending transactions');
    return { status: 'clear', pendingCount: 0 };
  }

  console.log(`${pendingCount} pending transaction(s) detected`);
  console.log(`Confirmed nonce: ${confirmedNonce}`);
  console.log(`Pending nonce: ${pendingNonce}`);
  console.log(`Stuck nonces: ${confirmedNonce} to ${pendingNonce - 1}`);

  return {
    status: 'stuck',
    pendingCount,
    confirmedNonce,
    pendingNonce,
    stuckNonces: Array.from(
      { length: pendingCount },
      (_, i) => confirmedNonce + i
    )
  };
}

// Usage
const result = await detectStuckTransactions(provider, '0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb');
if (result.status === 'stuck') {
  console.log('Consider replacing transactions at nonces:', result.stuckNonces);
}

3. Batch Transaction Submitter

Submit multiple transactions in sequence with correct nonce ordering:

JavaScript

async function sendBatchTransactions(wallet, transactions) {
  const startNonce = await provider.getTransactionCount(
    wallet.address, 'pending'
  );

  console.log(`Sending ${transactions.length} transactions starting at nonce ${startNonce}`);

  const receipts = [];
  for (let i = 0; i < transactions.length; i++) {
    const nonce = startNonce + i;
    const tx = await wallet.sendTransaction({
      ...transactions[i],
      nonce
    });

    console.log(`Tx ${i + 1}/${transactions.length} sent: ${tx.hash} (nonce: ${nonce})`);
    receipts.push(tx);
  }

  // Wait for all to confirm
  const confirmed = await Promise.all(
    receipts.map(tx => tx.wait())
  );

  console.log(`All ${confirmed.length} transactions confirmed`);
  return confirmed;
}

// Usage
const transactions = [
  { to: '0xRecipient1...', value: parseEther('0.1') },
  { to: '0xRecipient2...', value: parseEther('0.2') },
  { to: '0xRecipient3...', value: parseEther('0.05') }
];

await sendBatchTransactions(wallet, transactions);

Best Practices

Always use pending block tag when fetching the nonce for a new transaction to avoid nonce collisions
Track nonces locally with a monotonic counter that syncs with the pending nonce from the network on reset
If pending nonce equals latest nonce, no stuck transactions exist -- the account is clean
For high-throughput applications (multiple transactions per second), implement a local nonce manager with retry logic
The nonce starts at 0 for new accounts and increments by 1 for each confirmed outbound transaction

Error Handling

Common errors and solutions:

Error Code	Description	Solution
-32602	Invalid params	Verify the address is a valid 20-byte hex string and the block parameter is valid
-32603	Internal error	Retry with exponential backoff
-32000	Block not found	The requested block may be pruned - use `latest` or `pending`
-32005	Rate limit exceeded	Implement caching for nonce lookups

JavaScript

async function safeGetNonce(provider, address, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await provider.getTransactionCount(address, 'pending');
    } catch (error) {
      if (error.code === -32005) {
        await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000));
        continue;
      }
      if (i === maxRetries - 1) throw error;
      await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000));
    }
  }
}

eth_sendRawTransaction - Send a signed transaction to the network
eth_getBalance - Get the ETH balance of an address
eth_getTransactionByHash - Get transaction details by hash
eth_getTransactionReceipt - Get the receipt of a confirmed transaction

eth_getTransactionCount - Plasma RPC Method

When to Use This Method

Code Examples

Common Use Cases

1. Safe Transaction Sender with Nonce Management

2. Stuck Transaction Detector

3. Batch Transaction Submitter

Best Practices

Error Handling

On this page

eth_getTransactionCount - Plasma RPC Method

When to Use This Method

Code Examples

Common Use Cases

1. Safe Transaction Sender with Nonce Management

2. Stuck Transaction Detector

3. Batch Transaction Submitter

Best Practices

Error Handling

On this page

eth_getTransactionCount - Plasma RPC Method

When to Use This MethodCopy Anchor Link

Code ExamplesCopy Anchor Link

Common Use CasesCopy Anchor Link

1. Safe Transaction Sender with Nonce ManagementCopy Anchor Link

2. Stuck Transaction DetectorCopy Anchor Link

3. Batch Transaction SubmitterCopy Anchor Link

Best PracticesCopy Anchor Link

Error HandlingCopy Anchor Link

Related MethodsCopy Anchor Link

On this page

eth_getTransactionCount - Plasma RPC Method

When to Use This MethodCopy Anchor Link

Code ExamplesCopy Anchor Link

Common Use CasesCopy Anchor Link

1. Safe Transaction Sender with Nonce ManagementCopy Anchor Link

2. Stuck Transaction DetectorCopy Anchor Link

3. Batch Transaction SubmitterCopy Anchor Link

Best PracticesCopy Anchor Link

Error HandlingCopy Anchor Link

Related MethodsCopy Anchor Link

On this page

When to Use This Method

Code Examples

Common Use Cases

1. Safe Transaction Sender with Nonce Management

2. Stuck Transaction Detector

3. Batch Transaction Submitter

Best Practices

Error Handling

Related Methods

When to Use This Method

Code Examples

Common Use Cases

1. Safe Transaction Sender with Nonce Management

2. Stuck Transaction Detector

3. Batch Transaction Submitter

Best Practices

Error Handling

Related Methods