Instructions LaunchLab

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

Inventaire des instructions

• BothToken → MigrateToAmm → pool AMM v4 (les frais créateur peuvent être collectés de chaque côté ; AMM v4 n’a pas de champ natif de frais créateur, donc les frais créateur sont prélevés via le mécanisme du NFT LP-lock à la place).
• QuoteToken → MigrateToCpswap → pool CPMM avec creator_fee_on = OnlyQuoteToken (le créateur continue de gagner des frais du pool CPMM via le NFT Fee Key LaunchLab — voir products/launchlab/creator-fees).

​

Initialize

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // ou initial_virtual_quote_reserve pour curve_type=1
    open_time:                  u64,
    quote_mint:                 Pubkey,
    base_token_metadata: {                         // nom/symbole/uri en ligne ; le programme CPI vers 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.
• Les paramètres de frais réussissent les vérifications launch_config.max_*_fee_rate.
• open_time ≥ now − slop (le SDK applique ≥ now ; le programme tolère une antidatation légère).
• curve_type est reconnu.

• base_mint a supply = base_supply_max, tout dans base_vault.
• base_mint.mint_authority = launch_authority, freeze_authority = None.
• LaunchState initialisé avec status = Active, base_sold = 0, quote_reserve_real = 0.
• quote_reserve_target calculé à partir des paramètres courbe + base_supply_graduation + buy_numerator (approximativement).

​

Buy (variante canonique : 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. Divise quote_in en quote_in_after_fee et les parts de frais.
2. Résout la courbe par Newton pour base_out donnés le devis post-frais.
3. require(base_out ≥ minimum_base_out) sinon revert ExceededSlippage.
4. Déplace quote_in utilisateur → vault. Déplace base_out vault → utilisateur.
5. Met à jour base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share).
6. Met à 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 fait pas de graduation auto à l’intérieur de Buy — une Graduate ultérieure est requise.

​

BuyExactOut

base_out:      u64
maximum_quote_in: u64

​

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.

​

MigrateToAmm / MigrateToCpswap

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

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. Vérifie que pool_state.status == Migrate (c.-à-d., quote_reserve_target a été atteint). Sinon revert avec PoolMigrated (le statut était déjà Migrated) ou PoolFunding (toujours en financement).
2. Vérifie que pool_state.migrate_type correspond à l’instruction (0 pour AMM, 1 pour CPMM). Sinon revert avec MigrateTypeNotMatch.
3. Calcule 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. Divise le LP résultant selon le PlatformConfig.{platform_scale, creator_scale, burn_scale} de liaison (CPMM uniquement) — un morceau mintée vers platform_nft_wallet, un vers un NFT créateur enrobé par le programme LP-Lock, un brûlé via Burn & Earn. Pour la graduation AMM v4, la disposition du LP est gouvernée par les propres paramètres d’initialisation d’AMM v4.
6. Révoque base_mint.mint_authority (défini sur None).
7. Bascule pool_state.status = Migrated, définit vesting_schedule.start_time = block_time + cliff_period.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Instructions de vesting et de config de plateforme

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, UpdatePlatformCurveParam, RemovePlatformCurveParam, CreatePlatformGlobalAccess, ClosePlatformGlobalAccess
• 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 — Enum d’erreur LaunchLab.

• Module LaunchLab du SDK Raydium v2
• Code source du programme Raydium LaunchLab