🔥Crowdsale
The Launchpad tool runs a public token sale for the % of supply reserved as Public Sale in your vesting configuration. The dapp surfaces it as Launchpad in the sidebar; admin and public pages title it Crowdsale Management and Token Sale respectively.
This page covers the project creator side — creating, managing, and finalizing the sale. If you're a buyer looking to participate, see Participating in a Token Sale.
Prerequisites
Project created and vesting configured with a Public Sale % (see Vesting Configuration).
HTR or DZR in the project Credits balance for the deployment transaction.
Wallet connected as project owner.
Step 1 — Open Launchpad Setup
From the project dashboard's setup checklist, click Manage on Token Sale — or use the sidebar's Launchpad entry under Finance.
For a project with no existing sale, the setup form loads. For projects where a sale already exists, the Crowdsale Management panel loads.
Step 2 — Configure Sale Parameters
The form has two cards: Sale Allocation (the rate) and Sale Configuration (caps, dates):
Token Rate (Tokens per HTR)
Exchange rate, e.g. 500 tokens per 1 HTR
Soft Cap (HTR)
Minimum funding goal. If unreached at end of sale, buyers can refund their HTR.
Minimum Deposit (HTR)
Per-transaction minimum, e.g. 10.00 HTR
Start sale immediately
Checkbox; when on, the Start Date field is hidden and the sale opens on deployment.
Start Date
Sale opens at this timestamp (hidden if Start immediately is checked)
End Date
Sale closes at this timestamp
The Hard Cap is calculated automatically as tokens available × rate — no field for it. Tokens available comes from your vesting Public Sale allocation. The full allocation is reserved at deployment; unsold tokens can be withdrawn after finalization.
Step 3 — Deploy
Click Create Crowdsale.
Approve in the Hathor wallet and enter your PIN.
After confirmation, the dashboard's Token Sale step shows ✅ and the Launchpad menu now opens the Crowdsale Management view.
The Crowdsale Management View
The management panel runs the sale through its lifecycle states (from formatSaleState):
Upcoming
Deployed but Start Date hasn't been reached yet
Ready
Past Start Date but admin still needs to start the sale (manual start mode)
Live
Accepting purchases
Paused
Admin paused; purchases blocked
Soft Cap Reached
Soft Cap met but sale still running (admin may finalize early)
Successful
Finalized and Soft Cap was reached — buyers can claim, admin can withdraw
Failed
Finalized and Soft Cap was not reached — buyers can refund
Top of page:
Status badge (Upcoming / Live / Paused / Ended)
Countdown to start or end
Start Sale Early button (for Upcoming sales) / Pause / Resume / Finalize buttons depending on state
Preview Token Sale link (top right) — opens the public sale page in a new tab
Sections:
Sale Progress
Raised amount, Hard Cap goal, % of Hard Cap, participants
Token Allocation
Allocation % from vesting, Total Allocated tokens, Sold %
Sale Statistics
Total Raised, Tokens Sold
Sale Configuration
Read-only summary: Rate, Soft Cap, Hard Cap, Start/End Time, Min Deposit
Pausing & Resuming
Use Pause only for emergencies (a discovered exploit, regulatory inquiry, etc.):
Click Pause Sale, approve in wallet, enter PIN.
Status changes to Paused. Buyers see a banner on the public page and the purchase form is disabled.
Click Resume Sale to re-open.
Finalizing & Withdrawing
Once the sale has ended (or you choose to close it early after the Soft Cap is reached):
Click Finalize Sale → approve in wallet.
The management panel updates with final results.
Withdraw Raised HTR — sends the raised HTR to your wallet.
Withdraw Remaining Tokens — returns any unsold portion of the Public Sale allocation to your wallet.
⚠️ If the Soft Cap was not reached, the sale enters refund mode. Buyers can withdraw their HTR from the public page; you cannot withdraw the raised funds.
For Token Buyers
The buyer-facing flow — finding a sale, purchasing, refunds, and claiming — is documented in Participating in a Token Sale.
Best Practices
Realistic Soft Cap — Set it to your minimum viable funding. Too high risks sale failure and refunds.
Allow enough time — 7–14 days minimum for community participation. Don't run a sale across a major regional holiday.
Pre-announce — At least one week ahead, share the token address and the official
/launchpad/<token-id>URL.Pause sparingly — It shakes buyer confidence. Reserve for emergencies.
Troubleshooting
Cannot create sale
Vesting must have Public Sale % > 0
Sale stuck in Upcoming past start
If "Start sale immediately" was off, click Start Sale Early in the management panel
Finalize button disabled
Sale period must have ended OR Soft Cap reached
Withdraw HTR fails
Sale must be finalized first; check the Credits balance
Next Steps
Staking — set up a rewards pool for your token holders
Token Claiming — concept overview of how beneficiaries access their tokens
Last updated