LaunchLab GlobalConfig

이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.영문판 보기 →

GlobalConfig는 프로토콜 레벨 구성 계정입니다. 여러 개가 존재할 수 있으며 (curve_type, index)로 구분되고, 모든 런칭은 Initialize 시점에 정확히 하나를 선택합니다. 선택된 GlobalConfig의 값은 해당 런칭 매개변수의 하드 리밋이 됩니다. 플랫폼 레벨 사용자 지정(플랫폼별 수수료율, 허용되는 곡선 형태, 졸업 시 NFT 분할)은 products/launchlab/platform-config를 참고하세요.

개요

GlobalConfig는 (curve_type, index)별 싱글톤 PDA로, 모든 런칭이 따라야 하는 프로토콜 측 규칙을 정합니다:

허용되는 본딩 곡선의 종류(curve_type).
곡선이 매 매입/매도 시 부과하는 거래 수수료율.
졸업 시 부과되는 마이그레이션 수수료.
공급, 락 비율, 매도 비율, 마이그레이션 비율의 하한선.
쿼트 민트(일반적으로 래핑된 SOL 또는 USDC) — 사용자가 구입하는 자산.
프로토콜 측 세 개의 지갑: 프로토콜 수수료 소유자, 마이그레이션 수수료 소유자, 그리고 AMM v4 / CPMM으로의 졸업을 인증하는 두 개의 마이그레이션 제어 지갑.
선택적 플래그(requires_platform_auth) — 이 구성을 사용할 수 있는 플랫폼을 제한합니다.

GlobalConfig 계정은 LaunchLab 프로그램 관리자(Anchor 기반 Raydium 프로그램 전체에서 공유되는 하드코딩된 관리자 퍼블릭 키 — reference/program-addresses 참고)에 의해 생성 및 업데이트됩니다.

구조

// 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 requires_platform_auth:  u8,          // 0/1 flag
    pub padding_alignment:       [u8; 7],
    pub padding:                 [u64; 15],
}

PDA 유도:

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

(서명 전에 온체인 계정에서 정확한 시드 순서를 확인하세요 — 프로그램의 create_config 명령어가 신뢰할 수 있는 소스입니다.)

필드 의미

`curve_type`과 `index`

이 두 필드는 GlobalConfig를 고유하게 결정합니다. (curve_type, index) 쌍마다 하나의 GlobalConfig가 있습니다:

curve_type = 0 — 상수곱 가상 리저브 곡선. 가장 기본적이고 많이 사용됨.
curve_type = 1 — 고정 가격 곡선.
curve_type = 2 — 선형 가격 곡선.

index는 u16으로, 관리자가 곡선 타입별로 여러 구성을 게시할 수 있게 합니다(예: 낮은 수수료 구성, 높은 최소 쿼트 모금액 구성). Initialize 시 런칭이 (curve_type, index) 쌍을 제공하면 프로그램이 일치하는 GlobalConfig를 로드합니다.

수수료

trade_fee_rate — 거래 규모의 1/1_000_000 단위로 표시됩니다. 곡선의 모든 매입/매도에 적용됩니다. protocol_fee_owner는 CollectFee를 통해 자신의 몫을 청구합니다.
migrate_fee — 졸업 시 한 번 부과되는 고정 수수료(lamp 또는 쿼트 단위, 구성에 따라 다름). 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를 강제합니다.

공급 및 비율 하한선

이 하한선은 런칭이 Initialize 시 선택할 수 있는 곡선 형태 매개변수를 제한합니다. 작성자의 CurveParams이 이들 중 하나를 위반하면 Initialize는 InvalidInput으로 되돌립니다.

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 — MigrateToAmm에 서명해야 합니다. migrate_type = 0인 런칭(AMM v4 + OpenBook으로 졸업)에 사용됩니다.
migrate_to_cpswap_wallet — MigrateToCpswap에 서명해야 합니다. migrate_type = 1(CPMM으로 졸업)에 사용됩니다. Token-2022 런칭은 항상 이 경로를 취합니다.

이들은 일반적으로 Raydium에서 운영하는 졸업 크랭크가 보유하므로, 곡선이 임계값에 도달한 직후 졸업이 진행되며 작성자의 호출을 기다릴 필요가 없습니다.

`requires_platform_auth`

u8 플래그(0 = 누구나 이 구성을 사용할 수 있음; 0이 아닌 값 = 유효한 PlatformGlobalAccess PDA를 가진 플랫폼만 이에 대해 런칭할 수 있음). 설정된 경우, 이 GlobalConfig에 대한 모든 Initialize는 매칭되는 PlatformGlobalAccess 계정을 포함해야 하며, 이는 CreatePlatformGlobalAccess(관리자 전용 명령어)를 통해 플랫폼이 사전 인증받았음을 증명합니다. 플랫폼 측 메커니즘은 platform-config를 참고하세요.

초기화 시 기본값

CreateConfig가 호출될 때, 프로그램은 많은 필드를 하드코딩된 기본값으로 시드합니다:

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;
self.requires_platform_auth = 0;

관리자는 curve_type, index, migrate_fee, trade_fee_rate, quote_mint, 그리고 네 개의 지갑 퍼블릭 키를 생성 시점에 명시적으로 설정합니다. 이후 값들은 UpdateConfig를 통해 조정할 수 있습니다.

런칭이 `GlobalConfig`를 선택하는 방법

Initialize 시, 작성자는 다음을 전달합니다:

어떤 GlobalConfig PDA를 로드할지 선택하는 (curve_type, index).
곡선 형태를 설명하는 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.
requires_platform_auth != 0인 경우, 유효한 PlatformGlobalAccess PDA가 포함됩니다.

Initialize 후, 런칭의 PoolState는 global_config 퍼블릭 키를 직접 저장하므로 바인딩은 영구적입니다.

업데이트 경로

UpdateConfig는 관리자 전용이며 (param: u8, value: u64) 쌍을 취합니다. 각 param 값은 어떤 필드를 변경할지 선택합니다:

`param`	변경되는 필드
0	`migrate_fee`
1	`trade_fee_rate`
2	`max_share_fee_rate`
3	`min_base_supply`
4	`max_lock_rate`
5	`min_base_sell_rate`
6	`min_base_migrate_rate`
7	`min_quote_fund_raising`

지갑 회전(protocol_fee_owner, migrate_fee_owner, migrate_to_amm_wallet, migrate_to_cpswap_wallet)은 별도의 Pubkey 인자 형태를 취하므로, 관리자 트랜잭션을 구성하기 전에 update_config 소스에서 정확한 디스패치 테이블을 확인하세요. requires_platform_auth는 set_requires_platform_auth(bool)을 통해 토글됩니다.

클라이언트에서 `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,
);

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

사용 가능한 모든 구성을 나열하는 UI의 경우, SDK의 getAllGlobalConfigs 헬퍼를 사용하거나 이들을 반영하는 LaunchLab API 엔드포인트를 쿼리하세요. 온체인 계정 수는 적습니다(실제로는 한 자릿수).

LaunchLab

토큰 발행 플로우

Tips & Gotchas

개요

구조

필드 의미

`curve_type`과 `index`

수수료

공급 및 비율 하한선

쿼트 민트 및 프로토콜 지갑

마이그레이션 지갑

`requires_platform_auth`

초기화 시 기본값

런칭이 `GlobalConfig`를 선택하는 방법

업데이트 경로

클라이언트에서 `GlobalConfig` 읽기

관련 항목

LaunchLab

토큰 발행 플로우

Tips & Gotchas

Documentation Index

​개요

​구조

​필드 의미

​curve_type과 index

​수수료

​공급 및 비율 하한선

​쿼트 민트 및 프로토콜 지갑

​마이그레이션 지갑

​requires_platform_auth

​초기화 시 기본값

​런칭이 GlobalConfig를 선택하는 방법

​업데이트 경로

​클라이언트에서 GlobalConfig 읽기

​관련 항목

개요

구조

필드 의미

`curve_type`과 `index`

수수료

공급 및 비율 하한선

쿼트 민트 및 프로토콜 지갑

마이그레이션 지갑

`requires_platform_auth`

초기화 시 기본값

런칭이 `GlobalConfig`를 선택하는 방법

업데이트 경로

클라이언트에서 `GlobalConfig` 읽기

관련 항목