Instructions LaunchLab

​

Inventaire des instructions

​

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.
• Les paramètres de frais passent les vérifications launch_config.max_*_fee_rate.
• open_time ≥ now − slop (le SDK applique ≥ now ; le programme tolère un léger antidatage).
• curve_type est reconnu.

• base_mint a supply = curve_param.supply, tout dans base_vault.
• L’autorité de frappe est révoquée dans cette même instruction (set_authority(MintTokens, None)) juste après la frappe de l’offre — et non à la graduation. Le mint de base est donc définitivement à offre fixe, et aucune instruction ultérieure ne peut en frapper davantage.
• PoolState initialisé avec status = Fund (0), real_a = 0, real_b = 0.
• total_fund_raising_b vient directement de curve_param.total_quote_fund_raising.
• Pour InitializeWithToken2022 avec un TransferFeeConfig attaché : transfer_fee_config_authority = launch_authority, et withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth lorsque ce champ est défini, sinon launch_authority. Le côté retrait est écrit à la création du mint précisément pour que la plateforme puisse balayer les frais retenus avant la graduation. Voir platform-config.

​

Buy (variante canonique : 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 — uniquement lorsque share_fee_rate > 0.
2. system_program — toujours ; vérifié == System::id(), sinon InvalidInput.
3. platform_fee_vault — PDA [platform_config, quote_token_mint] ; créé à la première utilisation.
4. creator_fee_vault — PDA [creator, quote_token_mint] ; créé à la première utilisation.

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

1. Diviser quote_in en quote_in_after_fee et les parties de frais.
2. Résoudre Newton la courbe pour base_out étant donné la quote post-frais.
3. require(base_out ≥ minimum_base_out) sinon annuler ExceededSlippage.
4. Déplacer quote_in utilisateur → coffre. Déplacer base_out coffre → utilisateur.
5. Mettre à jour base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share).
6. Mettre à jour les compteurs de frais (protocol_fees_quote, creator_fees_quote).
7. state_data.num_buys += 1.
8. Si quote_reserve_real ≥ quote_reserve_target après la mise à jour, le SDK enchaîne généralement une ix Graduate dans la même transaction. Le programme ne diplôme pas automatiquement à l’intérieur de Buy — un Graduate ultérieur est requis.

​

BuyExactOut

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

​

Sell / SellExactIn / SellExactOut

• user_base_ata.balance ≥ base_in.
• La vente ne peut pas pousser base_sold en dessous de 0 (redondant avec ce qui précède étant donné que la comptabilité est cohérente).
• Le lancement est Active.

​

Frais de transfert côté quote

• Une limite calculée comme si le mint était sans frais est rejetée. Passer le coût sans frais comme maximum_amount_in, ou les produits sans frais comme minimum_amount_out, annule avec ExceededSlippage.
• real_quote n’avance que par ce qui a atteint le coffre. Un BuyExactIn de amount_in sur un mint de quote à 5% déplace real_quote de amount_in × 0.95.

​

Comptes restants d’échange

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — le migrate_to_amm_wallet enregistré sur la GlobalConfig de liaison.
• MigrateToCpswap — le migrate_to_cpswap_wallet enregistré sur la GlobalConfig de liaison.

1. Vérifier pool_state.status == Migrate (c.-à-d., quote_reserve_target a été atteint). Sinon, annuler avec PoolMigrated (le statut était déjà Migrated) ou PoolFunding (toujours en financement).
2. Vérifier pool_state.migrate_type correspond à l’instruction (0 pour AMM, 1 pour CPMM). Sinon, annuler avec MigrateTypeNotMatch.
3. Calculer les réserves post-graduation :
   • 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 dans le programme cible (AMM v4 Initialize2 ou CPMM InitializeWithPermission) avec ces réserves pour créer le pool post-graduation.
5. Pour les migrations CPMM exécutées après la mise à niveau 2026-08-17, combiner platform_scale + creator_scale en une part LP verrouillée détenue par la plateforme et frapper au maximum une NFT Fee Key vers platform_nft_wallet. Brûler le reste burn_scale. Avant la mise à niveau, creator_scale était verrouillé séparément et sa Fee Key allait au créateur de token. Les migrations historiques complétées ne sont pas modifiées. Pour la graduation AMM v4 hérité, la disposition LP suit le flux existant de cette instruction.
6. (Pas d’étape d’autorité de mint. base_mint.mint_authority était déjà défini sur None à la création du lancement — voir la note ci-dessous.)
7. Basculer pool_state.status = Migrated, définir vesting_schedule.start_time = block_time + cliff_period.

• transfer_fee_config_authority est toujours réassigné. Le PDA authority du lancement le détient pendant toute la phase pré-graduation, donc il y a toujours quelque chose à déplacer.
• WithheldWithdraw est réassigné uniquement lorsque le PDA authority le détient toujours. Les lancements créés à partir du 2026-08-27 portent déjà transfer_fee_extension_auth sur cette autorité à partir de la création du mint, donc l’étape est sautée. La garde est ce qui empêche la migration d’annuler sur ces mints — le PDA ne peut pas renoncer à une autorité qu’il ne détient plus.

​

Comptes restants de migration CPMM

​

Programmes de token de migration CPMM

​

Liste d’autorisation GlobalConfig de plateforme

• 0 : la plateforme accepte n’importe quel GlobalConfig autrement valide ; aucun compte d’autorisation n’est requis.
• 1 : Initialize, InitializeV2 et InitializeWithToken2022 doivent inclure le PlatformAllowConfig correspondant n’importe où dans remaining_accounts.

​

Règles de paramètres de lancement de plateforme

• Create alloue le compte ne contenant aucun groupe. Cet état ne restreint rien.
• Update upsert le groupe avec ce group_id, le remplaçant entièrement s’il existe. Il redimensionne le compte pour l’adapter, donc le signataire complète le loyer qu’il grandit et reçoit le loyer qu’il rétrécit. Un nouveau groupe au-delà du dixième retourne CurveRuleGroupsExceeded ; plus de 25 contraintes, un champ inconnu ou un opérateur, ou la même paire (field, op) deux fois dans un groupe retourne InvalidCurveRuleConstraint ; les quatre champs dérivés de TotalSellA sur une config non-constant-product retournent CurveRuleFieldNotSupportedByCurve.
• Remove supprime un groupe par id, rétrécissant le compte et remboursant la différence. Un id inconnu retourne CurveRuleGroupNotExist.
• Close retourne le loyer entier au signataire. La config est alors à nouveau non restreinte même si restrict_curve_param reste 1.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

CollectExcessLamports

​

Instructions de vesting et de configuration de plateforme

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

​

Matrice de changement d’état

​

Où aller ensuite

• products/launchlab/code-demos — Exemples TypeScript pour chaque instruction.
• products/launchlab/accounts — forme d’état complète.
• reference/error-codes — Énumération d’erreur LaunchLab.

• Module LaunchLab du SDK Raydium v2
• Source du programme Raydium LaunchLab