Documentation Index
Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
Use this file to discover all available pages before exploring further.
このページは AI による自動翻訳です。すべての内容は英語版を正とします。英語版を表示 →
このページでは各アカウントのレイアウトと役割を説明します。シード値は正規のものであり、
reference/program-addresses に一覧があります。CLMMプールはCPMMプールよりもアカウント数が多くなります。これはリクイディティがティック範囲にわたってスパースに格納されるためであり、そのスパース性の理解がこのページの中心的な内容です。アカウント一覧
稼働中のCLMMプールは以下のアカウントファミリーで構成されます。2つのミントとそのボルトを除き、すべてCLMMプログラムが所有します。| アカウント | 用途 | プールあたりの数 |
|---|---|---|
AmmConfig | 手数料ティア:取引手数料率、プロトコル分配、ファンド分配、デフォルトのティック間隔。このティアのすべてのプールで共有。 | 1(共有) |
PoolState | 現在の sqrt_price_x64、現在のティック、総リクイディティ、手数料グロース全体値、リワード情報、オブザベーションポインタ。 | 1 |
TickArrayState | TICK_ARRAY_SIZE 個の隣接ティックをまとめたブロック。必要に応じて初期化される。 | 0 ≤ N ≤ range |
TickArrayBitmapExtension | PoolState のインラインビットマップの範囲外にあるティック配列の存在を追跡するオーバーフロービットマップ。 | 0 または 1 |
PersonalPositionState | LP ポジション 1 つにつき 1 つ。範囲、リクイディティ、最終確認済みの手数料・リワードグロースを保持。Authority = NFT オーナー。 | ポジションごとに 1 |
| ポジション NFT ミント | 供給量 1 のミント。PersonalPositionState に関連付けられる。NFT を転送するとポジションが移転する。 | ポジションごとに 1 |
ObservationState | TWAP 用の価格オブザベーションのリングバッファ。 | 1 |
token_0_vault、token_1_vault | プールの残高を保持するトークンアカウント。プールオーソリティが所有。 | 2 |
DynamicFeeConfig | 動的手数料メカニズムの再利用可能なパラメータセット。create_customizable_pool で作成されたプールがオプトイン可能。管理者が管理。 | 共有(インデックスごと) |
LimitOrderState | 未約定の指値注文 1 つにつき 1 つ。オーナー、ティック、売買方向、合計金額、決済済み出力のスナップショットを記録。 | 注文ごとに 1 |
LimitOrderNonce | (wallet, nonce_index) ごとのカウンター。一意の注文 PDA を導出するために使用。 | (wallet, index) ごとに 1 |
PoolState
プールのライブ状態。スワップのたびにすべてのポジション変更のたびに参照されます。
sqrt_price_x64とtick_currentはプールの価格状態です。スワップのたびに同時に更新されます。tick_currentはlog_{1.0001}(price)の切り捨て値です。liquidityはアクティブなリクイディティ、つまりtick_currentを含む範囲のすべてのポジションのL値の合計です。スワップがティックを跨ぐたびに、またポジションが開かれ・閉じられ・サイズ変更されるたびに変化します。fee_growth_global_{0,1}_x64は、プール全体の履歴にわたってリクイディティ単位あたりに累積された手数料です。ポジションはこれを参照して自分の取り分を計算します。tick_spacingは初期化時にAmmConfigから固定され、変更されません。どのティックインデックスがポジションのエンドポイントとして許可されるかを決定します。tick_array_bitmapはスポット価格周辺のよく使われるティック範囲をカバーするインラインビットマップです。ポジションが遠くまで届くプールでは、オーバーフロー追跡は別のTickArrayBitmapExtensionアカウントに格納されます。fee_onはプール作成時に固定されます。0(FromInput)はクラシックな Uniswap-V3 の動作を再現します。1と2はスワップ手数料を板の片側にルーティングします。トレードオフについてはproducts/clmm/feesを参照してください。dynamic_fee_infoは動的手数料サーチャージのボラティリティ状態を保持します。有効化されている場合、スワップのたびにAmmConfig.trade_fee_rateに加えてdynamic_fee_componentが再計算されます。レイアウトは以下のDynamicFeeInfoに記載しています。動的手数料を使用しないプールではこの構造体全体がゼロになります。
AmmConfig
GET https://api-v3.raydium.io/main/clmm-config で最新情報を確認してください):
| Index | trade_fee_rate | ティック間隔 | 主な用途 |
|---|---|---|---|
| 0 | 100(0.01%) | 1 | ステーブルペア、USDC/USDT |
| 1 | 500(0.05%) | 10 | 相関の高いブルーチップ |
| 2 | 2_500(0.25%) | 60 | 標準ペア |
| 3 | 10_000(1.00%) | 120 | ボラティリティの高いペアやロングテール |
protocol_fee_rate と fund_fee_rate は取引手数料に対する割合で、CPMM と同じ規則です。詳細は products/clmm/fees を参照してください。
TickArrayState
CLMMはティックごとに 1 つのレコードを格納しません。そうすると数十億のアカウントが必要になります。代わりに、TICK_ARRAY_SIZE 個の隣接する初期化済み・未初期化のティック(プログラムバージョンによって通常 60 または 88)を 1 つの TickArrayState にグループ化し、初めて使用されるときに遅延生成します。
order_phaseはコホート ID です。コホートが「すべて未約定」から「一部約定済み」に遷移するたびにインクリメントされます。orders_amountは現在(最新)のコホートの入力トークン合計です。part_filled_orders_remainingは進行中のスワップによって約定されつつある直前のコホートを追跡します。unfilled_ratio_x64はコホートに対して保持される Q64.64 の乗数です。スワップがコホートの X% を約定すると、この比率は(1 − X)で乗算されます。各未決注文は開設時に独自の(order_phase, unfilled_ratio_x64)スナップショットを保存するため、決済の計算はスナップショット同士の比較に帰着します。
- ポジションのエンドポイントティック t は
t % tick_spacing == 0を満たす必要があります。間隔外のポジションはプログラムに拒否されます。 - ティックの配列の位置は
floor(t / (TICK_ARRAY_SIZE * tick_spacing)) * (TICK_ARRAY_SIZE * tick_spacing)で求まります。 - ティック配列は遅延初期化されます。未初期化の配列に最初に触れるポジションまたはスワップが、レントを支払って配列を作成します。
- ティック配列はプログラムによってクローズされることはありません。一度割り当てられると、内部のすべてのティックが
liquidity_gross == 0に戻った後もプールの存続期間中は維持されます。後続のポジションやスワップは既存のアカウントを追加レントなしで再利用できます。ティック配列のクリーンアップを行うClosePosition主導のパスは存在しません。
TickArrayBitmapExtension
PoolState.tick_array_bitmap(インライン)は「スポット付近」の範囲(±1,024 ティック配列)をカバーします。その範囲外(極端なティック値)に対して、プログラムは拡張アカウントを管理します。
(MIN_TICK, MAX_TICK))には必要ですが、SDK が自動的に解決します。
ポジション
CLMMのポジションは、ミントを含む3 つのアカウントのバンドルです。ポジション NFT ミント
供給量 1 の SPL Token ミント。ミントのアドレスは決定論的な PDA であり、オーナーのウォレット内のポジション NFT はその単一トークンを保持する ATA に過ぎません。NFT を転送することでポジションが移転します。プログラムは、状態に格納された Pubkey ではなく、NFT の ATA 残高の現在の保有者に対してオーソリゼーションを紐付けます。PersonalPositionState
未決ポジション 1 つにつき 1 つ。NFT ミントをキーとします。
ProtocolPositionState(非推奨)
古い CLMM リリースでは、
(pool, tick_lower, tick_upper) ごとの集計ブックキーピングを ProtocolPositionState PDA に格納していました。新しいリリースではこのアカウントを作成も参照もしません。 OpenPosition / IncreaseLiquidity / DecreaseLiquidity のアカウントリストには ABI 互換性のために UncheckedAccount として残っていますが、プログラムは書き込みを行いません。オンチェーンに残っている既存のアカウントは残骸です。管理者は CloseProtocolPosition を呼び出してレントを回収できます。範囲集計のブックキーピングは現在、TickArrayState 内の 2 つのエンドポイントティック(liquidity_gross、liquidity_net、ティックごとの fee_growth_outside_* / reward_growths_outside_x64)から直接導出されます。手数料グロースインサイドの計算式 fee_growth_inside = global − outside_lower − outside_upper は集計ポジションアカウントなしでも正しく機能します。オブザベーション
(tick_cumulative[t1] − tick_cumulative[t0]) / (t1 − t0) から区間の幾何平均価格を計算し、price = 1.0001 ** tick で価格を求めます。詳細は algorithms/clmm-math を参照してください。
DynamicFeeConfig と DynamicFeeInfo
動的手数料パラメータは 2 箇所に存在します。再利用可能なテンプレートである DynamicFeeConfig は管理者が管理し、オプトインしたプール間で共有されます。プールごとのランタイム状態である DynamicFeeInfo は PoolState に埋め込まれ、スワップのたびに更新されます。
DynamicFeeConfig
["dynamic_fee_config", index.to_be_bytes()]。create_dynamic_fee_config(管理者のみ)で作成し、update_dynamic_fee_config で変更します。enable_dynamic_fee = true で作成されたプールは、作成時にコンフィグの 5 つのキャリブレーションパラメータ(filter_period、decay_period、reduction_factor、dynamic_fee_control、max_volatility_accumulator)を自身の DynamicFeeInfo にスナップショットとして保存します。その後の DynamicFeeConfig への変更は既存のプールに遡及して影響しません。
DynamicFeeInfo(PoolState に埋め込み)
DynamicFeeConfig からコピーされたキャリブレーション値です。手数料の計算とデケイルールは products/clmm/math および products/clmm/fees に記載されています。
計算式で使用される定数:
| 定数 | 値 | 意味 |
|---|---|---|
VOLATILITY_ACCUMULATOR_SCALE | 10_000 | ボラティリティアキュムレータの粒度 |
REDUCTION_FACTOR_DENOMINATOR | 10_000 | reduction_factor の分母 |
DYNAMIC_FEE_CONTROL_DENOMINATOR | 100_000 | dynamic_fee_control の分母 |
MAX_FEE_RATE_NUMERATOR | 100_000 | 結果として得られる手数料率の上限(10%) |
LimitOrderState
未決の指値注文 1 つにつき 1 アカウント。
- オープン — ユーザーが
open_limit_orderを呼び出し、入力トークンのtotal_amountを預け入れます。注文はTickStateのコホートに紐付けられます。 - (任意)増減 —
increase_limit_orderはtotal_amountを追加し、decrease_limit_orderは未約定トークン(およびその時点までの決済済み出力)を返還します。 - 決済 — コホートが全部または一部約定された場合、オーナーまたは運用キーパーが
settle_limit_orderを呼び出してオーナーの ATA に出力トークンを送付します。 - クローズ —
unfilled_amount == 0になった後、アカウントをクローズできます。レントは常にownerに返還されます。
[owner.as_ref(), limit_order_nonce.key().as_ref(), limit_order_nonce.order_nonce.to_be_bytes().as_ref()]。注文 PDA は (owner, nonce_index, order_nonce) ごとに一意です。
LimitOrderNonce
(wallet, nonce_index) ごとのカウンター。1 人のユーザーが PDA の衝突なしに複数の指値注文パイプラインを並行して実行できるようにします。
[user_wallet.as_ref(), &[nonce_index]]。ほとんどのクライアントは nonce_index = 0 を使用し、order_nonce でカーディナリティを管理します。
キーアカウントの導出
reference/program-addresses と照合して確認してください。
ライフサイクル早見表
| イベント | 作成されるアカウント | 削除されるアカウント |
|---|---|---|
CreatePool | poolState、observation、token_0_vault、token_1_vault | — |
OpenPosition[WithToken22Nft] | NFT ミント + ATA、personalPosition、場合によって新規 tickArrayState、未作成の場合 tickArrayBitmapExtension | — |
IncreaseLiquidity | 場合によって新規 tickArrayState | — |
DecreaseLiquidity | — | ティックエントリーをクリアする場合あり(tickArrayState 自体はクローズされない) |
ClosePosition | — | NFT ミント、personalPosition |
SwapV2 | 場合によって新規 tickArrayState | — |
OpenLimitOrder | limitOrderState、必要に応じて limitOrderNonce(init-if-needed)、場合によって新規 tickArrayState | — |
IncreaseLimitOrder | — | — |
DecreaseLimitOrder | — | 注文が完全に消化された場合に limitOrderState をクローズ |
SettleLimitOrder | — | — |
CloseLimitOrder | — | limitOrderState(レント → owner) |
CreateDynamicFeeConfig | dynamicFeeConfig | — |
CreateCustomizablePool | poolState、observation、ボルト(CreatePool と同様)。enable_dynamic_fee = true の場合は dynamicFeeConfig をスナップショット。 | — |
CollectRewards | — | — |
UpdateRewardInfos | — | — |
CloseProtocolPosition(管理者) | — | 残骸 protocolPositionState(レント → 管理者) |
TickArrayState アカウントはプログラムによってクローズされることはありません。プールの存続期間中ずっとオンチェーンに残ります。一度初期化されたティック配列は、内部のすべてのティックが liquidity_gross == 0 に戻った後も存続します。既存のティック配列の再利用は無料で、追加レントが発生するのは一度も初期化されていない配列に最初に触れるポジションのみです。
参照先ガイド
- ティック数学とレンジの仕組み:
products/clmm/ticks-and-positions - スワップウォークと手数料グロース数学:
products/clmm/math - インストラクションのアカウントリスト:
products/clmm/instructions - 手数料とリワードの発生:
products/clmm/fees - 正規のプログラム ID とシード:
reference/program-addresses


