跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

本頁內容由 AI 自動翻譯，所有內容以英文版本為準。查看英文版 →
LaunchLab 啟動時，代幣解鎖是選用項目。在 Initialize 時設定 vesting_param.total_locked_amount = 0，下面的章節將不適用。一旦啟用，時程在啟動的生命週期內固定；懸崖期和解鎖期無法事後變更。

​
為什麼需要解鎖機制

聯合曲線在募資期間售出 base_supply_graduation 個代幣，並將餘額用於畢業後的流動性池。解鎖機制從供應量中切割出額外的部分，將其鎖定一段可配置的懸崖期，然後線性地釋放給一個或多個受益人──通常是建立者的團隊、顧問或平台合作夥伴。 實際應用案例：
  • 團隊分配。 建立者為創始團隊預留供應量的 5%，鎖定 6 個月，然後在接下來的 12 個月內線性解鎖。
  • 平台分配。 啟動平台通過 CreatePlatformVestingAccount 在每個列表項目上接收代幣的一部分，使用相同的時程。
  • 顧問／貢獻者贈款。 多個受益人各自擁有 VestingRecord 帳戶，每個帳戶獨立跟蹤其已領取的數量。
鎖定的代幣永遠不會進入曲線，也不是畢業後 LP 的一部分。它們在池的 base_vault 中處於休眠狀態，直到每位受益人呼叫 ClaimVestedToken。

​
時程形狀

啟動時的代幣解鎖由三個數字描述，並在 Initialize 時記錄一次：
欄位類型含義
total_locked_amountu64跨所有受益人（建立者 + 平台）鎖定的所有基礎代幣的總和。必須滿足 total_locked_amount <= supply * max_lock_rate / 1_000_000（來自 GlobalConfig 的約束）。
cliff_periodu64（秒）募資結束後任何代幣解鎖前的等待時間。
unlock_periodu64（秒）懸崖期後線性解鎖窗口的持續時間。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
帳戶
#名稱WS備註
1creatorWS必須等於 pool_state.creator；為新帳戶支付租金。
2beneficiaryW稍後接收已解鎖的代幣。公鑰在此被鎖定——無法變更。
3pool_stateW變更以增加 vesting_schedule.allocated_share_amount。
4vesting_recordWinit；PDA [b"pool_vesting", pool_state, beneficiary]。
5system_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。

​
CreatePlatformVestingAccount

CreateVestingAccount 的平台管理員變體。平台的解鎖錢包（存儲在 PlatformConfig.platform_vesting_wallet 上）是受益人，份額由 PlatformConfig.platform_vesting_scale 限制。 簽署者必須等於 platform_config.platform_vesting_wallet。其他帳戶與 CreateVestingAccount 相同。當平台簽約在其列表的每次啟動上接收固定的解鎖份額時使用。

​
ClaimVestedToken

僅限受益人。將任何新解鎖的代幣從池的 base_vault 轉移到受益人的 ATA。 參數 無（程序從時程中計算領取金額）。 帳戶
#名稱WS備註
1beneficiaryWS必須等於 vesting_record.beneficiary。
2authorityPDA [b"vault_auth_seed"]；簽署金庫轉移。
3pool_stateW僅在時程需要重新驗證時變更。
4vesting_recordWclaimed_amount 已更新。
5base_vaultW池的基礎代幣金庫；被扣除。
6beneficiary_ataW接收已解鎖的代幣；init_if_needed。
7base_mint池的基礎鑄幣。
8token_programSPL Token 或 Token-2022 程序。
9associated_token_program如果需要，用於 ATA 建立。
10system_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_000
  • total_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
A 的錢包接收 1726 萬個基礎代幣。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
A 接收另外 3452 萬個代幣。在 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。