Akun LaunchLab

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.Lihat versi bahasa Inggris →

Halaman ini mendokumentasikan grafik akun per-peluncuran: PoolState (akun state root untuk satu peluncuran), dua vaultnya, PDA authority, dan referensi pasca-kelulusan yang diperolehnya ketika peluncuran diselesaikan. Untuk config tingkat protokol yang membatasi setiap peluncuran, lihat products/launchlab/global-config. Untuk overlay per-platform, lihat products/launchlab/platform-config. Untuk akun vesting (VestingSchedule di PoolState, VestingRecord per penerima), lihat products/launchlab/vesting.

Inventori akun

Akun	Pemilik	Tujuan
`GlobalConfig`	Program LaunchLab	Aturan tingkat protokol: biaya, floor pasokan, dompet migrasi. Satu per `(curve_type, index)`.
`PlatformConfig`	Program LaunchLab	Overlay per-platform: branding, biaya platform, pemisahan NFT saat kelulusan, whitelist bentuk kurva.
`PoolState`	Program LaunchLab	State root per-peluncuran: mint, vault, parameter kurva, counter terjual, counter biaya, jadwal vesting, status kelulusan.
`authority`	Program LaunchLab	PDA tunggal di seed `[b"vault_auth_seed"]` yang memiliki vault di semua peluncuran dan menandatangani CPI pasca-kelulusan.
`base_vault`	SPL Token / Token-2022	Vault per-peluncuran yang menampung token base yang tidak terjual.
`quote_vault`	SPL Token	Vault per-peluncuran yang menampung token quote yang terakumulasi.
`VestingRecord`	Program LaunchLab	Catatan cliff + linear-unlock per-penerima. Opsional.
`creator_fee_vault`	SPL Token	Vault per-kreator + per-quote-mint yang menampung biaya kreator yang terkumpul, disapu oleh `ClaimCreatorFee`.
`platform_fee_vault`	SPL Token	Vault per-platform + per-quote-mint yang menampung biaya platform yang terkumpul, disapu oleh `ClaimPlatformFeeFromVault`.
(pasca-kelulusan) `cpmm_pool_state` atau `amm_pool_state`	Program CPMM / AMM v4	Pool yang dibuat oleh `MigrateToCpswap` / `MigrateToAmm`.
(pasca-kelulusan) Fee Key NFT	Program LP-Lock	Membungkus irisan LP kreator pada kelulusan CPMM; memberi hak pemegang untuk `ClaimCreatorFee` di pool CPMM.

SDK’s raydium.launchpad.getLaunchById mengembalikan PoolState ditambah flag yang menunjukkan apakah peluncuran telah lulus; jika ya, ID pool pasca-migrasi disertakan.

`PoolState`

State root per-peluncuran. Nama field di bawah cocok dengan struct Rust on-chain (states/pool.rs); beberapa nilai disederhanakan untuk keterbacaan — lihat sumber untuk tata letak memori yang tepat.

// states/pool.rs (abridged)
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
}

Nilai PoolStatus (dari Anchor IDL):

= Funding         — menerima beli / jual; di bawah quote_reserve_target
= Migrate         — quote_reserve_target tercapai; menunggu MigrateTo*
= Migrated        — MigrateTo* sudah dijalankan; jam vesting berjalan

Field yang menghadap integrator:

status — tiga nilai, monoton (Funding → Migrate → Migrated). Pembacaan selalu aman; penulisan dibatasi.
real_base, real_quote — state kurva saat ini. Dikombinasikan dengan virtual_base / virtual_quote cukup untuk menghitung harga spot tanpa menyentuh vault. Lihat bonding-curve.
total_base_sell vs real_base — rasio “kemajuan menuju kelulusan” untuk UI.
migrate_type — memilih apakah MigrateToAmm atau MigrateToCpswap adalah jalur kelulusan yang valid. Peluncuran Token-2022 harus menggunakan CPMM.
amm_creator_fee_on — hanya bermakna saat kelulusan ke CPMM. Memilih creator_fee_on = OnlyQuoteToken (0) atau BothToken (1) di pool CPMM pasca-kelulusan. Terlepas dari namanya, enum ini secara efektif juga mendorong target migrasi — BothToken dipasangkan dengan MigrateToAmm dalam praktik operasional saat ini; QuoteToken dengan MigrateToCpswap. Lihat creator-fees.
quote_protocol_fee / platform_fee / migrate_fee — tiga counter biaya independen. Masing-masing memiliki instruksi klaim sendiri; lihat instructions.
vesting_schedule — ada di setiap PoolState tetapi tidak aktif ketika total_locked_amount == 0. Lihat vesting untuk siklus hidup lengkap.

PDA authority

LaunchLab menggunakan satu PDA authority di semua peluncuran, diturunkan tanpa seed per-peluncuran:

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

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

PDA tunggal itu adalah:

Authority pada setiap base_vault dan quote_vault peluncuran.
mint_authority pada setiap base_mint peluncuran (pra-kelulusan).
Penandatangan pada CPI pasca-kelulusan ke AMM v4 / CPMM (MigrateTo*).
Penandatangan pada transfer ClaimVestedToken keluar dari base vault.

mint_authority dibatalkan segera setelah MigrateToAmm / MigrateToCpswap sehingga pasokan tetap terbatas selamanya. Dua PDA tambahan membatasi vault biaya:

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,
);

Ini menandatangani transfer keluar dari vault biaya terkait selama ClaimCreatorFee dan ClaimPlatformFeeFromVault.

Base mint

Dibuat inline oleh Initialize dengan:

mint_authority = authority (dibatalkan saat kelulusan).
freeze_authority = None.
supply = supply, seluruhnya dimint ke base_vault.
decimals dipilih oleh kreator di Initialize (biasanya 6).

Karena pasokan penuh dimint sebelumnya, base_mint.supply konstan selama peluncuran berlangsung. Pembelian kurva memindahkan token dari base_vault ke pembeli, tetapi tidak memanggil mint_to. Initialize / InitializeV2 membuat peluncuran SPL Token. Instruksi dedicated InitializeWithToken2022 memungkinkan base mint menjadi Token-2022 mint (dengan opsional TransferFeeConfig); quote mint tetap SPL Token. Peluncuran Token-2022 harus lulus ke pool CPMM karena AMM v4 hanya mendukung vault SPL Token.

Vault

Baik base_vault maupun quote_vault adalah akun SPL Token standar yang dimiliki oleh PDA LaunchLab authority. Alamat disimpan di PoolState dan juga dapat diturunkan:

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,
);

(Verifikasi awalan seed yang tepat dari struct akun Initialize sumber sebelum mengandalkan derivasi dalam produksi.)

Vault biaya

Dua PDA mengagregasi biaya di semua peluncuran:

Creator fee vault — PDA di seed [creator, quote_mint]. Setiap peluncuran yang mengumpulkan biaya kreator yang sama pada quote mint yang sama dituangkan ke vault yang sama. Kreator menyapunya melalui ClaimCreatorFee.
Platform fee vault — PDA di seed [platform_config, quote_mint]. Setiap peluncuran yang dirutekan melalui platform yang sama yang menggunakan quote mint yang sama dituangkan ke vault yang sama. platform_fee_wallet platform menyapunya melalui ClaimPlatformFeeFromVault. Ada juga varian sapuan per-peluncuran (ClaimPlatformFee) yang ditarik dari quote_vault peluncuran secara langsung tanpa melewati vault yang diagregasi.

Pola vault agregasi adalah yang memungkinkan kreator atau platform volume tinggi mengamortisasi biaya sewa akumulasi biaya di banyak peluncuran.

Quote vault ↔ `real_quote`

quote_vault.balance dan PoolState.real_quote harus tetap sinkron. Mereka dapat melenceng paling banyak jumlah tiga counter biaya tertunda (quote_protocol_fee, platform_fee, migrate_fee), yang berada di vault tetapi milik counter biaya dan bukan reserve kurva. Matematika kurva selalu menggunakan real_quote, tidak pernah saldo vault mentah. Invarian pra-kelulusan:

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

Transisi akun siklus hidup

Peristiwa	Status	`real_base`	`real_quote`	Pool pasca-kelulusan
`Initialize`	Funding	0	0	—
`BuyExactIn` / `BuyExactOut`	Funding	`+base_out`	`+quote_in_after_fee`	—
`SellExactIn` / `SellExactOut`	Funding	`−base_in`	`−quote_out_before_fee`	—
`MigrateToAmm` / `MigrateToCpswap`	Funding → Migrate → Migrated	(beku)	(beku)	dibuat, LP split per `PlatformConfig`
`ClaimCreatorFee` / `ClaimPlatformFee*`	apa saja	—	—	mengeringkan vault biaya
`CreateVestingAccount`	Funding	—	—	bump `vesting_schedule.allocated_share_amount`
`ClaimVestedToken`	Migrated saja	—	—	mengeringkan `base_vault`

Ke mana lanjut

products/launchlab/bonding-curve — matematika di balik real_base ↔ real_quote.
products/launchlab/instructions — daftar akun per-instruksi.
products/launchlab/global-config — ikatan tingkat protokol.
products/launchlab/platform-config — overlay platform.
products/launchlab/vesting — mekanik pasokan terkunci.
products/cpmm/accounts — tampilan cpmm_pool_state pasca-kelulusan.

Sumber:

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

LaunchLab

Token launch flow

Tips & Gotchas

Inventori akun

`PoolState`

PDA authority

Base mint

Vault

Vault biaya

Quote vault ↔ `real_quote`

Transisi akun siklus hidup

Ke mana lanjut

LaunchLab

Token launch flow

Tips & Gotchas

Documentation Index

​Inventori akun

​PoolState

​PDA authority

​Base mint

​Vault

​Vault biaya

​Quote vault ↔ real_quote

​Transisi akun siklus hidup

​Ke mana lanjut

Inventori akun

`PoolState`

PDA authority

Base mint

Vault

Vault biaya

Quote vault ↔ `real_quote`

Transisi akun siklus hidup

Ke mana lanjut