🔥Crowdsale

Our Crowdsale tool enables project creators to launch token sales with built-in security features and transparent management controls. This tool streamlines the token distribution process, allowing your community to participate in your project while ensuring fair and secure transactions.

This guide is divided into two parts:

• For Project Creators: How to set up, manage, and finalize your token sale.

• For Token Buyers: How to participate in sales and claim your purchased tokens.

For Project Creators (Admin Guide)

Prerequisites

Before creating a crowdsale, ensure you have:

• Active Project: You must have created your token project

• Vesting Configuration: Tokens must be allocated for public sale through vesting setup

• HTR for Fees: Sufficient HTR tokens for transaction fees

• Wallet Connected: Hathor-compatible wallet connected to the platform

➡️ If you haven't created your project yet, follow the Project Creation Guide.

Part 1: Allocating Tokens for Sale

Before you can create a crowdsale, you must allocate tokens for public sale through the vesting configuration.

Step 1: Setup Vesting

1. From your project dashboard, locate the Vesting card and click Setup Vesting.

2. On the Configure Project Vesting page, find the Special Allocations section.

3. Enter a percentage into the Public Sale (%) field. This defines the total amount of tokens available for the crowdsale.

4. Complete the remaining vesting configuration and click Configure Vesting.

5. Confirm the transaction in your wallet.

Note: The percentage you allocate here will be the maximum amount of tokens available for your crowdsale. This allocation must be completed before creating the sale.

Part 2: Creating Your Crowdsale

Once vesting is configured with a public sale allocation, you can create your crowdsale.

Step 1: Access Crowdsale Creation

1. Return to your project dashboard after the vesting transaction is confirmed.

2. The Token Sale card now shows an active Create Sale button. Click it.

Step 2: Configure Sale Parameters

You'll see the Create Crowdsale configuration page. Fill in the following parameters:

1. Token Rate (Tokens per HTR): Enter the exchange rate (e.g., 1 means 1 token per 1 HTR). The UI automatically calculates the price in USD.

2. Soft Cap (HTR): Enter the minimum funding goal. The sale is considered successful once this amount is reached.

3. Minimum Deposit (HTR): Set the smallest purchase amount allowed per transaction.

4. Start Date: Choose when the sale begins.

5. End Date: Choose when the sale ends.

6. (Optional) Check Start sale immediately if you want the sale to begin as soon as the contract is deployed.

Step 3: Deploy the Crowdsale

1. Review all parameters carefully.

2. Click the Create Crowdsale button at the bottom of the page.

3. Your wallet will prompt you to review the transaction. Verify the details and click Accept Transaction.

4. Enter your PIN to sign the transaction.

1. Wait for the transaction to be confirmed on the blockchain.

2. Once confirmed, you'll be returned to the project dashboard where the Token Sale card now shows Status: Ready (or Status: Live if you started immediately).

Part 3: Managing Your Active Sale

After your crowdsale is live, you can monitor its progress and manage operations through the admin panel.

Step 1: Access the Management Panel

1. From the project dashboard, locate the Token Sale card.

2. Click the three-dot menu icon (⋮) and select Manage Sale.

Step 2: Understanding the Management Dashboard

The Crowdsale Management panel provides a complete overview:

• Sale Progress: Visual progress bar showing HTR raised toward the Hard Cap, plus participant count

• Token Allocation: Total tokens allocated from vesting for this sale

• Sale Statistics: Real-time display of "Total Raised" and "Tokens Sold"

• Sale Configuration: Read-only summary of all parameters set during creation

• Admin Controls: Buttons to pause, resume, or finalize the sale

Step 3: Pausing and Resuming the Sale

The pause function allows you to temporarily halt all purchases during emergencies or maintenance.

To Pause:

1. In the Crowdsale Management panel, click the Pause Sale button.

2. Confirm the transaction in your wallet.

1. The status updates to Paused, and the button changes to Resume Sale. Users will see a notice that the sale is paused.

To Resume:

1. Click the Resume Sale button.

2. Confirm the transaction in your wallet.

3. The sale becomes active again, and users can continue purchasing.

Part 4: Finalizing the Sale and Withdrawing Funds

Once your sale ends or reaches its Soft Cap, you can finalize it and withdraw funds.

Step 1: Finalize the Sale

1. Navigate to the Crowdsale Management panel.

2. Once the sale period has ended or you're ready to close it, the Finalize Sale button becomes active. Click it.

1. Confirm the finalization transaction in your wallet.

2. After confirmation, the management panel updates to show the final sale results.

Step 2: Withdraw Raised Funds

After finalization, you can withdraw the HTR raised from the sale:

1. In the management panel, click the Withdraw HTR button (showing the total amount raised).

2. Confirm the transaction in your wallet.

3. The HTR is transferred to your wallet.

Step 3: Withdraw Unsold Tokens

If not all allocated tokens were sold, you can reclaim them:

1. Click the Withdraw Unsold Tokens button.

2. Confirm the transaction in your wallet.

3. The remaining tokens are returned to your wallet.

For Token Buyers (User Guide)

Step 1: Finding and Viewing the Sale

1. Navigate to the Explore or All Tokens section of the platform.

2. Click on the project you're interested in.

3. On the token's public page, you'll see a Token Sale card showing the current status (Live, Ready, Paused, or Ended).

4. Click View Full Sale Details to access the public crowdsale page.

The public crowdsale page displays:

• Sale Progress: Progress bar showing funds raised toward the goal

• Sale Details: Token price, Soft/Hard Caps, start/end times, and minimum deposit

• Participate in Sale: Form to purchase tokens

• Your Participation: Section showing your personal contribution (initially zeros)

Step 2: Purchasing Tokens

1. In the Participate in Sale form, enter the amount of HTR you wish to spend (must meet the minimum deposit requirement).

2. The UI automatically calculates and displays the number of tokens You will receive.

1. Click the Participate in Sale button.

2. Your wallet will prompt you to review and accept the transaction. Verify the details.

3. Enter your PIN to sign the transaction.

4. Wait for the transaction to be confirmed.

Step 3: Viewing Your Participation

After your purchase is confirmed, the page updates to reflect your contribution:

• The Sale Progress bar increases to include your purchase

• The Your Participation section now displays:

  • Your Deposit (amount in HTR)

  • Tokens Allocated (tokens you'll receive)

  • Claim Status: Not Claimed

💡 Tip: You can make multiple purchases during the sale period. Your participation details will accumulate.

Sale Status Updates

If the sale is paused by the admin, you'll see a banner stating "This sale is currently paused" and the purchase button will be disabled.

Once the Soft Cap is reached, the sale is considered successful and you'll see a status update.

Step 4: Claiming Your Tokens

After the sale has been finalized by the project admin, you can claim your purchased tokens.

1. Return to the public crowdsale page.

2. The Participate in Sale form is replaced by a Claim section with a message like "The sale was successful! Claim your tokens below."

1. Click the Claim Tokens button.

1. Confirm the transaction in your wallet and enter your PIN.

2. After confirmation, the tokens are transferred to your wallet. Your wallet balance will update to show the new tokens.

1. The Your Participation section updates to show Claim Status: Claimed.

Best Practices

For Project Creators

Sale Configuration

• Realistic Goals: Set achievable Soft and Hard Caps based on your project's stage and community size

• Fair Pricing: Research similar projects to set competitive token rates

• Minimum Deposit: Set a minimum that balances accessibility with preventing spam transactions

• Sale Duration: Allow sufficient time (7-14 days minimum) for community participation

Communication

• Pre-Sale Announcement: Announce your sale at least one week in advance across all channels

• Regular Updates: Post progress updates during the sale to maintain momentum

• Transparency: Be clear about tokenomics, roadmap, and use of funds

• Availability: Be responsive to community questions during the sale period

Post-Sale Management

• Timely Finalization: Finalize the sale promptly after it ends

• Quick Withdrawal: Enable token claiming as soon as possible after finalization

• Use of Funds: Communicate clearly how raised funds will be used

For Token Buyers

Research & Due Diligence

• Project Verification: Review the project's whitepaper, team, and roadmap

• Contract Verification: Ensure you're on the official crowdsale page

• Community Check: Join the project's Discord/Telegram to gauge community sentiment

• Tokenomics Review: Understand the total supply, vesting schedules, and distribution

Participation Strategy

• Budget Management: Only invest what you can afford to lose

• Timing: Don't wait until the last minute; network congestion may occur

• Multiple Purchases: You can make several smaller purchases if needed

• Record Keeping: Save transaction IDs for your records

Security

• Wallet Safety: Use secure wallets and never share your private keys

• Transaction Review: Always verify transaction details before signing

• Scam Awareness: Beware of fake sale links; always access through official channels

Troubleshooting

Common Issues

For Project Creators

Cannot Create Crowdsale

• Ensure vesting has been configured with a Public Sale allocation greater than 0%

• Verify you have sufficient HTR for transaction fees

• Check that you're connected with the correct project owner wallet

Sale Not Starting

• Verify the start date/time is set correctly

• If "Start immediately" was checked, wait for the creation transaction to confirm

• Check that the sale status shows "Ready" or "Live" on your dashboard

Cannot Finalize Sale

• Ensure the sale period has ended or the Soft Cap has been reached

• Verify you're connected with the project owner wallet

• Check network connectivity and try again

Withdrawal Fails

• Make sure you've finalized the sale first

• Ensure sufficient HTR for transaction fees

• Verify the transaction isn't already pending

For Token Buyers

Cannot Purchase Tokens

• Verify the sale is live (not paused or ended)

• Ensure your purchase amount meets the minimum deposit requirement

• Check you have sufficient HTR balance for the purchase plus transaction fees

• Confirm your wallet is properly connected

Purchase Transaction Fails

• Ensure the sale hasn't reached its Hard Cap

• Verify you have enough HTR for the purchase amount plus fees

• Check network connectivity and try again

• Confirm the sale is not paused

Cannot Claim Tokens

• Verify the sale has been finalized by the project admin

• Ensure you have tokens allocated (check Your Participation section)

• Check you haven't already claimed (look for "Claim Status: Claimed")

• Confirm you have sufficient HTR for transaction fees

Tokens Not Appearing in Wallet

• Wait a few minutes after claiming for the transaction to confirm

• Refresh your wallet or check the blockchain explorer

• Verify you claimed from the correct wallet address

• Ensure your wallet supports custom tokens (you may need to add the token manually)

Getting Help

If you encounter issues:

1. Check our Troubleshooting Guide

2. Join our Discord community

3. Contact support at [email protected]

Security Considerations

Smart Contract Security

• All crowdsale contracts are audited before deployment

• Contracts include emergency pause functionality for admin control

• Funds and tokens are held securely on-chain until finalization

• Claiming process is automated and trustless

Risk Factors

For Project Creators

• Regulatory Compliance: Ensure your token sale complies with local regulations

• Transparent Communication: Maintain clear communication to build trust

• Fund Management: Have a clear plan for how raised funds will be used

• Security Controls: Keep admin wallet secure; consider multi-signature solutions

For Token Buyers

• Investment Risk: Token prices may fluctuate; only invest what you can afford to lose

• Smart Contract Risk: While audited, smart contracts carry inherent risks

• Project Risk: Projects may fail to deliver on roadmaps; conduct thorough research

• Claiming Window: Claim your tokens promptly after the sale is finalized

---

Next Steps

For Project Creators

After launching your crowdsale:

1. Monitor Performance: Regularly check sale statistics and progress

2. Engage Community: Respond to questions and provide updates

3. Plan Post-Sale: Prepare for token claiming, liquidity provision, and next development phases

4. Complete Vesting: Continue with other vesting schedules for team and advisors

Learn more about managing your project:

• Vesting Configuration Guide - Set up additional vesting schedules

• Staking Guide - Create staking rewards for your token holders

For Token Buyers

After participating in a crowdsale:

1. Track Progress: Monitor the sale's progress toward its goals

2. Prepare to Claim: Watch for finalization announcements

3. Claim Promptly: Claim your tokens as soon as the sale is finalized

4. Stay Informed: Follow project updates and community channels

For more information about the broader ecosystem:

• Token Claiming Dashboard - Learn about claiming vested tokens

• Trading Guide - Understand how to trade your tokens

---

Launch your token sale with confidence using Dozer Finance's Crowdsale tool—secure, transparent, and easy to manage.