Tài khoản LaunchLab

Trang này được dịch tự động bằng AI. Phiên bản tiếng Anh là bản chính thức.Xem bản tiếng Anh →

Trang này tài liệu hóa đồ thị tài khoản cho mỗi lần phát hành: PoolState (tài khoản trạng thái gốc cho một lần phát hành), hai vault của nó, PDA quyền hạn, và các tham chiếu sau khi phát hành mà nó nhận được khi lần phát hành được giải quyết.Để xem cấu hình cấp giao thức ràng buộc mọi lần phát hành, xem products/launchlab/global-config. Để xem lớp phủ cho mỗi nền tảng, xem products/launchlab/platform-config. Để xem tài khoản vesting (VestingSchedule trên PoolState, VestingRecord cho mỗi người thụ hưởng), xem products/launchlab/vesting.

Danh sách tài khoản

Tài khoản	Chủ sở hữu	Mục đích
`GlobalConfig`	Chương trình LaunchLab	Quy tắc cấp giao thức: phí, sàn cung cấp, ví di chuyển. Một cho mỗi `(curve_type, index)`.
`PlatformConfig`	Chương trình LaunchLab	Lớp phủ cho mỗi nền tảng: thương hiệu, phí nền tảng, chia NFT khi phát hành, danh sách trắng hình dạng đường cong.
`PoolState`	Chương trình LaunchLab	Trạng thái gốc cho mỗi lần phát hành: mint, vault, tham số đường cong, bộ đếm đã bán, bộ đếm phí, lịch vesting, trạng thái phát hành.
`authority`	Chương trình LaunchLab	PDA duy nhất ở seed `[b"vault_auth_seed"]` sở hữu vault trên tất cả các lần phát hành và ký CPI sau khi phát hành.
`base_vault`	SPL Token / Token-2022	Vault cho mỗi lần phát hành giữ các token cơ sở chưa bán.
`quote_vault`	SPL Token	Vault cho mỗi lần phát hành giữ các token trích dẫn tích lũy.
`VestingRecord`	Chương trình LaunchLab	Bản ghi cliff + mở khóa tuyến tính cho mỗi người thụ hưởng. Tùy chọn.
`creator_fee_vault`	SPL Token	Vault cho mỗi người tạo + cho mỗi quote-mint giữ phí người tạo tích lũy, được quét bởi `ClaimCreatorFee`.
`platform_fee_vault`	SPL Token	Vault cho mỗi nền tảng + cho mỗi quote-mint giữ phí nền tảng tích lũy, được quét bởi `ClaimPlatformFeeFromVault`.
`PlatformAllowConfig`	Chương trình LaunchLab	Quyền được quản lý bởi nền tảng tùy chọn cho một cặp `(PlatformConfig, GlobalConfig)`. Chỉ được kiểm tra khi nền tảng bật hạn chế.
(sau khi phát hành) `cpmm_pool_state`	Chương trình CPMM	Pool được tạo bởi `MigrateToCpswap` cho mỗi lần phát hành mới. Trạng thái cũ vẫn có thể tham chiếu đến phát hành AMM v4.
(sau khi phát hành) Fee Key NFT	Chương trình LP-Lock	Trước bản nâng cấp 2026-08-17, các thang đo nền tảng và người tạo có thể tạo ra các Fee Key riêng biệt. Các lần di chuyển được thực hiện sau đó kết hợp cả hai thang đo thành một Fee Key nền tảng.

SDK của bạn raydium.launchpad.getLaunchById trả về PoolState cộng với một cờ cho biết liệu lần phát hành đã phát hành hay chưa; nếu có, ID pool sau khi di chuyển được bao gồm.

`PoolState`

Trạng thái gốc cho mỗi lần phát hành. Tên trường dưới đây khớp với struct Rust trên chuỗi (states/pool.rs); một số giá trị được đơn giản hóa để dễ đọc — tham khảo nguồn để biết bố cục bộ nhớ chính xác.

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

Các giá trị PoolStatus (từ Anchor IDL):

= Funding         — chấp nhận mua / bán; dưới quote_reserve_target
= Migrate         — quote_reserve_target đạt được; chờ MigrateTo*
= Migrated        — MigrateTo* đã được thực hiện; đồng hồ vesting chạy

Các trường hướng đến người tích hợp:

status — ba giá trị, đơn điệu (Funding → Migrate → Migrated). Đọc luôn an toàn; ghi bị gated.
real_base, real_quote — trạng thái đường cong hiện tại. Kết hợp với virtual_base / virtual_quote chúng đủ để tính giá spot mà không cần chạm vào vault. Xem bonding-curve.
total_base_sell so với real_base — tỷ lệ “tiến độ hướng tới phát hành” cho UI.
migrate_type — khởi tạo mới yêu cầu 1 (CPSWAP). Một 0 được lưu trữ vẫn có ý nghĩa chỉ cho một lần phát hành hiện có được tạo trước khi thực thi CPMM-only.
amm_creator_fee_on — chọn creator_fee_on = OnlyQuoteToken (0) hoặc BothToken (1) trên pool CPMM sau khi phát hành. Nó không chọn mục tiêu di chuyển. Xem creator-fees.
quote_protocol_fee / platform_fee / migrate_fee — ba bộ đếm phí độc lập. Mỗi cái có hướng dẫn yêu cầu riêng của nó; xem instructions.
vesting_schedule — hiện diện trên mọi PoolState nhưng không hoạt động khi total_locked_amount == 0. Xem vesting để biết vòng đời đầy đủ.

PDA quyền hạn

LaunchLab sử dụng một PDA quyền hạn duy nhất trên tất cả các lần phát hành, được lấy mà không có seed cho mỗi lần phát hành:

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 duy nhất đó là:

Quyền hạn trên base_vault và quote_vault của mỗi lần phát hành.
mint_authority trên base_mint của mỗi lần phát hành (trước khi phát hành).
Người ký trên CPI phát hành CPMM, và trên phát hành AMM v4 cũ cho trạng thái hiện có.
Người ký trên các chuyển ClaimVestedToken ra khỏi vault cơ sở.

mint_authority bị thu hồi ngay sau khi gọi MigrateToCpswap hoặc MigrateToAmm cũ, vì vậy cung cấp được cố định vĩnh viễn. Hai PDA bổ sung gated các vault phí:

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

Những cái này ký chuyển ra khỏi vault phí tương ứng trong ClaimCreatorFee và ClaimPlatformFeeFromVault.

Mint cơ sở

Được tạo nội tuyến bởi Initialize với:

mint_authority = authority (thu hồi khi phát hành).
freeze_authority = None.
supply = supply, hoàn toàn được mint vào base_vault.
decimals được chọn bởi người tạo tại Initialize (thường là 6).

Vì toàn bộ cung cấp được pre-mint, base_mint.supply là hằng số trong suốt vòng đời của lần phát hành. Các lần mua đường cong di chuyển token từ base_vault đến người mua, nhưng không gọi mint_to. Initialize / InitializeV2 tạo các lần phát hành SPL Token. Hướng dẫn InitializeWithToken2022 chuyên dụng cho phép mint cơ sở là mint Token-2022 (với TransferFeeConfig tùy chọn); mint trích dẫn vẫn là SPL Token. Cả ba đường dẫn khởi tạo đều yêu cầu phát hành CPMM.

Vault

Cả base_vault và quote_vault đều là các tài khoản SPL Token tiêu chuẩn được sở hữu bởi PDA authority LaunchLab. Các địa chỉ được lưu trữ trên PoolState và cũng có thể được lấy:

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

(Xác minh các tiền tố seed chính xác từ struct tài khoản Initialize của nguồn trước khi dựa vào một lần lấy trong sản xuất.)

Vault phí

Hai PDA tổng hợp phí trên các lần phát hành:

Vault phí người tạo — PDA ở seed [creator, quote_mint]. Mỗi lần phát hành kiếm được phí người tạo giống nhau trên cùng một quote mint đổ vào cùng một vault. Người tạo quét nó qua ClaimCreatorFee.
Vault phí nền tảng — PDA ở seed [platform_config, quote_mint]. Mỗi lần phát hành được định tuyến qua cùng một nền tảng sử dụng cùng một quote mint đổ vào cùng một vault. platform_fee_wallet của nền tảng quét nó qua ClaimPlatformFeeFromVault. Cũng có một biến thể quét cho mỗi lần phát hành (ClaimPlatformFee) kéo từ quote_vault của lần phát hành trực tiếp mà không đi qua vault tổng hợp.

Mô hình vault tổng hợp là những gì cho phép một người tạo hoặc nền tảng có khối lượng cao khấu hao chi phí thuê của việc tích lũy phí trên nhiều lần phát hành.

Quote vault ↔ `real_quote`

quote_vault.balance và PoolState.real_quote nên giữ đồng bộ. Chúng có thể trôi dạt tối đa là tổng của ba bộ đếm phí đang chờ xử lý (quote_protocol_fee, platform_fee, migrate_fee), nằm trong vault nhưng thuộc về các bộ đếm phí chứ không phải dự trữ đường cong. Toán học đường cong luôn sử dụng real_quote, không bao giờ là số dư vault thô. Bất biến trước khi phát hành:

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

Chuyển đổi tài khoản vòng đời

Sự kiện	Trạng thái	`real_base`	`real_quote`	Pool sau khi phát hành
`Initialize`	Funding	0	0	—
`BuyExactIn` / `BuyExactOut`	Funding	`+base_out`	`+quote_in_after_fee`	—
`SellExactIn` / `SellExactOut`	Funding	`−base_in`	`−quote_out_before_fee`	—
`MigrateToCpswap` (hoặc `MigrateToAmm` cũ)	Funding → Migrate → Migrated	(đóng băng)	(đóng băng)	được tạo; LP CPMM được chia thành LP bị khóa do nền tảng sở hữu và LP bị đốt
`ClaimCreatorFee` / `ClaimPlatformFee*`	bất kỳ	—	—	drains a fee vault
`CreateVestingAccount`	Funding	—	—	bumps `vesting_schedule.allocated_share_amount`
`ClaimVestedToken`	Migrated only	—	—	drains `base_vault`

Tiếp theo đi đâu

products/launchlab/bonding-curve — toán học đằng sau real_base ↔ real_quote.
products/launchlab/instructions — danh sách tài khoản cho mỗi hướng dẫn.
products/launchlab/global-config — ràng buộc cấp giao thức.
products/launchlab/platform-config — lớp phủ nền tảng.
products/launchlab/vesting — cơ chế cung cấp bị khóa.
products/cpmm/accounts — cpmm_pool_state sau khi phát hành trông như thế nào.

Nguồn:

raydium-launch/programs/launchpad/src/states/pool.rs — PoolState, PoolStatus, VestingSchedule, AmmCreatorFeeOn.
raydium-launch/programs/launchpad/src/lib.rs — hằng số seed PDA (AUTH_SEED, CREATOR_FEE_VAULT_AUTH_SEED, PLATFORM_FEE_VAULT_AUTH_SEED).
Mô-đun launchpad SDK Raydium v2.

LaunchLab

Token launch flow

Tips & Gotchas

Danh sách tài khoản

`PoolState`

PDA quyền hạn

Mint cơ sở

Vault

Vault phí

Quote vault ↔ `real_quote`

Chuyển đổi tài khoản vòng đời

Tiếp theo đi đâu

​Danh sách tài khoản

​PoolState

​PDA quyền hạn

​Mint cơ sở

​Vault

​Vault phí

​Quote vault ↔ real_quote

​Chuyển đổi tài khoản vòng đời

​Tiếp theo đi đâu

Danh sách tài khoản

`PoolState`

PDA quyền hạn

Mint cơ sở

Vault

Vault phí

Quote vault ↔ `real_quote`

Chuyển đổi tài khoản vòng đời

Tiếp theo đi đâu