Skip to main content

Quickstart — launch a drop

This guide walks you through creating your first airdrop as a creator. Total time: about five minutes, plus two transactions.

Prerequisites​

  • A wallet (MetaMask, Rabby, or anything WalletConnect-compatible).
  • An ERC-20 token balance covering the total you want to distribute — or use the Token Alchemist to deploy one first.
  • Gas on the target chain for two transactions (deploy + fund).
Test first

Droppie supports Sepolia and Base Sepolia. Run a test drop with a throwaway token before spending real funds.

1. Connect your wallet​

Open droppie.notcool.in, hit Launch App, and connect. Droppie works on any EVM chain — whatever network your wallet is currently on is where your drop deploys. These chains come pre-configured with curated RPCs and explorer links:

ChainChain ID
Ethereum1
Optimism10
Polygon137
Base8453
Arbitrum One42161
Sepolia (testnet)11155111
Base Sepolia (testnet)84532

On any other EVM network, Droppie recognizes your wallet's chain automatically (pulling its name, currency, and explorer from the public chainlist registry) and everything works the same way. This is possible because Droppie has no pre-deployed infrastructure — your wallet deploys the drop contract itself, so nothing needs to exist on a chain beforehand.

Make sure your wallet is on the chain where your token lives — the drop is deployed on that same chain.

2. Prepare your recipients CSV​

Droppie takes a simple two-column CSV: address,amount.

recipients.csv
address,amount
0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266,100
0x70997970C51812dc3A010C7d01b50e0d17dc79C8,250.5
0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC,42
ColumnRequiredDescription
addressYesRecipient's EVM address. Validated (including EIP-55 checksums for mixed-case addresses).
amountYesAmount in human units (e.g. 250.5 tokens, not wei). Converted using the token's decimals.

Rules to know:

  • Header row address,amount should be the first line.
  • Duplicates are merged: if an address appears twice, the amounts are summed into a single claim.
  • Amounts are human units. Droppie fetches your token's decimals() and scales for you. 1.5 for an 18-decimals token becomes 1500000000000000000 wei in the tree.
  • Rows that fail validation (bad address, bad checksum, non-positive amount) are reported with line numbers so you can fix and re-upload.

Exports from Excel, Google Sheets, or a Dune query all work as long as the two columns are there.

3. Run the create wizard​

Go to Create (/app/create). The wizard has four steps and saves a draft to your browser as you go — closing the tab won't lose your work.

Step 1 — Token​

Paste your token's contract address (or pick one you deployed with the Token Alchemist). Droppie reads the symbol, decimals, and your balance, and checks you can cover the total.

Step 2 — Recipients​

Upload or paste your CSV. Droppie parses it client-side, validates every row, dedupes, and shows the recipient count and total. Nothing leaves your browser.

Step 3 — Review​

Droppie builds the Merkle tree in your browser and shows you:

  • Recipient count and total amount (verify these against your source list!)
  • The Merkle root — the 32-byte fingerprint of your entire list that goes on-chain
  • The distribution file — a JSON snapshot of the list (schema) that claimers use to generate proofs. It's pinned to IPFS automatically; if pinning is unavailable you download it and host it anywhere (any HTTPS URL works).
  • Optional start time (default: immediate) and end time (default: no deadline). If you set an end time, it must be in the future and after the start time. After the end time, claiming stops and you can sweep unclaimed tokens back.

Step 4 — Deploy​

Two transactions, both signed by your wallet:

  1. Deploy your drop contract — your wallet deploys a fresh DroppieDrop with the token, root, claim window, and metadata URI baked in. The deploying wallet becomes the drop's creator — you own the contract.
  2. Fund the drop — a plain ERC-20 transfer of the total amount into the new contract. No approve step. Until this confirms, the drop shows as underfunded and claims are gated.

Your funds now sit in your own drop contract, not in Droppie. Only valid claims (and your own post-deadline sweep) can move them. See How it works for the full flow.

Once deployed you land on the drop detail page with a shareable link:

https://droppie.notcool.in/claim/{chainId}/{dropAddress}

Post it wherever your recipients live — Discord, X, a governance forum. Anyone on the list can claim; anyone not on it can't. Watch claims roll in on your dashboard's progress chart.

Next steps​