LaunchLab GlobalConfig

​

概要

​

レイアウト

// states/config.rs
pub const GLOBAL_CONFIG_SEED: &str = "global_config";

#[account]
pub struct GlobalConfig {
    pub epoch:                   u64,         // recent_epoch tracker
    pub curve_type:              u8,          // 0 = ConstantProduct, 1 = FixedPrice, 2 = LinearPrice
    pub index:                   u16,         // discriminator within a curve_type
    pub migrate_fee:             u64,         // SOL paid on graduation
    pub trade_fee_rate:          u64,         // 1/1_000_000 of volume
    pub max_share_fee_rate:      u64,         // 100 bps cap on the per-trade referral share fee
    pub min_base_supply:         u64,         // floor on Initialize supply (no decimals)
    pub max_lock_rate:           u64,         // ceiling on vesting locked / supply
    pub min_base_sell_rate:      u64,         // floor on base_supply_graduation / supply
    pub min_base_migrate_rate:   u64,         // floor on tokens that seed the post-graduation pool
    pub min_quote_fund_raising:  u64,         // floor on quote_reserve_target (with decimals)
    pub quote_mint:              Pubkey,
    pub protocol_fee_owner:      Pubkey,      // claims protocol fees via CollectFee
    pub migrate_fee_owner:       Pubkey,      // claims migration fees via CollectMigrateFee
    pub migrate_to_amm_wallet:   Pubkey,      // can sign MigrateToAmm
    pub migrate_to_cpswap_wallet:Pubkey,      // can sign MigrateToCpswap
    pub padding_alignment:       [u8; 8],
    pub padding:                 [u64; 15],
}

const [globalConfig] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("global_config"),
    Buffer.from(quoteMint.toBytes()),
    Buffer.from([curveType]),
    u16ToBytes(index),
  ],
  LAUNCHLAB_PROGRAM_ID,
);

​

フィールドセマンティクス

​

curve_type と index

• curve_type = 0 — 定数積仮想リザーブ曲線。デフォルトで最も使用されます。
• curve_type = 1 — 固定価格曲線。
• curve_type = 2 — 線形価格曲線。

​

フィー

• trade_fee_rate — トレード量の 1/1_000_000 で表示されます。曲線上のすべての買いと売りに適用されます。protocol_fee_owner は CollectFee 経由でその分を請求します。
• migrate_fee — 卒業時に 1 回請求される固定フィー（ラムポート単位またはクォート単位、設定による）。migrate_fee_owner が CollectMigrateFee 経由で請求します。
• max_share_fee_rate — 10_000（100 bps）に初期化されます。BuyExactIn、BuyExactOut、SellExactIn、SellExactOut が受け入れる share_fee_rate 引数を上限とします — トレード中に共有受信者に直接支払われるリファーラルフィーです。これは PlatformConfig.fee_rate を制限しません。そのレートには独自の上限があり、platform-config で説明されています。CreateConfig は init 時に trade_fee_rate + max_share_fee_rate < RATE_DENOMINATOR_VALUE を強制します。更新パスでは param = 6（max_share_fee_rate）のみが合計を再チェックします。param = 0（trade_fee_rate）は trade_fee_rate < RATE_DENOMINATOR_VALUE のみをアサートするため、トレードフィーだけを引き上げると、この 2 つの合計が結合上限を超える可能性があります。不変条件を保つ順序で設定してください。

​

供給量とレートの下限

• min_base_supply — 曲線が宣言できる最小 supply（小数なし）。デフォルトは 10_000_000。
• max_lock_rate — 1/1_000_000 で表示；デフォルト 300_000（30%）。total_locked_amount <= supply * max_lock_rate / 1_000_000 経由でベスティングを制限します。
• min_base_sell_rate — 1/1_000_000 で表示；デフォルト 200_000（20%）。base_supply_graduation / supply を下から制限します。
• min_base_migrate_rate — 1/1_000_000 で表示；デフォルト 200_000（20%）。卒業後プールをシードするために残されたトークン数を制限します。
• min_quote_fund_raising — ローンチが宣言できる最小 quote_reserve_target（小数付き）。デフォルトはクォートミントの 30_000_000_000 ユニット。

​

クォートミントとプロトコルウォレット

• quote_mint — ユーザーが購入する資産。ほとんどのローンチはラップド SOL（So111…112）または USDC（EPjF…Dt1v）を使用します。1 つの GlobalConfig は 1 つのクォートミントにバインドされます。異なるクォートが必要なローンチは異なる (curve_type, index) をターゲットにします。ミントは SPL Token プログラムまたは Token-2022 のいずれかで所有できます — 以下を参照してください。
• protocol_fee_owner — CollectFee に署名し、この設定にバインドされたすべてのローンチで発生したプロトコルフィーを請求する公開鍵。オンチェーンに保存；管理者は UpdateConfig 経由でローテーションできます。
• migrate_fee_owner — CollectMigrateFee に署名する公開鍵。

​

Token-2022 クォートミント

• 非推奨の Initialize はそれに対してローンチできません。 InitializeV2 と InitializeWithToken2022 のみが Token-2022 クォートプログラムを受け入れます。instructions を参照してください。
• 拡張機能の許可リストは適用されません。 CPMM と CLMM とは異なり、LaunchLab はクォートミントの拡張機能をスクリーニングしません — CreateConfig はミントをそのまま受け取るため、唯一のゲートは設定にバインドされるミントに対する管理者の裁量です。プログラムの NoSupportExtension チェックは LaunchLab 自体が作成する Token-2022 ベースミントのみをカバーします。1 つをバインドすることを高信頼アクションとして扱ってください；reference/token-2022-support を参照してください。

​

移行ウォレット

• migrate_to_amm_wallet — 保存された migrate_type = 0 を持つ既存のレガシーローンチの MigrateToAmm に署名します。
• migrate_to_cpswap_wallet — MigrateToCpswap に署名します。新しく初期化されたすべてのローンチはこのパスを使用します。

​

プラットフォーム側の許可リスト

​

初期化時のデフォルト

self.max_share_fee_rate     = 10_000;                  // 100 bps (referral share fee)
self.min_base_supply        = 10_000_000;              // no decimals
self.max_lock_rate          = 300_000;                 // 30%
self.min_base_migrate_rate  = 200_000;                 // 20%
self.min_base_sell_rate     = 200_000;                 // 20%
self.min_quote_fund_raising = 30_000_000_000;

​

ローンチが GlobalConfig を選択する方法

• (curve_type, index) — ロードする GlobalConfig PDA を選択します。
• CurveParams — 曲線形状を説明します（supply、total_base_sell、total_quote_fund_raising、migrate_type）。
• VestingParams — ロック供給を説明します。
• MintParams — ベースミント用。

• curve_type が global_config.curve_type と一致します。
• supply >= global_config.min_base_supply。
• total_locked_amount <= supply * max_lock_rate / 1_000_000。
• total_base_sell >= supply * min_base_sell_rate / 1_000_000。
• (supply − total_base_sell − total_locked_amount) >= supply * min_base_migrate_rate / 1_000_000 — つまり、卒業後プールをシードするのに十分なトークンが残っています。
• total_quote_fund_raising >= min_quote_fund_raising。
• migrate_type == 1（CPSWAP）。
• 選択されたプラットフォームが restrict_global_config == 1 を持つ場合、一致する PlatformAllowConfig が含まれます。

​

更新パス

​

クライアントから GlobalConfig を読む

import { Raydium } from "@raydium-io/raydium-sdk-v2";

// Fetch by PDA derivation:
const [configPda] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("global_config"),
    quoteMint.toBytes(),
    Buffer.from([curveType]),
    u16ToBytes(index),
  ],
  LAUNCHLAB_PROGRAM_ID,
);

// The SDK exposes the layout, not a getter — decode the account yourself:
import { LaunchpadConfig } from "@raydium-io/raydium-sdk-v2";
const info = await connection.getAccountInfo(configPda);
const config = LaunchpadConfig.decode(info!.data);
console.log(config.tradeFeeRate.toString(), config.minFundRaisingB.toString());

​

ポインタ

• products/launchlab/platform-config — 曲線形状をさらに制限するプラットフォームごとのオーバーレイ。
• products/launchlab/accounts — ローンチの完全なアカウントグラフ。
• products/launchlab/instructions — Initialize と更新命令。
• reference/program-addresses — 管理者公開鍵、プログラム ID、共有権限。

• raydium-launch/programs/launchpad/src/states/config.rs — GlobalConfig 構造体と initialize。
• raydium-launch/programs/launchpad/src/lib.rs — create_config、update_config。