Get a single-use SIWE nonce (valid 300 s)

POST

/v1/auth/nonce

curl --request POST \
  --url https://testnet-rpc.necter.network/v1/auth/nonce \
  --header 'Content-Type: application/json' \
  --data '{ "address": "example", "domain": "example" }'

• Public RPC host (JSON only)

Request Body^required

Media typeapplication/json

object

address

required

Lowercase EVM address

string

/^0x[0-9a-f]{40}$/

domain

required

Allowed: testnet.necter.network, 127.0.0.1:7878, localhost:7878, necter-miner.app (desktop/mobile apps)

string

Example ^generated

{
  "address": "example",
  "domain": "example"
}

Responses

200

Nonce and the exact message to sign

Media typeapplication/json

object

nonce

required

string

/^[A-Za-z0-9]{17}$/

issued_at

required

integer

expires_at

required

integer

message

required

EIP-4361 message the wallet signs (EIP-191), e.g. testnet.necter.network wants you to sign in with your Ethereum account:\n0xAbC…(EIP-55)\n\nSign in to Necter testnet.\n\nURI: https://testnet.necter.network\nVersion: 1\nChain ID: 11155111\nNonce: <nonce>\nIssued At: 2026-10-07T12:00:00Z\nExpiration Time: 2026-10-08T00:00:00Z

string

Example ^generated

{
  "nonce": "example",
  "issued_at": 1,
  "expires_at": 1,
  "message": "example"
}

400

Malformed request (bad_request, invalid_field)

Media typeapplication/json

object

error

required

Stable machine code

string

message

required

string

details

object

key

additional properties

any

request_id

required

string

Example ^generated

{
  "error": "example",
  "message": "example",
  "details": {},
  "request_id": "example"
}

429

rate_limited

Media typeapplication/json

object

error

required

Stable machine code

string

message

required

string

details

object

key

additional properties

any

request_id

required

string

Example ^generated

{
  "error": "example",
  "message": "example",
  "details": {},
  "request_id": "example"
}

Headers

Retry-After

integer