Back to How-To Guides
For Creators

Configure Token Vesting & Tokenomics

Set up professional tokenomics with team vesting schedules to protect your investors and align your team

⏱️ 15-20 minutes📊 Beginner-Friendly🔒 Required Before Launch

What You'll Learn

Why vesting matters for your project
How to set total supply & distribution
Adding team members with allocations
Setting vesting durations & cliffs
Using quick templates
Requesting token deployment

Why Configure Vesting?

Token vesting is essential for professional project launches. It protects investors, aligns your team's incentives, and prevents token dumps.

🛡️

Protects Investors

Prevents team from dumping tokens immediately, maintaining price stability for your investors.

🎯

Aligns Incentives

Team benefits from long-term success since their tokens unlock gradually over time.

Builds Trust

Professional tokenomics signal serious commitment and increase investor confidence.

Step-by-Step Guide

1

Navigate to Tokenomics Configuration

Go to your project dashboard and access the tokenomics configuration page.

Dashboard → My Projects → [Your Project] → Launch Tab → "🔧 Configure Tokenomics & Vesting"

💡 Tip: This button is only visible for projects in APPROVED status. If you don't see it, your project needs admin approval first.

2

Set Global Token Settings

Configure your token's total supply and default vesting parameters.

Total Supply

How many tokens will exist. Common ranges: 100M - 10B tokens.

Example: 1,000,000,000 (1 billion tokens)

Default Vesting Duration

How long team tokens take to fully unlock (in days).

Film Projects: 90-180 days | Tech Startups: 730-1460 days

Default Cliff Period

Initial lock period before any tokens vest (in days).

Common: 0-30 days (films) | 180-365 days (startups)
3

Use Quick Templates (Optional)

Choose a pre-configured template based on your project type.

🎬 Film/Creative

  • • 90 days vesting
  • • No cliff
  • • Fast unlock for creative cycles

📊 Standard

  • • 180 days vesting
  • • 30-day cliff
  • • Balanced approach

🚀 Startup

  • • 730 days vesting (2 years)
  • • 365-day cliff (1 year)
  • • Long-term commitment

🏢 Enterprise

  • • 1460 days vesting (4 years)
  • • 365-day cliff (1 year)
  • • Maximum alignment
4

Add Team Members

Add each team member who should receive tokens. Click "+ Add Team Member" and fill in:

Name & Role:Identifying information (e.g., "John Doe" - "Film Director")
Wallet Address:Their Ethereum wallet (starts with 0x...)
Token Amount:How many tokens they'll receive
Category:FOUNDER, TEAM, ADVISOR, or EARLY_INVESTOR
Custom Vesting:Override default duration and cliff for this person
Revocable:Can admin cancel if they leave? (Yes for employees, No for founders)
5

Review Summary & Validation

The system automatically validates your configuration and shows a summary.

✅ Validation Checks:

  • • All wallet addresses are valid Ethereum addresses
  • • All token amounts are greater than zero
  • • All cliff periods are less than or equal to vesting durations
  • • Total allocated does not exceed total supply
  • • No duplicate wallet addresses

⚠️ Warnings (Non-Blocking):

  • • Short vesting periods (<90 days)
  • • High team allocation (>80% of supply)
  • • Founders with <1 year vesting
6

Save Configuration

Click the "💾 Save Tokenomics Configuration" button at the bottom of the page.

📌 What Happens Next:
1. Your configuration is saved to the database
2. Admin receives a notification to review
3. You can modify anytime before token deployment
4. Once deployed, schedules are locked on-chain

7

Request Token Deployment

After saving your tokenomics, request admin to deploy your token.

Dashboard → My Projects → [Your Project] → Launch Tab → "📤 Request Token Deployment"

You can add an optional message to admin (e.g., preferred launch date, special requirements).

🎉 After Deployment:
• You'll receive a notification
• Tokens will be deployed on-chain
• Vesting schedules will be enforced by smart contract
• You can control launch mode (PREVIEW/LIVE)
• Team members can view their vesting at /dashboard/vesting

Best Practices

✅ DO: Use Longer Vesting for Founders

Founders should have 1-4 year vesting to signal long-term commitment. This builds investor confidence.

✅ DO: Include Cliff Periods

Cliffs prevent team members from leaving immediately after getting tokens. 30-90 days is common.

✅ DO: Make Employee Vesting Revocable

Protects your project if employees leave or underperform. Founders should be non-revocable.

❌ DON'T: Allocate >50% to Team

Leave enough for liquidity pools and public sale. 20-30% team allocation is the sweet spot.

❌ DON'T: Skip Vesting Entirely

No vesting is a major red flag for investors. Always use vesting for professional tokenomics.

Troubleshooting

Q: I don't see the "Configure Tokenomics" button

A: Your project must be in APPROVED status first. Submit your project for admin approval, then the tokenomics button will appear.

Q: I get "Invalid wallet address" error

A: Make sure the wallet address starts with "0x" and is exactly 42 characters long. Copy-paste directly from the wallet to avoid typos.

Q: Can I modify after saving?

A: Yes, BEFORE token deployment! Return to the tokenomics page, make changes, and save again. After deployment, vesting is locked on-chain and cannot be modified.

🎉 Ready to Launch!

After configuring your tokenomics and requesting deployment, admin will review and deploy your token with the vesting schedules you configured.