TokenVesting

📋 Contract Overview

Property	Value
📁 File	src/TokenVesting.sol
🔧 Type	Upgradeable UUPS Proxy
⚙️ Solidity	0.8.33
📜 License	MIT

🎯 Purpose: Manages BLTBY token vesting schedules for investors, team members, and stakeholders—ensuring tokens are released gradually over time.

---

📊 Vesting Types

📊 Vesting Types

Type	Cliff	Duration	Release
👼 Investor (Angel)	3 months	12 months	Linear
💰 Investor (VentureOne)	6 months	24 months	Linear
🏛️ Investor (Trust)	6 months	36 months	Custom
👥 Team	12 months	48 months	Linear
🎓 Advisor	6 months	24 months	Linear
🌐 Ecosystem	0	36 months	Linear

⚙️ Specifications

🔐 Roles

---

🔧 Functions

📝 Create

📝 Schedule Creation

Create Single Schedule

function createVestingSchedule(
    address beneficiary,
    uint256 amount,
    uint256 startTime,
    uint256 cliffDuration,
    uint256 vestingDuration,
    VestingType vestingType,
    bool revocable
) external onlyRole(VESTING_ADMIN_ROLE) returns (bytes32 scheduleId)

Requirements:

• Beneficiary not zero address

• Amount greater than zero

• Sufficient BLTBY in contract

• Duration greater than cliff

Batch Create

function createBatchVestingSchedules(
    address[] calldata beneficiaries,
    uint256[] calldata amounts,
    uint256 startTime,
    uint256 cliffDuration,
    uint256 vestingDuration,
    VestingType vestingType,
    bool revocable
) external onlyRole(VESTING_ADMIN_ROLE) returns (bytes32[] memory scheduleIds)

📤 Release

❌ Revoke

👁️ View

---

📈 Vesting Calculation

Linear vesting after cliff period.

function computeVestedAmount(...) public view returns (uint256) {
    uint256 currentTime = block.timestamp;

    // Before cliff: nothing vested
    if (currentTime < startTime + cliffDuration) {
        return 0;
    }

    // After full vesting: everything vested
    if (currentTime >= startTime + vestingDuration) {
        return totalAmount;
    }

    // During vesting: linear calculation
    uint256 timeVested = currentTime - startTime;
    return (totalAmount * timeVested) / vestingDuration;
}

---

📊 Timeline Example

Example: 1,000,000 BLTBY over 24 months with 6-month cliff

Month	Vested	Releasable
0-6 (Cliff)	0	0
7	~291,667	291,667
12	500,000	500,000 - released
24	1,000,000	1,000,000 - released

---

📜 Events & Errors

📢 Events

event VestingScheduleCreated(
    bytes32 indexed scheduleId,
    address indexed beneficiary,
    uint256 amount,
    uint256 startTime,
    uint256 cliffDuration,
    uint256 vestingDuration
);
event TokensReleased(
    bytes32 indexed scheduleId,
    address indexed beneficiary,
    uint256 amount
);
event VestingRevoked(
    bytes32 indexed scheduleId,
    uint256 unvestedReturned
);

⛔ Errors

---

🔗 Contract Interactions

Contract	Interaction
🪙 BLTBYToken	Holds and transfers vesting tokens
🔧 InvestorMintContract	Creates investor schedules
🏦 Treasury	Receives revoked unvested tokens

---

🔗 Investor Integration

The InvestorMintContract creates vesting schedules automatically:

// In InvestorMintContract.invest()
vestingContract.createVestingSchedule(
    investor,
    bltbyAmount,
    block.timestamp,
    tierCliff,
    tierDuration,
    VestingType.Investor,
    false  // Not revocable for investors
);

---

💻 Integration Examples

Creating a Schedule

const tx = await vestingContract.createVestingSchedule(
    beneficiaryAddress,
    parseEther("1000000"),  // 1M BLTBY
    Math.floor(Date.now() / 1000),  // Now
    6 * 30 * 24 * 60 * 60,  // 6 month cliff
    24 * 30 * 24 * 60 * 60, // 24 month total
    0,  // VestingType.Investor
    false  // Not revocable
);

Checking Releasable

const releasable = await vestingContract.getReleasableAmount(scheduleId);
console.log(`Can release: ${formatEther(releasable)} BLTBY`);

Releasing Tokens

await vestingContract.release(scheduleId);
// Tokens transferred to beneficiary

---

🔗 Related Pages

BLTBYTokenInvestorMintContractInvestment Tiers