Vesting trong 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.

​

Tại sao cần vesting

• Phân bổ cho đội. Một nhà tạo dự trữ, chẳng hạn, 5% cung cấp cho đội founding, bị khóa trong 6 tháng và mở khóa tuyến tính trong 12 tháng tiếp theo.
• Phân bổ cho nền tảng. Một nền tảng phát hành nhận được một phần từ mọi token mà nó liệt kê, theo cùng một lịch trình, thông qua CreatePlatformVestingAccount.
• Các khoản cấp cho cố vấn/người đóng góp. Nhiều người thụ hưởng có tài khoản VestingRecord riêng của họ, mỗi tài khoản theo dõi số tiền đã yêu cầu của chính mình một cách độc lập.

​

Hình dạng lịch trình

// 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
}

​

Công thức mở khóa tuyến tính

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

​

Bố cục tài khoản

​

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 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],
}

​

Các instruction

​

CreateVestingAccount

share_amount: u64    // tokens to assign to this beneficiary

• share_amount > 0.
• pool_state.vesting_schedule.allocated_share_amount + share_amount <= total_locked_amount.
• Pubkey beneficiary không có VestingRecord hiện có cho pool này.

• vesting_record được khởi tạo với 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 (nếu không VestingNotStarted).
• pool_state.status == PoolStatus::Migrated — graduation phải đã xảy ra. Gọi trước graduation sẽ trả về.
• Delta mở khóa-amount lớn hơn không. Một lệnh gọi không hoạt động (delta được tính toán là 0) sẽ trả về.

• vesting_record.claimed_amount tiến tới mở khóa tích lũy mới.
• delta_amount của base token được chuyển giao đến beneficiary_ata.

​

Ví dụ đã hoạt động

• supply = 1_000_000_000
• total_locked_amount = 100_000_000 (10% cung cấp)
• cliff_period = 180 * 86400 (180 ngày)
• unlock_period = 365 * 86400 (1 năm tuyến tính sau cliff)

• Người thụ hưởng A (đội): share_amount = 70_000_000
• Người thụ hưởng B (cố vấn): 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

​

Trường hợp đặc biệt

• Người thụ hưởng mất khóa của họ. Pubkey trên VestingRecord.beneficiary là signer duy nhất có thể gọi ClaimVestedToken. Không có đường dẫn khôi phục. Đặt người thụ hưởng thành multisig nếu khôi phục là vấn đề.
• Phí chuyển Token-2022. Nếu base mint là mint Token-2022 có extension phí chuyển giao, người thụ hưởng nhận delta_amount − transfer_fee, không phải delta đầy đủ. Vault của pool vẫn ghi lại số tiền được chuyển giao là số lượng brutto — sự khác biệt tích lũy vào tài khoản phí được giữ lại của mint.
• Pool chưa graduation. Gọi ClaimVestedToken trước graduation sẽ trả về. Đồng hồ vesting chỉ bắt đầu khi gây quỹ thực sự hoàn thành; một lần phát hành bị hủy (cái không bao giờ đặt start_time) để các token bị khóa không thể tiếp cận trong vault.
• Cố gắng phân bổ quá mức. Chương trình thực thi allocated_share_amount <= total_locked_amount trên mọi CreateVestingAccount. Phần còn lại (nếu có) của total_locked_amount để không được phân bổ là mất — những token đó nằm trong vault mãi mãi khi lần phát hành graduation. Phân bổ số tiền đầy đủ trừ khi đó là ý định.

​

Con trỏ

• products/launchlab/accounts — bố cục đầy đủ PoolState bao gồm VestingSchedule.
• products/launchlab/instructions — vòng đời graduation.
• products/launchlab/platform-config — ngữ nghĩa platform_vesting_scale cho phân bổ nền tảng.
• products/launchlab/global-config — trần max_lock_rate ràng buộc 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.