CPMM 命令

​

命令サマリー

​

Initialize

init_amount_0: u64
init_amount_1: u64
open_time:     u64   // Unix タイムスタンプ。この前のスワップは拒否されます

• ミントはソート済み（バイト順で token_0_mint < token_1_mint）。
• どちらのミントも CPMM 許可リスト外の拡張機能を使用していません（TransferFeeConfig、MetadataPointer、TokenMetadata、InterestBearingConfig、ScaledUiAmount）— products/cpmm/accounts を参照してください。SupportMintAssociated PDA（シード [b"support_mint", mint]）が存在するミントは拡張機能チェックをスキップします — ただし、その PDA を remaining_accounts に追加しなければなりません。プログラムは渡されたアカウントのみをスキャンし、PDA 自体を読み込むことは決してないため、アカウントを渡さずにレジストリに依存すると NotSupportMint（6007）で失敗します。順序は関係ありません（照合はキーによります）。バイパスが必要なミントごとに 1 エントリを渡してください。このレジストリは、2026-09 アップグレードがハードコードされた 4 ミントホワイトリストを削除した後の唯一のバイパスです。
• creator は各 ATA で少なくとも init_amount_0 と init_amount_1 を持っています。
• amm_config.disable_create_pool == false。

• pool_state.lp_supply = sqrt(init_amount_0 * init_amount_1) — 完全な 平方根です。クリエイターにミントされるのは lp_supply − 100 で、ロックされる 100 ベース単位は lp_supply に計上されるものの決してミントされません。
• したがってプールの生涯にわたり lp_mint.supply == pool_state.lp_supply − 100 です。すべての LP シェア計算（デポジット、引き出し）は lp_supply で除算するため、このフィールドを使用し、ミントのオンチェーン供給量で代用しないでください。sqrt(...) < 100 の場合は InitLpAmountTooLess で失敗します。
• observation_state は初期化されます。observation_index = 0 および pool_id = pool_state.key()。
• create_pool_fee ラムポートは作成者から受取人に転送され、ネイティブ SOL として同期されます（wSOL ATA です）。
• プールのステータスビットマスクは 0（デポジット / 引き出し / スワップすべて有効）です。
• enable_creator_fee = false および creator_fee_on = BothToken。Initialize はクリエイターフィーの有効化をサポートしていません — そのパスは InitializeWithPermission です。
• open_time は、呼び出し元が <= block_timestamp の値を渡した場合、block_timestamp + 1 にバンプされます。スワップは open_time の前に拒否されます。デポジットと引き出しはすぐに機能します。

• InvalidInput — ミントがソートされていない、または同一のミント。
• NotSupportMint — ブロックされた Token-2022 拡張機能。
• ExceededSlippage — まれに。init_amount_0/1 が小数点の不一致により 0 LP になる場合。

​

Deposit

lp_token_amount:   u64   // LP にミントする LP トークンの数
maximum_token_0:   u64
maximum_token_1:   u64

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // same for side 1

needed_token_0 = ceil(lp_token_amount * total_0 / lp_supply)
transfer_0     = needed_token_0 + inverse_transfer_fee(needed_token_0) // Token-2022
require(transfer_0 <= maximum_token_0, "ExceededSlippage")             // same for side 1

• lp_supply += lp_token_amount。
• vault_0 += needed_token_0（入力の Token-2022 転送フィーを差し引いた額）。
• vault_1 += needed_token_1（入力の Token-2022 転送フィーを差し引いた額）。

​

Withdraw

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // same for side 1

out_token_0     = min(total_0, floor(lp_token_amount * total_0 / lp_supply))
receive_token_0 = out_token_0 − transfer_fee(out_token_0)             // Token-2022
require(receive_token_0 >= minimum_token_0, "ExceededSlippage")       // same for side 1

// As with Deposit: the base is the fee-excluded vault total, and the floor is
// checked against what the LP actually receives, after the transfer fee.

• lp_supply -= lp_token_amount。
• ボールトは out_token_0 / out_token_1 を送信します（総額。ユーザーは Token-2022 転送フィーを差し引いた額を受け取ります）。

​

SwapBaseInput

amount_in:            u64
minimum_amount_out:   u64

• open_time <= now。
• pool_status はスワップを許可します。
• どちらのミントもこの権限に対して一時停止またはフリーズされていません。
• amount_in > 0。

• ExceededSlippage — amount_out < minimum_amount_out。
• ZeroTradingTokens — トレードが 0 に丸められます。
• NotApproved — プールは UpdatePoolStatus を介してスワップに対して一時停止されています。
• InvalidInput — ミントがプールのボールトミントのいずれとも一致しません。

​

SwapBaseOutput

max_amount_in:  u64
amount_out:     u64

​

CollectProtocolFee

transfer pool_state.protocol_fees_token0 from vault_0 to recipient_0
transfer pool_state.protocol_fees_token1 from vault_1 to recipient_1
pool_state.protocol_fees_token0 = 0
pool_state.protocol_fees_token1 = 0

​

CollectFundFee

​

CollectCreatorFee

​

CollectCreatorFeePermissionless

• すべての creator_fees_token_0 と creator_fees_token_1 をプールボールトからクリエイター ATA に転送します。
• 両方のクリエイターフィーカウンターをゼロにし、pool_state.recent_epoch を更新します。
• 両方のカウンターがゼロの場合、NoFeeCollect を返します。

​

UpdatePoolStatus

status: u8      // 新しいビットマスク

​

CreateAmmConfig

index:             u16
trade_fee_rate:    u64
protocol_fee_rate: u64
fund_fee_rate:     u64
create_pool_fee:   u64
creator_fee_rate:  u64

• 同じ index を持つ既存の AmmConfig がありません。
• protocol_fee_rate + fund_fee_rate <= FEE_RATE_DENOMINATOR_VALUE。

​

UpdateAmmConfig

• param = 0 → trade_fee_rate（trade_fee_rate + creator_fee_rate < 1_000_000 をアサート）
• param = 1 → protocol_fee_rate（≤ 1_000_000 および + fund_fee_rate ≤ 1_000_000 をアサート）
• param = 2 → fund_fee_rate（≤ 1_000_000 および + protocol_fee_rate ≤ 1_000_000 をアサート）
• param = 3 → protocol_owner。新しいキーは value には 入りません：remaining_accounts[0] として追加してください（読み取り専用で構いません）。デフォルトの公開鍵であってはならず、アカウントを省略すると unwrap() でパニックします。
• param = 4 → fund_owner。3 と同じ仕組みです。
• param = 5 → create_pool_fee
• param = 6 → disable_create_pool（ゼロ以外の value はすべて無効化します）
• param = 7 → creator_fee_rate（creator_fee_rate + trade_fee_rate < 1_000_000 をアサート）

​

CollectExcessLamports

​

状態変化マトリックス

​

次のステップ

• products/cpmm/code-demos — 上記の実行可能な TypeScript サンプル。
• reference/error-codes — 完全な Anchor エラーテーブル。
• products/cpmm/fees — Collect*Fee 命令が排出するフィー蓄積モデル。

• raydium-io/raydium-cp-swap — instructions
• Raydium SDK v2 — @raydium-io/raydium-sdk-v2