# Vesting Configuration The Vesting Blueprint Suite enables secure token distribution with customizable schedules and transparent on-chain management. This guide will walk you through setting up vesting schedules for your team, advisors, investors, and other stakeholders. ## What is Token Vesting? Token vesting is a mechanism that locks tokens for a specified period and releases them gradually over time. This ensures that team members, advisors, and investors remain committed to the project's long-term success. ### Key Benefits * **Align Incentives**: Keep team members committed to long-term project success * **Prevent Dumps**: Avoid sudden token dumps that could crash the price * **Build Trust**: Show transparency in token distribution to the community * **Regulatory Compliance**: Meet legal requirements for token distribution ## Prerequisites Before configuring vesting: * **Project Created**: You must have an active token project * **Token Supply**: Ensure you have tokens available for vesting * **Beneficiary Addresses**: Collect wallet addresses for all vesting recipients * **Vesting Parameters**: Plan your vesting schedules and percentages ## Step 1: Access Vesting Configuration ### Navigate to Vesting Setup 1. Go to your project's management dashboard 2. Click on the **"Vesting"** card 3. You'll see the vesting configuration interface ### Understanding the Interface The vesting configuration page has two main sections: ### Special Allocations * Pre-configured allocations for common use cases * Includes staking rewards, public sale, and liquidity pool allocations ### Vesting Allocations * Custom vesting schedules for specific beneficiaries * Flexible configuration for team, advisors, and investors * Add multiple allocation schedules as needed ## Step 2: Configure Special Allocations Special allocations are pre-configured token distributions for common project needs: #### Staking Rewards * **Purpose**: The percentage of the total supply that will be allocated to the staking rewards pool. When you configure vesting with a non-zero percentage here, a staking pool for your token is automatically created. Users can then stake your tokens to earn a share of these rewards over time. * **Configuration**: Set percentage of total supply for staking rewards and specify the pool duration * **Learn More**: For a detailed guide on setting up and managing your staking pool, see our [Staking Guide](/project-launch-tools/staking.md) #### Public Sale * **Purpose**: Tokens allocated for public token sale * **Configuration**: Set percentage for public sale distribution * **Usage**: These tokens will be available for public purchase #### Liquidity Pool * **Purpose**: Tokens for DEX liquidity provision * **Configuration**: Set percentage for liquidity pool * **Dependency**: Requires vesting configuration to be completed first #### Daily Staking Rewards * **Purpose**: Daily distribution of staking rewards * **Status**: Coming Soon (feature under development) * **Configuration**: Set daily reward amount > 💡 **Tip**: Special allocations help you plan your token distribution strategy. Configure these before setting up individual vesting schedules. ## Step 3: Create Vesting Allocations ### Add New Allocation 1. Click **"+ Add Allocation"** in the Vesting Allocations section 2. A new allocation card will appear 3. Fill out the following parameters: ### Allocation Configuration #### Name * Enter a descriptive name (e.g., "Team", "Advisors", "Early Investors") * Helps identify the beneficiary group * Use clear, consistent naming #### Percentage (%) * Set the percentage of total supply for this allocation * Enter as a number (e.g., 20 for 20%) * Ensure all percentages don't exceed 100% #### Beneficiary Address * Enter the Hathor wallet address of the recipient * Double-check the address for accuracy * Use the "Use owner address" checkbox if the recipient is the project owner #### Cliff Period (months) * Set the initial lock period before vesting begins * During this period, no tokens are released * Common values: 6-12 months for team, 0-3 months for advisors #### Vesting Duration (months) * Set the total time over which tokens will be released * After cliff period, tokens release linearly over this duration * Common values: 12-48 months depending on role ### Preview Function The preview section shows a summary of your vesting schedule: * **Recipient**: Name and address * **Allocation**: Percentage and token amount * **Schedule**: Cliff and vesting duration details ## Step 4: Advanced Configuration ### Multiple Allocations You can create multiple vesting schedules for different groups: #### Team Allocation * Higher cliff period (6-12 months) * Longer vesting duration (24-48 months) * Larger percentage of total supply #### Advisor Allocation * Shorter cliff period (0-3 months) * Medium vesting duration (12-24 months) * Smaller percentage of total supply #### Investor Allocation * Variable cliff period based on investment terms * Vesting duration based on agreement * Percentage based on investment amount ### Best Practices #### Cliff Periods * **Team**: 6-12 months to ensure commitment * **Advisors**: 0-3 months for immediate engagement * **Investors**: Based on investment agreement terms #### Vesting Durations * **Team**: 24-48 months for long-term alignment * **Advisors**: 12-24 months for ongoing support * **Investors**: 12-36 months based on agreement #### Percentage Distribution * **Team**: 15-25% of total supply * **Advisors**: 2-5% of total supply * **Investors**: 20-40% of total supply * **Community/Public**: 30-50% of total supply ## Step 5: Review and Deploy ### Final Review Before deploying your vesting configuration: 1. **Check Percentages**: Ensure total allocations don't exceed 100% 2. **Verify Addresses**: Double-check all beneficiary addresses 3. **Review Schedules**: Confirm cliff periods and vesting durations 4. **Test Calculations**: Verify token amounts in previews ### Deploy Vesting 1. Click **"Deploy Vesting"** or similar confirmation button 2. Review the transaction details 3. Confirm the transaction in your wallet 4. Wait for confirmation ## Step 6: Post-Deployment ### Verification After successful deployment: 1. **Check Transaction**: Verify the vesting contract deployment 2. **Review Dashboard**: Confirm vesting schedules appear correctly 3. **Test Access**: Ensure beneficiaries can access their vesting information ### Management #### Monitoring Vesting * Track vesting progress through the dashboard * Monitor token releases and remaining allocations * Update beneficiary information if needed #### Modifying Schedules * Most vesting parameters cannot be changed after deployment * Contact support for emergency modifications * Plan carefully before deployment ## Troubleshooting ### Common Issues #### Invalid Address Format * Ensure addresses are valid Hathor wallet addresses * Check for typos or extra characters * Use the address validation feature if available #### Percentage Exceeds 100% * Reduce individual allocation percentages * Remove unnecessary allocations * Recalculate total distribution #### Transaction Fails * Ensure sufficient HTR for transaction fees * Check network connection * Verify wallet is unlocked and connected ### Getting Help If you encounter issues: 1. Check our [Troubleshooting Guide](https://github.com/Dozer-Protocol/white-paper/blob/main/gitbook/products/troubleshooting.md) 2. Join our [Discord community](https://discord.gg/KRhaCp6P) 3. Contact support at ## Security Considerations ### Best Practices #### Address Verification * Always verify beneficiary addresses before deployment * Use official communication channels to confirm addresses * Consider using multi-signature wallets for large allocations #### Access Control * Limit access to vesting configuration to authorized personnel * Use secure wallets for project management * Regularly review and audit vesting schedules #### Emergency Procedures * Plan for emergency token release procedures * Document all vesting parameters and beneficiaries * Maintain backup records of all configurations *** Ready to learn how to claim vested tokens? Continue to our [Token Claiming Dashboard Guide](/project-launch-tools/token-claiming.md) to understand how beneficiaries can access their tokens. --- # 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/vesting-configuration.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.