LaunchLab PlatformConfig

​

개요

1. 브랜딩 — 이름, 웹사이트, 이미지 링크로, 모두 인라인으로 저장되어 모든 익스플로러나 애그리게이터가 토큰을 런칭한 플랫폼을 표시할 수 있습니다.
2. 플랫폼 수수료 — 프로토콜의 trade_fee_rate 위에 추가되는 거래 수수료(fee_rate)입니다. 플랫폼의 platform_fee_wallet에 누적됩니다. 생성 및 업데이트 경로 모두에서 500 bps(50000)로 제한되며, 2026-08-26에 100 bps(10000)에서 인상되었습니다 — 수수료 상한 참조.
3. LP 마이그레이션 분배 — 세 개의 저장된 정수(platform_scale, creator_scale, burn_scale)로 1_000_000으로 합산됩니다. 2026-08-17 업그레이드 전에는 크리에이터 스케일이 별도의 크리에이터 Fee Key를 생성했습니다. 업그레이드 후 실행된 마이그레이션은 처음 두 개를 플랫폼 소유의 잠금 LP 지분으로 결합하고, 나머지는 소각됩니다.
4. 런칭 파라미터 규칙 — 선택적 제한(restrict_curve_param)으로, 런칭이 선택한 GlobalConfig의 PlatformCurveRule 계정을 만족하도록 요구합니다. 규칙은 값 범위, 대체 계층, 토큰 타입 게이팅을 지원하며, PlatformConfig가 아닌 자신의 계정에 있습니다.
5. 글로벌 설정 허용 목록 — 선택적 제한으로, 선택한 GlobalConfig에 대해 플랫폼이 생성한 PlatformAllowConfig를 요구합니다.

const [platformConfigPda] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("platform_config"),
    platformAdmin.toBuffer(),       // platform's owning pubkey
  ],
  LAUNCHLAB_PROGRAM_ID,
);

​

레이아웃

// states/platform_config.rs
pub const PLATFORM_CONFIG_SEED: &str = "platform_config";
pub const NAME_SIZE: usize = 64;
pub const WEB_SIZE:  usize = 256;
pub const IMG_SIZE:  usize = 256;
pub const MAX_CREATOR_FEE_RATE: u64 = 5000;       // 50 bps (denominator 1_000_000)
pub const MAX_TRANSFER_FEE_RATE: u16 = 500;       // 5%   (denominator 10_000)

#[account]
pub struct PlatformConfig {
    pub epoch:                       u64,
    pub platform_fee_wallet:         Pubkey,            // signs ClaimPlatformFee
    pub platform_nft_wallet:         Pubkey,            // receives the platform NFT slice at CPMM graduation
    pub platform_scale:              u64,               // share of LP minted to platform NFT
    pub creator_scale:               u64,               // creator share before upgrade; added to platform share afterward
    pub burn_scale:                  u64,               // share of LP burned permanently
    pub fee_rate:                    u64,               // platform's trade fee (1/1_000_000)
    pub name:                        [u8; 64],          // utf-8 padded with zeros
    pub web:                         [u8; 256],
    pub img:                         [u8; 256],
    pub cpswap_config:               Pubkey,            // CPMM AmmConfig that the post-grad pool will bind to
    pub creator_fee_rate:            u64,               // creator-side fee taken pre-graduation
    pub transfer_fee_extension_auth: Pubkey,            // for Token-2022 launches: withdraw-withheld authority from mint creation, fee-config authority from graduation
    pub platform_vesting_wallet:     Pubkey,
    pub platform_vesting_scale:      u64,               // platform's slice of total_locked_amount
    pub platform_cp_creator:         Pubkey,            // optional creator-of-record on the post-graduation CPMM pool
    pub restrict_global_config:      u8,                // 0 = unrestricted, 1 = require allow PDA
    pub restrict_curve_param:        u8,                // 0 = unrestricted, 1 = enforce the PlatformCurveRule
    pub curve_rule_manager:          Pubkey,            // hot wallet allowed to manage rule accounts
    pub padding:                     [u8; 78],
}

• (0, 100_000, 900_000) — 90% LP 소각, 10% 플랫폼에 잠금.
• (50_000, 100_000, 850_000) — 85% 소각, 15% 플랫폼에 잠금.
• (0, 0, 1_000_000) — 완전 소각, NFT 민트 없음. 엄격한 “내부자 없음” 런칭.

​

브랜딩 필드

function readString(bytes: Uint8Array): string {
  const end = bytes.indexOf(0);
  return Buffer.from(end === -1 ? bytes : bytes.subarray(0, end)).toString("utf-8");
}

​

수수료 메커니즘

trade_fee     = amount_in × global_config.trade_fee_rate    / 1_000_000
platform_fee  = amount_in × platform_config.fee_rate        / 1_000_000
creator_fee   = amount_in × platform_config.creator_fee_rate / 1_000_000

amount_after_fee = amount_in − trade_fee − platform_fee − creator_fee

• trade_fee는 프로토콜의 protocol_fee_owner에 누적됩니다(CollectFee를 통해 청구).
• platform_fee는 플랫폼별 금고에 누적됩니다(ClaimPlatformFee 또는 ClaimPlatformFeeFromVault를 통해 청구; instructions 참조).
• creator_fee는 크리에이터의 공개키 + 인용 민트로 키된 크리에이터별 금고에 누적됩니다(ClaimCreatorFee를 통해 청구).

​

수수료 상한

​

Token-2022 전송 수수료 권한

• 런칭 후가 아니라 런칭 전에 필드를 설정하세요. transfer_fee_extension_auth가 Pubkey::default()인 동안 생성된 런칭은 인출 측에 authority PDA를 놓습니다. 나중에 필드를 설정하면 여전히 작동합니다 — 졸업이 제자리에 있는 PDA를 찾고 권한을 전달합니다 — 하지만 그 사이에 보유된 잔액을 인출할 수 없습니다.
• 런칭 중간에 필드를 회전하면 두 권한이 분할됩니다. 런칭의 생성과 졸업 사이에 transfer_fee_extension_auth를 변경하면 민트의 인출 보유 권한은 생성 시 구성된 키에 남아 있고(PDA는 더 이상 보유하지 않으므로 마이그레이션이 해당 인수를 건너뜀) 수수료 설정 권한은 새 키로 갑니다. 런칭 간에 회전하거나 Token-2022를 통해 직접 두 키를 조정할 계획을 세우세요.

​

NFT 마이그레이션 분배 (CPMM 전용)

lp_to_platform = floor(lp_total × (platform_scale + creator_scale) / 1_000_000)
lp_to_burn     = lp_total − lp_to_platform

​

런칭 파라미터 규칙

pub restrict_curve_param: u8,   // 0 = unrestricted, 1 = enforce the rule of the used config
pub curve_rule_manager:   Pubkey, // may manage rule accounts; the platform admin always may too

• curve_rule_manager는 위임이지, 전송이 아닙니다. UpdatePlatformConfig::CurveRuleManager를 통해 설정하면 해당 지갑은 관리자 키 없이 이 플랫폼의 규칙 계정을 생성, 업데이트, 제거, 종료할 수 있습니다. 플랫폼 관리자는 병렬로 동일한 권한을 유지하므로, 필드를 회전하거나 지우면 제어를 복구합니다. Pubkey::default()는 관리자만 규칙을 관리할 수 있음을 의미합니다. restrict_curve_param을 뒤집을 수 없으며, 이는 관리자 전용 호출로 유지됩니다.
• 규칙은 GlobalConfig 위에 적용되며, 대신이 아닙니다. 규칙 체크는 설정의 자체 제한 전에 실행되고 이들을 좁힐 수만 있습니다.

​

PlatformAllowConfig — 플랫폼 제한

pub const PLATFORM_ALLOW_CONFIG_SEED: &str = "platform_allow_config";

#[account]
pub struct PlatformAllowConfig {
    pub bump:            u8,
    pub platform_config: Pubkey,
    pub global_config:   Pubkey,
    pub padding:         [u64; 8],
}

​

읽기 경로

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

console.log("Platform:", readString(platformConfig.name));
console.log("Fee rate:", platformConfig.feeRate, "(/1M)");
console.log("NFT split:",
  platformConfig.platformScale,
  platformConfig.creatorScale,
  platformConfig.burnScale,
);
console.log("Restrict launch params:", platformConfig.restrictCurveParam);
console.log("Rule manager:", platformConfig.curveRuleManager.toBase58());

​

업데이트 경로

​

일반적인 함정

• 빌더가 업데이트되기 전에 restrict_curve_param 활성화. 1인 동안 규칙 PDA는 규칙 계정이 없는 설정의 경우에도 모든 런칭에서 remaining_accounts에 있어야 합니다 — 누락된 계정은 통과가 아니라 NotEnoughRemainingAccounts입니다. 빌더 변경을 먼저 배포한 다음 플래그를 뒤집으세요.
• 빈 규칙으로 restrict_curve_param 활성화. 0개 그룹을 보유하거나 0개 제약을 보유한 그룹은 모든 것을 허용합니다. 플래그를 활성화하는 것 자체는 제한이 아닙니다. 먼저 그룹을 작성하고, SDK 체크로 검증하고, devnet에서 전체 시퀀스를 리허설하세요.
• NFT 분배 반올림. 세 스케일은 정확히 1_000_000으로 합산되어야 합니다. CreatePlatformConfig에서 1 오프 오류는 되돌아갑니다. 런타임에서 1 오프는 1개의 추가 LP 단위를 민트하거나 소각할 것이며, 이것이 엄격한 동등성 체크가 방지하는 것입니다.
• 플랫폼 베스팅 이중 할당. platform_vesting_scale > 0이면, 플랫폼은 런칭의 펀드레이징이 끝난 후 한 번 CreatePlatformVestingAccount를 호출해야 합니다. 잊으면, 그 지분은 할당되지 않고 영구적으로 휴면 상태로 남습니다(런칭의 total_locked_amount 예산은 소비되지만 플랫폼은 절대 청구하지 않습니다).
• platform_cp_creator 모호성. Pubkey::default()로 설정되면, 런칭 크리에이터가 졸업 후 CPMM 풀의 pool_creator로 기록됩니다. 실제 키로 설정되면, 그 키가 대신 기록됩니다. 이는 졸업 후 CPMM 크리에이터 수수료의 수혜자와 원래 CPMM::CollectCreatorFee 경로에 서명할 수 있는 사람을 결정합니다. 허가 없는 수집 경로는 여전히 이 기록된 키의 정규 ATA에 지불합니다. 플랫폼 설정 생성 시 어떤 모델을 원하는지 결정하세요.
• transfer_fee_extension_auth 늦게 설정 또는 회전. 필드는 Token-2022 런칭당 두 번 읽힙니다 — 민트 생성 시 withdraw_withheld_authority에 대해 한 번, 졸업 시 transfer_fee_config_authority에 대해 한 번 — 따라서 이 두 순간 사이에 변경되는 값은 두 권한을 다른 키에 남깁니다. Token-2022 전송 수수료 권한 참조.
• 허용 계정 없이 제한. restrict_global_config를 활성화하기 전에 필요한 PlatformAllowConfig를 생성하면 해당 설정을 선택하는 새 런칭이 차단됩니다.

​

포인터

• products/launchlab/global-config — 런칭이 만족해야 하는 프로토콜 측 규칙.
• products/launchlab/vesting — platform_vesting_scale 메커니즘.
• products/launchlab/creator-fees — 크리에이터 수수료 대 플랫폼 Fee Key 권리.
• products/launchlab/platforms — 플랫폼 통합자 방법.

• raydium-launch/programs/launchpad/src/states/platform_config.rs — PlatformConfig, PlatformParams, MigrateNftInfo, is_curve_rule_manager, is_platform_admin.
• raydium-launch/programs/launchpad/src/states/platform_curve_rule.rs — PlatformCurveRule, CurveRuleGroup, ParamConstraint.
• raydium-launch/programs/launchpad/src/states/platform_allow_config.rs — PlatformAllowConfig.
• raydium-launch/programs/launchpad/src/instructions/platform/update_platform_config.rs — PlatformConfigParam 디스패치 및 업데이트 시간 수수료 상한을 적용하는 필드별 설정자.
• raydium-launch/programs/launchpad/src/lib.rs — 플랫폼 설정 및 허용 설정 진입점.
• raydium-launch/programs/launchpad/src/instructions/initialize_with_token_2022.rs — transfer_fee_extension_auth가 새 민트의 TransferFeeConfig에 기록되는 위치.
• raydium-launch/programs/launchpad/src/instructions/admin/migrate_to_cpswap.rs — 졸업 시간 권한 인수 및 그 get_withdraw_withheld_authority 가드.