Hướng dẫn lệnh LaunchLab

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

Danh sách lệnh

• BothToken → MigrateToAmm → nhóm AMM v4 (phí người tạo có thể được thu từ cả hai phía; AMM v4 không có trường phí người tạo gốc, vì vậy phí người tạo được lấy thông qua cơ chế khóa LP NFT thay thế).
• QuoteToken → MigrateToCpswap → nhóm CPMM với creator_fee_on = OnlyQuoteToken (người tạo tiếp tục kiếm phí từ nhóm CPMM thông qua LaunchLab Fee Key NFT — xem products/launchlab/creator-fees).

​

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 inline; chương trình CPI sang 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 thực thi ≥ 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 khởi tạo với status = Active, base_sold = 0, quote_reserve_real = 0.
• quote_reserve_target được tính toán 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. Giải quyết Newton đường cong cho base_out dựa trên quote sau phí.
3. require(base_out ≥ minimum_base_out) nếu không quay lại ExceededSlippage.
4. Di chuyển quote_in người dùng → kho. Di chuyển base_out kho → 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 bản cập nhật, SDK thường chuỗi 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 — cần một Graduate tiếp theo.

​

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 xuống 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 quay lại 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 quay lại với MigrateTypeNotMatch.
3. Tính toán dự trữ sau khi 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 mục tiêu (AMM v4 Initialize2 hoặc CPMM InitializeWithPermission) với những dự trữ đó để tạo nhóm sau khi tốt nghiệp.
5. Chia LP kết quả theo PlatformConfig.{platform_scale, creator_scale, burn_scale} liên kết (chỉ CPMM) — một phần được đúc thành platform_nft_wallet, một phần thành NFT người tạo được bao bọc bởi chương trình LP-Lock, một phần được đốt qua Burn & Earn. Đối với tốt nghiệp AMM v4, quy định LP được quản lý bởi các tham số khởi tạo của AMM v4.
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.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Hướng dẫn thực thi và cấu hình nền tảng

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, UpdatePlatformCurveParam, RemovePlatformCurveParam, CreatePlatformGlobalAccess, ClosePlatformGlobalAccess
• 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.

• Raydium SDK v2 LaunchLab module
• Mã nguồn chương trình Raydium LaunchLab