LaunchLab 帳戶

本頁內容由 AI 自動翻譯，所有內容以英文版本為準。查看英文版 →

本頁記錄了每次發行的帳戶圖表：PoolState（一次發行的根狀態帳戶）、其兩個金庫、授權 PDA，以及發行結算時獲得的畢業後參考。有關約束每次發行的協議級設定，請參閱 products/launchlab/global-config。有關每個平台的疊加層，請參閱 products/launchlab/platform-config。有關歸屬帳戶（PoolState 上的 VestingSchedule、每個受益人的 VestingRecord），請參閱 products/launchlab/vesting。

帳戶清單

帳戶	擁有者	用途
`GlobalConfig`	LaunchLab 程式	協議級規則：費用、供應下限、遷移錢包。每個 `(curve_type, index)` 一個。
`PlatformConfig`	LaunchLab 程式	每個平台的疊加層：品牌、平台費用、畢業時的 NFT 分割、曲線形狀白名單。
`PoolState`	LaunchLab 程式	每次發行的根狀態：鑄幣、金庫、曲線參數、銷售計數器、費用計數器、歸屬時間表、畢業狀態。
`authority`	LaunchLab 程式	單一 PDA，種子為 `[b"vault_auth_seed"]`，擁有所有發行的金庫並簽署畢業後 CPI。
`base_vault`	SPL Token / Token-2022	每次發行的金庫，持有未售出的基礎代幣。
`quote_vault`	SPL Token	每次發行的金庫，持有累積的報價代幣。
`VestingRecord`	LaunchLab 程式	每個受益人的懸崖 + 線性解鎖記錄。可選。
`creator_fee_vault`	SPL Token	每個創作者 + 每個報價鑄幣的金庫，持有應計創作者費用，由 `ClaimCreatorFee` 清掃。
`platform_fee_vault`	SPL Token	每個平台 + 每個報價鑄幣的金庫，持有應計平台費用，由 `ClaimPlatformFeeFromVault` 清掃。
`PlatformAllowConfig`	LaunchLab 程式	可選的平台管理權限，用於一個 `(PlatformConfig, GlobalConfig)` 對。僅在平台啟用限制時檢查。
（畢業後）`cpmm_pool_state`	CPMM 程式	由 `MigrateToCpswap` 為每次新發行建立的池。舊版狀態仍可參考 AMM v4 畢業。
（畢業後）Fee Key NFT	LP-Lock 程式	在 2026-08-17 升級之前，平台和創作者規模可能產生單獨的 Fee Key。之後執行的遷移將兩個規模合併為一個平台 Fee Key。

SDK 的 raydium.launchpad.getLaunchById 返回 PoolState 加上一個標誌，指示發行是否已畢業；如果已畢業，則包含遷移後的池 ID。

`PoolState`

每次發行的根狀態。下面的欄位名稱與鏈上 Rust 結構（states/pool.rs）相符；為了可讀性，某些值已簡化——請查閱源代碼以了解確切的記憶體佈局。

// 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
}

PoolStatus 值（來自 Anchor IDL）：

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

面向整合者的欄位：

status — 三個值，單調遞增（Funding → Migrate → Migrated）。讀取始終安全；寫入受限。
real_base、real_quote — 當前曲線狀態。結合 virtual_base / virtual_quote，它們足以計算現貨價格，無需接觸金庫。請參閱 bonding-curve。
total_base_sell vs real_base — UI 的「畢業進度」比率。
migrate_type — 新初始化需要 1（CPSWAP）。存儲的 0 僅對在強制執行 CPMM 之前建立的現有發行有意義。
amm_creator_fee_on — 在畢業後 CPMM 池上選擇 creator_fee_on = OnlyQuoteToken（0）或 BothToken（1）。它不選擇遷移目標。請參閱 creator-fees。
quote_protocol_fee / platform_fee / migrate_fee — 三個獨立的費用計數器。每個都有自己的領取指令；請參閱 instructions。
vesting_schedule — 存在於每個 PoolState 上，但當 total_locked_amount == 0 時不活躍。請參閱 vesting 了解完整的生命週期。

授權 PDA

LaunchLab 在所有發行中使用單一授權 PDA，無每次發行的種子：

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 是：

每次發行的 base_vault 和 quote_vault 上的授權。
每次發行的 base_mint 上的 mint_authority（畢業前）。
CPMM 畢業 CPI 上的簽署者，以及現有狀態的舊版 AMM v4 畢業。
ClaimVestedToken 轉帳出基礎金庫的簽署者。

mint_authority 在 MigrateToCpswap 或舊版 MigrateToAmm 呼叫後立即被撤銷，因此供應永久固定。兩個額外的 PDA 控制費用金庫：

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

這些在 ClaimCreatorFee 和 ClaimPlatformFeeFromVault 期間簽署相應費用金庫的轉帳。

基礎鑄幣

由 Initialize 內聯建立，具有：

mint_authority = authority（在畢業時撤銷）。
freeze_authority = None。
supply = supply，完全鑄造到 base_vault。
decimals 由創作者在 Initialize 時選擇（通常為 6）。

由於完整供應是預先鑄造的，base_mint.supply 在發行的整個生命週期內是常數。曲線購買將代幣從 base_vault 移動到買方，但不呼叫 mint_to。 Initialize / InitializeV2 建立 SPL Token 發行。專用的 InitializeWithToken2022 指令允許基礎鑄幣是 Token-2022 鑄幣（具有可選的 TransferFeeConfig）；報價鑄幣仍然是 SPL Token。所有三個初始化路徑都需要 CPMM 畢業。

金庫

base_vault 和 quote_vault 都是由 LaunchLab authority PDA 擁有的標準 SPL Token 帳戶。地址存儲在 PoolState 上，也可以派生：

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

（在生產中依賴派生之前，請從源的 Initialize 帳戶結構驗證確切的種子前綴。）

費用金庫

兩個 PDA 在發行中聚合費用：

創作者費用金庫 — PDA，種子為 [creator, quote_mint]。每次在同一報價鑄幣上賺取相同創作者費用的發行都流入同一金庫。創作者通過 ClaimCreatorFee 清掃它。
平台費用金庫 — PDA，種子為 [platform_config, quote_mint]。通過同一平台路由且使用同一報價鑄幣的每次發行都流入同一金庫。平台的 platform_fee_wallet 通過 ClaimPlatformFeeFromVault 清掃它。還有一個每次發行的清掃變體（ClaimPlatformFee），它直接從發行的 quote_vault 提取，無需通過聚合金庫。

聚合金庫模式允許高交易量的創作者或平台在許多發行中攤銷費用累積的租金成本。

Quote vault ↔ `real_quote`

quote_vault.balance 和 PoolState.real_quote 應保持同步。它們最多可以漂移三個待處理費用計數器（quote_protocol_fee、platform_fee、migrate_fee）的總和，這些計數器位於金庫中但屬於費用計數器而不是曲線儲備。曲線數學始終使用 real_quote，從不使用原始金庫餘額。畢業前不變量：

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

生命週期帳戶轉換

事件	狀態	`real_base`	`real_quote`	畢業後池
`Initialize`	Funding	0	0	—
`BuyExactIn` / `BuyExactOut`	Funding	`+base_out`	`+quote_in_after_fee`	—
`SellExactIn` / `SellExactOut`	Funding	`−base_in`	`−quote_out_before_fee`	—
`MigrateToCpswap`（或舊版 `MigrateToAmm`）	Funding → Migrate → Migrated	（凍結）	（凍結）	已建立；CPMM LP 分割為平台擁有的鎖定 LP 和燒毀 LP
`ClaimCreatorFee` / `ClaimPlatformFee*`	任何	—	—	清掃費用金庫
`CreateVestingAccount`	Funding	—	—	碰撞 `vesting_schedule.allocated_share_amount`
`ClaimVestedToken`	僅限 Migrated	—	—	清掃 `base_vault`

接下來去哪裡

products/launchlab/bonding-curve — real_base ↔ real_quote 背後的數學。
products/launchlab/instructions — 每個指令的帳戶列表。
products/launchlab/global-config — 協議級綁定。
products/launchlab/platform-config — 平台疊加層。
products/launchlab/vesting — 鎖定供應機制。
products/cpmm/accounts — 畢業後 cpmm_pool_state 的樣子。

來源：

raydium-launch/programs/launchpad/src/states/pool.rs — PoolState、PoolStatus、VestingSchedule、AmmCreatorFeeOn。
raydium-launch/programs/launchpad/src/lib.rs — PDA 種子常數（AUTH_SEED、CREATOR_FEE_VAULT_AUTH_SEED、PLATFORM_FEE_VAULT_AUTH_SEED）。
Raydium SDK v2 launchpad 模組。

LaunchLab

代幣發行流程

Tips & Gotchas

帳戶清單

`PoolState`

授權 PDA

基礎鑄幣

金庫

費用金庫

Quote vault ↔ `real_quote`

生命週期帳戶轉換

接下來去哪裡

​帳戶清單

​PoolState

​授權 PDA

​基礎鑄幣

​金庫

​費用金庫

​Quote vault ↔ real_quote

​生命週期帳戶轉換

​接下來去哪裡

帳戶清單

`PoolState`

授權 PDA

基礎鑄幣

金庫

費用金庫

Quote vault ↔ `real_quote`

生命週期帳戶轉換

接下來去哪裡