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 Überprü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).
• Für InitializeWithToken2022 mit angehängtem TransferFeeConfig: transfer_fee_config_authority = launch_authority und withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth, wenn dieses Feld gesetzt ist, andernfalls launch_authority. Die Abhebungsseite wird bei der Mint-Erstellung geschrieben, damit die Plattform Einbehaltungsgebühren vor der Graduierung einziehen kann. Siehe platform-config.

​

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 der Kurve für base_out gegeben die Post-Gebühren Quote.
3. require(base_out ≥ minimum_base_out) andernfalls ExceededSlippage zurückweisen.
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 ix 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.
• Der Verkauf kann base_sold nicht unter 0 drücken (redundant mit dem obigen, wenn die Buchhaltung konsistent ist).
• Launch ist Active.

​

Quote-seitige Transfergebühren

• Eine Grenze, die berechnet wird, als ob der Mint gebührenfrei wäre, wird abgelehnt. Die gebührenfreien Kosten als maximum_amount_in oder die gebührenfreien Einnahmen als minimum_amount_out zu übergeben, führt zu ExceededSlippage.
• real_quote rückt nur um das vor, was den Vault erreichte. Ein BuyExactIn von amount_in auf einem 5% Quote Mint bewegt real_quote um amount_in × 0.95.

​

MigrateToAmm / MigrateToCpswap

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

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 PoolMigrated (Status war bereits Migrated) oder PoolFunding (noch in Finanzierung) zurückweisen.
2. Überprüfen Sie, dass pool_state.migrate_type der Anweisung entspricht (0 für AMM, 1 für CPMM). Andernfalls MigrateTypeNotMatch zurückweisen.
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 plattformgesammelten 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.

• transfer_fee_config_authority wird immer neu zugewiesen. Die Launch authority PDA hält sie für die ganze Pre-Graduierungs-Phase, daher gibt es immer etwas zu verschieben.
• WithheldWithdraw wird nur neu zugewiesen, wenn die authority PDA sie noch hält. Launches, die ab 2026-08-27 erstellt wurden, tragen bereits transfer_fee_extension_auth auf dieser Autorität von der Mint-Erstellung, daher wird der Schritt übersprungen. Die Schutzvorrichtung ist das, was verhindert, dass die Migration auf diesen Mints zurückweist — die PDA kann eine Autorität, die sie nicht mehr hält, nicht abtreten.

​

CPMM-Migrations verbleibende Konten

​

CPMM-Migrations Token-Programme

​

Plattform GlobalConfig Allowlist

• 0: die Plattform akzeptiert jeden ansonsten gültigen GlobalConfig; kein Allow-Konto ist erforderlich.
• 1: Initialize, InitializeV2 und InitializeWithToken2022 müssen das entsprechende PlatformAllowConfig irgendwo in remaining_accounts enthalten.

​

Plattform Launch-Parameter-Regeln

• Create ordnet das Konto zu, das keine Gruppe hält. Dieser Status schränkt nichts ein.
• Update upsert die Gruppe mit dieser group_id, ersetzt sie vollständig, wenn sie existiert. Es ändert die Größe des Kontos, um zu passen, daher zahlt der Unterzeichner die Miete, um die es wächst, und erhält die Miete zurück, um die es schrumpft. Eine neue Gruppe über die zehnte hinaus gibt CurveRuleGroupsExceeded zurück; mehr als 25 Einschränkungen, ein unbekanntes Feld oder Operator, oder das gleiche (field, op) Paar zweimal in einer Gruppe gibt InvalidCurveRuleConstraint zurück; die vier TotalSellA-abgeleiteten Felder auf einer nicht-konstanten-Produkt-Konfiguration geben CurveRuleFieldNotSupportedByCurve zurück.
• Remove löscht eine Gruppe nach ID, schrumpft das Konto und erstattet die Differenz. Eine unbekannte ID gibt CurveRuleGroupNotExist zurück.
• Close gibt die ganze Miete an den Unterzeichner zurück. Die Konfiguration ist dann wieder uneingeschränkt, auch wenn restrict_curve_param 1 bleibt.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Vesting und Plattformkonfiguration Anweisungen

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

​

State-Änderungs-Matrix

​

Wo es weitergeht

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

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