Skip to main content

Claim Distribution

Returns an EIP-712 signature for one distribution row so the user can claim tokens from the distribution contract. Idempotent — the same (user, distribution, nonce) always yields the same signature.

POST /points/claim/:distribution_id

Auth: Authorization: Bearer <JWT> from the EIP-712 login. API keys are not accepted.

Response (data)

{
"user": "0xabcd...",
"distribution_id": "uuid",
"amount": "28420000000000000000000",
"nonce": 0,
"deadline": 1777593600,
"signature": "0x...",
"domain": { "name": "...", "version": "1", "chainId": 43114, "verifyingContract": "0x..." }
}

Submit amount, nonce, deadline and signature to the distribution contract before deadline.

Errors (error.code)

codeMeaning
NOT_FOUNDUnknown distribution id
FORBIDDENRow belongs to another user
ALREADY_CLAIMEDclaim_status = claimed
EXPIREDPast claim_deadline
SIGNER_UNAVAILABLEBackend signer not configured on this deployment
SIGN_FAILEDSigning error