> For the complete documentation index, see [llms.txt](https://docs.dozer.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dozer.finance/user-guides/participating-in-token-sale.md).

# Participating in a Token Sale

This guide shows how to buy tokens from a project's public sale on Dozer Tools. The sale page is sometimes called the **Launchpad** or **Crowdsale** — they're the same thing.

## What You Need

* A **Hathor wallet** with Reown / WalletConnect support
* **HTR** for the purchase plus a small extra for transaction fees
* The **token URL** or token symbol of the sale you want to join

## Step 1 — Find the Sale

Three ways to reach a sale:

* **Explore → Token Sales** in the top navigation — lists all active and upcoming sales.
* **Explore → All Tokens** — open any token's page; if it has an active sale, the **Token Sale** card surfaces it.
* **Direct link** — projects usually publish a `/launchpad/<token-id>` URL on their social channels.

## Step 2 — Connect Your Wallet

1. Click **Connect Wallet** in the top right (or anywhere a connect prompt appears).
2. Copy the WalletConnect URI from the modal.
3. In your Hathor wallet, open the **QR icon → Manual → Reown Connection**, paste the URI, click **Connect**.
4. Approve the session request in your wallet.

Once connected, the top-right button shows your address (truncated, e.g. `WbvoFb...9GrE`).

## Step 3 — Read the Sale Page

<img src="/files/vaY7t8kNDSKuSpP0VM2l" alt="Public Launchpad page" width="700">

| Section                 | What it shows                                                                    |
| ----------------------- | -------------------------------------------------------------------------------- |
| **Status badge**        | Upcoming / Ready / Live / Paused / Soft Cap Reached / Successful / Failed        |
| **Sale Progress**       | HTR raised vs Hard Cap, countdown to start (Upcoming) or end (Live)              |
| **Sale Details**        | Token Price, Soft Cap, Hard Cap, Min Purchase, Start/End Time, participant count |
| **Your Participation**  | What you've already contributed, claim status                                    |
| **Participate in Sale** | Form that appears when the sale is Live                                          |

### Status meanings

* **Upcoming** — Not started yet. You can read the details but cannot buy.
* **Ready** — Past the start time but not yet activated; the project admin will start it manually.
* **Live** — Purchases open.
* **Paused** — Project admin temporarily disabled purchases. Wait or move on.
* **Soft Cap Reached** — Sale met its minimum goal but is still accepting purchases.
* **Successful** — Sale ended and Soft Cap was reached. Claim your tokens.
* **Failed** — Sale ended without reaching Soft Cap. Refund your HTR.

## Step 4 — Buy Tokens (Live sales)

1. In **Participate in Sale**, enter the **HTR amount** you want to spend (must be ≥ Min Purchase).
2. The UI shows how many tokens you'll receive at the configured rate.
3. Click **Participate in Sale**.
4. In your wallet, review the transaction details, enter your PIN, sign.
5. After confirmation, the **Your Participation** panel updates:
   * **Your Deposit** — HTR you've contributed in total
   * **Refundable** — recoverable if the sale fails
   * **Tokens Allocated** — what you'll receive at claim time
   * **Claim Status** — `Not Claimed` until you claim after a Successful finalize

You can purchase multiple times during a sale; amounts accumulate.

## Step 5 — Claim or Refund After the Sale Ends

Once the project admin **finalizes** the sale, the **Participate in Sale** form is replaced by a single action button in the Your Participation panel. The button's label and color depend on three things:

| Sale state        | You deposited? | Already claimed? | Button label     | Style             |
| ----------------- | -------------- | ---------------- | ---------------- | ----------------- |
| Successful        | Yes            | No               | **Claim Tokens** | Primary (default) |
| Successful        | Yes            | Yes              | Already Claimed  | Disabled          |
| Failed            | Yes            | No               | **Claim Refund** | Red (destructive) |
| Failed            | Yes            | Yes              | Already Claimed  | Disabled          |
| Any state         | No             | —                | No Participation | Disabled          |
| Not yet finalized | —              | —                | Not Available    | Disabled          |

So **the same panel handles both outcomes** — you don't navigate to a different page. The Sale Progress badge at the top will read **Successful** or **Failed** so you know which action you're confirming.

### How to claim or refund

1. Make sure the badge at the top shows **Successful** or **Failed** (the project has finalized the sale).
2. Click **Claim Tokens** (success) or **Claim Refund** (failure).
3. Approve the transaction in your wallet, enter your PIN.
4. After confirmation:
   * **Successful sale** — your purchased tokens land in your wallet; Claim Status switches to **Claimed**.
   * **Failed sale** — your HTR deposit returns to your wallet; Claim Status switches to **Claimed**.

> The button stays active until you've claimed. It costs a small HTR transaction fee whether you're claiming tokens or a refund.

If after a successful claim the token doesn't appear in your wallet, register it manually: **QR icon → Manual → Register Token** in Hathor wallet, then paste the token's contract address from the public token page.

## Safety Checks

* **Verify the URL** — Always confirm you're on `testnet.tools.dozer.finance` (or the official mainnet domain). Phishing copies exist.
* **Check the token contract** — Open the token's public page from the official project channels, not from random links.
* **Read the vesting plan** — Public Sale tokens may have their own cliff or unlock schedule. Visible in the **Token Vesting** section of the token's public page.
* **Keep some HTR aside** — Claiming and refunding both cost a small transaction fee.

## Troubleshooting

| Symptom                                | Fix                                                             |
| -------------------------------------- | --------------------------------------------------------------- |
| Participate button disabled            | Sale is not Live, or amount is below Min Purchase               |
| Transaction rejected                   | Wallet session expired — disconnect and reconnect               |
| Tokens not in wallet after claim       | Refresh; if still missing, register the token manually          |
| Refund button missing on a Failed sale | The sale may still be processing finalization — wait 1-2 blocks |

## Related

* [Wallet Setup](/user-guides/wallet-setup.md) — install and connect a Hathor wallet
* [Claiming Vested Tokens](/user-guides/claiming-vested-tokens.md) — beneficiary-side claims (team, advisors, etc.)
* [Staking Tokens](/user-guides/staking-tokens.md) — stake your newly purchased tokens for rewards