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 platform 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)으로 초기화됩니다. 바인딩된 PlatformConfig의 플랫폼 공유 수수료율을 제한합니다(platform-config 참고). 프로그램은 trade_fee_rate + max_share_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)를 대상으로 합니다.
• protocol_fee_owner — CollectFee에 서명하고 이 설정에 바인딩된 모든 런칭에서 누적된 프로토콜 수수료를 청구하는 공개키. 온체인에 저장되며, 관리자는 UpdateConfig를 통해 회전할 수 있습니다.
• migrate_fee_owner — CollectMigrateFee에 서명하는 공개키.

​

마이그레이션 지갑

• migrate_to_amm_wallet — 저장된 migrate_type = 0인 기존 레거시 런칭에 대해 MigrateToAmm에 서명합니다.
• migrate_to_cpswap_wallet — MigrateToCpswap에 서명합니다. 새로 초기화된 모든 런칭이 이 경로를 사용합니다.

​

플랫폼 측 허용 목록

​

초기화 시 기본값

self.max_share_fee_rate     = 10_000;                  // 100 bps
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,
);

const config = await raydium.launchpad.getGlobalConfig(configPda);
console.log(config.tradeFeeRate, config.minQuoteFundRaising);

​

참고 자료

• 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.