LaunchLab-Konten

Diese Seite wurde mit KI automatisch übersetzt. Maßgeblich ist stets die englische Version.Englische Version ansehen →

Diese Seite dokumentiert das Pro-Launch-Kontennetzwerk: die PoolState (das Root-State-Konto für einen Launch), ihre zwei Vaults, die Authority-PDA und die Post-Graduation-Referenzen, die sie erhält, wenn der Launch abgeschlossen wird. Für die Protocol-Level-Konfiguration, die jeden Launch begrenzt, siehe products/launchlab/global-config. Für die Pro-Platform-Überlagerung siehe products/launchlab/platform-config. Für Vesting-Konten (VestingSchedule auf PoolState, VestingRecord pro Begünstigter), siehe products/launchlab/vesting.

Konteninventar

Konto	Eigentümer	Zweck
`GlobalConfig`	LaunchLab-Programm	Protocol-Level-Regeln: Gebühren, Versorgungsuntergrenzen, Migrationsbrieftaschen. Eine pro `(curve_type, index)`.
`PlatformConfig`	LaunchLab-Programm	Pro-Platform-Überlagerung: Branding, Platform-Gebühr, NFT-Split bei Graduation, Curve-Shape-Whitelist.
`PoolState`	LaunchLab-Programm	Pro-Launch-Root-State: Mints, Vaults, Curve-Parameter, Verkaufszähler, Gebührenzähler, Vesting-Plan, Graduation-Status.
`authority`	LaunchLab-Programm	Einzelne PDA mit Seed `[b"vault_auth_seed"]`, die Vaults über alle Launches hinweg besitzt und die Post-Graduation-CPI signiert.
`base_vault`	SPL Token / Token-2022	Pro-Launch-Vault, der die unverkauften Base-Token hält.
`quote_vault`	SPL Token	Pro-Launch-Vault, der akkumulierte Quote-Token hält.
`VestingRecord`	LaunchLab-Programm	Pro-Begünstigter Cliff + Linear-Unlock-Datensatz. Optional.
`creator_fee_vault`	SPL Token	Pro-Creator + Pro-Quote-Mint-Vault, der aufgelaufene Creator-Gebühren hält, geleert durch `ClaimCreatorFee`.
`platform_fee_vault`	SPL Token	Pro-Platform + Pro-Quote-Mint-Vault, der aufgelaufene Platform-Gebühren hält, geleert durch `ClaimPlatformFeeFromVault`.
`PlatformAllowConfig`	LaunchLab-Programm	Optionale Platform-verwaltete Berechtigung für ein `(PlatformConfig, GlobalConfig)`-Paar. Wird nur überprüft, wenn die Platform die Einschränkung aktiviert.
(Post-Graduation) `cpmm_pool_state`	CPMM-Programm	Pool erstellt durch `MigrateToCpswap` für jeden neuen Launch. Legacy-State kann immer noch eine AMM-v4-Graduation referenzieren.
(Post-Graduation) Fee Key NFT	LP-Lock-Programm	Vor dem 2026-08-17-Upgrade konnten Platform- und Creator-Skalen separate Fee Keys erzeugen. Migrationen, die danach ausgeführt wurden, kombinieren beide Skalen in einen Platform-Fee-Key.

Das SDK raydium.launchpad.getLaunchById gibt PoolState plus ein Flag zurück, das anzeigt, ob der Launch abgeschlossen wurde; wenn ja, ist die Post-Migration-Pool-ID enthalten.

`PoolState`

Der Pro-Launch-Root-State. Feldnamen unten entsprechen der On-Chain-Rust-Struktur (states/pool.rs); einige Werte sind zur Lesbarkeit vereinfacht — konsultieren Sie die Quelle für das exakte Memory-Layout.

// states/pool.rs (abgekürzt)
pub struct PoolState {
    pub epoch:                     u64,        // recent_epoch tracker
    pub auth_bump:                 u8,
    pub status:                    u8,         // PoolStatus enum
    pub base_decimals:             u8,
    pub quote_decimals:            u8,
    pub migrate_type:              u8,         // 0 = AMM v4, 1 = CPMM
    pub supply:                    u64,        // total base tokens (no decimals)
    pub total_base_sell:           u64,        // base supply allocated to the curve
    pub virtual_base:              u64,        // virtual-reserve seed
    pub virtual_quote:             u64,        // virtual-reserve seed
    pub real_base:                 u64,        // base sold so far
    pub real_quote:                u64,        // quote raised so far (excl. fees)
    pub total_quote_fund_raising:  u64,        // graduation threshold in quote

    pub quote_protocol_fee:        u64,        // accrued, pending CollectFee
    pub platform_fee:              u64,        // accrued, pending ClaimPlatformFee
    pub migrate_fee:               u64,        // accrued, pending CollectMigrateFee
    pub vesting_schedule:          VestingSchedule,

    pub global_config:             Pubkey,
    pub platform_config:           Pubkey,
    pub creator:                   Pubkey,
    pub base_mint:                 Pubkey,
    pub quote_mint:                Pubkey,
    pub base_vault:                Pubkey,
    pub quote_vault:               Pubkey,

    pub amm_creator_fee_on:        u8,         // 0 = QuoteToken, 1 = BothToken (CPMM-only)
    pub token_program_flag:        u8,         // bit flags for SPL Token vs Token-2022
    pub padding:                   [u8; 54],
}

#[derive(Default, Debug, Clone)]
pub struct VestingSchedule {
    pub total_locked_amount:    u64,
    pub cliff_period:           u64,
    pub unlock_period:          u64,
    pub start_time:             u64,           // set at graduation
    pub allocated_share_amount: u64,           // running sum across VestingRecords
}

PoolStatus-Werte (aus dem Anchor IDL):

= Funding         — accepting buys / sells; below quote_reserve_target
= Migrate         — quote_reserve_target reached; awaiting MigrateTo*
= Migrated        — MigrateTo* already executed; vesting clock running

Integrator-relevante Felder:

status — drei Werte, monoton (Funding → Migrate → Migrated). Lesevorgänge immer sicher; Schreibvorgänge gated.
real_base, real_quote — aktueller Curve-State. Kombiniert mit virtual_base / virtual_quote sind sie ausreichend, um den Spot-Preis zu berechnen, ohne die Vaults zu berühren. Siehe bonding-curve.
total_base_sell vs real_base — „Fortschritt zur Graduation”-Verhältnis für UIs.
migrate_type — neue Initialisierung erfordert 1 (CPSWAP). Ein gespeichertes 0 bleibt nur für einen bestehenden Launch sinnvoll, der vor der CPMM-Only-Erzwingung erstellt wurde.
amm_creator_fee_on — wählt creator_fee_on = OnlyQuoteToken (0) oder BothToken (1) auf dem Post-Graduation-CPMM-Pool. Es wählt nicht das Migrationsziel. Siehe creator-fees.
quote_protocol_fee / platform_fee / migrate_fee — drei unabhängige Gebührenzähler. Jeder hat seine eigene Claim-Anweisung; siehe instructions.
vesting_schedule — vorhanden auf jedem PoolState, aber inaktiv, wenn total_locked_amount == 0. Siehe vesting für den vollständigen Lebenszyklus.

Die Authority-PDA

LaunchLab verwendet eine einzelne Authority-PDA über alle Launches hinweg, abgeleitet ohne Pro-Launch-Seed:

const LAUNCHLAB_PROGRAM_ID = new PublicKey("<LAUNCHLAB_ID>"); // see reference/program-addresses

const [authority, bump] = PublicKey.findProgramAddressSync(
  [Buffer.from("vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

Diese einzelne PDA ist:

Die Authority auf jedem Launch’s base_vault und quote_vault.
Die mint_authority auf jedem Launch’s base_mint (vor Graduation).
Der Unterzeichner auf der CPMM-Graduation-CPI und auf Legacy-AMM-v4-Graduation für bestehenden State.
Der Unterzeichner auf ClaimVestedToken-Transfers aus dem Base-Vault.

Die mint_authority wird unmittelbar nach MigrateToCpswap oder einem Legacy-MigrateToAmm-Aufruf widerrufen, sodass die Versorgung dauerhaft festgelegt ist. Zwei zusätzliche PDAs gaten die Gebühren-Vaults:

const [creatorFeeVaultAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("creator_fee_vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

const [platformFeeVaultAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("platform_fee_vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

Diese unterzeichnen den Transfer aus den entsprechenden Gebühren-Vaults während ClaimCreatorFee und ClaimPlatformFeeFromVault.

Base Mint

Erstellt inline durch Initialize mit:

mint_authority = authority (widerrufen bei Graduation).
freeze_authority = None.
supply = supply, vollständig in base_vault geprägt.
decimals vom Creator bei Initialize gewählt (üblicherweise 6).

Da die vollständige Versorgung vorher geprägt ist, ist base_mint.supply für die Lebensdauer des Launches konstant. Curve-Käufe verschieben Token von base_vault zum Käufer, rufen aber nicht mint_to auf. Initialize / InitializeV2 erstellen SPL-Token-Launches. Die dedizierte InitializeWithToken2022-Anweisung ermöglicht es, dass der Base-Mint ein Token-2022-Mint ist (mit optionalem TransferFeeConfig); der Quote-Mint ist immer noch SPL Token. Alle drei Initialisierungspfade erfordern CPMM-Graduation.

Vaults

Sowohl base_vault als auch quote_vault sind Standard-SPL-Token-Konten, die von der LaunchLab-authority-PDA besessen werden. Adressen werden auf PoolState gespeichert und können auch abgeleitet werden:

const [baseVault] = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), baseMint.toBuffer()],
  LAUNCHLAB_PROGRAM_ID,
);
const [quoteVault] = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), quoteMint.toBuffer()],
  LAUNCHLAB_PROGRAM_ID,
);

(Überprüfen Sie die genauen Seed-Präfixe aus der Initialize-Accounts-Struktur der Quelle, bevor Sie sich in der Produktion auf eine Ableitung verlassen.)

Gebühren-Vaults

Zwei PDAs aggregieren Gebühren über Launches hinweg:

Creator-Gebühren-Vault — PDA mit Seeds [creator, quote_mint]. Jeder Launch, der die gleichen Creator-Gebühren auf dem gleichen Quote-Mint verdient, fließt in den gleichen Vault. Der Creator leert ihn über ClaimCreatorFee.
Platform-Gebühren-Vault — PDA mit Seeds [platform_config, quote_mint]. Jeder Launch, der durch die gleiche Platform geleitet wird und den gleichen Quote-Mint verwendet, fließt in den gleichen Vault. Die platform_fee_wallet der Platform leert ihn über ClaimPlatformFeeFromVault. Es gibt auch eine Pro-Launch-Leer-Variante (ClaimPlatformFee), die direkt aus dem Launch’s quote_vault zieht, ohne durch den aggregierten Vault zu gehen.

Das aggregierte-Vault-Muster ermöglicht es einem hochvolumigen Creator oder einer Platform, die Mietkosten der Gebührenakkumulation über viele Launches hinweg zu amortisieren.

Quote Vault ↔ `real_quote`

quote_vault.balance und PoolState.real_quote sollten synchron bleiben. Sie können um höchstens die Summe der drei ausstehenden Gebührenzähler (quote_protocol_fee, platform_fee, migrate_fee) abweichen, die im Vault sitzen, aber zu den Gebührenzählern und nicht zur Curve-Reserve gehören. Die Curve-Mathematik verwendet immer real_quote, nie den rohen Vault-Saldo. Pre-Graduation-Invariante:

quote_vault.balance ==
   real_quote
 + quote_protocol_fee
 + platform_fee
 + migrate_fee

Lebenszyklus-Kontentransitionen

Ereignis	Status	`real_base`	`real_quote`	Post-Graduation-Pool
`Initialize`	Funding	0	0	—
`BuyExactIn` / `BuyExactOut`	Funding	`+base_out`	`+quote_in_after_fee`	—
`SellExactIn` / `SellExactOut`	Funding	`−base_in`	`−quote_out_before_fee`	—
`MigrateToCpswap` (oder Legacy `MigrateToAmm`)	Funding → Migrate → Migrated	(eingefroren)	(eingefroren)	erstellt; CPMM LP wird in Platform-eigene gesperrte LP und verbrannte LP aufgeteilt
`ClaimCreatorFee` / `ClaimPlatformFee*`	beliebig	—	—	leert einen Gebühren-Vault
`CreateVestingAccount`	Funding	—	—	erhöht `vesting_schedule.allocated_share_amount`
`ClaimVestedToken`	Nur Migrated	—	—	leert `base_vault`

Nächste Schritte

products/launchlab/bonding-curve — die Mathematik hinter real_base ↔ real_quote.
products/launchlab/instructions — Pro-Anweisung-Kontenlisten.
products/launchlab/global-config — Protocol-Level-Bindung.
products/launchlab/platform-config — Platform-Überlagerung.
products/launchlab/vesting — Gesperrte Versorgungsmechanik.
products/cpmm/accounts — wie der Post-Graduation-cpmm_pool_state aussieht.

Quellen:

raydium-launch/programs/launchpad/src/states/pool.rs — PoolState, PoolStatus, VestingSchedule, AmmCreatorFeeOn.
raydium-launch/programs/launchpad/src/lib.rs — PDA-Seed-Konstanten (AUTH_SEED, CREATOR_FEE_VAULT_AUTH_SEED, PLATFORM_FEE_VAULT_AUTH_SEED).
Raydium SDK v2 launchpad Modul.

LaunchLab

Token-Launch-Ablauf

Tips & Gotchas

Konteninventar

`PoolState`

Die Authority-PDA

Base Mint

Vaults

Gebühren-Vaults

Quote Vault ↔ `real_quote`

Lebenszyklus-Kontentransitionen

Nächste Schritte

​Konteninventar

​PoolState

​Die Authority-PDA

​Base Mint

​Vaults

​Gebühren-Vaults

​Quote Vault ↔ real_quote

​Lebenszyklus-Kontentransitionen

​Nächste Schritte

Konteninventar

`PoolState`

Die Authority-PDA

Base Mint

Vaults

Gebühren-Vaults

Quote Vault ↔ `real_quote`

Lebenszyklus-Kontentransitionen

Nächste Schritte