# 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](/user-guides/claiming-vested-tokens.md) — for vesting beneficiaries (team, advisors, ecosystem allocations)
* [🔥 Participating in a Token Sale](/user-guides/participating-in-token-sale.md) — 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:

1. The **token contract address** (or public token page URL: `/tokens/<token-id>`)
2. The **exact Hathor address** you registered as their beneficiary
3. A link to the [Claiming Vested Tokens](/user-guides/claiming-vested-tokens.md) guide
4. The **cliff and vesting duration** so they know when to expect first unlocks

## Related

* [Vesting Configuration](/project-launch-tools/vesting-configuration.md) — where beneficiary addresses and schedules are set
* [Crowdsale](/project-launch-tools/crowdsale.md) — sale management; the buyer claim flow is in the user guide
* [Claiming Vested Tokens (User Guide)](/user-guides/claiming-vested-tokens.md)
* [Participating in a Token Sale (User Guide)](/user-guides/participating-in-token-sale.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dozer.finance/project-launch-tools/token-claiming.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.