◆nav.brand
docs.title/Airdrop / Claim

Airdrop / Claim

Merkle-proof claim page with eligibility checker

docs.viewTemplate

docs.h.overview

A gas-light airdrop: upload a recipients CSV, generate a Merkle tree, and ship a claim page with an instant eligibility checker. Only claimers pay gas.

Airdrop / Claim turns a list of addresses + amounts into a live claim page. Paste or upload a CSV, the tooling builds the Merkle root, and recipients check eligibility and claim with one click.

The MerkleDistributor contract verifies proofs on-chain and prevents double claims. The wizard helps you build the tree, fund the contract and deploy.

docs.h.included

  • Next.js 16 app (App Router, TypeScript, Tailwind)
  • MerkleDistributor.sol + Hardhat + tree builder
  • CSV import + proof generation scripts
  • Dockerfile + docker-compose
  • README + setup wizard

docs.h.contracts

  • MerkleDistributor.sol — gas-light airdrop: recipients prove (address, amount) against a Merkle root and claim once; owner can sweep leftovers (OpenZeppelin SafeERC20 + MerkleProof).

docs.h.stack

docs.stackLine

docs.chainsLine

docs.h.quickstart

docs.quickstartP

unzip airdrop-claim.zip && cd airdrop-claim
npm install
npm run dev

docs.quickstartUrl

docs.h.configure

docs.configureP

  1. docs.wizard.1
  2. docs.wizard.2
  3. docs.wizard.3
  4. docs.wizard.4
  5. docs.wizard.5
Tip · docs.configureTip

docs.configureP2

docs.h.customize

docs.h.branding

docs.brandingP

docs.brandingP2

docs.h.languages

docs.languagesP

docs.h.editing

docs.editingP

docs.h.configRef

docs.configRefP

  • docs.configRef.1
  • docs.configRef.2
Tip · docs.configRefTip

docs.h.deployContracts

docs.deployContractsP

# compile + copy artifacts the app/wizard use
npm run compile

# deploy to the network in your .env (RPC_URL + DEPLOYER_PRIVATE_KEY)
npm run deploy

docs.deployContractsP2

docs.h.deployApp

docs.h.vercel

  1. docs.vercel.1
  2. docs.vercel.2
  3. docs.vercel.3

docs.h.docker

docs.dockerP

# build + run; with no .env it opens the setup wizard
docker compose up --build

# once you have a .env, pass it in:
docker run --env-file .env -p 3006:3000 airdrop-claim

docs.dockerP2

docs.h.vps

docs.vpsP

npm install
npm run build
npm run start   # serves the production build

docs.h.checklist

  • docs.checklist.1
  • docs.checklist.2
  • docs.checklist.3
  • docs.checklist.4
  • docs.checklist.5

docs.h.support

docs.supportP