Returns an address's transaction count in live, pinned, or retained execution state. Without a CLIENT, it builds a reusable READ and does not access state.
Local
Exact signatures with descriptions, requirements, inputs, returns, and examples.
nonce(CLIENT, ADDRESS) # Immediate Read · RPC required Reads the account nonce from the CLIENT's current state context; only a live CLIENT necessarily resolves latest state.
| Name | Type |
|---|---|
nonce | UBIGINT |
Account transaction count. Returns the account nonce as UBIGINT. Contract nonces and retained execution state follow the selected CLIENT context.
nonce returns the account transaction count used by EVM account state; it is not a pending-transaction queue length.
nonce(CLIENT, ADDRESS, BIGINT) # Immediate Read · RPC required Reads the account nonce at an explicit block height; older heights may require archive access.
| Name | Type | Use |
|---|---|---|
client | CLIENT Readable EVM state represented by a live, pinned, or execution CLIENT. | required positional |
address | ADDRESS Account or contract address whose transaction count should be read. | required positional |
block_number | BIGINT Explicit historical block height for a repeatable nonce read. | required positional |
| Name | Type |
|---|---|
nonce | UBIGINT |
Account transaction count. Returns the account nonce as UBIGINT. Contract nonces and retained execution state follow the selected CLIENT context.
Named parameters · RPC required
nonce(ADDRESS) # Read Builder · RPC required Builds a reusable account-nonce READ; no client is resolved and no state is accessed.
Named parameters · RPC required