CPMM インストラクション

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

このページは権威的なインストラクション・リファレンスです。これらのインストラクションを実際に構成するコードについては、products/cpmm/code-demos を参照してください。エラーコードの意味については reference/error-codes を参照してください。

インストラクション一覧

ディスクリミネータ名	署名者	機能
`Initialize`	プール作成者	2 つのミントと `AmmConfig` から新しい CPMM プールを作成します。パーミッションレス。誰でも呼び出せます。新しいプールに `enable_creator_fee = false` をハードコードします。`pool_state` アカウントは、正規の PDA またはランダムな新規キーペア（Initialize アカウントを参照）のいずれかです。
`InitializeWithPermission`	ペイヤー + `Permission` PDA の保有者	`Initialize` のパーミッション付きバリアント。呼び出し元（ペイヤー）は自身の公開鍵から派生した `Permission` PDA を所有する必要があります。プール作成をゲートする必要があるプラットフォーム（例：LaunchLab 卒業）で使用されます。呼び出し元が `creator_fee_on`（`BothToken` / `OnlyToken0` / `OnlyToken1`）をピン留めでき、新しいプールに `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`	蓄積されたクリエイターフィーを回収します（クリエイターフィーが有効な場合）。
`CollectCreatorFeePermissionless`	任意のペイヤー	すべての蓄積されたクリエイターフィーを `pool_creator` の正規トークンアカウントに回収します。ペイヤーは不足している受取人 ATA を作成できますが、転送をリダイレクトすることはできません。
`UpdatePoolStatus`	`admin`	ビットマスクを使用してプール上の特定の操作を一時停止・再開します。
`UpdateAmmConfig`	`admin`	`AmmConfig` のフィー率またはプロトコル・ファンド所有者を変更します。
`CreateAmmConfig`	`admin`	新しいフィーティア（新しい `AmmConfig` アカウント）を作成します。
`CreatePermissionPda`	`admin` または委任されたパーミッション PDA 作成者	特定の権限が `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）。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（100 ラムポートの LP トークン）の 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 より前に拒否されます。デポジットと引き出しはすぐに機能します。

一般的なエラー（完全なリストは reference/error-codes を参照）

InvalidInput — ミントがソートされていない、または同一のミント。
NotSupportMint — ブロックされた Token-2022 拡張機能。
ExceededSlippage — まれに。init_amount_0/1 が小数点の不一致により 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 トークンがバーンされるため、lp_mint は書き込み可能です。）計算

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 ではなく、ユーザーの方向による入力 → 出力です。プログラムはミントをマッチングすることでどのボールトがどれであるかを判断します。計算 — products/cpmm/math を参照してください。 前提条件

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

一般的なエラー

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

`SwapBaseOutput`

正確な出力スワップ。引数

max_amount_in:  u64
amount_out:     u64

アカウント — SwapBaseInput と同じ。計算 — 逆曲線と天井。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 によって署名されます。完全な creator_fees_token_0 および creator_fees_token_1 残高をクリエイターのトークンアカウントに転送し、両方のカウンターをゼロにします。両方のカウンターがゼロの場合、NoFeeCollect を返します。

`CollectCreatorFeePermissionless`

誰でもクリエイターフィー回収をトリガーできます。インストラクションは常に完全な蓄積残高を pool_state.pool_creator が所有する正規関連トークンアカウントに送信します。呼び出し元は別のクリエイターまたは宛先を選択できません。どちらかの ATA が不足している場合、ペイヤーがその作成に資金を提供します。元の CollectCreatorFee は呼び出し可能なままなので、既存のクライアントは互換性を保ちます。引数 — なし。 アカウント

#	名前	W	S	注記
1	`payer`	W	S	任意の署名者。不足しているクリエイター ATA に資金を提供します。
2	`creator`			`pool_state.pool_creator` と等しい必要があります。署名しません。
3	`authority`			CPMM グローバルボールト権限 PDA。
4	`pool_state`	W		蓄積されたクリエイターフィーカウンターを保有します。
5	`token_0_vault`	W		プールのトークン 0 ボールトと一致する必要があります。
6	`token_1_vault`	W		プールのトークン 1 ボールトと一致する必要があります。
7	`vault_0_mint`			`token_0_vault.mint` と一致する必要があります。
8	`vault_1_mint`			`token_1_vault.mint` と一致する必要があります。
9	`creator_token_0`	W		`vault_0_mint` のクリエイターの正規 ATA。不足している場合は作成されます。
10	`creator_token_1`	W		`vault_1_mint` のクリエイターの正規 ATA。不足している場合は作成されます。
11	`token_0_program`			SPL Token または Token-2022、トークン 0 に一致します。
12	`token_1_program`			SPL Token または Token-2022、トークン 1 に一致します。
13	`associated_token_program`			不足している受取人 ATA を作成します。
14	`system_program`			`payer` からアカウント作成に資金を提供します。

効果

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

`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 マルチシグです。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	—
`CollectCreatorFeePermissionless`	—	− （クリエイターバケットで）	`creator_*` → 0	—
`UpdatePoolStatus`	—	—	—	—

次のステップ

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

ソース：

プロダクト

アルゴリズム

CPMM インストラクション

インストラクション一覧

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

状態変化マトリックス

次のステップ

​インストラクション一覧

​Initialize

​Deposit

​Withdraw

​SwapBaseInput

​SwapBaseOutput

​CollectProtocolFee

​CollectFundFee

​CollectCreatorFee

​CollectCreatorFeePermissionless

​UpdatePoolStatus

​CreateAmmConfig

​UpdateAmmConfig

​状態変化マトリックス

​次のステップ

インストラクション一覧

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

状態変化マトリックス

次のステップ