Instruções do LaunchLab

​

Inventário de instruções

​

Initialize

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // ou initial_virtual_quote_reserve para curve_type=1
    open_time:                  u64,
    quote_mint:                 Pubkey,
    base_token_metadata: {                         // nome/símbolo/uri inline; programa faz CPI para 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.
• Parâmetros de taxa passam nas verificações launch_config.max_*_fee_rate.
• open_time ≥ now − slop (SDK impõe ≥ now; programa tolera backdating leve).
• curve_type é reconhecido.

• base_mint tem supply = base_supply_max, tudo em base_vault.
• base_mint.mint_authority = launch_authority, freeze_authority = None.
• LaunchState inicializado com status = Active, base_sold = 0, quote_reserve_real = 0.
• quote_reserve_target computado a partir de parâmetros de curva + base_supply_graduation + buy_numerator (aproximadamente).
• Para InitializeWithToken2022 com um TransferFeeConfig anexado: transfer_fee_config_authority = launch_authority, e withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth quando esse campo está definido, caso contrário launch_authority. O lado de retirada é escrito na criação de mint precisamente para que a plataforma possa varrer taxas retidas antes da graduação. Veja 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 em quote_in_after_fee e as partes de taxa.
2. Newton-resolver a curva para base_out dado o quote pós-taxa.
3. require(base_out ≥ minimum_base_out) caso contrário reverter ExceededSlippage.
4. Mover quote_in usuário → vault. Mover base_out vault → usuário.
5. Atualizar base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share).
6. Atualizar contadores de taxa (protocol_fees_quote, creator_fees_quote).
7. state_data.num_buys += 1.
8. Se quote_reserve_real ≥ quote_reserve_target após a atualização, o SDK tipicamente encadeia uma ix Graduate na mesma transação. O programa não auto-gradua dentro de Buy — um Graduate subsequente é necessário.

​

BuyExactOut

base_out:      u64
maximum_quote_in: u64

​

Sell / SellExactIn / SellExactOut

• user_base_ata.balance ≥ base_in.
• Vender não pode empurrar base_sold abaixo de 0 (redundante com o acima dado que a contabilidade é consistente).
• Lançamento é Active.

​

Taxas de transferência do lado da quote

• Um limite computado como se o mint fosse sem taxa é rejeitado. Passar o custo sem taxa como maximum_amount_in, ou os rendimentos sem taxa como minimum_amount_out, reverte com ExceededSlippage.
• real_quote avança apenas pelo que chegou ao vault. Um BuyExactIn de amount_in em um mint de quote de 5% move real_quote por amount_in × 0.95.

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — a migrate_to_amm_wallet registrada na vinculação GlobalConfig.
• MigrateToCpswap — a migrate_to_cpswap_wallet registrada na vinculação GlobalConfig.

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. Verificar pool_state.status == Migrate (ou seja, quote_reserve_target foi atingido). Caso contrário reverter com PoolMigrated (status já era Migrated) ou PoolFunding (ainda em financiamento).
2. Verificar pool_state.migrate_type corresponde à instrução (0 para AMM, 1 para CPMM). Caso contrário reverter com MigrateTypeNotMatch.
3. Computar as reservas pós-graduação:
   • 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 no programa de destino (AMM v4 Initialize2 ou CPMM InitializeWithPermission) com essas reservas para criar o pool pós-graduação.
5. Para migrações CPMM executadas após a atualização de 2026-08-17, combinar platform_scale + creator_scale em uma participação de LP bloqueada de propriedade da plataforma e cunhar no máximo um NFT de Chave de Taxa para platform_nft_wallet. Queimar o restante burn_scale. Antes da atualização, creator_scale era bloqueado separadamente e sua Chave de Taxa ia para o criador do token. Migrações históricas concluídas não são modificadas. Para graduação legada AMM v4, a disposição de LP segue o fluxo existente dessa instrução.
6. Revogar base_mint.mint_authority (definir para None).
7. Virar pool_state.status = Migrated, definir vesting_schedule.start_time = block_time + cliff_period.

• transfer_fee_config_authority é sempre reatribuída. O PDA de lançamento authority a mantém por toda a fase pré-graduação, então sempre há algo para mover.
• WithheldWithdraw é reatribuída apenas quando o PDA authority ainda a mantém. Lançamentos criados a partir de 2026-08-27 em diante já carregam transfer_fee_extension_auth nessa autoridade a partir da criação de mint, então o passo é pulado. A guarda é o que impede a migração de reverter nesses mints — o PDA não pode assinar uma autoridade que não mantém mais.

​

Contas restantes de migração CPMM

​

Programas de token de migração CPMM

​

Lista de permissões GlobalConfig da plataforma

• 0: a plataforma aceita qualquer GlobalConfig válido; nenhuma conta de permissão é necessária.
• 1: Initialize, InitializeV2 e InitializeWithToken2022 devem incluir o PlatformAllowConfig correspondente em qualquer lugar em remaining_accounts.

​

Regras de parâmetro de lançamento da plataforma

• Create aloca a conta sem grupo. Esse estado não restringe nada.
• Update faz upsert do grupo com esse group_id, substituindo-o completamente se existir. Redimensiona a conta para caber, então o signatário complementa o aluguel que cresce e recebe de volta o aluguel que encolhe. Um novo grupo além do décimo retorna CurveRuleGroupsExceeded; mais de 25 restrições, um campo desconhecido ou operador, ou o mesmo par (field, op) duas vezes em um grupo retorna InvalidCurveRuleConstraint; os quatro campos derivados de TotalSellA em uma config não-produto-constante retorna CurveRuleFieldNotSupportedByCurve.
• Remove descarta um grupo por id, encolhendo a conta e reembolsando a diferença. Um id desconhecido retorna CurveRuleGroupNotExist.
• Close retorna todo o aluguel ao signatário. A config fica irrestrita novamente mesmo enquanto restrict_curve_param permanece 1.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Instruções de vesting e configuração de plataforma

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, CreatePlatformAllowConfig, ClosePlatformAllowConfig
• CreatePlatformCurveRule, UpdatePlatformCurveRule, RemovePlatformCurveRule, ClosePlatformCurveRule
• CreateConfig, UpdateConfig

​

Matriz de mudança de estado

​

Para onde ir a seguir

• products/launchlab/code-demos — exemplos TypeScript para cada instrução.
• products/launchlab/accounts — forma de estado completa.
• reference/error-codes — enum de erro LaunchLab.

• Módulo Raydium SDK v2 LaunchLab
• Fonte do programa Raydium LaunchLab