CPMM instructions

CPMM プログラムのすべてのインストラクション、引数、アカウントリスト、事前・事後条件、戻されるエラーの参照。

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

英語版を表示 →

​

インストラクション概要

ディスクリミネータ名	署名者	動作
Initialize	プール作成者	2つのミント と AmmConfig から新しい CPMM プールを作成します。パーミッションレス。新しいプールで enable_creator_fee = false がハードコードされます。pool_state アカウントは正規 PDA またはランダムキーペア（Initialize アカウント参照）です。
InitializeWithPermission	ペイヤー + Permission PDA の保有者	Initialize の許可版。呼び出し者（ペイヤー）は自身の公開鍵から導出された Permission PDA を所有する必要があります。プール作成をゲートする必要があるプラットフォームで使用（例：LaunchLab 卒業）。呼び出し者が creator_fee_on を固定でき、新しいプールで enable_creator_fee = true に強制されます。pool_state の creator フィールドはペイヤーではなく別途渡される creator アカウントに設定されます。pool_state の正規 PDA またはランダムキーペアの柔軟性は Initialize と同じです。
Deposit	LP	両トークンで流動性を追加。LP トークンを受け取ります。
Withdraw	LP	LP トークンをバーン。両方の基礎となるトークンを按分で受け取ります。
SwapBaseInput	スワップ実行者	確定入力スワップ（amount_in をイン、≥ minimum_amount_out をアウト）。
SwapBaseOutput	スワップ実行者	確定出力スワップ（≤ maximum_amount_in をイン、amount_out をアウト）。
CollectProtocolFee	protocol_owner (AmmConfig より)	ボルトから蓄積したプロトコルフィーを回収します。
CollectFundFee	fund_owner (AmmConfig より)	ボルトから蓄積したファンドフィーを回収します。
CollectCreatorFee	pool_creator	蓄積したクリエイターフィーを回収（クリエイターフィーが有効な場合）。
UpdatePoolStatus	admin	ビットマスクを使用してプール上の特定の操作を一時停止・再開します。
UpdateAmmConfig	admin	AmmConfig のフィー率またはプロトコル/ファンド所有者を変更します。
CreateAmmConfig	admin	新しいフィーティア（新しい AmmConfig アカウント）を作成します。
CreatePermissionPda	admin	特定の権限が InitializeWithPermission を呼び出すことを許可する Permission PDA をミント。
ClosePermissionPda	admin	以前発行された Permission PDA を取り消します。

ステータスビットマスク：各プールの status は u8 で、ビット 0 = デポジット無効、ビット 1 = 引出無効、ビット 2 = スワップ無効（プログラムの PoolStatusBitIndex { Deposit, Withdraw, Swap } など）。クリアビットは操作が許可されたことを意味し、セットビットは一時停止されたことを意味します。UpdatePoolStatus は生の u8 を受け取り、既存値を上書きします。

以降のセクションでは詳細に説明します。アカウント順序は CPMM IDL に従い、SDK および raydium-cp-swap/programs/cp-swap/src/instructions の Rust クライアントがこの順序に合わせます。

​

Initialize

新しい CPMM プールを作成します。

引数

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

アカウント (W = 書き込み可能、S = 署名者)

#	名前	W	S	注記
1	creator	W	S	レント払い。pool_state.pool_creator として記録されます。
2	amm_config			選択されたフィーティア。
3	authority			CPMM グローバルオーソリティ PDA。
4	pool_state	W	S*	ここで init。正規 PDA ["pool", amm_config, token_0_mint, token_1_mint] または ランダムキーペア — 正規 PDA でない場合、プログラムは pool_state に署名を要求（require_eq!(pool_account_info.is_signer, true)）。ランダムキーペアパスは作成者が正規 PDA での前走行動作を回避できます。下流 PDA（lp_mint、ボルト、observation_state）は pool_state.key() から導出されます。
5	token_0_mint			ソート：token_0_mint < token_1_mint。
6	token_1_mint
7	lp_mint	W		ここで init。オーソリティを authority に設定。
8	creator_token_0	W		init_amount_0 のソース ATA。
9	creator_token_1	W		init_amount_1 のソース ATA。
10	creator_lp_token	W		LP の宛先（欠落時に作成）。
11	token_0_vault	W		ここで init。authority が所有。
12	token_1_vault	W
13	create_pool_fee	W		作成者が支払う create_pool_fee の宛先 ATA。
14	observation_state	W		ここで init。
15	token_program			SPL Token（LP ミント用）。
16	token_0_program			SPL Token または Token-2022。
17	token_1_program			SPL Token または Token-2022。
18	associated_token_program
19	system_program
20	rent

* pool_state はランダムキーペアパスでのみ署名します。正規 PDA パスは pool_state なしで実行されます。

事前条件

• ミントがソート済み（バイト順で token_0_mint < token_1_mint）。
• どちらのミントも CPMM許可リスト外の拡張を使用していない（TransferFeeConfig、MetadataPointer、TokenMetadata、InterestBearingConfig、ScaledUiAmount） — /ja/products/cpmm/accounts 参照。プログラム内の小さいミント単位の許可リストは個別サポートのチェックをバイパス。
• 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) − LOCKED_LP で存在。
• LOCKED_LP（LP トークン 100 ラムポート）の LP スターターが永続的にロック — pool_state.lp_supply は liquidity − 100 を記録しつつ、100 LP ユニットは流通外のまま、プールが完全にドレイン・ゼロ除算を防止。
• 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 前に拒否；デポジット・引出は即座に動作。

一般的エラー （完全リストは /ja/reference/error-codes で）

• 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

アカウント

#	名前	W	S
1	owner		S
2	authority
3	pool_state	W
4	owner_lp_token	W
5	token_0_account	W
6	token_1_account	W
7	token_0_vault	W
8	token_1_vault	W
9	token_program
10	token_program_2022
11	vault_0_mint
12	vault_1_mint
13	lp_mint	W

数学

needed_token_0 = ceil(lp_token_amount * vault_0 / lp_supply)
needed_token_1 = ceil(lp_token_amount * vault_1 / lp_supply)
require(needed_token_0 <= maximum_token_0, "ExceededSlippage")
require(needed_token_1 <= maximum_token_1, "ExceededSlippage")

k の比例性に変化なし — ボルトと lp_supply は同一要素でスケール。

事後条件

• lp_supply += lp_token_amount。
• vault_0 += needed_token_0（入力時 Token-2022 転送フィー差引後）。
• vault_1 += needed_token_1（入力時 Token-2022 転送フィー差引後）。

一般的エラー — ExceededSlippage、ZeroTradingTokens、デポジット一時停止時 InvalidStatus。

​

Withdraw

LP トークンをバーン、両基礎トークンを按分で受け取ります。

引数

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

アカウント

#	名前	W	S
1	owner		S
2	authority
3	pool_state	W
4	owner_lp_token	W
5	token_0_account	W
6	token_1_account	W
7	token_0_vault	W
8	token_1_vault	W
9	token_program
10	token_program_2022
11	vault_0_mint
12	vault_1_mint
13	lp_mint	W

（Deposit と同一；lp_mint は LP トークンがバーンされるため書き込み可能）

数学

out_token_0 = floor(lp_token_amount * vault_0 / lp_supply)
out_token_1 = floor(lp_token_amount * vault_1 / lp_supply)
require(out_token_0 >= minimum_token_0, "ExceededSlippage")
require(out_token_1 >= minimum_token_1, "ExceededSlippage")

事後条件

• lp_supply -= lp_token_amount。
• ボルトが out_token_0 / out_token_1 を送信（総額；ユーザーは Token-2022 転送フィー差引後を受取）。

​

SwapBaseInput

確定入力スワップ。

引数

amount_in:            u64
minimum_amount_out:   u64

アカウント

#	名前	W	S
1	payer		S
2	authority
3	amm_config
4	pool_state	W
5	input_token_account	W
6	output_token_account	W
7	input_vault	W
8	output_vault	W
9	input_token_program
10	output_token_program
11	input_token_mint
12	output_token_mint
13	observation_state	W

順序は 入力 → 出力 で、プールの正規 token_0 / token_1 ではなくユーザー方向。プログラムはミントを照合してボルトを判定。

数学 — /ja/products/cpmm/math 参照。

事前条件

• 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

アカウント — SwapBaseInput と同じ。

数学 — 逆曲線（シーリング付き）、/ja/products/cpmm/math 参照。

一般的エラー — ExceededSlippage（gross_in > max_amount_in）、ZeroTradingTokens、InvalidInput、NotApproved。

​

CollectProtocolFee

ボルトから蓄積したプロトコルフィーを回収。

引数 — なし。

アカウント

#	名前	W	S
1	owner		S	amm_config.protocol_owner に一致する必要。
2	authority
3	pool_state	W
4	amm_config
5	token_0_vault	W
6	token_1_vault	W
7	vault_0_mint
8	vault_1_mint
9	recipient_token_0_account	W
10	recipient_token_1_account	W
11	token_program
12	token_program_2022

エフェクト

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

曲線の有効バランスに変化なし（蓄積フィーはすでに除外）。

一般的エラー — 署名者が protocol_owner でない場合 NotApproved。

​

CollectFundFee

CollectProtocolFee と同じ形だが、fund_owner が署名、fund_fees_* カウンタをゼロ化。

​

CollectCreatorFee

同じ形、pool_state.pool_creator が署名。プールが非ゼロクリエイターフィー率で初期化された場合のみ転送を発行。

​

UpdatePoolStatus

プール上の個別操作を一時停止・再開。status フィールドはビットマスク：

ビット	フラグ	セット時の効果
0	DEPOSIT_DISABLED	Deposit が NotApproved で拒否。
1	WITHDRAW_DISABLED	Withdraw が拒否。
2	SWAP_DISABLED	SwapBaseInput / SwapBaseOutput が拒否。

引数

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

アカウント

#	名前	W	S
1	authority		S	CPMM プログラムのアドミン鍵に一致する必要。
2	pool_state	W

アドミン鍵は CPMM プログラムのアップグレード権限 — 実際には Raydium マルチシグ。/ja/security/admin-and-multisig 参照。

​

CreateAmmConfig

新しいフィーティアを作成。

引数

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

アカウント

#	名前	W	S
1	owner	W	S	アドミン。
2	amm_config	W		ここで init。
3	system_program

事前条件

• 同じ index の既存 AmmConfig なし。
• protocol_fee_rate + fund_fee_rate <= FEE_RATE_DENOMINATOR_VALUE。

​

UpdateAmmConfig

既存 AmmConfig でフィー率またはオーナーシップを変更。param: u8（更新フィールドディスクリミネータ）と value: u64 を受け取ります。パラメータあたりの値セマンティクスはソースに；一般的には：

• param = 0 → trade_fee_rate
• param = 1 → protocol_fee_rate
• param = 2 → fund_fee_rate
• param = 3 → new_protocol_owner（Pubkey バイトを再解釈として渡す）
• param = 4 → new_fund_owner
• param = 5 → create_pool_fee
• param = 6 → disable_create_pool

変更はアドミンが署名、この AmmConfig にバインドされた すべてのプール に次のスワップで影響。マイグレーションなし；プールは単に新値を読み込み。

​

状態変更マトリックス

インストラクション	lp_supply	ボルトバランス	蓄積フィーフィールド	observation
Initialize	+ init LP	+ init_amount_{0,1}	0	init
InitializeWithPermission	+ init LP	+ init_amount_{0,1}	0	init
Deposit	+	+ both	—	—
Withdraw	−	− both	—	—
SwapBaseInput	—	+ in, − out	+ trade_fee をプロトコル/ファンドに分割；有効な場合 + creator_fee	+ （インターバル経過時）
SwapBaseOutput	—	+ in, − out	+ trade_fee をプロトコル/ファンドに分割；有効な場合 + creator_fee	+ （インターバル経過時）
CollectProtocolFee	—	−（プロトコルバケット分）	protocol_* → 0	—
CollectFundFee	—	−（ファンドバケット分）	fund_* → 0	—
CollectCreatorFee	—	−（クリエイターバケット分）	creator_* → 0	—
UpdatePoolStatus	—	—	—	—

​

次へ進む

• /ja/products/cpmm/code-demos — 上記の実行可能 TypeScript サンプル。
• /ja/reference/error-codes — 完全 Anchor エラーテーブル。
• /ja/products/cpmm/fees — CollectProtocolFee / CollectFundFee / CollectCreatorFee が回収するフィー蓄積モデル。

ソース：

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