Quy tắc đường cong LaunchLab

​

Mô hình tư duy

GlobalConfig       sàn giao thức      "supply >= 10M, sell rate >= 20%, ..."
  └─ PlatformCurveRule   quy tắc của bạn     "và trên nền tảng của tôi: một trong những hình dạng này"
       └─ check group    một hình dạng     "supply = 1B AND fund raising in [80, 90] SOL"
            └─ constraint một kiểm tra    "(Supply, Eq, 1_000_000_000)"

• Các ràng buộc bên trong một nhóm được AND lại với nhau. Tất cả chúng phải giữ.
• Các nhóm bên trong một quy tắc được OR lại với nhau. Một lần khởi chạy được phép ngay khi nó thỏa mãn bất kỳ nhóm nào.

​

Ràng buộc

pub struct ParamConstraint {
    pub field: u8,    // tham số khởi chạy nào, xem bảng dưới đây
    pub op:    u8,    // 0 Eq, 1 Gte (min), 2 Lte (max), 3 Neq
    pub value: u128,
}

​

Trường

​

Chín kịch bản

​

1. Một tầng tiêu chuẩn

​

2. Một dải thay vì một số

​

3. Các tầng cạnh nhau

​

4. Một dải định giá tốt nghiệp

​

5. Một sàn di chuyển

​

6. Vesting mà bạn thực sự thực thi

​

7. Gating loại token

​

8. Một giới hạn phí chuyển có điều kiện

​

9. Một chương trình khuyến mãi có thời hạn, được lên lịch trước

​

Hạn chế loại đường cong

​

Kiểm tra trước khi gửi

​

Trước một lần khởi chạy: những tham số này sẽ vượt qua không?

import {
  checkLaunchAgainstCurveRule,
  getPdaPlatformCurveRule,
  LaunchpadCurveRuleBaseTokenProgram,
  LaunchpadCurveRuleField,
  PlatformCurveRule,
} from "@raydium-io/raydium-sdk-v2";
import BN from "bn.js";

const platformConfig = await raydium.launchpad.getPlatformConfig(platformConfigId);

// ở 0 chương trình không đọc quy tắc nào cả, vì vậy không có gì để kiểm tra
if (platformConfig.restrictCurveParam !== 0) {
  const ruleId = getPdaPlatformCurveRule(programId, platformConfigId, configId).publicKey;
  const ruleAccount = await connection.getAccountInfo(ruleId);

  const result = checkLaunchAgainstCurveRule({
    // undefined khi tài khoản không tồn tại — nền tảng không viết quy tắc cho cấu hình này
    rule: ruleAccount === null ? undefined : PlatformCurveRule.decode(ruleAccount.data),
    context: {
      curveType: globalConfig.curveType,
      migrateType: 1,
      migrateCpmmFeeOn: 0,
      supply: new BN("1000000000000000"),
      totalSellA: new BN("793100000000000"),
      totalFundRaisingB: new BN("85000000000"),
      totalLockedAmount: new BN(0),
      cliffPeriod: new BN(0),
      unlockPeriod: new BN(0),
      baseTokenProgram: LaunchpadCurveRuleBaseTokenProgram.SplToken,
      // bỏ qua transferFee hoàn toàn khi base mint không mang tiện ích mở rộng phí chuyển
      unixTimestamp: new BN(Math.floor(Date.now() / 1000)),
    },
  });

  if (!result.ok) {
    // mỗi nhóm từ chối lần khởi chạy; mỗi mục liệt kê tất cả các ràng buộc không thành công của nhóm đó
    for (const group of result.groupFailures) {
      for (const c of group.unsatisfied) {
        console.log(
          `group ${group.groupId}: ${LaunchpadCurveRuleField[c.field]} is ${c.actual ?? "not computable"},`,
          `rule wants op ${c.op} ${c.value.toString()}`,
        );
      }
    }
  }
}

• Một tài khoản quy tắc bị thiếu, và một quy tắc không có nhóm, đều vượt qua. Một nhóm không có ràng buộc cũng vậy. Chuyển rule: undefined cho một tài khoản không tồn tại; không coi nó là một từ chối.
• Các giá trị không thể tính toán không thành công. Một cung cấp không có tỷ lệ, và một lượng bị khóa lớn hơn những gì bán đường cong để lại không có lượng di chuyển. actual quay lại undefined và ràng buộc được tính là không thỏa mãn, chính xác như on-chain.
• Tất cả các ràng buộc không thành công được báo cáo, không chỉ cái đầu tiên. Chương trình tắt ngắn vì nó chỉ cần một phán quyết; trợ giúp thu thập mọi thứ để biểu mẫu của bạn có thể liệt kê mọi vấn đề cùng một lúc.

​

Trước khi viết một quy tắc: nhóm này có hợp lệ không?

import {
  checkCurveRuleGroupWritable,
  LaunchpadCurveRuleField,
  LaunchpadCurveRuleOp,
} from "@raydium-io/raydium-sdk-v2";

const constraints = [
  { field: LaunchpadCurveRuleField.Supply, op: LaunchpadCurveRuleOp.Eq, value: new BN("1000000000000000") },
  { field: LaunchpadCurveRuleField.TotalFundRaisingB, op: LaunchpadCurveRuleOp.Gte, value: new BN("50000000000") },
  { field: LaunchpadCurveRuleField.TotalFundRaisingB, op: LaunchpadCurveRuleOp.Lte, value: new BN("200000000000") },
];

const writable = checkCurveRuleGroupWritable({
  groupId: 0,
  constraints,
  curveType: globalConfig.curveType,
  // các id mà quy tắc đã giữ, vì vậy thay thế một nhóm không bị nhầm lẫn với việc thêm một
  existingGroupIds: existingRule?.groups.map((g) => g.groupId) ?? [],
});

// mỗi lỗi mang mã lỗi chương trình mà giao dịch sẽ bị từ chối
if (!writable.ok) console.log(writable.errors);

​

Kiểm tra trên devnet trước tiên

1. Tạo một cấu hình nền tảng và một quy tắc trên devnet, và viết các nhóm giống như bạn dự định gửi.
2. Chạy mọi hình dạng khởi chạy mà UI của bạn có thể tạo ra thông qua checkLaunchAgainstCurveRule, và xác nhận các phán quyết là những cái bạn mong đợi — cả những hình dạng nên vượt qua và những hình dạng nên bị từ chối.
3. Bật restrict_curve_param, sau đó thực sự khởi chạy một token nên vượt qua và một nên bị từ chối. Cái thứ hai nên không thành công với CurveParamNotMatchPlatformRule (6025), không phải NotEnoughRemainingAccounts (6018) — cái sau có nghĩa là trình xây dựng của bạn không nối PDA quy tắc và kiểm tra không thực sự được thực hiện.
4. Chỉ sau đó lặp lại trên mainnet, theo cùng một thứ tự.

​

Vận hành một quy tắc

​

Người quản lý được ủy quyền

​

Tiền thuê theo nội dung

​

Thứ tự triển khai

1. Tập duyệt toàn bộ chuỗi trên devnet — xem Kiểm tra trên devnet trước tiên.
2. Tạo tài khoản quy tắc và viết các nhóm của nó. Không có gì thay đổi — với restrict_curve_param vẫn 0, chương trình không đọc chúng.
3. Kiểm tra quy tắc ngoài chuỗi với checkLaunchAgainstCurveRule: cho mỗi hình dạng khởi chạy mà UI của bạn có thể tạo ra, xác nhận một số nhóm chấp nhận nó.
4. Đặt restrict_curve_param thành 1. Từ thời điểm đó, những lần khởi chạy của những người tạo của bạn được kiểm tra.
5. Để quay lại, đặt nó thành 0 lại. Tài khoản quy tắc được để nguyên.

​

Chi phí tại thời gian khởi chạy

​

Nơi đi tiếp theo

• products/launchlab/platform-config — các trường PlatformConfig gating và ủy quyền quy tắc.
• products/launchlab/global-config — sàn giao thức mà quy tắc thu hẹp.
• products/launchlab/instructions — bốn hướng dẫn quy tắc và tài khoản của chúng.
• products/launchlab/accounts — PlatformCurveRule trong kho tài khoản.
• sdk-api/typescript-sdk — bề mặt SDK mà hai trợ giúp kiểm tra nằm trong.
• reference/changelog/2026-08-31-launchlab-platform-curve-rules — những gì thay thế danh sách trắng tham số đường cong, và những gì bộ giải mã phải thay đổi.

• raydium-launch/programs/launchpad/src/states/platform_curve_rule.rs — PlatformCurveRule, CurveRuleGroup, ParamConstraint, không gian id trường và op, và CurveRuleContext::value_of.
• raydium-launch/programs/launchpad/src/utils/platform_curve_rule.rs — kiểm tra thời gian khởi chạy.
• raydium-launch/programs/launchpad/src/instructions/platform/ — create, update, remove, và close_platform_curve_rule.