LaunchLab GlobalConfig

​

개요

• 허용되는 본딩 곡선의 종류(curve_type).
• 곡선이 모든 매수와 매도에 부과하는 거래 수수료율.
• 졸업 시 부과되는 마이그레이션 수수료.
• 공급량, 락 비율, 판매 비율, 마이그레이션 비율의 하한.
• 인용 민트(일반적으로 래핑된 SOL 또는 USDC) — 사용자가 구매하는 자산.
• 네 개의 프로토콜 지갑: 프로토콜 수수료 소유자, 마이그레이션 수수료 소유자, CPMM 및 레거시 AMM v4 졸업을 위해 보유된 두 개의 마이그레이션 제어 지갑.

​

레이아웃

// 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 — 졸업 시 한 번 부과되는 고정 수수료(라멜 또는 인용 단위, 설정에 따라 다름). 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는 초기화 시 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만 확인하므로, 거래 수수료만 올리면 두 값의 합이 결합 상한을 넘을 수 있습니다. 불변식을 유지하는 순서로 설정하세요.

​

공급량 및 비율 하한

• 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)를 사용합니다. 하나의 GlobalConfig는 하나의 인용 민트에 바인딩됩니다; 다른 인용 대상이 필요한 런칭은 다른 (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 기본 민트만 포함합니다. 하나를 바인딩하는 것을 높은 신뢰 작업으로 취급하세요; 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";

// PDA 유도로 가져오기:
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.