Instrucciones de LaunchLab

​

Inventario de instrucciones

​

Initialize

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // o initial_virtual_quote_reserve para curve_type=1
    open_time:                  u64,
    quote_mint:                 Pubkey,
    base_token_metadata: {                         // nombre/símbolo/uri en línea; el programa hace CPI a 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.
• Los parámetros de tarifa pasan las comprobaciones launch_config.max_*_fee_rate.
• open_time ≥ now − slop (SDK aplica ≥ now; el programa tolera un ligero retroceso).
• curve_type es reconocido.

• base_mint tiene supply = base_supply_max, todo en base_vault.
• base_mint.mint_authority = launch_authority, freeze_authority = None.
• LaunchState inicializado con status = Active, base_sold = 0, quote_reserve_real = 0.
• quote_reserve_target calculado a partir de parámetros de curva + base_supply_graduation + buy_numerator (aproximadamente).

​

Buy (variante canónica: 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. Dividir quote_in en quote_in_after_fee y las partes de tarifa.
2. Resolver la curva con Newton para base_out dado el presupuesto posterior a la tarifa.
3. require(base_out ≥ minimum_base_out) de lo contrario revertir ExceededSlippage.
4. Mover quote_in usuario → bóveda. Mover base_out bóveda → usuario.
5. Actualizar base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share).
6. Actualizar contadores de tarifa (protocol_fees_quote, creator_fees_quote).
7. state_data.num_buys += 1.
8. Si quote_reserve_real ≥ quote_reserve_target después de la actualización, el SDK típicamente encadena una instrucción Graduate en la misma transacción. El programa no se gradúa automáticamente dentro de Buy — se requiere un Graduate posterior.

​

BuyExactOut

base_out:      u64
maximum_quote_in: u64

​

Sell / SellExactIn / SellExactOut

• user_base_ata.balance ≥ base_in.
• La venta no puede empujar base_sold por debajo de 0 (redundante con lo anterior dado que la contabilidad es consistente).
• El lanzamiento es Active.

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — la migrate_to_amm_wallet registrada en la vinculación GlobalConfig.
• MigrateToCpswap — la migrate_to_cpswap_wallet registrada en la vinculación GlobalConfig.

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. Verificar pool_state.status == Migrate (es decir, quote_reserve_target ha sido alcanzado). De lo contrario revertir con PoolMigrated (el estado ya era Migrated) o PoolFunding (aún en financiación).
2. Verificar que pool_state.migrate_type coincida con la instrucción (0 para AMM, 1 para CPMM). De lo contrario revertir con MigrateTypeNotMatch.
3. Calcular las reservas posteriores a la graduación:
   • 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 en el programa de destino (AMM v4 Initialize2 o CPMM InitializeWithPermission) con esas reservas para crear el pool posterior a la graduación.
5. Para migraciones CPMM ejecutadas después de la actualización del 2026-08-17, combinar platform_scale + creator_scale en una participación de LP bloqueada de propiedad de plataforma y acuñar como máximo un NFT de Clave de Tarifa a platform_nft_wallet. Quemar el resto de burn_scale. Antes de la actualización, creator_scale estaba bloqueado por separado y su Clave de Tarifa iba al creador del token. Las migraciones históricas completadas no se modifican. Para graduación heredada de AMM v4, la disposición de LP sigue el flujo existente de esa instrucción.
6. Revocar base_mint.mint_authority (establecer a None).
7. Cambiar pool_state.status = Migrated, establecer vesting_schedule.start_time = block_time + cliff_period.

​

Cuentas restantes de migración CPMM

​

Lista de permitidos de GlobalConfig de plataforma

• 0: la plataforma acepta cualquier GlobalConfig válido; no se requiere cuenta de permitidos.
• 1: Initialize, InitializeV2 e InitializeWithToken2022 deben incluir el PlatformAllowConfig coincidente en cualquier lugar en remaining_accounts.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Instrucciones de vesting y configuración de plataforma

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, UpdatePlatformCurveParam, RemovePlatformCurveParam, CreatePlatformAllowConfig, ClosePlatformAllowConfig
• CreateConfig, UpdateConfig

​

Matriz de cambio de estado

​

Dónde ir a continuación

• products/launchlab/code-demos — ejemplos de TypeScript para cada instrucción.
• products/launchlab/accounts — forma de estado completo.
• reference/error-codes — enumeración de errores de LaunchLab.

• Módulo LaunchLab del SDK de Raydium v2
• Fuente del programa LaunchLab de Raydium