LaunchLab 啟動時，代幣解鎖是選用項目。在 Initialize 時設定 vesting_param.total_locked_amount = 0，下面的章節將不適用。一旦啟用，時程在啟動的生命週期內固定；懸崖期和解鎖期無法事後變更。
為什麼需要解鎖機制
聯合曲線在募資期間售出 base_supply_graduation 個代幣，並將餘額用於畢業後的流動性池。解鎖機制從供應量中切割出額外的部分，將其鎖定一段可配置的懸崖期，然後線性地釋放給一個或多個受益人──通常是建立者的團隊、顧問或平台合作夥伴。
實際應用案例：
- 團隊分配。 建立者為創始團隊預留供應量的 5%，鎖定 6 個月，然後在接下來的 12 個月內線性解鎖。
- 平台分配。 啟動平台通過
CreatePlatformVestingAccount 在每個列表項目上接收代幣的一部分，使用相同的時程。
- 顧問／貢獻者贈款。 多個受益人各自擁有
VestingRecord 帳戶，每個帳戶獨立跟蹤其已領取的數量。
鎖定的代幣永遠不會進入曲線，也不是畢業後 LP 的一部分。它們在池的 base_vault 中處於休眠狀態，直到每位受益人呼叫 ClaimVestedToken。
時程形狀
啟動時的代幣解鎖由三個數字描述，並在 Initialize 時記錄一次：
| 欄位 | 類型 | 含義 |
|---|
total_locked_amount | u64 | 跨所有受益人（建立者 + 平台）鎖定的所有基礎代幣的總和。必須滿足 total_locked_amount <= supply * max_lock_rate / 1_000_000（來自 GlobalConfig 的約束）。 |
cliff_period | u64（秒） | 募資結束後任何代幣解鎖前的等待時間。 |
unlock_period | u64（秒） | 懸崖期後線性解鎖窗口的持續時間。0 表示所有代幣在懸崖期結束時立即解鎖。 |
PoolState.vesting_schedule（一個 VestingSchedule 結構）加上鏈上的 start_time，程序在募資成功結束的時刻（首次滿足畢業條件時）記錄為 block_time + cliff_period。
// states/pool.rs
pub struct VestingSchedule {
pub total_locked_amount: u64,
pub cliff_period: u64,
pub unlock_period: u64,
pub start_time: u64, // set by the program at fundraising end
pub allocated_share_amount: u64, // running sum of allocations to vesting records
}
allocated_share_amount 是已通過 CreateVestingAccount / CreatePlatformVestingAccount 分配給 VestingRecord 帳戶的總金額。它永遠不能超過 total_locked_amount。如果建立者過度分配，下一個 CreateVestingAccount 呼叫將以 InvalidTotalLockedAmount 回退。
線性解鎖公式
募資結束後，程序為每個 VestingRecord 計算累計解鎖金額為：
elapsed = min(now, start_time + unlock_period) − start_time
unlocked_amount = token_share_amount × elapsed / unlock_period
unlock_period == 0，整個 token_share_amount 在 start_time 時一次性變為可領取。否則曲線是從 start_time 的 0 到 start_time + unlock_period 的 token_share_amount 的直線，之後上限為 token_share_amount。
每次 ClaimVestedToken 呼叫轉移的金額是新計算的累計解鎖金額與記錄上的 claimed_amount 欄位之間的差值。
delta_amount = unlocked_amount − vesting_record.claimed_amount
vesting_record.claimed_amount = unlocked_amount
start_time 之前領取將以 VestingNotStarted 回退。在 start_time + unlock_period 之後領取會結算全部餘額。
帳戶佈局
VestingSchedule
在 PoolState 上內聯。參見 accounts。
VestingRecord
每位受益人的記錄。PDA 衍生為：
seeds = [
b"pool_vesting",
pool_state.key(),
beneficiary.key(),
]
program = LaunchLab program
// states/vesting.rs
#[account]
pub struct VestingRecord {
pub epoch: u64, // recent_epoch tracker
pub pool: Pubkey, // back-pointer to PoolState
pub beneficiary: Pubkey, // who can call ClaimVestedToken
pub claimed_amount: u64, // cumulative claimed
pub token_share_amount: u64, // total allocated to this beneficiary
pub padding: [u64; 8],
}
VestingRecord。在同一啟動上再次分配給相同的受益人將回退，因為 PDA 已存在。
CreateVestingAccount
僅限建立者。通過初始化新的 VestingRecord PDA 將池的 total_locked_amount 的一部分分配給新的受益人。
參數
share_amount: u64 // tokens to assign to this beneficiary
| # | 名稱 | W | S | 備註 |
|---|
| 1 | creator | W | S | 必須等於 pool_state.creator；為新帳戶支付租金。 |
| 2 | beneficiary | W | | 稍後接收已解鎖的代幣。公鑰在此被鎖定——無法變更。 |
| 3 | pool_state | W | | 變更以增加 vesting_schedule.allocated_share_amount。 |
| 4 | vesting_record | W | | init；PDA [b"pool_vesting", pool_state, beneficiary]。 |
| 5 | system_program | | | 帳戶建立所需。 |
share_amount > 0。pool_state.vesting_schedule.allocated_share_amount + share_amount <= total_locked_amount。beneficiary 公鑰在此池上沒有現有的 VestingRecord。
後置條件
vesting_record 初始化，其中 token_share_amount = share_amount、claimed_amount = 0。pool_state.vesting_schedule.allocated_share_amount += share_amount。
常見錯誤 — InvalidTotalLockedAmount、InvalidInput。
CreateVestingAccount 的平台管理員變體。平台的解鎖錢包（存儲在 PlatformConfig.platform_vesting_wallet 上）是受益人，份額由 PlatformConfig.platform_vesting_scale 限制。
簽署者必須等於 platform_config.platform_vesting_wallet。其他帳戶與 CreateVestingAccount 相同。當平台簽約在其列表的每次啟動上接收固定的解鎖份額時使用。
ClaimVestedToken
僅限受益人。將任何新解鎖的代幣從池的 base_vault 轉移到受益人的 ATA。
參數
無（程序從時程中計算領取金額）。
帳戶
| # | 名稱 | W | S | 備註 |
|---|
| 1 | beneficiary | W | S | 必須等於 vesting_record.beneficiary。 |
| 2 | authority | | | PDA [b"vault_auth_seed"]；簽署金庫轉移。 |
| 3 | pool_state | W | | 僅在時程需要重新驗證時變更。 |
| 4 | vesting_record | W | | claimed_amount 已更新。 |
| 5 | base_vault | W | | 池的基礎代幣金庫；被扣除。 |
| 6 | beneficiary_ata | W | | 接收已解鎖的代幣；init_if_needed。 |
| 7 | base_mint | | | 池的基礎鑄幣。 |
| 8 | token_program | | | SPL Token 或 Token-2022 程序。 |
| 9 | associated_token_program | | | 如果需要，用於 ATA 建立。 |
| 10 | system_program | | | 帳戶建立所需。 |
block_time >= pool_state.vesting_schedule.start_time（否則為 VestingNotStarted）。pool_state.status == PoolStatus::Migrated — 畢業必須已發生。在畢業前呼叫將回退。- 已解鎖金額的差值大於零。無操作呼叫（計算差值為 0）將回退。
後置條件
vesting_record.claimed_amount 前進至新的累計解鎖金額。delta_amount 的基礎代幣轉移至 beneficiary_ata。
常見錯誤 — VestingNotStarted、NoAssetsToCollect、MathOverflow。
工作範例
啟動設定：
supply = 1_000_000_000total_locked_amount = 100_000_000（供應量的 10%）cliff_period = 180 * 86400（180 天）unlock_period = 365 * 86400（懸崖期後 1 年線性解鎖）
建立者在 Initialize 後立即分配兩個 VestingRecord 帳戶：
- 受益人 A（團隊）：
share_amount = 70_000_000
- 受益人 B（顧問）：
share_amount = 30_000_000
allocated_share_amount = 100_000_000，等於 total_locked_amount — 無法進行進一步分配。
募資在 2027-01-01T00:00Z 完成。程序設定 start_time = 2027-01-01 + 180 天 = 2027-06-30。
在 2027-09-30（start_time 後 90 天），受益人 A 呼叫 ClaimVestedToken：
elapsed = min(now, start_time + 365·86400) − start_time
= 90 · 86400
unlocked_amount = 70_000_000 × (90 / 365) ≈ 17_260_274
delta_amount = 17_260_274 − 0 = 17_260_274
vesting_record.claimed_amount 前進至 17_260_274。
六個月後（2028-03-31，start_time 後 270 天），A 再次領取：
unlocked_amount = 70_000_000 × (270 / 365) ≈ 51_780_822
delta_amount = 51_780_822 − 17_260_274 = 34_520_548
2028-06-30（unlock_period 結束）後，下一次領取轉移剩餘的約 1822 萬個代幣，並將 claimed_amount 設定為 token_share_amount。
邊界情況
- 受益人丟失其金鑰。
VestingRecord.beneficiary 上的公鑰是唯一可以呼叫 ClaimVestedToken 的簽署者。沒有恢復路徑。如果恢復很重要，應將受益人設為多簽。
- Token-2022 轉移費用。 如果基礎鑄幣是具有轉移費用擴展的 Token-2022 鑄幣，受益人接收
delta_amount − transfer_fee，而不是完整的差值。池的金庫仍然記錄轉移的總額 — 差值累積到鑄幣的保留費用帳戶。
- 池未畢業。 在畢業前呼叫
ClaimVestedToken 將回退。解鎖時鐘只在募資實際完成時開始；中止的啟動（永遠不設定 start_time）將鎖定的代幣留在金庫中無法使用。
- 超額分配嘗試。 程序在每個
CreateVestingAccount 上強制執行 allocated_share_amount <= total_locked_amount。total_locked_amount 中未分配的餘額（如有）被遺失 — 一旦啟動畢業，這些代幣將永遠留在金庫中。除非是有意，否則分配全部金額。
來源：
raydium-launch/programs/launchpad/src/states/vesting.rs — VestingRecord。raydium-launch/programs/launchpad/src/states/pool.rs — VestingSchedule、VestingParams、is_vesting_started、vesting_end_time。raydium-launch/programs/launchpad/src/instructions/create_vesting_account.rs。raydium-launch/programs/launchpad/src/instructions/claim_vested_token.rs。
