v1

latestOpenAPI 3.1.02026-07-2619047.9 KB

Login

Verifies the wallet's signature over the challenge issued by /v1/spl/challenge and returns an authentication token. Pass the token as Authorization: Bearer <token> on /v1/spl/private-balance and on /v1/spl/transfer requests that need to connect to the Private Ephemeral Rollup.

post/v1/spl/login

Request body

pubkeystring required

The public key of the wallet that will read private data.

challengestring required

The challenge string returned by /v1/spl/challenge.

signaturestring required

The wallet's signature over the challenge string.

mockboolean

Optional. When true, the API uses a mock login flow for testing. Defaults to false.

Example request

{
  "pubkey": "Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L",
  "challenge": "1234567890",
  "signature": "1234567890"
}

Response

Authentication token

tokenstring required

The authentication token provided by the Private Ephemeral Rollup.