Presales

Endpoints for listing presales, managing allowlists, and generating Merkle proofs.

GET `/api/presales`

Search and list presales with filters and pagination. Authentication: Public Query Parameters

Parameter	Type	Required	Default	Description
`sort`	`"asc" \| "desc"`	No	desc	Sort direction.
`limit`	`number`	No	100	Page size.
`offset`	`number`	No	0	Offset.
`chainId`	`number`	No	—	Chain ID filter.
`status`	`number \| "all" \| "successful"`	No	—	Presale status filter.

Response: Paginated presale list.

{
  "presales": [ ... ],
  "totalCount": 42
}

GET `/api/presales/allowlists`

Returns the allowlist for a presale. Authentication: Public Query Parameters

Parameter	Type	Required	Default	Description
`presaleId`	`number`	Yes	—	Presale ID.
`chainId`	`number`	Yes	—	Chain ID.

Response: Merkle root and allocations.

{
  "presaleId": 1,
  "chainId": 8453,
  "merkleRoot": "0x...",
  "allocations": [
    { "address": "0x...", "allowedAmountEth": "1.0", "allowedAmountWei": "1000000000000000000" }
  ]
}

POST `/api/presales/allowlists`

Saves a presale allowlist Merkle tree. Authentication: Public Body Parameters

Parameter	Type	Required	Default	Description
`presaleId`	`number`	Yes	—	Presale ID.
`chainId`	`number`	Yes	—	Chain ID.
`merkleRoot`	`string`	Yes	—	Hex-encoded Merkle root.
`tree`	`object`	Yes	—	MerkleTreeDump object ({ format, leafEncoding, tree, values }).

Response: Success confirmation.

{ "success": true }

GET `/api/presales/allowlists/proof`

Returns a Merkle proof for a buyer in a presale allowlist. Authentication: Public Query Parameters

Parameter	Type	Required	Default	Description
`presaleId`	`number`	Yes	—	Presale ID.
`chainId`	`number`	Yes	—	Chain ID.
`buyerAddress`	`address`	Yes	—	Buyer wallet address.

Response: Proof and allowed amount, or rejection.

{
  "isAllowed": true,
  "proof": ["0x..."],
  "allowedAmountWei": "1000000000000000000",
  "allowedAmountEth": "1.0"
}

GET `/api/presales/refresh`

Enqueues a presale for re-indexing by transaction hash. Authentication: Public Query Parameters

Parameter	Type	Required	Default	Description
`txHash`	`string`	Yes	—	Hex-encoded transaction hash.
`chainId`	`number`	No	8453	Chain ID (defaults to Base).

Response: Confirmation that the presale was enqueued.

{
  "enqueued": true,
  "message": "Presale enqueued for refresh",
  "data": { "txHash": "0x...", "chainId": 8453 }
}

Introduction

General

Droids

API Reference

SDK Reference

References

GET `/api/presales`

GET `/api/presales/allowlists`

POST `/api/presales/allowlists`

GET `/api/presales/allowlists/proof`

GET `/api/presales/refresh`

​GET /api/presales

​GET /api/presales/allowlists

​POST /api/presales/allowlists

​GET /api/presales/allowlists/proof

​GET /api/presales/refresh

GET `/api/presales`

GET `/api/presales/allowlists`

POST `/api/presales/allowlists`

GET `/api/presales/allowlists/proof`

GET `/api/presales/refresh`