🔐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
Go to your project's management dashboard
Click on the "Vesting" card
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: Tokens reserved for staking rewards
Status: Coming Soon (feature under development)
Configuration: Set percentage of total supply for staking rewards
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
Click "+ Add Allocation" in the Vesting Allocations section
A new allocation card will appear
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:
Check Percentages: Ensure total allocations don't exceed 100%
Verify Addresses: Double-check all beneficiary addresses
Review Schedules: Confirm cliff periods and vesting durations
Test Calculations: Verify token amounts in previews
Deploy Vesting
Click "Deploy Vesting" or similar confirmation button
Review the transaction details
Confirm the transaction in your wallet
Wait for confirmation
Step 6: Post-Deployment
Verification
After successful deployment:
Check Transaction: Verify the vesting contract deployment
Review Dashboard: Confirm vesting schedules appear correctly
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:
Check our Troubleshooting Guide
Join our Discord community
Contact support at [email protected]
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 to understand how beneficiaries can access their tokens.
Last updated
Was this helpful?