Instruksi LaunchLab

​

Inventaris instruksi

​

Initialize

base_mint_param: MintParams {
    decimals: u8,                 // must equal the program's BASE_MINT_DECIMALS
    name:     String,
    symbol:   String,
    uri:      String,
}

curve_param: CurveParams {        // Borsh enum — one leading variant-tag byte
    Constant { data: ConstantCurve { supply: u64, total_base_sell: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
    Fixed    { data: FixedCurve    { supply: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
    Linear   { data: LinearCurve   { supply: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
}

vesting_param: VestingParams {
    total_locked_amount: u64,     // 0 requires cliff_period == unlock_period == 0
    cliff_period:        u64,     // seconds after fundraising ends
    unlock_period:       u64,     // seconds
}

amm_fee_on: AmmCreatorFeeOn       // 0 = QuoteToken, 1 = BothToken (CPMM migrations only)

• 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 = curve_param.supply, semuanya di base_vault.
• Otoritas mint dicabut di dalam instruksi yang sama ini (set_authority(MintTokens, None)) tepat setelah supply dicetak — bukan pada saat kelulusan. Karena itu base mint permanen bersupply tetap, dan tidak ada instruksi berikutnya yang dapat mencetak lebih banyak.
• PoolState diinisialisasi dengan status = Fund (0), real_a = 0, real_b = 0.
• total_fund_raising_b berasal langsung dari curve_param.total_quote_fund_raising.
• Untuk InitializeWithToken2022 dengan TransferFeeConfig terlampir: transfer_fee_config_authority = launch_authority, dan withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth ketika bidang itu diatur, sebaliknya 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)

amount_in:           u64
minimum_amount_out:  u64
share_fee_rate:      u64   // referral fee on a 1_000_000 denominator; must be
                           // <= global_config.max_share_fee_rate. Pass 0 for no
                           // referral. Any non-zero value requires the share-fee
                           // receiver as remaining_accounts[0].

1. share_fee_receiver — hanya ketika share_fee_rate > 0.
2. system_program — selalu; diperiksa == System::id(), jika tidak InvalidInput.
3. platform_fee_vault — PDA [platform_config, quote_token_mint]; dibuat saat pertama kali dipakai.
4. creator_fee_vault — PDA [creator, quote_token_mint]; dibuat saat pertama kali dipakai.

• 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 kutipan pasca-biaya.
3. require(base_out ≥ minimum_base_out) sebaliknya kembali 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

amount_out:         u64
maximum_amount_in:  u64
share_fee_rate:     u64   // as for BuyExactIn

​

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

​

Akun sisa perdagangan

​

MigrateToAmm / MigrateToCpswap

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

1. Verifikasi pool_state.status == Migrate (yaitu, quote_reserve_target telah tercapai). Sebaliknya kembali 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). Sebaliknya kembali 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. (Tidak ada langkah mint-authority. base_mint.mint_authority sudah diatur ke None pada pembuatan peluncuran — lihat catatan di bawah.)
7. Balik pool_state.status = Migrated, atur vesting_schedule.start_time = block_time + cliff_period.

• transfer_fee_config_authority selalu ditetapkan kembali. PDA authority peluncuran memegangnya untuk seluruh fase pra-kelulusan, jadi selalu ada sesuatu untuk dipindahkan.
• WithheldWithdraw ditetapkan kembali 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 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 sebaliknya valid; tidak ada akun izin 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 menyimpan grup. Status itu tidak membatasi apa pun.
• Update upsert grup dengan group_id itu, menggantinya sepenuhnya jika ada. Itu 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

​

CollectExcessLamports

​

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