Presale Overview
Learn how the Token Sale presale phase works, including whitelist management, discount pricing, per-address caps, and transition to public sale.
The presale is an optional early-access phase that opens before the public sale. Only whitelisted investors can participate, and a configurable discount makes presale prices more favorable than the public sale price.
What the presale provides
- Access control -- only addresses added to the whitelist can buy during presale
- Discount pricing -- a configurable multiplier reduces the effective token price
- Separate cap -- a per-address limit specific to the presale phase, independent of the global maximum purchase limit
Configuration
Presale parameters are set when creating the sale and become immutable after activation:
| Parameter | Description |
|---|---|
| Presale end time | When the presale phase automatically transitions to public sale |
| Presale discount | Price multiplier, e.g., 0.8 for a 20% discount (1 USDC buys 25% more tokens) |
| Presale max per address | Maximum tokens any single investor can purchase during the presale phase |
How the discount works
The discount multiplier reduces the effective price ratio. Example:
- Public price ratio: 1 USDC = 100 tokens
- Presale discount: 0.8 (20% off)
- Presale effective price: 1 USDC = 125 tokens
The platform shows the effective presale price automatically when the sale is in Presale status.
Managing the whitelist
SALE_ADMIN_ROLE can add and remove addresses from the presale whitelist at any time during the presale phase, from the Whitelist tab on the sale detail page:
- Add a single address -- enter one wallet address to grant presale access
- Import a CSV -- upload a list, review the row-level validation (net-new, already whitelisted, invalid skipped), and confirm. Large lists are imported in gas-safe batches, and re-importing an address that is already whitelisted is safe
- Remove an address -- revoke presale access for an address
Transitioning to public sale
The presale ends in one of two ways:
| Method | Trigger | On-chain effect |
|---|---|---|
| Time-based (automatic) | presaleEndTime passes | Lazy -- status updates on the next transaction |
| Manual (admin) | Admin transitions to public sale | Immediate on-chain status update |
The platform always shows the effective status based on the current time, so investors see Public Sale as soon as presaleEndTime has passed -- even before any on-chain transaction triggers the formal transition.
Presale limits vs public sale limits
| Limit type | Applies in presale | Applies in public sale |
|---|---|---|
| Presale max per address | Yes | No |
| Global max per address | Yes (stricter) | Yes |
| Hard cap | Yes | Yes |
| Min purchase | Yes | Yes |
Next steps
Token Sale overview
Token Sale enables compliant primary distribution of digital assets to investors. Learn about sale phases, payment currencies, optional presale, vesting schedules, and soft cap protection.
Token sale vesting schedules
Learn how vesting schedules work in a token sale. Understand cliff periods, linear token release, and how to withdraw your vested tokens.