Get a wallet's next action number

Every wallet has a counter that goes up by one with each action it takes. Whatever it signs is tied to the number it had at the time, so a copy of an old request is worthless once the counter has moved on. That is what makes a signed action safe to send over the internet. Read the number here, include it when you sign, and send it with the action. Between reading and sending, the wallet must not do anything else, or the number will have moved and the action will be refused — read it fresh for each action rather than keeping one around. `POST /ebus/prepare` returns the same number along with everything else you need, so most integrations never call this directly. No sign-in needed. The counter is public, and knowing it grants nothing.

GET
/ebus/nonce

Query Parameters

address*string

The wallet address to look up.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.dual.network/ebus/nonce?address=0x1234567890abcdef1234567890abcdef12345678"
{
  "nonce": 3
}

{
  "code": 16,
  "message": "no auth provided"
}

{
  "code": 5,
  "message": "object not found"
}
{
  "code": 13,
  "message": "internal error"
}