LaunchLab 계정

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

이 페이지는 런칭별 계정 그래프를 문서화합니다: PoolState (한 번의 런칭을 위한 루트 상태 계정), 두 개의 볼트, 권한 PDA, 그리고 런칭이 정산될 때 얻게 되는 졸업 후 참조입니다.모든 런칭을 제한하는 프로토콜 수준의 설정은 products/launchlab/global-config를 참조하세요. 플랫폼별 오버레이는 products/launchlab/platform-config를 참조하세요. 베스팅 계정 (PoolState의 VestingSchedule, 수혜자별 VestingRecord)은 products/launchlab/vesting을 참조하세요.

계정 목록

계정	소유자	목적
`GlobalConfig`	LaunchLab 프로그램	프로토콜 수준 규칙: 수수료, 공급 하한, 마이그레이션 지갑. `(curve_type, index)`당 하나.
`PlatformConfig`	LaunchLab 프로그램	플랫폼별 오버레이: 브랜딩, 플랫폼 수수료, 졸업 시 NFT 분할, 곡선 형태 화이트리스트.
`PoolState`	LaunchLab 프로그램	런칭별 루트 상태: 민트, 볼트, 곡선 매개변수, 판매 카운터, 수수료 카운터, 베스팅 일정, 졸업 상태.
`authority`	LaunchLab 프로그램	시드 `[b"vault_auth_seed"]`에서 파생된 단일 PDA로, 모든 런칭의 볼트를 소유하고 졸업 후 CPI에 서명합니다.
`base_vault`	SPL Token / Token-2022	미판매 기본 토큰을 보유하는 런칭별 볼트.
`quote_vault`	SPL Token	누적된 인용 토큰을 보유하는 런칭별 볼트.
`VestingRecord`	LaunchLab 프로그램	수혜자별 클리프 + 선형 잠금 해제 기록. 선택 사항.
`creator_fee_vault`	SPL Token	크리에이터별 + 인용 민트별 볼트로 누적된 크리에이터 수수료를 보유하며, `ClaimCreatorFee`로 정산됩니다.
`platform_fee_vault`	SPL Token	플랫폼별 + 인용 민트별 볼트로 누적된 플랫폼 수수료를 보유하며, `ClaimPlatformFeeFromVault`로 정산됩니다.
`PlatformAllowConfig`	LaunchLab 프로그램	하나의 `(PlatformConfig, GlobalConfig)` 쌍에 대한 선택적 플랫폼 관리 권한. 플랫폼이 제한을 활성화할 때만 확인됩니다.
(졸업 후) `cpmm_pool_state`	CPMM 프로그램	모든 새로운 런칭에 대해 `MigrateToCpswap`으로 생성된 풀. 레거시 상태는 여전히 AMM v4 졸업을 참조할 수 있습니다.
(졸업 후) Fee Key NFT	LP-Lock 프로그램	2026-08-17 업그레이드 이전에는 플랫폼 및 크리에이터 스케일이 별도의 Fee Key를 생성할 수 있었습니다. 그 이후에 실행된 마이그레이션은 두 스케일을 하나의 플랫폼 Fee Key로 결합합니다.

SDK의 raydium.launchpad.getLaunchById는 PoolState와 런칭이 졸업했는지 여부를 나타내는 플래그를 반환합니다. 졸업했다면 마이그레이션 후 풀 ID가 포함됩니다.

`PoolState`

런칭별 루트 상태입니다. 아래의 필드 이름은 온체인 Rust 구조체 (states/pool.rs)와 일치합니다. 일부 값은 가독성을 위해 단순화되었으므로 정확한 메모리 레이아웃은 소스를 참조하세요.

// states/pool.rs (abridged)
pub struct PoolState {
    pub epoch:                     u64,        // recent_epoch tracker
    pub auth_bump:                 u8,
    pub status:                    u8,         // PoolStatus enum
    pub base_decimals:             u8,
    pub quote_decimals:            u8,
    pub migrate_type:              u8,         // 0 = AMM v4, 1 = CPMM
    pub supply:                    u64,        // total base tokens (no decimals)
    pub total_base_sell:           u64,        // base supply allocated to the curve
    pub virtual_base:              u64,        // virtual-reserve seed
    pub virtual_quote:             u64,        // virtual-reserve seed
    pub real_base:                 u64,        // base sold so far
    pub real_quote:                u64,        // quote raised so far (excl. fees)
    pub total_quote_fund_raising:  u64,        // graduation threshold in quote

    pub quote_protocol_fee:        u64,        // accrued, pending CollectFee
    pub platform_fee:              u64,        // accrued, pending ClaimPlatformFee
    pub migrate_fee:               u64,        // accrued, pending CollectMigrateFee
    pub vesting_schedule:          VestingSchedule,

    pub global_config:             Pubkey,
    pub platform_config:           Pubkey,
    pub creator:                   Pubkey,
    pub base_mint:                 Pubkey,
    pub quote_mint:                Pubkey,
    pub base_vault:                Pubkey,
    pub quote_vault:               Pubkey,

    pub amm_creator_fee_on:        u8,         // 0 = QuoteToken, 1 = BothToken (CPMM-only)
    pub token_program_flag:        u8,         // bit flags for SPL Token vs Token-2022
    pub padding:                   [u8; 54],
}

#[derive(Default, Debug, Clone)]
pub struct VestingSchedule {
    pub total_locked_amount:    u64,
    pub cliff_period:           u64,
    pub unlock_period:          u64,
    pub start_time:             u64,           // set at graduation
    pub allocated_share_amount: u64,           // running sum across VestingRecords
}

PoolStatus 값 (Anchor IDL에서):

= Funding         — 매수/매도 수락; quote_reserve_target 이하
= Migrate         — quote_reserve_target 도달; MigrateTo* 대기 중
= Migrated        — MigrateTo* 이미 실행됨; 베스팅 시계 실행 중

통합자 대면 필드:

status — 세 가지 값, 단조 (Funding → Migrate → Migrated). 읽기는 항상 안전하며, 쓰기는 제한됩니다.
real_base, real_quote — 현재 곡선 상태. virtual_base / virtual_quote와 함께 볼트에 접근하지 않고도 현물 가격을 계산하기에 충분합니다. bonding-curve를 참조하세요.
total_base_sell vs real_base — UI를 위한 “졸업까지의 진행률” 비율.
migrate_type — 새로운 초기화에는 1 (CPSWAP)이 필요합니다. 저장된 0은 CPMM 전용 적용 이전에 생성된 기존 런칭에서만 의미가 있습니다.
amm_creator_fee_on — 졸업 후 CPMM 풀에서 creator_fee_on = OnlyQuoteToken (0) 또는 BothToken (1)을 선택합니다. 마이그레이션 대상을 선택하지 않습니다. creator-fees를 참조하세요.
quote_protocol_fee / platform_fee / migrate_fee — 세 개의 독립적인 수수료 카운터. 각각 자체 청구 명령어가 있습니다. instructions를 참조하세요.
vesting_schedule — 모든 PoolState에 존재하지만 total_locked_amount == 0일 때는 비활성화됩니다. 전체 라이프사이클은 vesting을 참조하세요.

권한 PDA

LaunchLab은 런칭별 시드 없이 모든 런칭에서 단일 권한 PDA를 사용합니다:

const LAUNCHLAB_PROGRAM_ID = new PublicKey("<LAUNCHLAB_ID>"); // reference/program-addresses 참조

const [authority, bump] = PublicKey.findProgramAddressSync(
  [Buffer.from("vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

이 단일 PDA는:

모든 런칭의 base_vault 및 quote_vault의 권한입니다.
각 런칭의 base_mint의 mint_authority (졸업 전).
CPMM 졸업 CPI 및 기존 상태에 대한 레거시 AMM v4 졸업의 서명자입니다.
ClaimVestedToken 기본 볼트 외부 전송의 서명자입니다.

mint_authority는 MigrateToCpswap 또는 레거시 MigrateToAmm 호출 직후 취소되므로 공급이 영구적으로 고정됩니다. 두 개의 추가 PDA가 수수료 볼트를 제어합니다:

const [creatorFeeVaultAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("creator_fee_vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

const [platformFeeVaultAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("platform_fee_vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

이들은 ClaimCreatorFee 및 ClaimPlatformFeeFromVault 중에 해당 수수료 볼트 외부의 전송에 서명합니다.

기본 민트

Initialize로 인라인 생성되며:

mint_authority = authority (졸업 시 취소).
freeze_authority = None.
supply = supply, 전체가 base_vault로 민팅됨.
decimals는 Initialize에서 크리에이터가 선택 (일반적으로 6).

전체 공급이 사전 민팅되므로 base_mint.supply는 런칭 기간 동안 상수입니다. 곡선 매수는 토큰을 base_vault에서 구매자로 이동하지만 mint_to를 호출하지 않습니다. Initialize / InitializeV2는 SPL Token 런칭을 생성합니다. 전용 InitializeWithToken2022 명령어는 기본 민트가 Token-2022 민트 (선택적 TransferFeeConfig 포함)가 되도록 합니다. 인용 민트는 여전히 SPL Token입니다. 세 가지 초기화 경로 모두 CPMM 졸업이 필요합니다.

볼트

base_vault와 quote_vault 모두 LaunchLab authority PDA가 소유한 표준 SPL Token 계정입니다. 주소는 PoolState에 저장되며 다음과 같이 파생될 수도 있습니다:

const [baseVault] = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), baseMint.toBuffer()],
  LAUNCHLAB_PROGRAM_ID,
);
const [quoteVault] = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), quoteMint.toBuffer()],
  LAUNCHLAB_PROGRAM_ID,
);

(프로덕션에서 파생에 의존하기 전에 소스의 Initialize 계정 구조에서 정확한 시드 접두사를 확인하세요.)

수수료 볼트

두 개의 PDA가 런칭 전체에서 수수료를 집계합니다:

크리에이터 수수료 볼트 — 시드 [creator, quote_mint]의 PDA. 동일한 크리에이터가 동일한 인용 민트에서 얻은 모든 런칭이 동일한 볼트로 흘러갑니다. 크리에이터는 ClaimCreatorFee를 통해 정산합니다.
플랫폼 수수료 볼트 — 시드 [platform_config, quote_mint]의 PDA. 동일한 플랫폼을 통해 라우팅되고 동일한 인용 민트를 사용하는 모든 런칭이 동일한 볼트로 흘러갑니다. 플랫폼의 platform_fee_wallet은 ClaimPlatformFeeFromVault를 통해 정산합니다. 런칭별 정산 변형 (ClaimPlatformFee)도 있으며, 이는 집계된 볼트를 거치지 않고 런칭의 quote_vault에서 직접 끌어옵니다.

집계된 볼트 패턴은 높은 거래량의 크리에이터 또는 플랫폼이 많은 런칭에 걸쳐 수수료 누적의 임차료 비용을 분할할 수 있게 합니다.

Quote vault ↔ `real_quote`

quote_vault.balance와 PoolState.real_quote는 동기화 상태를 유지해야 합니다. 이들은 최대 세 개의 미결 수수료 카운터 (quote_protocol_fee, platform_fee, migrate_fee)의 합만큼 벗어날 수 있으며, 이는 볼트에 있지만 수수료 카운터에 속하고 곡선 준비금에는 속하지 않습니다. 곡선 수학은 항상 real_quote를 사용하며, 원시 볼트 잔액은 사용하지 않습니다. 졸업 전 불변식:

quote_vault.balance ==
   real_quote
 + quote_protocol_fee
 + platform_fee
 + migrate_fee

라이프사이클 계정 전환

이벤트	상태	`real_base`	`real_quote`	졸업 후 풀
`Initialize`	Funding	0	0	—
`BuyExactIn` / `BuyExactOut`	Funding	`+base_out`	`+quote_in_after_fee`	—
`SellExactIn` / `SellExactOut`	Funding	`−base_in`	`−quote_out_before_fee`	—
`MigrateToCpswap` (또는 레거시 `MigrateToAmm`)	Funding → Migrate → Migrated	(고정)	(고정)	생성됨; CPMM LP는 플랫폼 소유 잠금 LP 및 소각 LP로 분할됨
`ClaimCreatorFee` / `ClaimPlatformFee*`	모두	—	—	수수료 볼트 정산
`CreateVestingAccount`	Funding	—	—	`vesting_schedule.allocated_share_amount` 증가
`ClaimVestedToken`	Migrated만	—	—	`base_vault` 정산

다음 단계

products/launchlab/bonding-curve — real_base ↔ real_quote 뒤의 수학.
products/launchlab/instructions — 명령어별 계정 목록.
products/launchlab/global-config — 프로토콜 수준 바인딩.
products/launchlab/platform-config — 플랫폼 오버레이.
products/launchlab/vesting — 잠금 공급 메커니즘.
products/cpmm/accounts — 졸업 후 cpmm_pool_state의 모습.

소스:

raydium-launch/programs/launchpad/src/states/pool.rs — PoolState, PoolStatus, VestingSchedule, AmmCreatorFeeOn.
raydium-launch/programs/launchpad/src/lib.rs — PDA 시드 상수 (AUTH_SEED, CREATOR_FEE_VAULT_AUTH_SEED, PLATFORM_FEE_VAULT_AUTH_SEED).
Raydium SDK v2 launchpad 모듈.

LaunchLab

토큰 발행 플로우

Tips & Gotchas

계정 목록

`PoolState`

권한 PDA

기본 민트

볼트

수수료 볼트

Quote vault ↔ `real_quote`

라이프사이클 계정 전환

다음 단계

​계정 목록

​PoolState

​권한 PDA

​기본 민트

​볼트

​수수료 볼트

​Quote vault ↔ real_quote

​라이프사이클 계정 전환

​다음 단계

계정 목록

`PoolState`

권한 PDA

기본 민트

볼트

수수료 볼트

Quote vault ↔ `real_quote`

라이프사이클 계정 전환

다음 단계