> 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/` 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 Public Launchpad page | 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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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/user-guides/participating-in-token-sale.md?ask= ``` 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.