Vesting LaunchLab

Token terkunci, jadwal cliff dan linear-unlock, akun VestingRecord per-penerima, serta instruksi create / claim yang digunakan kreator dan platform untuk mendistribusikan cadangan pasokan setelah graduation.

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.

Lihat versi bahasa Inggris →

Vesting adalah opsional pada peluncuran LaunchLab. Tetapkan vesting_param.total_locked_amount = 0 saat Initialize dan bagian di bawah tidak berlaku. Setelah diaktifkan, jadwal bersifat tetap selama masa hidup launch; cliff dan periode unlock tidak dapat diubah secara retroaktif.

​

Mengapa vesting

Kurva bonding menjual base_supply_graduation token selama penggalangan dana dan menabur sisa ke pool pasca-graduation. Vesting mengambil irisan tambahan dari pasokan, menguncinya untuk cliff yang dapat dikonfigurasi, kemudian mereleasenya secara linier kepada satu atau lebih penerima — biasanya tim kreator, penasihat, atau mitra platform.

Kasus penggunaan praktis:

• Alokasi tim. Kreator mereservasi, katakanlah, 5% dari pasokan untuk tim pendiri, dikunci selama 6 bulan dan dibuka secara linier selama 12 bulan berikutnya.
• Alokasi platform. Platform peluncuran menerima irisan dari setiap token yang ditempatkannya, pada jadwal yang sama, melalui CreatePlatformVestingAccount.
• Hibah penasihat / kontributor. Penerima ganda dengan akun VestingRecord mereka sendiri, masing-masing melacak jumlah yang diklaim mereka secara independen.

Token terkunci tidak pernah memasuki kurva dan bukan bagian dari LP graduation. Mereka tetap dorman di base_vault pool hingga setiap penerima memanggil ClaimVestedToken.

​

Bentuk jadwal

Vesting untuk peluncuran dijelaskan dengan tiga angka, dicatat sekali pada waktu Initialize:

Field	Type	Arti
total_locked_amount	u64	Jumlah semua token base terkunci di semua penerima (kreator + platform). Harus memenuhi total_locked_amount <= supply * max_lock_rate / 1_000_000 dari GlobalConfig yang mengikat.
cliff_period	u64 (detik)	Waktu tunggu setelah penggalangan dana berakhir sebelum token unlock apa pun.
unlock_period	u64 (detik)	Durasi jendela unlock linier setelah cliff. 0 berarti semuanya dibuka secara instan pada akhir cliff.

Ketiga nilai ini berada di PoolState.vesting_schedule (struct VestingSchedule) ditambah start_time on-chain, yang program catat sebagai block_time + cliff_period pada saat penggalangan dana berhasil berakhir (ketika kondisi graduation pertama kali terpenuhi).

// states/pool.rs
pub struct VestingSchedule {
    pub total_locked_amount:     u64,
    pub cliff_period:            u64,
    pub unlock_period:           u64,
    pub start_time:              u64,   // diatur program saat akhir penggalangan dana
    pub allocated_share_amount:  u64,   // jumlah berjalan alokasi ke vesting records
}

allocated_share_amount adalah jumlah total yang sudah ditetapkan ke akun VestingRecord melalui CreateVestingAccount / CreatePlatformVestingAccount. Ini tidak boleh pernah melebihi total_locked_amount. Jika kreator over-allocate, panggilan CreateVestingAccount berikutnya dibatalkan dengan InvalidTotalLockedAmount.

​

Formula unlock linier

Setelah penggalangan dana berakhir, program menghitung jumlah unlock kumulatif untuk setiap VestingRecord sebagai:

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

Jika unlock_period == 0, seluruh token_share_amount menjadi klaim dalam satu langkah di start_time. Sebaliknya kurva adalah garis lurus dari 0 di start_time ke token_share_amount di start_time + unlock_period, dibatasi pada token_share_amount sesudahnya.

Jumlah yang ditransfer pada setiap panggilan ClaimVestedToken adalah delta antara jumlah unlock kumulatif yang baru dihitung ulang dan bidang claimed_amount yang berjalan di rekam.

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

Klaim sebelum start_time dibatalkan dengan VestingNotStarted. Klaim setelah start_time + unlock_period menyelesaikan sisa penuh.

​

Tata letak akun

​

VestingSchedule

Berada inline di PoolState. Lihat accounts.

​

VestingRecord

Rekam per-penerima. PDA diturunkan sebagai:

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

// states/vesting.rs
#[account]
pub struct VestingRecord {
    pub epoch:               u64,         // pelacak recent_epoch
    pub pool:                Pubkey,      // back-pointer ke PoolState
    pub beneficiary:         Pubkey,      // siapa yang dapat memanggil ClaimVestedToken
    pub claimed_amount:      u64,         // klaim kumulatif
    pub token_share_amount:  u64,         // total alokasi ke penerima ini
    pub padding:             [u64; 8],
}

Penerima hanya dapat memiliki satu VestingRecord per peluncuran. Mengalokasikan kembali ke penerima yang sama pada peluncuran yang sama dibatalkan karena PDA sudah ada.

​

Instruksi

​

CreateVestingAccount

Hanya kreator. Mengalokasikan irisan dari total_locked_amount pool ke penerima baru dengan menginisialisasi PDA VestingRecord segar.

Argumen

share_amount: u64    // token untuk ditetapkan ke penerima ini

Akun

#	Nama	W	S	Catatan
1	creator	W	S	Harus sama dengan pool_state.creator; membayar sewa untuk akun baru.
2	beneficiary	W		Menerima token unlock nanti. Pubkey dikunci di sini — tidak dapat diubah.
3	pool_state	W		Dimutasi untuk menaikkan vesting_schedule.allocated_share_amount.
4	vesting_record	W		init; PDA [b"pool_vesting", pool_state, beneficiary].
5	system_program			Diperlukan untuk pembuatan akun.

Prekondisi

• share_amount > 0.
• pool_state.vesting_schedule.allocated_share_amount + share_amount <= total_locked_amount.
• Pubkey beneficiary tidak memiliki VestingRecord yang ada untuk pool ini.

Potkondisi

• vesting_record diinisialisasi dengan token_share_amount = share_amount, claimed_amount = 0.
• pool_state.vesting_schedule.allocated_share_amount += share_amount.

Kesalahan umum — InvalidTotalLockedAmount, InvalidInput.

​

CreatePlatformVestingAccount

Varian platform-admin dari CreateVestingAccount. Dompet vesting platform (disimpan di PlatformConfig.platform_vesting_wallet) adalah penerima, dan bagian dibatasi oleh PlatformConfig.platform_vesting_scale.

Penandatangan harus sama dengan platform_config.platform_vesting_wallet. Akun lainnya mencerminkan CreateVestingAccount. Gunakan ini ketika platform berkomitmen untuk menerima bagian vesting tetap pada setiap peluncuran yang ditempatkannya.

​

ClaimVestedToken

Hanya penerima. Mentransfer token yang baru dibuka dari base_vault pool ke ATA penerima.

Argumen

Tidak ada (program menghitung jumlah klaim dari jadwal).

Akun

#	Nama	W	S	Catatan
1	beneficiary	W	S	Harus sama dengan vesting_record.beneficiary.
2	authority			PDA [b"vault_auth_seed"]; menandatangani transfer vault.
3	pool_state	W		Dimutasi hanya jika jadwal perlu divalidasi ulang.
4	vesting_record	W		claimed_amount diperbarui.
5	base_vault	W		Vault token base pool; didebit.
6	beneficiary_ata	W		Menerima token unlock; init_if_needed.
7	base_mint			Mint base pool.
8	token_program			Program SPL Token atau Token-2022.
9	associated_token_program			Untuk pembuatan ATA jika diperlukan.
10	system_program			Diperlukan untuk pembuatan akun.

Prekondisi

• block_time >= pool_state.vesting_schedule.start_time (sebaliknya VestingNotStarted).
• pool_state.status == PoolStatus::Migrated — graduation harus sudah terjadi. Memanggil sebelum graduation membatalkan.
• Delta unlock-amount lebih besar dari nol. Panggilan no-op (delta yang dihitung adalah 0) dibatalkan.

Potkondisi

• vesting_record.claimed_amount maju ke jumlah unlock kumulatif yang baru.
• delta_amount token base ditransfer ke beneficiary_ata.

Kesalahan umum — VestingNotStarted, NoAssetsToCollect, MathOverflow.

​

Contoh kerja

Peluncuran menetapkan:

• supply = 1_000_000_000
• total_locked_amount = 100_000_000 (10% dari pasokan)
• cliff_period = 180 * 86400 (180 hari)
• unlock_period = 365 * 86400 (1 tahun linier setelah cliff)

Kreator mengalokasikan dua akun VestingRecord segera setelah Initialize:

• Penerima A (tim): share_amount = 70_000_000
• Penerima B (penasihat): share_amount = 30_000_000

allocated_share_amount = 100_000_000, sama dengan total_locked_amount — tidak ada alokasi lebih lanjut yang mungkin.

Penggalangan dana selesai pada 2027-01-01T00:00Z. Program menetapkan start_time = 2027-01-01 + 180 hari = 2027-06-30.

Pada 2027-09-30 (90 hari setelah start_time), Penerima A memanggil 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

Dompet A menerima 17.26M token base. vesting_record.claimed_amount maju ke 17_260_274.

Enam bulan kemudian (2028-03-31, 270 hari setelah start_time), A mengklaim lagi:

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

A menerima 34.52M token lagi. Setelah 2028-06-30 (akhir unlock_period), klaim berikutnya mentransfer ~18.22M yang tersisa dan meninggalkan claimed_amount == token_share_amount.

​

Kasus tepi

• Penerima kehilangan kunci mereka. Pubkey di VestingRecord.beneficiary adalah satu-satunya penandatangan yang dapat memanggil ClaimVestedToken. Tidak ada jalan pemulihan. Tetapkan penerima ke multisig jika pemulihan penting.
• Biaya transfer Token-2022. Jika mint base adalah mint Token-2022 dengan ekstensi transfer-fee, penerima menerima delta_amount − transfer_fee, bukan delta penuh. Vault pool masih mencatat jumlah bruto sebagai ditransfer — perbedaan mengakrual ke akun withheld-fee mint.
• Pool tidak graduated. Memanggil ClaimVestedToken sebelum graduation membatalkan. Jam vesting mulai hanya ketika penggalangan dana benar-benar selesai; peluncuran yang dibatalkan (yang tidak pernah mengatur start_time) meninggalkan token terkunci tidak dapat dijangkau di vault.
• Upaya over-allocation. Program memberlakukan allocated_share_amount <= total_locked_amount pada setiap CreateVestingAccount. Sisa (jika ada) dari total_locked_amount yang tidak dialokasikan adalah hilang — token tersebut tetap di vault selamanya setelah peluncuran graduation. Alokasikan jumlah penuh kecuali itu adalah tujuannya.

​

Penunjuk

• products/launchlab/accounts — tata letak PoolState lengkap termasuk VestingSchedule.
• products/launchlab/instructions — siklus hidup graduation.
• products/launchlab/platform-config — semantik platform_vesting_scale untuk alokasi platform.
• products/launchlab/global-config — batas max_lock_rate yang membatasi total_locked_amount.

Sumber:

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