Instruksi LaunchLab

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

LaunchLab mengekspos set instruksi yang ketat: enam panggilan yang menghadap pengguna ditambah beberapa primitif admin. SDK membungkus semuanya; halaman ini mendokumentasikan permukaan mentah untuk agregator, alat pemantauan, dan program yang memerlukan CPI.

Inventaris instruksi

Grup	Instruksi	Dapat dipanggil oleh
Konfigurasi global	`CreateConfig` / `UpdateConfig`	Admin program; otoritas create-config yang didelegasikan juga dapat memanggil `CreateConfig`
Siklus hidup peluncuran	`Initialize` / `InitializeV2`	Siapa saja (pembuat) — peluncuran SPL Token; V2 mencatat `amm_creator_fee_on` untuk kelulusan CPMM yang akan datang
Siklus hidup peluncuran	`InitializeWithToken2022`	Siapa saja (pembuat) — peluncuran Token-2022, `TransferFeeConfig` opsional
Perdagangan	`BuyExactIn` / `BuyExactOut`	Siapa saja — pembelian input-tepat / output-tepat pada kurva ikatan
Perdagangan	`SellExactIn` / `SellExactOut`	Siapa saja — penjualan input-tepat / output-tepat pada kurva ikatan
Kelulusan	`MigrateToAmm`	Dompet migrasi — kelulusan AMM v4 warisan untuk pool yang diinisialisasi sebelum penegakan pembuatan CPMM-only.
Kelulusan	`MigrateToCpswap`	Dompet migrasi — lulus ke CPMM. Semua peluncuran yang baru diinisialisasi menggunakan jalur ini. Membungkus `InitializeWithPermission` pada CPMM.
Biaya	`CollectFee`	Admin — kumpulkan biaya protokol dari peluncuran
Biaya	`CollectMigrateFee`	Admin — kumpulkan biaya migrasi yang terkumpul
Biaya	`ClaimCreatorFee`	Pembuat — klaim biaya pembuat yang terkumpul selama fase kurva
Vesting	`CreateVestingAccount`	Pembuat — alokasikan token terkunci ke penerima manfaat, dibuka setelah kelulusan
Vesting	`CreatePlatformVestingAccount`	Admin platform — alokasikan token terkunci ke penerima manfaat sisi platform
Vesting	`ClaimVestedToken`	Penerima manfaat — klaim token yang tidak terkunci setelah tebing
Konfigurasi platform	`CreatePlatformConfig` / `UpdatePlatformConfig`	Admin platform
Konfigurasi platform	`UpdatePlatformCurveParam` / `RemovePlatformCurveParam`	Admin platform — kelola daftar per-platform bentuk kurva yang diizinkan
Biaya platform	`ClaimPlatformFee` / `ClaimPlatformFeeFromVault`	Admin platform
Akses platform	`CreatePlatformAllowConfig` / `ClosePlatformAllowConfig`	Admin platform — pertahankan daftar allowlist `GlobalConfig` yang digunakan ketika platform itu mengaktifkan pembatasan

Pemisahan “ExactIn/ExactOut” mencerminkan SwapBaseInput / SwapBaseOutput CPMM — di rantai mereka adalah diskriminator instruksi terpisah dengan pembulatan yang sedikit berbeda. Pemilihan jalur kelulusan. Setiap panggilan Initialize, InitializeV2, dan InitializeWithToken2022 yang baru harus menetapkan migrate_type = 1 (CPSWAP). Setiap upaya untuk menginisialisasi pool yang terikat AMM v4 baru mengembalikan MigrateTypeNotMatch. amm_creator_fee_on hanya memilih apakah biaya pembuat CPMM yang dihasilkan berlaku untuk token kutipan atau kedua token; itu tidak memilih program target. MigrateToAmm tetap dapat dipanggil untuk PoolState yang ada yang diinisialisasi dengan migrate_type = 0 sebelum pembatasan ini. Rilis tidak menulis ulang status pool yang ada atau menghapus instruksi warisan.

`Initialize`

Buat peluncuran baru. Argumen

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // atau initial_virtual_quote_reserve untuk curve_type=1
    open_time:                  u64,
    quote_mint:                 Pubkey,
    base_token_metadata: {                         // nama/simbol/uri inline; program CPI ke Metaplex
        name:   String,
        symbol: String,
        uri:    String,
    },
    fees: {
        buy_numerator:   u64,
        buy_denominator: u64,
        sell_numerator:  u64,
        sell_denominator: u64,
        lp_share:        u64,
        creator_share:   u64,
        protocol_share:  u64,
        total_share:     u64,
    },
    post_graduation_lp_policy:  u8,                // 0 = Burn, 1 = Lock, 2 = ToCreator
}

Akun (ringkas)

#	Nama	W	S	Catatan
1	`creator`	W	S	Membayar sewa + pembuatan base mint.
2	`launch_config`			Pengikatan konfigurasi protokol.
3	`launch_state`	W		Akun baru.
4	`launch_authority`			PDA.
5	`base_mint`	W	S	Keypair Segar (atau PDA) — instruksi ini menginisialisasinya.
6	`base_vault`	W		ATA dari `launch_authority` pada `base_mint`.
7	`quote_mint`
8	`quote_vault`	W		ATA dari `launch_authority` pada `quote_mint`.
9	`metadata`	W		PDA metadata Metaplex.
10	`metaplex_program`
11	`token_program`			SPL Token saja.
12	`system_program`
13	`rent`

Kondisi awal

quote_mint ∈ launch_config.allowed_quote_mints.
base_supply_graduation ≤ base_supply_max.
Parameter biaya lulus pemeriksaan launch_config.max_*_fee_rate.
open_time ≥ now − slop (SDK memberlakukan ≥ now; program mentoleransi backdating ringan).
curve_type dikenali.

Kondisi akhir

base_mint memiliki supply = base_supply_max, semuanya di base_vault.
base_mint.mint_authority = launch_authority, freeze_authority = None.
LaunchState diinisialisasi dengan status = Active, base_sold = 0, quote_reserve_real = 0.
quote_reserve_target dihitung dari parameter kurva + base_supply_graduation + buy_numerator (kira-kira).

Kesalahan umum — InvalidQuoteMint, FeeRateTooHigh, InvalidCurveParams, MathOverflow.

`Buy` (varian kanonik: `BuyExactIn`)

Pengguna menyediakan quote_in tetap; kurva menghitung base_out. Argumen

quote_in:          u64
minimum_base_out:  u64

Akun

#	Nama	W	S
1	`user`	W	S
2	`launch_state`	W
3	`launch_authority`
4	`base_vault`	W
5	`quote_vault`	W
6	`user_base_ata`	W
7	`user_quote_ata`	W
8	`base_mint`
9	`quote_mint`
10	`token_program`
11	`associated_token_program`
12	`system_program`

Kondisi awal

launch_state.status == Active.
now ≥ open_time.
user_quote_ata.balance ≥ quote_in.
quote_in > 0.

Efek

Pisahkan quote_in menjadi quote_in_after_fee dan bagian biaya.
Newton-selesaikan kurva untuk base_out yang diberikan post-fee quote.
require(base_out ≥ minimum_base_out) jika tidak balik ExceededSlippage.
Pindahkan quote_in pengguna → vault. Pindahkan base_out vault → pengguna.
Perbarui base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share).
Perbarui penghitung biaya (protocol_fees_quote, creator_fees_quote).
state_data.num_buys += 1.
Jika quote_reserve_real ≥ quote_reserve_target setelah pembaruan, SDK biasanya merantai ix Graduate dalam transaksi yang sama. Program tidak auto-graduate di dalam Buy — Graduate berikutnya diperlukan.

`BuyExactOut`

Pengguna menentukan base_out yang tepat; program menghitung quote_in. Argumen

base_out:      u64
maximum_quote_in: u64

Akun yang sama seperti BuyExactIn. Menggunakan integral kuadrat bentuk tertutup (atau CPMM terbalik, untuk curve_type 1) daripada iterasi Newton.

`Sell` / `SellExactIn` / `SellExactOut`

Cerminan dari Buy. Pengguna mengembalikan base_in ke kurva dan menerima quote_out. Biaya dikurangkan dari quote_out, jadi pengguna menerima lebih sedikit daripada hasil terintegrasi mentah. Kondisi awal —

user_base_ata.balance ≥ base_in.
Penjualan tidak dapat mendorong base_sold di bawah 0 (redundan dengan di atas mengingat akuntansi konsisten).
Peluncuran adalah Active.

Efek — simetris dengan Buy. base_sold berkurang, quote_reserve_real berkurang. Biaya masih terkumpul.

`MigrateToAmm` / `MigrateToCpswap`

Lulus peluncuran ke pool yang dapat diperdagangkan setelah kurva mencapai total_quote_fund_raising. Peluncuran baru adalah CPMM-only. MigrateToAmm dipertahankan untuk pool yang ada yang migrate_type tersimpannya adalah 0. Siapa yang menandatangani

MigrateToAmm — migrate_to_amm_wallet yang dicatat pada GlobalConfig pengikatan.
MigrateToCpswap — migrate_to_cpswap_wallet yang dicatat pada GlobalConfig pengikatan.

Dompet ini biasanya dipegang oleh crank kelulusan yang dioperasikan Raydium; dalam praktik kelulusan mendarat beberapa detik setelah ambang batas terlampaui, terlepas dari siapa yang memicu pembelian terakhir. Argumen MigrateToAmm mengambil tiga (terutama parameter pasar OpenBook yang program teruskan ke AMM v4):

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

MigrateToCpswap tidak mengambil apa pun. Efek (umum untuk keduanya)

Verifikasi pool_state.status == Migrate (yaitu, quote_reserve_target telah tercapai). Jika tidak, balik dengan PoolMigrated (status sudah Migrated) atau PoolFunding (masih dalam pendanaan).
Verifikasi pool_state.migrate_type cocok dengan instruksi (0 untuk AMM, 1 untuk CPMM). Jika tidak, balik dengan MigrateTypeNotMatch.
Hitung cadangan pasca-kelulusan:
- base_amount_out = base_vault.amount − vesting_schedule.total_locked_amount
- quote_amount_out = quote_vault.amount − quote_protocol_fee − migrate_fee − platform_fee
CPI ke program target (AMM v4 Initialize2 atau CPMM InitializeWithPermission) dengan cadangan tersebut untuk membuat pool pasca-kelulusan.
Untuk migrasi CPMM yang dieksekusi setelah upgrade 2026-08-17, gabungkan platform_scale + creator_scale menjadi satu saham LP terkunci milik platform dan mint paling banyak satu Fee Key NFT ke platform_nft_wallet. Bakar sisa burn_scale. Sebelum upgrade, creator_scale dikunci secara terpisah dan Fee Key-nya pergi ke pembuat token. Migrasi historis yang selesai tidak dimodifikasi. Untuk kelulusan AMM v4 warisan, disposisi LP mengikuti alur yang ada dari instruksi itu.
Cabut base_mint.mint_authority (atur ke None).
Balik pool_state.status = Migrated, atur vesting_schedule.start_time = block_time + cliff_period.

Kondisi akhir — BuyExactIn, BuyExactOut, SellExactIn, SellExactOut akan menolak dari titik ini dengan PoolMigrated. Pool AMM yang dihasilkan adalah kanonik dan berdagang seperti pool AMM v4 / CPMM lainnya. Kesalahan umum — PoolFunding, PoolMigrated, MigrateTypeNotMatch, InvalidCpSwapConfig, MathOverflow.

Akun sisa migrasi CPMM

Klien yang membangun MigrateToCpswap harus menggunakan indeks remaining_accounts tetap ini:

Indeks	Akun
0–4	Pemilik Fee Key platform, mint, akun token, PDA likuiditas terkunci, dan akun metadata
5	Pembuat peluncuran asli; digunakan ketika `platform_cp_creator` tidak diatur
6	PDA izin CPMM yang diturunkan dari `[b"permission", launch_authority]`
7	`platform_cp_creator` yang dikonfigurasi; digunakan ketika bidang tidak default
8	PDA support-mint CPMM untuk `mint0` yang diurutkan, diturunkan dari `[b"support_mint", mint0]`
9	PDA support-mint CPMM untuk `mint1` yang diurutkan, diturunkan dari `[b"support_mint", mint1]`

Instruksi memerlukan setidaknya sepuluh akun sisa pada jalur yang ditingkatkan. Akun support-mint adalah input CPI read-only. Turunkan kedua alamat bahkan ketika mint tidak memiliki catatan dukungan yang diinisialisasi. Pembangun yang lebih lama yang masih menambahkan akun creator-lock atau menghilangkan indeks 8–9 harus diperbarui.

Daftar allowlist `GlobalConfig` platform

PlatformConfig.restrict_global_config mengontrol pemeriksaan:

0: platform menerima GlobalConfig yang valid; tidak ada akun allow yang diperlukan.
1: Initialize, InitializeV2, dan InitializeWithToken2022 harus menyertakan PlatformAllowConfig yang cocok di mana saja di remaining_accounts.

Admin platform membuat atau menutup PDA dengan CreatePlatformAllowConfig dan ClosePlatformAllowConfig. Bijinya adalah [b"platform_allow_config", platform_config, global_config]. Instruksi PlatformGlobalAccess yang dikelola admin sebelumnya dan PDA sudah pensiun.

`CollectFee`

Penyapuan admin biaya perdagangan yang terkumpul protokol pada satu peluncuran. Argumen — tidak ada. Akun

#	Nama	W	S	Catatan
1	`protocol_fee_owner`		S	Harus sama dengan `global_config.protocol_fee_owner`.
2	`authority`			PDA `[b"vault_auth_seed"]`; menandatangani transfer vault.
3	`pool_state`	W		Dimutasi untuk menol `quote_protocol_fee`.
4	`global_config`			Sumber kebenaran untuk penandatangan.
5	`quote_vault`	W		Dikuras oleh `quote_protocol_fee`.
6	`recipient_token_account`	W		ATA dari `protocol_fee_owner` pada `quote_mint`.
7	`quote_mint`
8	`token_program`			SPL Token (quote mint selalu SPL Token).

Efek — transfer pool_state.quote_protocol_fee dari quote_vault ke recipient_token_account, kemudian nol penghitung. Dapat dipanggil kapan saja setelah pembelian pertama.

`CollectMigrateFee`

Penyapuan admin biaya migrasi yang terkumpul pada kelulusan. Bentuk akun yang sama seperti CollectFee dengan migrate_fee_owner sebagai penandatangan (bukan protocol_fee_owner) dan pool_state.migrate_fee sebagai penghitung yang dikuras.

`ClaimCreatorFee`

Penyapuan per-pembuat biaya pembuat yang terkumpul di setiap peluncuran yang dimiliki pembuat yang menggunakan quote mint yang sama. Menguras vault biaya per-pembuat, bukan per-pool. Argumen — tidak ada. Akun

#	Nama	W	S	Catatan
1	`creator`	W	S	Pembuat pool.
2	`fee_vault_authority`			PDA `[b"creator_fee_vault_auth_seed"]`.
3	`creator_fee_vault`	W		PDA pada biji `[creator, quote_mint]`; vault pembuat agregat.
4	`recipient_token_account`	W		`init_if_needed`; ATA dari `creator` pada `quote_mint`.
5	`quote_mint`
6	`token_program`
7	`system_program`			Untuk pembuatan ATA jika diperlukan.
8	`associated_token_program`

Efek — transfer seluruh saldo creator_fee_vault ke recipient_token_account. Balik dengan pemeriksaan require-greater-than-zero jika vault kosong.

`ClaimPlatformFee`

Penyapuan per-platform yang menguras vault kutipan peluncuran secara langsung. Gunakan ini ketika platform ingin mengklaim potongannya untuk satu peluncuran spesifik tanpa melalui vault platform agregat. Argumen — tidak ada. Akun

#	Nama	W	S	Catatan
1	`platform_fee_wallet`	W	S	Harus sama dengan `platform_config.platform_fee_wallet`.
2	`authority`			PDA `[b"vault_auth_seed"]`.
3	`pool_state`	W		Dikuras oleh `pool_state.platform_fee`.
4	`platform_config`			Sumber kebenaran untuk penandatangan.
5	`quote_vault`	W		Dikuras.
6	`recipient_token_account`	W		`init_if_needed`; ATA dari `platform_fee_wallet`.
7	`quote_mint`
8	`token_program`
9	`system_program`
10	`associated_token_program`

Efek — transfer pool_state.platform_fee dari quote_vault ke recipient_token_account, nol penghitung.

`ClaimPlatformFeeFromVault`

Penyapuan agregat per-platform. Menguras vault biaya per-quote-mint platform yang mengumpulkan biaya dari setiap peluncuran yang dirutekan melalui platform. Argumen — tidak ada. Akun

#	Nama	W	S	Catatan
1	`platform_fee_wallet`	W	S	Harus sama dengan `platform_config.platform_fee_wallet`.
2	`fee_vault_authority`			PDA `[b"platform_fee_vault_auth_seed"]`.
3	`platform_config`
4	`platform_fee_vault`	W		PDA pada biji `[platform_config, quote_mint]`.
5	`recipient_token_account`	W		`init_if_needed`; ATA dari `platform_fee_wallet`.
6	`quote_mint`
7	`token_program`
8	`system_program`
9	`associated_token_program`

Efek — transfer saldo penuh platform_fee_vault ke recipient_token_account. Balik jika vault kosong.

Instruksi vesting dan konfigurasi platform

Ini didokumentasikan di halaman khusus karena masing-masing memiliki model statusnya sendiri:

Matriks perubahan status

Instruksi	`status`	`real_base`	`real_quote`	Penghitung biaya	Pool pasca-status
`Initialize{V2,WithToken2022}`	Funding	0	0	0	—
`BuyExactIn(q_in)`	Funding	+∆	+∆q_after_fee	`quote_protocol_fee += ∆`, `platform_fee += ∆`	—
`SellExactIn(b_in)`	Funding	−∆	−∆q_before_fee	(sama)	—
Ambang tercapai	→ Migrate	—	—	—	—
`MigrateToCpswap` / `MigrateToAmm` warisan	→ Migrated	(beku)	(beku)	`migrate_fee` diatur	dibuat; LP CPMM dibagi menjadi kunci platform dan bakar
`CollectFee` / `CollectMigrateFee`	apa pun	—	—	penghitung dinol	—
`ClaimCreatorFee` / `ClaimPlatformFee*`	apa pun	—	—	menguras vault	—
`CreateVestingAccount`	Funding	—	—	—	bumps `allocated_share_amount`
`ClaimVestedToken`	Migrated	—	—	—	menguras `base_vault`

Ke mana selanjutnya

products/launchlab/code-demos — contoh TypeScript untuk setiap instruksi.
products/launchlab/accounts — bentuk status lengkap.
reference/error-codes — enum kesalahan LaunchLab.

Sumber:

Modul Raydium SDK v2 LaunchLab
Sumber program Raydium LaunchLab

LaunchLab

Token launch flow

Tips & Gotchas

Inventaris instruksi

`Initialize`

`Buy` (varian kanonik: `BuyExactIn`)

`BuyExactOut`

`Sell` / `SellExactIn` / `SellExactOut`

`MigrateToAmm` / `MigrateToCpswap`

Akun sisa migrasi CPMM

Daftar allowlist `GlobalConfig` platform

`CollectFee`

`CollectMigrateFee`

`ClaimCreatorFee`

`ClaimPlatformFee`

`ClaimPlatformFeeFromVault`

Instruksi vesting dan konfigurasi platform

Matriks perubahan status

Ke mana selanjutnya

​Inventaris instruksi

​Initialize

​Buy (varian kanonik: BuyExactIn)

​BuyExactOut

​Sell / SellExactIn / SellExactOut

​MigrateToAmm / MigrateToCpswap

​Akun sisa migrasi CPMM

​Daftar allowlist GlobalConfig platform

​CollectFee

​CollectMigrateFee

​ClaimCreatorFee

​ClaimPlatformFee

​ClaimPlatformFeeFromVault

​Instruksi vesting dan konfigurasi platform

​Matriks perubahan status

​Ke mana selanjutnya

Inventaris instruksi

`Initialize`

`Buy` (varian kanonik: `BuyExactIn`)

`BuyExactOut`

`Sell` / `SellExactIn` / `SellExactOut`

`MigrateToAmm` / `MigrateToCpswap`

Akun sisa migrasi CPMM

Daftar allowlist `GlobalConfig` platform

`CollectFee`

`CollectMigrateFee`

`ClaimCreatorFee`

`ClaimPlatformFee`

`ClaimPlatformFeeFromVault`

Instruksi vesting dan konfigurasi platform

Matriks perubahan status

Ke mana selanjutnya