For the complete documentation index, see llms.txt. This page is also available as Markdown.

eth_getTransactionCount

This behavior is disabled by default and only enabled for allowlisted originators. If you would like it enabled for your custom endpoint, please let us know.

If eth_getTransactionCount is submitted with the "pending" param, Blink intercepts the call, looks up the most recent transaction it has accepted for that address within the last 3 hours — or the last 96 seconds if you use revert protection — and returns the greater of:

  • the node's pending transaction count, and

  • Blink's latest recorded nonce for that address + 1

If Blink has no recent transaction for the address, or the node's pending count is higher, the node response is returned unchanged.

Only transactions Blink accepted for submission are counted. A transaction we declined does not raise the nonce, so you are never handed a nonce that skips one we never forwarded.

The shorter window for revert protection is deliberate: those submissions are dropped after 96 seconds, so past that point the nonce is free again and bumping past it would hand you a gap.

All calls with a block tag other than "pending" (for example "latest" or "earliest") will return responses directly from our Ethereum nodes.

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_getTransactionCount",
  "params": [
    "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97",
    "pending"
  ]
}

Example response

Last updated