Instrucciones de LaunchLab

​

Inventario de instrucciones

​

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.
• 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 = curve_param.supply, todo en base_vault.
• La autoridad de acuñación se revoca en esta misma instrucción (set_authority(MintTokens, None)) justo después de acuñar el suministro — no en la graduación. Por tanto, el mint base queda permanentemente con suministro fijo, y ninguna instrucción posterior puede acuñar más.
• PoolState inicializado con status = Fund (0), real_a = 0, real_b = 0.
• total_fund_raising_b viene directamente de curve_param.total_quote_fund_raising.
• 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)

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 — solo cuando share_fee_rate > 0.
2. system_program — siempre; se verifica == System::id(), si no InvalidInput.
3. platform_fee_vault — PDA [platform_config, quote_token_mint]; creada en el primer uso.
4. creator_fee_vault — PDA [creator, quote_token_mint]; creada en el primer uso.

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

1. Divide quote_in en quote_in_after_fee y las partes de tarifa.
2. Resuelve Newton la curva para base_out dada la cotización posterior a la tarifa.
3. require(base_out ≥ minimum_base_out) de lo contrario revierte ExceededSlippage.
4. Mueve quote_in usuario → bóveda. Mueve base_out bóveda → usuario.
5. Actualiza base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share).
6. Actualiza 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

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

​

Sell / SellExactIn / SellExactOut

• user_base_ata.balance ≥ base_in.
• Vender 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 sin tarifa es rechazado. Pasar el costo sin tarifa como maximum_amount_in, o los ingresos sin tarifa 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.

​

Cuentas restantes de comercio

​

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.

1. Verifica pool_state.status == Migrate (es decir, quote_reserve_target ha sido alcanzado). De lo contrario revierte con PoolMigrated (el estado ya era Migrated) o PoolFunding (aún en financiación).
2. Verifica pool_state.migrate_type coincide con la instrucción (0 para AMM, 1 para CPMM). De lo contrario revierte con MigrateTypeNotMatch.
3. Calcula 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 de CPMM ejecutadas después de la actualización 2026-08-17, combina platform_scale + creator_scale en una participación de LP bloqueada propiedad de la plataforma y acuña como máximo un NFT de Clave de Tarifa a platform_nft_wallet. Quema 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. (Sin paso de autoridad de mint. base_mint.mint_authority ya fue establecido a None en la creación del lanzamiento — ver la nota abajo.)
7. Voltea pool_state.status = Migrated, establece vesting_schedule.start_time = block_time + cliff_period.

• transfer_fee_config_authority siempre es reasignada. El PDA de authority del lanzamiento la mantiene durante toda la fase previa a la graduación, por lo que siempre hay algo que mover.
• WithheldWithdraw es reasignada solo cuando el PDA de authority aún la mantiene. Los lanzamientos creados desde 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 guardia es lo que evita que la migración revierta en esos mints — el PDA no puede renunciar a una autoridad que ya no mantiene.

​

Cuentas restantes de migración de CPMM

​

Programas de token de migración de 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 actualiza 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 no 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 de nuevo incluso mientras restrict_curve_param permanece 1.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

CollectExcessLamports

​

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

​

A 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