enum AllocationType {
    Founder,          // 30M: 3M TGE, 6mo cliff, 24mo vest
    Treasury,         // 13M: 6.5M TGE, 12mo vest
    EcosystemRewards  // 25M: Released via rewards contracts
}

function initializeAllocations() external onlyOwner

event AllocationsInitialized(uint256 tgeTimestamp);

function setBeneficiary(
    AllocationType allocationType,
    address beneficiary
) external onlyOwner

function proposeBeneficiaryChange(
    AllocationType allocationType,
    address newBeneficiary
) external

event BeneficiaryChangeProposed(
    AllocationType indexed allocationType,
    address indexed currentBeneficiary,
    address indexed newBeneficiary,
    uint256 effectiveTime
);

function executeBeneficiaryChange(AllocationType allocationType) external

function cancelBeneficiaryChange(AllocationType allocationType) external

function claim(AllocationType allocationType) external nonReentrant

event TokensClaimed(
    AllocationType indexed allocationType,
    address indexed beneficiary,
    uint256 amount
);

function getClaimable(AllocationType allocationType) public view returns (uint256)

function getAllocationStatus(AllocationType allocationType) external view returns (
    uint256 totalAmount,
    uint256 vestedAmount,
    uint256 claimedAmount,
    uint256 claimableAmount,
    uint256 vestingStart,
    uint256 cliffEnd,
    uint256 vestingEnd,
    address beneficiary
)

function getPendingBeneficiaryChange(AllocationType allocationType) external view returns (
    address newBeneficiary,
    uint256 effectiveTime,
    uint256 timeRemaining
)

function getAllAllocations() external view returns (Allocation[3] memory)

function getTotalClaimed() external view returns (uint256)
function getTotalRemaining() external view returns (uint256)

TGE                  6 months               30 months
|                      |                       |
v                      v                       v
[3M TGE]---[CLIFF]---[===== 27M LINEAR =====]

At TGE:     3M unlocked
Month 6:    3M (cliff ends, vesting begins)
Month 12:   3M + 6.75M = 9.75M
Month 18:   3M + 13.5M = 16.5M
Month 24:   3M + 20.25M = 23.25M
Month 30:   30M (fully vested)

TGE                                     12 months
|                                          |
v                                          v
[6.5M TGE]---[======= 6.5M LINEAR =======]

At TGE:     6.5M unlocked
Month 6:    6.5M + 3.25M = 9.75M
Month 12:   13M (fully vested)

TGE
|
v
[========= 25M AVAILABLE FOR REWARDS =========]

All 25M available immediately for rewards distribution.

import { ethers } from 'ethers';

const distribution = new ethers.Contract(address, abi, signer);

// Check allocation status
const status = await distribution.getAllocationStatus(0); // Founder
console.log('Total:', ethers.formatEther(status.totalAmount));
console.log('Vested:', ethers.formatEther(status.vestedAmount));
console.log('Claimed:', ethers.formatEther(status.claimedAmount));
console.log('Claimable:', ethers.formatEther(status.claimableAmount));

// Claim tokens (as beneficiary)
const claimable = await distribution.getClaimable(0); // Founder
if (claimable > 0) {
  const tx = await distribution.claim(0);
  await tx.wait();
}

// Propose beneficiary change (2-day timelock)
const tx = await distribution.proposeBeneficiaryChange(
  0, // Founder allocation
  newBeneficiaryAddress
);
await tx.wait();

// After 2 days, execute the change
await distribution.executeBeneficiaryChange(0);