Instrucciones de 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.

​

Inventario de instrucciones

• BothToken → MigrateToAmm → grupo AMM v4 (la comisión del creador puede cobrarse de cualquier lado; AMM v4 no tiene campo nativo de comisión del creador, por lo que las comisiones del creador se cobran mediante el mecanismo de bloqueo LP NFT).
• QuoteToken → MigrateToCpswap → grupo CPMM con creator_fee_on = OnlyQuoteToken (el creador continúa ganando comisiones del grupo CPMM a través del NFT de Clave de Comisión de LaunchLab — ver products/launchlab/creator-fees).

​

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 inline; 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 comisión pasan verificaciones de launch_config.max_*_fee_rate.
• open_time ≥ now − slop (SDK refuerza ≥ now; el programa tolera datación anterior leve).
• 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. Divide quote_in en quote_in_after_fee y las partes de comisión.
2. Resuelve Newton la curva para base_out dada la comisión post-comisión.
3. require(base_out ≥ minimum_base_out) si no, 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 comisiones (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 ix Graduate en la misma transacción. El programa no auto-gradúa 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.
• Vender 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 el GlobalConfig vinculado.
• MigrateToCpswap — la migrate_to_cpswap_wallet registrada en el GlobalConfig vinculado.

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. Verifica pool_state.status == Migrate (es decir, quote_reserve_target ha sido alcanzado). Si no, revierte con PoolMigrated (el estado ya fue Migrated) o PoolFunding (aún en financiamiento).
2. Verifica pool_state.migrate_type coincida con la instrucción (0 para AMM, 1 para CPMM). Si no, 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 al programa objetivo (AMM v4 Initialize2 o CPMM InitializeWithPermission) con esas reservas para crear el grupo posterior a la graduación.
5. Divide el LP resultante según el PlatformConfig.{platform_scale, creator_scale, burn_scale} vinculado (solo CPMM) — una parte acuñada a platform_nft_wallet, una a un NFT de creador envuelto por el programa LP-Lock, una quemada vía Burn & Earn. Para graduación AMM v4, la disposición del LP se rige por los parámetros de inicialización propios de AMM v4.
6. Revoca base_mint.mint_authority (establecer a None).
7. Voltea pool_state.status = Migrated, establece vesting_schedule.start_time = block_time + cliff_period.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Instrucciones de vesting y config de plataforma

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, UpdatePlatformCurveParam, RemovePlatformCurveParam, CreatePlatformGlobalAccess, ClosePlatformGlobalAccess
• CreateConfig, UpdateConfig

​

Matriz de cambio de estado

​

Hacia 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 — enum de errores de LaunchLab.

• Módulo LaunchLab del SDK Raydium v2
• Código fuente del programa Raydium LaunchLab