Akun LaunchLab

PoolState (akar per-peluncuran), vault dasar dan kutipan, PDA otoritas, dan grafik akun per-peluncuran. GlobalConfig tingkat protokol dan PlatformConfig tingkat platform tersedia di halaman terpisah.

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, pemisahan NFT saat kelulusan, saklar parameter peluncuran dan manajer aturan. Tetap 944 byte.
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 / Token-2022	Vault per-peluncuran yang menyimpan token kutipan yang terakumulasi. Mengikuti program mana pun yang memiliki mint kutipan.
VestingRecord	Program LaunchLab	Catatan cliff + linear-unlock per-penerima manfaat. Opsional.
creator_fee_vault	SPL Token / Token-2022	Vault per-kreator + per-mint-kutipan yang menyimpan biaya kreator yang terkumpul, disapu oleh ClaimCreatorFee. Mengikuti program mint kutipan.
platform_fee_vault	SPL Token / Token-2022	Vault per-platform + per-mint-kutipan yang menyimpan biaya platform yang terkumpul, disapu oleh ClaimPlatformFeeFromVault. Mengikuti program mint kutipan.
PlatformAllowConfig	Program LaunchLab	Izin yang dikelola platform opsional untuk satu pasangan (PlatformConfig, GlobalConfig). Diperiksa hanya ketika platform mengaktifkan pembatasan.
PlatformCurveRule	Program LaunchLab	Aturan parameter peluncuran yang dikelola platform opsional untuk satu pasangan (PlatformConfig, GlobalConfig). Ukuran variabel, 150 byte kosong.
(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,         // bit0 = base mint, bit1 = quote mint; 0 = SPL Token, 1 = 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):

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

Field yang menghadap integrator:

• status — tiga nilai, monoton (Funding → Migrate → Migrated). Pembacaan selalu aman; penulisan terbatas.
• 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.
• token_program_flag — bidang bit, bukan boolean. Bit0 adalah mint dasar dan bit1 adalah mint kutipan, masing-masing 0 untuk SPL Token dan 1 untuk Token-2022, jadi byte mengambil empat nilai: 0 (keduanya warisan), 1 (Token-2022 dasar), 2 (Token-2022 kutipan), 3 (keduanya Token-2022). Baca satu mint dengan (token_program_flag >> bit) & 1. Membandingkan seluruh byte terhadap 0 untuk mengklasifikasikan mint dasar menyelesaikan 2 ke program yang salah. Bit1 konstan 0 sampai mint kutipan Token-2022 didukung.
• quote_protocol_fee / platform_fee / migrate_fee — tiga penghitung biaya independen. Masing-masing memiliki instruksi klaim sendiri; lihat instructions.
• vesting_schedule — hadir pada 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>"); // see reference/program-addresses

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

PDA tunggal itu adalah:

• Otoritas pada base_vault dan quote_vault setiap peluncuran.
• mint_authority pada base_mint setiap 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.
• transfer_fee_config_authority pada TransferFeeConfig mint dasar Token-2022, untuk seluruh fase pra-kelulusan — dan withdraw_withheld_authority-nya juga, tetapi hanya ketika platform meninggalkan PlatformConfig.transfer_fee_extension_auth tidak diatur.

mint_authority dicabut segera setelah panggilan MigrateToCpswap atau MigrateToAmm warisan, jadi pasokan secara permanen tetap.

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 (dicabut saat kelulusan).
• freeze_authority = None.
• supply = supply, sepenuhnya dimint ke base_vault.
• decimals dipilih oleh kreator di Initialize (biasanya 6).

Karena pasokan penuh dimint sebelumnya, base_mint.supply konstan untuk kehidupan peluncuran. Pembelian kurva memindahkan token dari base_vault ke pembeli, tetapi tidak memanggil mint_to.

Initialize / InitializeV2 membuat mint dasar SPL Token. Instruksi InitializeWithToken2022 khusus memungkinkan mint dasar menjadi mint Token-2022 (dengan TransferFeeConfig opsional). Ketiga jalur inisialisasi memerlukan kelulusan CPMM.

Ketika InitializeWithToken2022 melampirkan TransferFeeConfig, mint dibuat dengan transfer_fee_config_authority = authority dan withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth, kembali ke authority ketika platform belum menetapkan field itu. Kedua otoritas ditugaskan kembali ke kunci platform saat kelulusan, sisi tarik hanya jika PDA masih memegangnya. Lihat platform-config.

Mint kutipan independen dari mint dasar dan mungkin sendiri adalah mint Token-2022 — InitializeV2 dan InitializeWithToken2022 menerima program mana pun di slot program kutipan mereka. Initialize yang sudah usang tidak: akun program-kutipan mereka masih diketik ke SPL Token, jadi konfigurasi yang mint kutipannya adalah Token-2022 hanya dapat diluncurkan melalui dua yang lain. Mint kutipan tidak pernah dibuat oleh LaunchLab; itu adalah apa pun yang dinamai GlobalConfig.quote_mint. Lihat global-config dan reference/token-2022-support.

​

Vault

Baik base_vault maupun quote_vault adalah akun token yang dimiliki oleh PDA LaunchLab authority, masing-masing dibuat pada program yang memiliki mintnya sendiri — jadi peluncuran dapat memiliki vault dasar warisan dan vault kutipan Token-2022, atau kombinasi lainnya. token_program_flag mencatat mana yang mana. 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 awalan 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.

Keduanya dibuat dengan malas pada swap pertama yang mengumpulkan biaya, pada program mana pun yang memiliki mint kutipan. Kreator atau platform yang menjalankan peluncuran terhadap mint kutipan warisan dan Token-2022 berakhir dengan satu vault per mint, seperti yang sudah dilakukan untuk dua mint warisan yang berbeda.

Pola vault yang diagregasi adalah apa yang memungkinkan kreator atau platform 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

​

PlatformCurveRule

Satu akun per pasangan (PlatformConfig, GlobalConfig), menyimpan bentuk peluncuran yang diizinkan platform pada konfigurasi itu. Seed PDA adalah [b"platform_curve_rule", platform_config, global_config].

#[account]
pub struct PlatformCurveRule {
    pub bump:            u8,
    pub version:         u8,
    pub platform_config: Pubkey,
    pub global_config:   Pubkey,
    pub epoch:           u64,
    pub padding:         [u64; 8],
    pub groups:          Vec<CurveRuleGroup>,   // up to 10
}

pub struct CurveRuleGroup {
    pub group_id:    u16,                       // stable id, used to update or remove the group
    pub epoch:       u64,
    pub constraints: Vec<ParamConstraint>,      // up to 25, ANDed
}

pub struct ParamConstraint {
    pub field: u8,                              // which launch parameter
    pub op:    u8,                              // 0 Eq, 1 Gte, 2 Lte, 3 Neq
    pub value: u128,
}

Akun dibuat tanpa grup dan diubah ukurannya pada setiap perubahan grup, jadi panjangnya adalah 150 + Σ(14 + 18 × constraints) dan decoder tidak boleh menganggap ukuran tetap. Grup adalah OR: peluncuran diizinkan segera setelah kendala satu grup semuanya berlaku. Nol grup berarti tidak ada pembatasan.

Bacanya hanya ketika PlatformConfig.restrict_curve_param pemilik adalah 1 — pada 0 program mengabaikan akun, dan aturan basi mungkin duduk di sana. ID field, operator, dan playbook ada di products/launchlab/curve-rules.

​

Transisi akun siklus hidup

Acara	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 terbakar
ClaimCreatorFee / ClaimPlatformFee*	apa pun	—	—	menguras vault biaya
CreateVestingAccount	Funding	—	—	menaikkan vesting_schedule.allocated_share_amount
ClaimVestedToken	Migrated only	—	—	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.