Authenticate user with signed data

post

Authenticate a user with signed data. Verifies the wallet signature and issues session tokens (access and refresh).

Path parameters

apiKeystringRequired

API key generated at https://studio.aurora.dev

Body

application/json

signedDataany ofRequired

Signed message payload. Supports multiple signing standards (for example nep413 and erc191), discriminated by the standard field.

or

Responses

200

Signature verification succeeded; tokens issued

application/json

Signature verification succeeded; tokens issued

accessTokenstringRequired

JWT access token for authenticated API calls.

Example: <jwt>

refreshTokenstringRequired

JWT refresh token used to obtain new access tokens.

Example: <jwt>

expiresInnumberRequired

Access token lifetime in seconds.

Example: 900

refreshExpiresInnumberRequired

Refresh token lifetime in seconds.

Example: 2592000

400

Default Response

application/json

401

Signature verification failed

application/json

500

Internal Server Error - Failed to reach the auth service

application/json

post/api/auth/authenticate/{apiKey}

HTTPcURLJavaScriptPython

POST /api/auth/authenticate/{apiKey} HTTP/1.1
Host: intents-api.aurora.dev
Content-Type: application/json
Accept: */*
Content-Length: 381

{
  "signedData": {
    "standard": "nep413",
    "public_key": "ed25519:5TagutioHgKLh7KZ1VEFBYfgRkPtqnKm9LoMnJMJugxm",
    "signature": "ed25519:5TagutioHgKLh7KZ1VEFBYfgRkPtqnKm9LoMnJMJugxm",
    "payload": {
      "recipient": "intents.near",
      "nonce": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=",
      "message": "{\"signer_id\":\"user.near\",\"deadline\":\"2025-03-04T15:00:00Z\",\"intents\":[]}",
      "callbackUrl": "text"
    }
  }
}

{
  "accessToken": "<jwt>",
  "refreshToken": "<jwt>",
  "expiresIn": 900,
  "refreshExpiresIn": 2592000
}