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 status akar untuk satu peluncuran), dua vaultnya, PDA otoritas, dan referensi pasca-kelulusan yang diperolehnya saat peluncuran diselesaikan. Untuk konfigurasi tingkat protokol yang membatasi setiap peluncuran, lihat products/launchlab/global-config. Untuk overlay per-platform, lihat products/launchlab/platform-config. Untuk akun vesting (VestingSchedule pada PoolState, VestingRecord per penerima manfaat), lihat products/launchlab/vesting.

Inventaris akun

Akun	Pemilik	Tujuan
`GlobalConfig`	Program LaunchLab	Aturan tingkat protokol: biaya, lantai pasokan, dompet migrasi. Satu per `(curve_type, index)`.
`PlatformConfig`	Program LaunchLab	Overlay per-platform: branding, biaya platform, pembagian NFT saat kelulusan, whitelist bentuk kurva.
`PoolState`	Program LaunchLab	Status akar per-peluncuran: mint, vault, parameter kurva, penghitung terjual, penghitung biaya, jadwal vesting, status kelulusan.
`authority`	Program LaunchLab	PDA tunggal pada 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 menyimpan token dasar yang tidak terjual.
`quote_vault`	SPL Token	Vault per-peluncuran yang menyimpan token kutipan yang terakumulasi.
`VestingRecord`	Program LaunchLab	Catatan cliff + unlock-linear per-penerima manfaat. Opsional.
`creator_fee_vault`	SPL Token	Vault per-kreator + per-quote-mint yang menyimpan biaya kreator yang terkumpul, disapu oleh `ClaimCreatorFee`.
`platform_fee_vault`	SPL Token	Vault per-platform + per-quote-mint yang menyimpan biaya platform yang terkumpul, disapu oleh `ClaimPlatformFeeFromVault`.
`PlatformAllowConfig`	Program LaunchLab	Izin yang dikelola platform opsional untuk satu pasangan `(PlatformConfig, GlobalConfig)`. Diperiksa hanya ketika platform mengaktifkan pembatasan.
(pasca-kelulusan) `cpmm_pool_state`	Program CPMM	Pool yang dibuat oleh `MigrateToCpswap` untuk setiap peluncuran baru. Status warisan masih dapat mereferensikan kelulusan AMM v4.
(pasca-kelulusan) Fee Key NFT	Program LP-Lock	Sebelum upgrade 2026-08-17, skala platform dan kreator dapat menghasilkan Fee Key terpisah. Migrasi yang dijalankan setelahnya menggabungkan kedua skala menjadi satu Fee Key platform.

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

`PoolState`

Status akar per-peluncuran. Nama field di bawah cocok dengan struct Rust on-chain (states/pool.rs); beberapa nilai disederhanakan untuk keterbacaan — konsultasikan 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 pembelian / penjualan; 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 tergated.
real_base, real_quote — status kurva saat ini. Dikombinasikan dengan virtual_base / virtual_quote mereka 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 — inisialisasi baru memerlukan 1 (CPSWAP). 0 yang tersimpan tetap bermakna hanya untuk peluncuran yang ada yang dibuat sebelum penegakan CPMM-only.
amm_creator_fee_on — memilih creator_fee_on = OnlyQuoteToken (0) atau BothToken (1) pada pool CPMM pasca-kelulusan. Ini tidak memilih target migrasi. Lihat creator-fees.
quote_protocol_fee / platform_fee / migrate_fee — tiga penghitung biaya independen. Masing-masing memiliki instruksi klaim sendiri; lihat instructions.
vesting_schedule — hadir di setiap PoolState tetapi tidak aktif ketika total_locked_amount == 0. Lihat vesting untuk siklus hidup lengkap.

PDA otoritas

LaunchLab menggunakan satu PDA otoritas 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:

Otoritas pada setiap base_vault dan quote_vault peluncuran.
mint_authority pada setiap base_mint peluncuran (pra-kelulusan).
Penandatangan pada CPI kelulusan CPMM, dan pada kelulusan AMM v4 warisan untuk status yang ada.
Penandatangan pada transfer ClaimVestedToken keluar dari vault dasar.

mint_authority dibatalkan segera setelah panggilan MigrateToCpswap atau MigrateToAmm warisan, sehingga pasokan tetap permanen. 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 yang sesuai selama ClaimCreatorFee dan ClaimPlatformFeeFromVault.

Mint dasar

Dibuat inline oleh Initialize dengan:

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

Karena pasokan penuh dimint sebelumnya, base_mint.supply konstan selama masa peluncuran. Pembelian kurva memindahkan token dari base_vault ke pembeli, tetapi tidak memanggil mint_to. Initialize / InitializeV2 membuat peluncuran SPL Token. Instruksi InitializeWithToken2022 khusus memungkinkan mint dasar menjadi mint Token-2022 (dengan TransferFeeConfig opsional); mint kutipan masih SPL Token. Ketiga jalur inisialisasi memerlukan kelulusan CPMM.

Vault

Baik base_vault maupun quote_vault adalah akun SPL Token standar yang dimiliki oleh PDA LaunchLab authority. Alamat disimpan pada 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 prefiks seed yang tepat dari struct akun Initialize sumber sebelum mengandalkan derivasi dalam produksi.)

Vault biaya

Dua PDA mengagregasi biaya di semua peluncuran:

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

Pola vault yang diagregasi adalah apa yang memungkinkan kreator atau platform dengan volume tinggi untuk mengamortisasi biaya sewa akumulasi biaya di banyak peluncuran.

Quote vault ↔ `real_quote`

quote_vault.balance dan PoolState.real_quote harus tetap sinkron. Mereka dapat bergeser paling banyak jumlah dari tiga penghitung biaya yang tertunda (quote_protocol_fee, platform_fee, migrate_fee), yang duduk di vault tetapi milik penghitung biaya dan bukan cadangan 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`	—
`MigrateToCpswap` (atau `MigrateToAmm` warisan)	Funding → Migrate → Migrated	(beku)	(beku)	dibuat; LP CPMM dibagi menjadi LP terkunci milik platform dan LP yang dibakar
`ClaimCreatorFee` / `ClaimPlatformFee*`	apa pun	—	—	menguras vault biaya
`CreateVestingAccount`	Funding	—	—	menaikkan `vesting_schedule.allocated_share_amount`
`ClaimVestedToken`	Migrated saja	—	—	menguras `base_vault`

Ke mana selanjutnya

products/launchlab/bonding-curve — matematika di balik real_base ↔ real_quote.
products/launchlab/instructions — daftar akun per-instruksi.
products/launchlab/global-config — pengikatan tingkat protokol.
products/launchlab/platform-config — overlay platform.
products/launchlab/vesting — mekanik pasokan terkunci.
products/cpmm/accounts — seperti apa 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 launchpad Raydium SDK v2.

LaunchLab

Token launch flow

Tips & Gotchas

Inventaris akun

`PoolState`

PDA otoritas

Mint dasar

Vault

Vault biaya

Quote vault ↔ `real_quote`

Transisi akun siklus hidup

Ke mana selanjutnya

​Inventaris akun

​PoolState

​PDA otoritas

​Mint dasar

​Vault

​Vault biaya

​Quote vault ↔ real_quote

​Transisi akun siklus hidup

​Ke mana selanjutnya

Inventaris akun

`PoolState`

PDA otoritas

Mint dasar

Vault

Vault biaya

Quote vault ↔ `real_quote`

Transisi akun siklus hidup

Ke mana selanjutnya