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 antedatado).
• 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).
• Para InitializeWithToken2022 con un TransferFeeConfig adjunto: transfer_fee_config_authority = launch_authority, y withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth cuando ese campo está establecido, de lo contrario launch_authority. El lado de retiro se escribe en la creación de mint precisamente para que la plataforma pueda barrer tarifas retenidas antes de la graduación. Ver platform-config.

​

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 Newton la curva para base_out dada la cotización 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.

​

Tarifas de transferencia del lado de la cotización

• Un límite calculado como si el mint fuera libre de tarifas es rechazado. Pasar el costo libre de tarifas como maximum_amount_in, o los ingresos libres de tarifas como minimum_amount_out, revierte con ExceededSlippage.
• real_quote avanza solo por lo que llegó a la bóveda. Un BuyExactIn de amount_in en un mint de cotización del 5% mueve real_quote por amount_in × 0.95.

​

MigrateToAmm / MigrateToCpswap

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

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 la 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. Voltear pool_state.status = Migrated, establecer vesting_schedule.start_time = block_time + cliff_period.

• transfer_fee_config_authority siempre es reasignado. El PDA de lanzamiento authority lo mantiene durante toda la fase previa a la graduación, por lo que siempre hay algo que mover.
• WithheldWithdraw es reasignado solo cuando el PDA authority aún lo mantiene. Los lanzamientos creados a partir del 2026-08-27 en adelante ya llevan transfer_fee_extension_auth en esa autoridad desde la creación de mint, por lo que el paso se omite. La protección es lo que evita que la migración revierta en esos mints — el PDA no puede renunciar a una autoridad que ya no posee.

​

Cuentas restantes de migración CPMM

​

Programas de token de migración CPMM

​

Lista de permitidos de GlobalConfig de plataforma

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

​

Reglas de parámetros de lanzamiento de plataforma

• Create asigna la cuenta sin grupo. Ese estado no restringe nada.
• Update inserta o reemplaza el grupo con ese group_id, reemplazándolo completamente si existe. Redimensiona la cuenta para que quepa, por lo que el firmante completa la renta que crece y recibe de vuelta la renta que se reduce. Un nuevo grupo más allá del décimo devuelve CurveRuleGroupsExceeded; más de 25 restricciones, un campo desconocido u operador, o el mismo par (field, op) dos veces en un grupo devuelve InvalidCurveRuleConstraint; los cuatro campos derivados de TotalSellA en una configuración que no es de producto constante devuelven CurveRuleFieldNotSupportedByCurve.
• Remove elimina un grupo por id, reduciendo la cuenta y reembolsando la diferencia. Un id desconocido devuelve CurveRuleGroupNotExist.
• Close devuelve toda la renta al firmante. La configuración es entonces sin restricciones nuevamente incluso mientras restrict_curve_param permanece 1.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Instrucciones de vesting y configuración de plataforma

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, CreatePlatformAllowConfig, ClosePlatformAllowConfig
• CreatePlatformCurveRule, UpdatePlatformCurveRule, RemovePlatformCurveRule, ClosePlatformCurveRule
• 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