v2

latestOpenAPI 3.0.3raw.githubusercontent.com2026-04-104616.2 KB

claims

Submit a claim request

Submits a UTXO claim request to the relayer for asynchronous processing. The relayer validates the request, builds the on-chain transactions, and submits them.

Returns immediately with a request_id for polling via GET /v1/claims/{request_id}.

Note: This endpoint is designed to be called by the SDK, not directly. The request body contains cryptographic proof data that must be generated by the SDK's claim functions.

post/v1/claims

Request body

variant'encrypted_balance' | 'public_balance' required

Claim target — encrypted token account or public ATA.

user_pubkeystring required

Base58-encoded Solana public key of the claiming user.

mintstring required

Base58-encoded token mint address.

stealth_pool_indexinteger required

Index of the stealth pool containing the UTXOs.

max_utxo_capacityinteger required

Maximum number of UTXOs in this claim batch.

optional_datastring required

Base64-encoded 32-byte metadata field.

Response

Claim accepted and queued for processing

request_idstring uuid

UUID for polling the claim status.

status'received'

Always "received".