# Token Claiming

The Token Claiming Dashboard allows vesting beneficiaries to view their token allocations, track vesting progress, and claim available tokens. This guide explains how to access and use the claiming interface effectively.

## Overview

The claiming dashboard provides a comprehensive view of your vested tokens, including:

* **Current Status**: Available tokens ready to claim
* **Vesting Progress**: Timeline and remaining tokens
* **Claim History**: Record of all previous claims
* **Schedule Details**: Cliff periods and vesting timelines

## Prerequisites

To access the token claiming dashboard, you need:

* **Beneficiary Address**: Your wallet must be included in a vesting schedule
* **Hathor Wallet**: Compatible wallet connected to the network
* **Network Access**: Access to Hathor Testnet or Mainnet
* **HTR Tokens**: Small amount for transaction fees

## Step 1: Access the Dashboard

### Connect Your Wallet

1. Visit [testnet.tools.dozer.finance](https://testnet.tools.dozer.finance/)
2. Click **"Connect Wallet"** in the top right corner
3. Select your preferred wallet connection method
4. Approve the connection in your wallet

### Navigate to Claiming Interface

1. Look for **"Token Claiming"** or **"My Vested Tokens"** in the main navigation
2. Alternatively, access through the project page if you're a project owner
3. The dashboard will automatically detect your vested token allocations

## Step 2: Understanding Your Vesting Status

### Dashboard Overview

The claiming dashboard displays several key sections:

#### Token Information

* Token name and symbol
* Total allocated amount
* Current wallet balance
* Project information and links

#### Vesting Summary

* Total tokens allocated to your address
* Tokens already claimed
* Tokens currently available to claim
* Tokens still locked (vesting)

#### Vesting Schedule

* Cliff period end date
* Vesting start date
* Vesting completion date
* Next claimable amount and date

### Status Indicators

#### Available to Claim 🟢

* Tokens that have vested and are ready to claim
* Shows exact amount available
* Claim button is active

#### Vesting in Progress 🟡

* Tokens currently being released over time
* Shows progress percentage
* Next claim date displayed

#### Cliff Period 🔴

* Tokens locked during initial period
* No tokens available yet
* Shows cliff end date

#### Fully Vested ✅

* All tokens have been released
* No more tokens to claim
* Complete vesting history available

## Step 3: Claiming Your Tokens

### Check Available Tokens

1. Review the **"Available to Claim"** section
2. Verify the token amount and project details
3. Ensure you have sufficient HTR for transaction fees

### Claim Process

1. Click **"Claim Tokens"** button
2. Review the transaction details in the popup
3. Confirm the claim amount and recipient address
4. Approve the transaction in your wallet
5. Wait for transaction confirmation

### Claim Confirmation

After successful claiming:

* **Transaction Hash**: Record the transaction ID for your records
* **Updated Balance**: Check your wallet for the new token balance
* **Claim History**: The transaction will appear in your claim history
* **Next Claim Date**: View when the next tokens will be available

## Step 4: Monitoring Vesting Progress

### Progress Tracking

#### Vesting Timeline

* Visual timeline showing vesting progress
* Markers for important dates (cliff end, milestones)
* Percentage completion indicator

#### Claim History

* Complete record of all previous claims
* Transaction details and timestamps
* Running total of claimed tokens

#### Upcoming Releases

* Next claimable amount
* Date of next token release
* Remaining vesting duration

### Notifications

#### Email Notifications (if enabled)

* Alerts when tokens become available
* Reminders for upcoming releases
* Important updates about vesting schedules

#### Dashboard Alerts

* Real-time status updates
* Important announcements
* System maintenance notifications

## Step 5: Managing Multiple Allocations

### Multiple Projects

If you have vested tokens from multiple projects:

1. **Project Selector**: Use dropdown to switch between projects
2. **Unified View**: See all allocations in one dashboard
3. **Individual Claims**: Claim from each project separately

### Different Vesting Schedules

#### Team Allocation

* Longer cliff periods
* Gradual release over extended time
* Higher total allocation amounts

#### Advisor Allocation

* Shorter cliff periods
* Faster vesting schedules
* Smaller allocation amounts

#### Investor Allocation

* Variable schedules based on agreement
* May include different vesting terms
* Professional investment terms

## Troubleshooting

### Common Issues

#### No Tokens Available

* Check if cliff period has ended
* Verify your wallet address is correct
* Ensure vesting schedule is active

#### Transaction Fails

* Ensure sufficient HTR for transaction fees
* Check network connection
* Verify wallet is unlocked

#### Incorrect Token Amount

* Contact project team for verification
* Check vesting schedule details
* Review claim history for discrepancies

#### Dashboard Not Loading

* Refresh the page
* Check network connection
* Try connecting wallet again

### Getting Help

If you encounter issues:

1. **Project Support**: Contact the project team directly
2. **Platform Support**: Reach out to <contact@dozer.finance>
3. **Community Help**: Join our [Discord community](https://discord.gg/KRhaCp6P)
4. **Documentation**: Check our [Troubleshooting Guide](https://github.com/Dozer-Protocol/white-paper/blob/main/gitbook/products/troubleshooting.md)

## Security Best Practices

### Wallet Security

#### Secure Storage

* Use hardware wallets for large token amounts
* Keep private keys secure and backed up
* Enable all available security features

#### Transaction Verification

* Always verify transaction details before confirming
* Check recipient addresses carefully
* Keep records of all transactions

### Claiming Strategy

#### Regular Claims

* Claim tokens regularly to avoid accumulation
* Monitor vesting schedules for optimal timing
* Consider tax implications of token claims

#### Emergency Access

* Maintain backup access methods
* Keep contact information for project teams
* Document all vesting agreements

## Advanced Features

### Bulk Claims

#### Multiple Projects

* Claim from multiple projects in one transaction
* Reduce transaction fees
* Streamline claiming process

#### Scheduled Claims

* Set up automatic claiming (if available)
* Reduce manual monitoring
* Optimize claiming timing

### Analytics and Reporting

#### Claim History Export

* Download complete claim history
* Generate reports for tax purposes
* Track vesting performance

#### Portfolio Overview

* View all vested tokens across projects
* Track total allocation values
* Monitor overall vesting progress

***

## Next Steps

Now that you understand how to claim your vested tokens:

1. **Set Up Monitoring**: Regularly check your vesting status
2. **Plan Claims**: Develop a strategy for claiming tokens
3. **Stay Informed**: Keep up with project updates and announcements
4. **Secure Storage**: Ensure your claimed tokens are stored securely

For additional support or questions about the claiming process, don't hesitate to reach out to our community or support team.
