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    // サイド 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")             // サイド 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    // サイド 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")       // サイド 1 も同じ

// Deposit と同様：ベースはフィー除外ボルト合計で、フロアは LP が実際に受け取る内容に対してチェックされます。

• 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

share_rate = creator_fee_share.share_rate   (アカウントが存在する場合)
           | amm_config.creator_fee_share_rate   (そうでない場合)

shared_i  = floor(creator_fees_token_i * share_rate / 1_000_000)
creator_i = creator_fees_token_i - shared_i

transfer creator_i from vault_i to creator_token_i
pool_state.protocol_fees_token_i += shared_i     // ボルトに留まります
pool_state.creator_fees_token_i   = 0
pool_state.recent_epoch = current epoch

​

CollectCreatorFeePermissionless

​

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] として追加します（読み取り専用で問題ありません）。デフォルト pubkey であってはいけず、アカウントを省略すると 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 をアサート）
• param = 8 → creator_fee_share_rate（≤ 1_000_000 をアサート）。2026-09-19 で追加。このティア上のクリエイターフィーのプロトコルのデフォルトシェア。products/cpmm/fees を参照してください。トレードフィーを分割する protocol_fee_rate とは関係ありません。

​

CreateCreatorFeeShare

share_rate: u64   // クリエイターフィーの OF プロトコルのシェア、FEE_RATE_DENOMINATOR = 1_000_000 以上

• share_rate <= 1_000_000、そうでない場合は InvalidInput（6003）。
• PDA は既に存在してはいけません — Anchor の init は同じペアの 2 番目の呼び出しで失敗します。レートを変更するには、アカウントを閉じて再度作成します。

• creator_fee_share は bump、creator、amm_config、share_rate を保存します。
• その後のすべての CollectCreatorFee / CollectCreatorFeePermissionless は、creator によって amm_config の下で作成されたプール上で、コンフィグの代わりにこのアカウントからシェアを解決します。

​

CloseCreatorFeeShare

• アカウントは閉じられ、そのラムポートは owner に行きます。
• そのペアの収集は再び amm_config.creator_fee_share_rate からシェアを解決します — 管理者が UpdateAmmConfig パラメータ 8 を設定していない限り、これは 0 です。

​

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