💰Token Claiming
Token claiming is the user-facing side of vesting and Launchpad sales — it's how beneficiaries and buyers actually receive the tokens that have been allocated to them on-chain.
This page is a concept overview for project creators. End users should use the dedicated user guides:
🪙 Claiming Vested Tokens — for vesting beneficiaries (team, advisors, ecosystem allocations)
🔥 Participating in a Token Sale — for Launchpad sale buyers (includes the claim step after a successful sale)
Two Claim Surfaces
Dozer Tools exposes claiming in two different places, depending on where the allocation came from.
1. Vesting claims — Token Vesting section
For tokens distributed through your project's vesting plan (team, advisors, ecosystem reserves, custom investor allocations).
Where: The public token page at
/tokens/<token-id>, in the Token Vesting section.Tabs: Allocations (claim here), Distribution (visualization), Vesting Schedule (timeline).
Status states: Cliff Period, Vesting in Progress, Available to Claim, Nothing to Claim, Fully Claimed.
Per-row claim: Each beneficiary row has its own Claim button.
2. Launchpad claims — Public sale page
For tokens purchased through a Launchpad crowdsale.
Where: The public sale page at
/launchpad/<token-id>, in the Your Participation panel.Available after: The project owner finalizes a Successful sale.
Failed sale: Same panel exposes a Refund button instead, returning HTR to the buyer.
What Project Creators Should Know
You don't claim on behalf of beneficiaries — they claim themselves.
Beneficiaries claim per allocation, per project. Cross-project bulk claiming is not supported.
Each claim costs the beneficiary a small HTR transaction fee. Most users batch claims rather than claiming every unlock cycle.
The status badges and progress bars on the Token Vesting tab update automatically — beneficiaries can use the page as a read-only monitor.
What to Tell Your Beneficiaries
When onboarding a new beneficiary group (team, advisors, investors), include in your communication:
The token contract address (or public token page URL:
/tokens/<token-id>)The exact Hathor address you registered as their beneficiary
A link to the Claiming Vested Tokens guide
The cliff and vesting duration so they know when to expect first unlocks
Related
Vesting Configuration — where beneficiary addresses and schedules are set
Crowdsale — sale management; the buyer claim flow is in the user guide
Last updated