LaunchLab アカウント

このページは AI による自動翻訳です。すべての内容は英語版を正とします。英語版を表示 →

このページでは、ローンチごとの アカウントグラフを説明します。ローンチの PoolState（ルート状態アカウント）、その 2 つのヴォルト、オーソリティ PDA、およびローンチが決済される際に獲得する卒業後の参照です。すべてのローンチを制限するプロトコルレベルの設定については、products/launchlab/global-config を参照してください。プラットフォームごとのオーバーレイについては、products/launchlab/platform-config を参照してください。ベスティングアカウント（PoolState の VestingSchedule、受益者ごとの VestingRecord）については、products/launchlab/vesting を参照してください。

アカウント一覧

アカウント	オーナー	用途
`GlobalConfig`	LaunchLab プログラム	プロトコルレベルのルール：フィー、供給量のフロア、マイグレーションウォレット。`(curve_type, index)` ごとに 1 つ。
`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` でスイープされます。
(卒業後) `cpmm_pool_state` または `amm_pool_state`	CPMM / AMM v4 プログラム	`MigrateToCpswap` / `MigrateToAmm` で作成されるプール。
(卒業後) Fee Key NFT	LP-Lock プログラム	CPMM 卒業時のクリエーターの LP スライスをラップします。ホルダーに CPMM プール上の `ClaimCreatorFee` の権利を与えます。

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         — buys / sells を受け付け中。quote_reserve_target 未満
= Migrate         — quote_reserve_target に到達。MigrateTo* を待機中
= Migrated        — MigrateTo* 実行済み。ベスティング時間経過中

統合業者向けのフィールド：

status — 3 つの値、単調性あり（Funding → Migrate → Migrated）。読み取りは常に安全です。書き込みはゲート制御されています。
real_base、real_quote — 現在の曲線状態。virtual_base / virtual_quote と組み合わせて、ヴォルトに触れることなくスポット価格を計算するのに十分です。bonding-curve を参照してください。
total_base_sell vs real_base — UI の「卒業への進捗」比率。
migrate_type — MigrateToAmm または MigrateToCpswap のどちらが有効な卒業パスであるかを選択します。Token-2022 ローンチは CPMM を使用する必要があります。
amm_creator_fee_on — CPMM への卒業時にのみ意味があります。卒業後の CPMM プール上で creator_fee_on = OnlyQuoteToken（0）または BothToken（1）を選択します。名前に反して、このエナムは事実上、マイグレーションターゲットも駆動します — 現在の運用実績では BothToken は MigrateToAmm と組み合わせられ、QuoteToken は MigrateToCpswap と組み合わせられています。 creator-fees を参照してください。
quote_protocol_fee / platform_fee / migrate_fee — 3 つの独立したフィーカウンター。それぞれ独自のクレーム指示があります。instructions を参照してください。
vesting_schedule — すべての PoolState に存在しますが、total_locked_amount == 0 の場合は非アクティブです。完全なライフサイクルについては、vesting を参照してください。

オーソリティ PDA

LaunchLab は、ローンチごとのシードなしで、すべてのローンチにわたって 単一の オーソリティ PDA を使用します：

const LAUNCHLAB_PROGRAM_ID = new PublicKey("<LAUNCHLAB_ID>"); // see 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（卒業前）。
AMM v4 / CPMM への卒業後 CPI（MigrateTo*）の署名者。
ClaimVestedToken でベースヴォルトから転送する際の署名者。

mint_authority は MigrateToAmm / MigrateToCpswap の直後に取り消され、供給量は永久に固定されます。 2 つの追加 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 です。Token-2022 ローンチは CPMM プールへ卒業する必要があります。AMM v4 は SPL Token ヴォルトのみをサポートするためです。

ヴォルト

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 アカウント構造体から正確なシードプレフィックスを確認してください。）

フィーヴォルト

2 つの PDA はローンチ全体のフィーを集約します：

クリエーターフィーヴォルト — シード [creator, quote_mint] の PDA。同じクリエーターが同じクオートミントで稼いだすべてのローンチは、同じヴォルトに流れ込みます。クリエーターは ClaimCreatorFee 経由でこれをスイープします。
プラットフォームフィーヴォルト — シード [platform_config, quote_mint] の PDA。同じプラットフォーム経由でルーティングされ、同じクオートミントを使用するすべてのローンチは、同じヴォルトに流れ込みます。プラットフォームの platform_fee_wallet は ClaimPlatformFeeFromVault 経由でこれをスイープします。また、ローンチごとのスイープバリアント（ClaimPlatformFee）があり、集約ヴォルトを経由せず、ローンチの quote_vault から直接プルします。

集約ヴォルトパターンにより、高取引量のクリエーターまたはプラットフォームは、多くのローンチにわたってフィー蓄積のレントコストを償却できます。

クオートヴォルト ↔ `real_quote`

quote_vault.balance と PoolState.real_quote は同期を保つ必要があります。3 つの待機中のフィーカウンター（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`	—
`MigrateToAmm` / `MigrateToCpswap`	Funding → Migrate → Migrated	(frozen)	(frozen)	作成、LP は `PlatformConfig` に従い分割
`ClaimCreatorFee` / `ClaimPlatformFee*`	any	—	—	フィーヴォルトをドレイン
`CreateVestingAccount`	Funding	—	—	`vesting_schedule.allocated_share_amount` をバンプ
`ClaimVestedToken`	Migrated only	—	—	`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

LaunchLab アカウント

アカウント一覧

`PoolState`

オーソリティ PDA

ベースミント

ヴォルト

フィーヴォルト

クオートヴォルト ↔ `real_quote`

ライフサイクルアカウント遷移

次へ

LaunchLab

トークン発行フロー

Tips & Gotchas

Documentation Index

​アカウント一覧

​PoolState

​オーソリティ PDA

​ベースミント

​ヴォルト

​フィーヴォルト

​クオートヴォルト ↔ real_quote

​ライフサイクルアカウント遷移

​次へ

アカウント一覧

`PoolState`

オーソリティ PDA

ベースミント

ヴォルト

フィーヴォルト

クオートヴォルト ↔ `real_quote`

ライフサイクルアカウント遷移

次へ