LaunchLab ベスティング

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.

​

ベスティングの理由

• チーム配分。 クリエイターが供給の 5% をファウンディングチームに予約し、6 ヶ月ロックして、その後 12 ヶ月で線形アンロック。
• プラットフォーム配分。 ローンチプラットフォームは CreatePlatformVestingAccount を通じて、同じスケジュールで、リストする各トークンのスライスを受け取ります。
• アドバイザー / 協力者グラント。 複数の受益者がそれぞれの VestingRecord アカウントを持ち、各自が独立してクレームされた量を追跡します。

​

スケジュール形状

// states/pool.rs
pub struct VestingSchedule {
    pub total_locked_amount:     u64,
    pub cliff_period:            u64,
    pub unlock_period:           u64,
    pub start_time:              u64,   // プログラムが募資終了時に設定
    pub allocated_share_amount:  u64,   // ベスティングレコードへの配分の累積合計
}

​

線形アンロック公式

elapsed         = min(now, start_time + unlock_period) − start_time
unlocked_amount = token_share_amount × elapsed / unlock_period

delta_amount    = unlocked_amount − vesting_record.claimed_amount
vesting_record.claimed_amount = unlocked_amount

​

アカウントレイアウト

​

VestingSchedule

​

VestingRecord

seeds = [
  b"pool_vesting",
  pool_state.key(),
  beneficiary.key(),
]
program = LaunchLab program

// states/vesting.rs
#[account]
pub struct VestingRecord {
    pub epoch:               u64,         // recent_epoch トラッカー
    pub pool:                Pubkey,      // PoolState への逆ポインタ
    pub beneficiary:         Pubkey,      // ClaimVestedToken を呼び出せるユーザー
    pub claimed_amount:      u64,         // 累積クレーム額
    pub token_share_amount:  u64,         // この受益者に配分される総額
    pub padding:             [u64; 8],
}

​

命令

​

CreateVestingAccount

share_amount: u64    // この受益者に割り当てるトークン

• 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。

​

CreatePlatformVestingAccount

​

ClaimVestedToken

• block_time >= pool_state.vesting_schedule.start_time（そうでなければ VestingNotStarted）。
• pool_state.status == PoolStatus::Migrated — 卒業が既に発生している必要があります。卒業前に呼び出すとリバートされます。
• アンロック額のデルタが 0 より大きい。無操作呼び出し（計算されたデルタが 0）はリバートされます。

• vesting_record.claimed_amount は新しい累積アンロック額に進みます。
• delta_amount の基本トークンが beneficiary_ata に転送されます。

​

実例

• supply = 1_000_000_000
• total_locked_amount = 100_000_000（供給の 10%）
• cliff_period = 180 * 86400（180 日）
• unlock_period = 365 * 86400（クリフ後 1 年線形）

• 受益者 A（チーム）: share_amount = 70_000_000
• 受益者 B（アドバイザー）: share_amount = 30_000_000

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

unlocked_amount = 70_000_000 × (270 / 365) ≈ 51_780_822
delta_amount    = 51_780_822 − 17_260_274 = 34_520_548

​

エッジケース

• 受益者が鍵を失う。 VestingRecord.beneficiary の公開鍵は、ClaimVestedToken を呼び出せる唯一の署名者です。回復パスはありません。回復が重要な場合は、受益者をマルチシグに設定してください。
• Token-2022 転送手数料。 基本ミントが転送手数料拡張を持つ Token-2022 ミントの場合、受益者は delta_amount − transfer_fee を受け取り、全デルタではありません。プールのボルトはまだ転送された総額を記録します — 差額はミントの保留中手数料アカウントに累積されます。
• プール未卒業。 卒業前に ClaimVestedToken を呼び出すとリバートされます。ベスティング時間は募資が実際に完了したときのみ開始されます。中止されたローンチ（start_time を設定しない）は、ロックされたトークンをボルト内に到達不可能なままにします。
• 過剰配分の試み。 プログラムは CreateVestingAccount のすべてで allocated_share_amount <= total_locked_amount を強制します。total_locked_amount の未配分のままの残り（ある場合）は 失われます — ローンチが卒業すると、それらのトークンは永遠にボルト内に留まります。そうしたい場合を除き、全額を配分してください。

​

ポインタ

• products/launchlab/accounts — VestingSchedule を含む完全な PoolState レイアウト。
• products/launchlab/instructions — 卒業ライフサイクル。
• products/launchlab/platform-config — プラットフォーム配分用の platform_vesting_scale セマンティクス。
• products/launchlab/global-config — total_locked_amount を制限する max_lock_rate 上限。

• 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。