LaunchLab-Anweisungen

​

Anweisungsbestand

​

Initialize

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // oder initial_virtual_quote_reserve für curve_type=1
    open_time:                  u64,
    quote_mint:                 Pubkey,
    base_token_metadata: {                         // inline name/symbol/uri; Programm CPIs zu 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.
• Gebührenparameter bestehen launch_config.max_*_fee_rate-Prüfungen.
• open_time ≥ now − slop (SDK erzwingt ≥ now; Programm toleriert leichte Rückdatierung).
• curve_type wird erkannt.

• base_mint hat supply = base_supply_max, alles in base_vault.
• base_mint.mint_authority = launch_authority, freeze_authority = None.
• LaunchState initialisiert mit status = Active, base_sold = 0, quote_reserve_real = 0.
• quote_reserve_target berechnet aus Kurvenparametern + base_supply_graduation + buy_numerator (ungefähr).

​

Buy (kanonische Variante: 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. Teilen Sie quote_in in quote_in_after_fee und die Gebührenteile auf.
2. Newton-Lösen Sie die Kurve für base_out gegeben das Post-Gebühren-Quote.
3. require(base_out ≥ minimum_base_out) sonst revert ExceededSlippage.
4. Verschieben Sie quote_in Benutzer → Vault. Verschieben Sie base_out Vault → Benutzer.
5. Aktualisieren Sie base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share).
6. Aktualisieren Sie Gebührenzähler (protocol_fees_quote, creator_fees_quote).
7. state_data.num_buys += 1.
8. Wenn quote_reserve_real ≥ quote_reserve_target nach der Aktualisierung, verkettete das SDK typischerweise eine Graduate-Anweisung in derselben Transaktion. Das Programm graduiert nicht automatisch innerhalb von Buy — eine nachfolgende Graduate ist erforderlich.

​

BuyExactOut

base_out:      u64
maximum_quote_in: u64

​

Sell / SellExactIn / SellExactOut

• user_base_ata.balance ≥ base_in.
• Verkauf kann base_sold nicht unter 0 drücken (redundant mit dem obigen, wenn die Buchhaltung konsistent ist).
• Launch ist Active.

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — das migrate_to_amm_wallet, das auf der Bindungs-GlobalConfig aufgezeichnet ist.
• MigrateToCpswap — das migrate_to_cpswap_wallet, das auf der Bindungs-GlobalConfig aufgezeichnet ist.

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. Überprüfen Sie pool_state.status == Migrate (d. h. quote_reserve_target wurde erreicht). Andernfalls revert mit PoolMigrated (Status war bereits Migrated) oder PoolFunding (noch in Finanzierung).
2. Überprüfen Sie, dass pool_state.migrate_type der Anweisung entspricht (0 für AMM, 1 für CPMM). Andernfalls revert mit MigrateTypeNotMatch.
3. Berechnen Sie die Post-Graduierungs-Reserven:
   • 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 in das Ziel-Programm (AMM v4 Initialize2 oder CPMM InitializeWithPermission) mit diesen Reserven, um den Post-Graduierungs-Pool zu erstellen.
5. Für CPMM-Migrationen, die nach dem 2026-08-17-Upgrade ausgeführt werden, kombinieren Sie platform_scale + creator_scale in einen plattformeigenen gesperrten LP-Anteil und prägen Sie höchstens einen Fee-Key-NFT zu platform_nft_wallet. Verbrennen Sie den burn_scale-Rest. Vor dem Upgrade war creator_scale separat gesperrt und sein Fee-Key ging an den Token-Ersteller. Abgeschlossene historische Migrationen werden nicht geändert. Für Legacy-AMM-v4-Graduierung folgt die LP-Disposition dem bestehenden Fluss dieser Anweisung.
6. Widerrufen Sie base_mint.mint_authority (setzen Sie auf None).
7. Kippen Sie pool_state.status = Migrated, setzen Sie vesting_schedule.start_time = block_time + cliff_period.

​

CPMM-Migrations-Restkonten

​

Plattform-GlobalConfig-Allowlist

• 0: Die Plattform akzeptiert jede ansonsten gültige GlobalConfig; kein Allow-Konto ist erforderlich.
• 1: Initialize, InitializeV2 und InitializeWithToken2022 müssen die passende PlatformAllowConfig irgendwo in remaining_accounts enthalten.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Vesting- und Plattformkonfigurationsanweisungen

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

​

State-Änderungsmatrix

​

Nächste Schritte

• products/launchlab/code-demos — TypeScript-Beispiele für jede Anweisung.
• products/launchlab/accounts — vollständige State-Form.
• reference/error-codes — LaunchLab-Fehler-Enum.

• Raydium SDK v2 LaunchLab Modul
• Raydium LaunchLab Programm-Quelle