A phase is a window with its own price, its own rule about who can mint, and its
own caps. Most collections are more than one straight public sale, and phases
are how everything else gets expressed.
Kinds of phase
Four kinds, as many of each as you like:Each carries a price, a start, an end, a per-wallet cap and a cap on how many
the phase can sell. Phases become candy guards. The wizard gives you whitelist and public
windows, each with a price, a start time and a per-wallet cap.
Caps stack
Two limits apply at once:
- Per wallet — how many one address can mint in this phase.
- Per phase — how many the phase can sell in total, out of your supply.
A wallet that used up its allowance in phase 1 starts fresh in phase 2. If you
want a lifetime limit across the whole mint, per-wallet caps won’t give you that
— use one phase, or an allowlist you control.
Allowlists
Upload your addresses; each minter proves they’re on the list when they mint.
Prepare the list
One address per line. Duplicates get removed.
Save it
We check the list we stored is the list we built the proof from, so a
half-saved allowlist can’t silently go live.
Check it works
The mint page tells a visitor whether they’re eligible before enabling the
button, and it works this out the same way the contract does — so the page
and the chain can’t disagree.
If we can’t check eligibility — because a chain endpoint is struggling — the
mint page shows an error, not “you’re not on the list”.So an eligibility error during a busy mint usually means infrastructure, not
your allowlist. Check the chain before you start editing addresses.
Token gates, and their limits
Gates check a wallet’s balance at the moment it mints, on the same chain.
They can be got around: someone can acquire the gating token, mint, and dispose
of it. And they can’t see other chains — a Base contract can’t read an Ethereum
holding, and nothing on EVM can see Solana.
If the gate genuinely needs to hold, use an allowlist.
Setting tokens aside
You can reserve tokens for specific wallets before the public sale — your team,
partners, holders of a previous collection.
This isn’t free, and the cost doesn’t scale the way you’d expect. Gas is charged
per wallet, not per batch, and on Solana you also pay account rent for every
item you deliver.Work out the cost before you promise a large reserved drop.
Timing
Phases run on absolute times. A phase with no end runs until the next one starts
or supply runs out.
Leave a gap between your allowlist phase ending and public starting. Back to
back means anyone whose allowlist transaction is still confirming is racing the
public rush for the same tokens.
