Admin Login
HomeGuidesAPI ReferenceChangelogBlockdaemon Main Docs
Log In
Guides

External Nonce Management

Client-supplied nonces for EVM, Solana, and Polkadot

External nonce management

Vault can assign the next nonce when it builds a transaction. Your system can also supply the nonce, and Vault will use that value. Use a client-supplied nonce to pipeline several submissions or to replace a transaction that is still pending.

The field lives on the chain parameters of the start request. It is a decimal string.

EVM

Set EVM.Nonce on makeTransaction, sponsor, or another EVM start route. The example highlights the nonce. A live transfer also sends destination and amount.

Omit Nonce and Vault reads the next nonce from the network, including transactions still in the mempool. Set Nonce and Vault puts that value on the transaction.

curl -s -X POST "https://<wallet-host>/api/cwp/operations/start/makeTransaction" \
  -H "authorization: <api-key>" \
  -H "content-type: application/json" \
  -d '{
    "OperationID": "replace-7",
    "CAIP19": "eip155:1/slip44:60",
    "Asset": "ETH",
    "Source": { "MasterKeyName": "default", "AccountName": "treasury", "AddressIndex": 0 },
    "EVM": { "Nonce": "7", "MaxFeePerGas": "40000000000", "MaxPriorityFeePerGas": "2000000000" }
  }'

Assign consecutive nonces yourself when several transactions from the same address are in flight. Two requests that both omit Nonce can observe the same next nonce.

To replace a pending transaction, submit a new operation with the same nonce and a higher MaxFeePerGas. The network rejects a replacement that does not raise the fee enough. A nonce that has already confirmed cannot be reused.

Policy Nodes check a client-supplied nonce against the transaction they sign. See transaction and approval flows.

Solana

Solana durable nonce accounts let a transaction wait without depending on a recent blockhash. Associate the nonce account first with POST /api/cwp/operations/start/associateToNonceAccount, then set Solana.NonceAccount on the transactions that must use it.

AssociateNonceAccount takes PayerAddress, NonceAccount, Authority, Start, and Count.

Polkadot

Set Substrate.Nonce on the start request. Omit it and Vault assigns the next account nonce.

🗣️We Are Here to Help!

Please contact us via email or support chat if you encounter an issue, bug, or need assistance. Don't forget to include any relevant details about the problem. To request a wallet form and Institutional Vault Approver form, please click here or contact our sales team.


Did this page help you?