LaunchLab-Anweisungen

​

Anweisungsbestand

​

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.
• 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 = curve_param.supply, alles in base_vault.
• Die Mint-Autorität wird in derselben Anweisung widerrufen (set_authority(MintTokens, None)), direkt nachdem das Angebot geprägt wurde — nicht bei der Graduation. Die Base-Mint hat daher dauerhaft ein festes Angebot, und keine spätere Anweisung kann mehr prägen.
• PoolState wird initialisiert mit status = Fund (0), real_a = 0, real_b = 0.
• total_fund_raising_b kommt direkt aus curve_param.total_quote_fund_raising.
• 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 genau deshalb bei der Mint-Erstellung geschrieben, damit die Plattform einbehaltene Gebühren vor der Graduierung einziehen kann. Siehe platform-config.

​

Buy (kanonische Variante: 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 — nur wenn share_fee_rate > 0.
2. system_program — immer; geprüft == System::id(), sonst InvalidInput.
3. platform_fee_vault — PDA [platform_config, quote_token_mint]; wird bei der ersten Verwendung erstellt.
4. creator_fee_vault — PDA [creator, quote_token_mint]; wird bei der ersten Verwendung erstellt.

• 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 das Post-Fee-Quote.
3. require(base_out ≥ minimum_base_out) andernfalls Rückgängigmachen 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 ix in derselben Transaktion. Das Programm graduiert nicht automatisch innerhalb von Buy — eine nachfolgende Graduate ist erforderlich.

​

BuyExactOut

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

​

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 wäre der Mint gebührenfrei, 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.

​

Handels-Restkonten

​

MigrateToAmm / MigrateToCpswap

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

1. Verifizieren Sie pool_state.status == Migrate (d.h. quote_reserve_target wurde erreicht). Andernfalls Rückgängigmachen mit PoolMigrated (Status war bereits Migrated) oder PoolFunding (noch in Finanzierung).
2. Verifizieren Sie pool_state.migrate_type stimmt mit der Anweisung überein (0 für AMM, 1 für CPMM). Andernfalls Rückgängigmachen 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 wurden, kombinieren Sie platform_scale + creator_scale in einen Plattform-eigenen 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 Flow dieser Anweisung.
6. (Kein Mint-Authority-Schritt. base_mint.mint_authority war bereits bei der Launch-Erstellung auf None gesetzt — siehe die Notiz unten.)
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 neu zugewiesen nur wenn die authority PDA sie immer noch hält. Launches, die ab 2026-08-27 erstellt wurden, tragen bereits transfer_fee_extension_auth auf dieser Authority von der Mint-Erstellung, daher wird der Schritt übersprungen. Der Guard ist das, was Migration davon abhält, auf diesen Mints rückgängig zu machen — die PDA kann eine Authority, die sie nicht mehr hält, nicht abgeben.

​

CPMM-Migrations-Restkonten

​

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 passende 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 ganz, wenn sie existiert. Es ändert die Größe des Kontos, um zu passen, daher zahlt der Unterzeichner die Miete, die es wächst, und erhält die Miete zurück, die es schrumpft. Eine neue Gruppe über der zehnten gibt CurveRuleGroupsExceeded zurück; mehr als 25 Constraints, 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-Config 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 Config ist dann wieder uneingeschränkt, auch wenn restrict_curve_param 1 bleibt.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

CollectExcessLamports

​

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