Hướng dẫn LaunchLab

​

Danh sách lệnh

​

Initialize

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // hoặc initial_virtual_quote_reserve cho curve_type=1
    open_time:                  u64,
    quote_mint:                 Pubkey,
    base_token_metadata: {                         // tên/ký hiệu/uri nội tuyến; chương trình CPI tới Metaplex
        name:   String,
        symbol: String,
        uri:    String,
    },
    fees: {
        buy_numerator:   u64,
        buy_denominator: u64,
        sell_numerator:  u64,
        sell_denominator: u64,
        lp_share:        u64,
        creator_share:   u64,
        protocol_share:  u64,
        total_share:     u64,
    },
    post_graduation_lp_policy:  u8,                // 0 = Burn, 1 = Lock, 2 = ToCreator
}

• quote_mint ∈ launch_config.allowed_quote_mints.
• base_supply_graduation ≤ base_supply_max.
• Các tham số phí vượt qua kiểm tra launch_config.max_*_fee_rate.
• open_time ≥ now − slop (SDK áp dụng ≥ now; chương trình chấp nhận backdating nhẹ).
• curve_type được công nhận.

• base_mint có supply = base_supply_max, tất cả trong base_vault.
• base_mint.mint_authority = launch_authority, freeze_authority = None.
• LaunchState được khởi tạo với status = Active, base_sold = 0, quote_reserve_real = 0.
• quote_reserve_target được tính từ các tham số đường cong + base_supply_graduation + buy_numerator (xấp xỉ).

​

Buy (biến chính tắc: BuyExactIn)

quote_in:          u64
minimum_base_out:  u64

• launch_state.status == Active.
• now ≥ open_time.
• user_quote_ata.balance ≥ quote_in.
• quote_in > 0.

1. Chia quote_in thành quote_in_after_fee và các phần phí.
2. Newton-giải đường cong cho base_out được cung cấp bởi post-fee quote.
3. require(base_out ≥ minimum_base_out) nếu không hoàn nguyên ExceededSlippage.
4. Di chuyển quote_in người dùng → vault. Di chuyển base_out vault → người dùng.
5. Cập nhật base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share).
6. Cập nhật bộ đếm phí (protocol_fees_quote, creator_fees_quote).
7. state_data.num_buys += 1.
8. Nếu quote_reserve_real ≥ quote_reserve_target sau khi cập nhật, SDK thường xuyên chuỗi một lệnh Graduate trong cùng một giao dịch. Chương trình không tự động tốt nghiệp bên trong Buy — một Graduate tiếp theo là bắt buộc.

​

BuyExactOut

base_out:      u64
maximum_quote_in: u64

​

Sell / SellExactIn / SellExactOut

• user_base_ata.balance ≥ base_in.
• Bán không thể đẩy base_sold dưới 0 (dư thừa với điều trên vì kế toán nhất quán).
• Khởi chạy là Active.

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — migrate_to_amm_wallet được ghi lại trên GlobalConfig liên kết.
• MigrateToCpswap — migrate_to_cpswap_wallet được ghi lại trên GlobalConfig liên kết.

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. Xác minh pool_state.status == Migrate (tức là quote_reserve_target đã được đạt). Nếu không hoàn nguyên với PoolMigrated (trạng thái đã là Migrated) hoặc PoolFunding (vẫn đang tài trợ).
2. Xác minh pool_state.migrate_type khớp với lệnh (0 cho AMM, 1 cho CPMM). Nếu không hoàn nguyên với MigrateTypeNotMatch.
3. Tính toán các dự trữ sau tốt nghiệp:
   • base_amount_out = base_vault.amount − vesting_schedule.total_locked_amount
   • quote_amount_out = quote_vault.amount − quote_protocol_fee − migrate_fee − platform_fee
4. CPI vào chương trình đích (AMM v4 Initialize2 hoặc CPMM InitializeWithPermission) với các dự trữ đó để tạo pool sau tốt nghiệp.
5. Đối với các di chuyển CPMM được thực hiện sau nâng cấp 2026-08-17, kết hợp platform_scale + creator_scale thành một cổ phần LP bị khóa do nền tảng sở hữu và tạo ra nhiều nhất một NFT Fee Key cho platform_nft_wallet. Đốt phần còn lại burn_scale. Trước nâng cấp, creator_scale bị khóa riêng biệt và Fee Key của nó đã được gửi tới người tạo token. Các di chuyển lịch sử đã hoàn thành không được sửa đổi. Đối với tốt nghiệp AMM v4 kế thừa, việc xử lý LP tuân theo luồng hiện có của lệnh đó.
6. Thu hồi base_mint.mint_authority (đặt thành None).
7. Lật pool_state.status = Migrated, đặt vesting_schedule.start_time = block_time + cliff_period.

​

Các tài khoản còn lại của di chuyển CPMM

​

Danh sách cho phép GlobalConfig nền tảng

• 0: nền tảng chấp nhận bất kỳ GlobalConfig nào hợp lệ; không cần tài khoản cho phép.
• 1: Initialize, InitializeV2 và InitializeWithToken2022 phải bao gồm PlatformAllowConfig phù hợp ở bất kỳ đâu trong remaining_accounts.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Các lệnh vesting và cấu hình nền tảng

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, UpdatePlatformCurveParam, RemovePlatformCurveParam, CreatePlatformAllowConfig, ClosePlatformAllowConfig
• CreateConfig, UpdateConfig

​

Ma trận thay đổi trạng thái

​

Tiếp theo đi đâu

• products/launchlab/code-demos — Ví dụ TypeScript cho mỗi lệnh.
• products/launchlab/accounts — hình dạng trạng thái đầy đủ.
• reference/error-codes — Enum lỗi LaunchLab.

• Mô-đun Raydium SDK v2 LaunchLab
• Nguồn chương trình Raydium LaunchLab