Instruksi LaunchLab

​

Inventaris instruksi

​

Initialize

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
}

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

• 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).
• Untuk InitializeWithToken2022 dengan TransferFeeConfig terlampir: transfer_fee_config_authority = launch_authority, dan withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth ketika bidang itu diatur, jika tidak launch_authority. Sisi penarikan ditulis pada pembuatan mint tepatnya sehingga platform dapat menyapu biaya yang ditahan sebelum kelulusan. Lihat platform-config.

​

Buy (varian kanonik: BuyExactIn)

quote_in:          u64
minimum_base_out:  u64

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

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

​

BuyExactOut

base_out:      u64
maximum_quote_in: u64

​

Sell / SellExactIn / SellExactOut

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

​

Biaya transfer sisi kutipan

• Batas yang dihitung seolah-olah mint bebas biaya ditolak. Melewatkan biaya-bebas cost sebagai maximum_amount_in, atau hasil bebas-biaya sebagai minimum_amount_out, kembali dengan ExceededSlippage.
• real_quote maju hanya dengan apa yang mencapai vault. BuyExactIn dari amount_in pada mint kutipan 5% memindahkan real_quote sebesar amount_in × 0.95.

​

MigrateToAmm / MigrateToCpswap

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

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. Verifikasi pool_state.status == Migrate (yaitu, quote_reserve_target telah tercapai). Jika tidak kembalikan dengan PoolMigrated (status sudah Migrated) atau PoolFunding (masih dalam pendanaan).
2. Verifikasi pool_state.migrate_type cocok dengan instruksi (0 untuk AMM, 1 untuk CPMM). Jika tidak kembalikan dengan MigrateTypeNotMatch.
3. 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
4. CPI ke program target (AMM v4 Initialize2 atau CPMM InitializeWithPermission) dengan cadangan tersebut untuk membuat pool pasca-kelulusan.
5. 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 aliran yang ada dari instruksi itu.
6. Cabut base_mint.mint_authority (atur ke None).
7. Balik pool_state.status = Migrated, atur vesting_schedule.start_time = block_time + cliff_period.

• transfer_fee_config_authority selalu ditetapkan ulang. PDA authority peluncuran memegangnya untuk seluruh fase pra-kelulusan, jadi selalu ada sesuatu untuk dipindahkan.
• WithheldWithdraw ditetapkan ulang hanya ketika PDA authority masih memegangnya. Peluncuran yang dibuat dari 2026-08-27 ke depan sudah membawa transfer_fee_extension_auth pada otoritas itu dari pembuatan mint, jadi langkah itu dilewati. Penjaga adalah apa yang membuat migrasi tidak kembali pada mint tersebut — PDA tidak dapat menandatangani otoritas yang tidak lagi dipegang.

​

Akun sisa migrasi CPMM

​

Program token migrasi CPMM

​

Daftar putih GlobalConfig platform

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

​

Aturan parameter peluncuran platform

• Create mengalokasikan akun yang tidak memegang grup. Status itu tidak membatasi apa pun.
• Update upsert grup dengan group_id itu, menggantinya sepenuhnya jika ada. Ini mengubah ukuran akun agar sesuai, jadi penandatangan menambah sewa yang tumbuh dan menerima kembali sewa yang menyusut. Grup baru di luar kesepuluh mengembalikan CurveRuleGroupsExceeded; lebih dari 25 batasan, bidang yang tidak dikenal atau operator, atau pasangan (field, op) yang sama dua kali dalam satu grup mengembalikan InvalidCurveRuleConstraint; empat bidang yang diturunkan TotalSellA pada konfigurasi non-constant-product mengembalikan CurveRuleFieldNotSupportedByCurve.
• Remove menjatuhkan satu grup berdasarkan id, menyusutkan akun dan mengembalikan perbedaannya. Id yang tidak dikenal mengembalikan CurveRuleGroupNotExist.
• Close mengembalikan seluruh sewa ke penandatangan. Konfigurasi kemudian tidak dibatasi lagi bahkan sementara restrict_curve_param tetap 1.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Instruksi vesting dan platform-config

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, CreatePlatformAllowConfig, ClosePlatformAllowConfig
• CreatePlatformCurveRule, UpdatePlatformCurveRule, RemovePlatformCurveRule, ClosePlatformCurveRule
• CreateConfig, UpdateConfig

​

Matriks perubahan status

​

Ke mana selanjutnya

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

• Modul Raydium SDK v2 LaunchLab
• Sumber program Raydium LaunchLab