LaunchLab 명령어

​

명령어 목록

​

Initialize

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // 또는 curve_type=1의 경우 initial_virtual_quote_reserve
    open_time:                  u64,
    quote_mint:                 Pubkey,
    base_token_metadata: {                         // 인라인 name/symbol/uri; 프로그램이 Metaplex로 CPI
        name:   String,
        symbol: String,
        uri:    String,
    },
    fees: {
        buy_numerator:   u64,
        buy_denominator: u64,
        sell_numerator:  u64,
        sell_denominator: u64,
        lp_share:        u64,
        creator_share:   u64,
        protocol_share:  u64,
        total_share:     u64,
    },
    post_graduation_lp_policy:  u8,                // 0 = Burn, 1 = Lock, 2 = ToCreator
}

• quote_mint ∈ launch_config.allowed_quote_mints.
• base_supply_graduation ≤ base_supply_max.
• 수수료 매개변수가 launch_config.max_*_fee_rate 검사를 통과.
• open_time ≥ now − slop (SDK는 ≥ now 강제; 프로그램은 약간의 백데이팅 허용).
• curve_type이 인식됨.

• base_mint는 supply = base_supply_max, 모두 base_vault에 있음.
• base_mint.mint_authority = launch_authority, freeze_authority = None.
• LaunchState는 status = Active, base_sold = 0, quote_reserve_real = 0으로 초기화.
• quote_reserve_target은 곡선 매개변수 + base_supply_graduation + buy_numerator에서 계산 (대략).

​

Buy (정규 변형: BuyExactIn)

quote_in:          u64
minimum_base_out:  u64

• launch_state.status == Active.
• now ≥ open_time.
• user_quote_ata.balance ≥ quote_in.
• quote_in > 0.

1. quote_in을 quote_in_after_fee와 수수료 부분으로 분할.
2. 사후 수수료 인용에 대해 base_out을 위해 곡선을 Newton 풀이.
3. require(base_out ≥ minimum_base_out) 아니면 ExceededSlippage로 되돌림.
4. quote_in 사용자 → 금고로 이동. base_out 금고 → 사용자로 이동.
5. base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share) 업데이트.
6. 수수료 카운터 업데이트 (protocol_fees_quote, creator_fees_quote).
7. state_data.num_buys += 1.
8. 업데이트 후 quote_reserve_real ≥ quote_reserve_target이면, SDK는 일반적으로 같은 트랜잭션에서 Graduate ix를 연결합니다. 프로그램은 Buy 내에서 자동 졸업하지 않습니다 — 후속 Graduate가 필요합니다.

​

BuyExactOut

base_out:      u64
maximum_quote_in: u64

​

Sell / SellExactIn / SellExactOut

• user_base_ata.balance ≥ base_in.
• 매도는 base_sold를 0 아래로 밀 수 없음 (회계가 일관성 있으면 위와 중복).
• 런칭이 Active.

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — 바인딩 GlobalConfig에 기록된 migrate_to_amm_wallet.
• MigrateToCpswap — 바인딩 GlobalConfig에 기록된 migrate_to_cpswap_wallet.

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. pool_state.status == Migrate 확인 (즉, quote_reserve_target에 도달). 아니면 PoolMigrated (상태가 이미 Migrated) 또는 PoolFunding (여전히 펀딩 중)으로 되돌림.
2. pool_state.migrate_type이 명령어와 일치하는지 확인 (0 AMM, 1 CPMM). 아니면 MigrateTypeNotMatch로 되돌림.
3. 사후 졸업 준비금 계산:
   • base_amount_out = base_vault.amount − vesting_schedule.total_locked_amount
   • quote_amount_out = quote_vault.amount − quote_protocol_fee − migrate_fee − platform_fee
4. 대상 프로그램 (AMM v4 Initialize2 또는 CPMM InitializeWithPermission)으로 CPI하여 그 준비금으로 사후 졸업 풀 생성.
5. 2026-08-17 업그레이드 후 실행된 CPMM 마이그레이션의 경우, platform_scale + creator_scale을 하나의 플랫폼 소유 잠긴 LP 공유로 결합하고 최대 하나의 Fee Key NFT를 platform_nft_wallet에 민트. burn_scale 나머지 소각. 업그레이드 전에는 creator_scale이 별도로 잠겼고 그 Fee Key는 토큰 생성자에게 갔습니다. 완료된 과거 마이그레이션은 수정되지 않습니다. 레거시 AMM v4 졸업의 경우, LP 처분은 그 명령어의 기존 흐름을 따릅니다.
6. base_mint.mint_authority 취소 (None으로 설정).
7. pool_state.status = Migrated 뒤집기, vesting_schedule.start_time = block_time + cliff_period 설정.

​

CPMM 마이그레이션 남은 계정

​

플랫폼 GlobalConfig 허용 목록

• 0: 플랫폼은 유효한 GlobalConfig를 수용합니다; 허용 계정이 필요하지 않습니다.
• 1: Initialize, InitializeV2, InitializeWithToken2022는 remaining_accounts 어디든 일치하는 PlatformAllowConfig를 포함해야 합니다.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

베스팅 및 플랫폼 설정 명령어

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, UpdatePlatformCurveParam, RemovePlatformCurveParam, CreatePlatformAllowConfig, ClosePlatformAllowConfig
• CreateConfig, UpdateConfig

​

상태 변경 매트릭스

​

다음 단계

• products/launchlab/code-demos — 각 명령어의 TypeScript 예제.
• products/launchlab/accounts — 전체 상태 형태.
• reference/error-codes — LaunchLab 오류 열거형.

• Raydium SDK v2 LaunchLab 모듈
• Raydium LaunchLab 프로그램 소스