Arbitrum One · txpool

txpool_content

Returns the contents of the transaction pool.

Returns an object containing all pending and queued transactions in the pool, grouped by origin address and sorted by nonce. Pending transactions are ready for inclusion in the next block(s). Queued transactions have nonce gaps and are scheduled for future execution.

Result

Transaction pool content

Schema

{
  "type": "object",
  "title": "Transaction pool content",
  "description": "All pending and queued transactions in the pool, grouped by address and nonce.",
  "properties": {
    "pending": {
      "type": "object",
      "title": "pending transactions",
      "description": "Transactions ready for inclusion in the next block(s)"
    },
    "queued": {
      "type": "object",
      "title": "queued transactions",
      "description": "Transactions with nonce gaps awaiting preceding transactions before they can be executed"
    }
  },
  "required": [
    "pending",
    "queued"
  ]
}

Example request

Endpoint: https://your-arb-node.azxa.io

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "txpool_content",
  "params": []
}

Example response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "pending": {
      "0x0216d5032f356960cd3749c31ab34eeff21b3395": {
        "806": {
          "blockHash": null,
          "blockNumber": null,
          "from": "0x0216d5032f356960cd3749c31ab34eeff21b3395",
          "gas": "0x5208",
          "gasPrice": "0xba43b7400",
          "hash": "0xaf953a2d01f55cfe080c0c94150a60105e8ac3d51153058a1f03dd239dd08586",
          "input": "0x",
          "nonce": "0x326",
          "to": "0x7f69a91a3cf4be60020fb58b893b7cbb65376db8",
          "transactionIndex": null,
          "value": "0x19a99f0cf456000"
        }
      }
    },
    "queued": {
      "0x0216d5032f356960cd3749c31ab34eeff21b3395": {
        "808": {
          "blockHash": null,
          "blockNumber": null,
          "from": "0x0216d5032f356960cd3749c31ab34eeff21b3395",
          "gas": "0x5208",
          "gasPrice": "0xba43b7400",
          "hash": "0x593f723c6f7abc7878c4927d2f1a0e6c5a6c0b4c9f5a7b2e3d4c5f6a7b8c9d0e",
          "input": "0x",
          "nonce": "0x328",
          "to": "0x7f69a91a3cf4be60020fb58b893b7cbb65376db8",
          "transactionIndex": null,
          "value": "0x19a99f0cf456000"
        }
      }
    }
  }
}

Test fixture

Fixture: get-content

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "txpool_content"
}

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "pending": {
      "0x0c2c51a0990AeE1d73C1228de158688341557508": {
        "0": {
          "blockHash": null,
          "blockNumber": null,
          "blockTimestamp": null,
          "from": "…",
          "gas": "…",
          "gasPrice": "…",
          "hash": "…",
          "input": "…",
          "nonce": "…",
          "to": "…",
          "transactionIndex": null,
          "value": "…",
          "…": "5 more fields"
        },
        "1": {
          "blockHash": null,
          "blockNumber": null,
          "blockTimestamp": null,
          "from": "…",
          "gas": "…",
          "gasPrice": "…",
          "maxFeePerGas": "…",
          "maxPriorityFeePerGas": "…",
          "hash": "…",
          "input": "…",
          "nonce": "…",
          "to": null,
          "…": "9 more fields"
        },
        "2": {
          "blockHash": null,
          "blockNumber": null,
          "blockTimestamp": null,
          "from": "…",
          "gas": "…",
          "gasPrice": "…",
          "hash": "…",
          "input": "…",
          "nonce": "…",
          "to": "…",
          "transactionIndex": null,
          "value": "…",
          "…": "7 more fields"
        },
        "3": {
          "blockHash": null,
          "blockNumber": null,
          "blockTimestamp": null,
          "from": "…",
          "gas": "…",
          "gasPrice": "…",
          "maxFeePerGas": "…",
          "maxPriorityFeePerGas": "…",
          "hash": "…",
          "input": "…",
          "nonce": "…",
          "to": "…",
          "…": "9 more fields"
        }
      },
      "0x14e46043e63D0E3cdcf2530519f4cFAf35058Cb2": {
        "0": {
          "blockHash": null,
          "blockNumber": null,
          "blockTimestamp": null,
          "from": "…",
          "gas": "…",
          "gasPrice": "…",
          "maxFeePerGas": "…",
          "maxPriorityFeePerGas": "…",
          "hash": "…",
          "input": "…",
          "nonce": "…",
          "to": "…",
          "…": "9 more fields"
        }
      }
    },
    "queued": {}
  }
}

cURL

curl -X POST https://your-arb-node.azxa.io \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"txpool_content","params":[]}'