> ## 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.

# 管理者キーとマルチシグ

> Raydium プログラム全体の管理者権限の概要 — 各管理者が実行できること、マルチシグの構成、そして各ロールを現在誰が保有しているかをオンチェーンで確認する方法。

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

  [英語版を表示 →](/security/admin-and-multisig)
</Info>

<Info>
  Raydium の全プログラムには、少なくとも 1 つの特権ロールがあります。プログラムをアップグレードしたり、新しいコンフィグを作成したり、プロトコル手数料を引き出したりできるキーです。これらのロールが行える操作を最小化し（さらに遅延付きマルチシグで保護する）ことが、管理者キーが侵害された場合の主要な防衛策です。このページでは各ロールとその実際の保護方法をまとめています。
</Info>

## プログラム別ロール一覧

### AMM v4

| ロール          | 権限アドレス              | 実行できること                 |
| ------------ | ------------------- | ----------------------- |
| プログラムアップグレード | Squads マルチシグ（3/4）   | 新しいプログラムバイトコードのデプロイ     |
| プール管理者       | Treasury マルチシグ（3/5） | プールのステータス切替、既存プールの手数料更新 |

### CPMM

| ロール           | 権限アドレス              | 実行できること                       |
| ------------- | ------------------- | ----------------------------- |
| プログラムアップグレード  | Squads マルチシグ（3/4）   | 新しいプログラムバイトコードのデプロイ           |
| AmmConfig 管理者 | Treasury マルチシグ（3/5） | 新規 AmmConfig（手数料ティア）の作成、既存の切替 |
| プール作成手数料の受取先  | Treasury マルチシグ（3/5） | プール作成時の一回限りの手数料の受取            |

### CLMM

| ロール                          | 権限アドレス                           | 実行できること                                                                                                                                                                                                                                                    |
| ---------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| プログラムアップグレード                 | Squads マルチシグ（3/4）                | 新しいプログラムバイトコードのデプロイ                                                                                                                                                                                                                                        |
| AmmConfig 管理者                | Treasury マルチシグ（3/5）              | AmmConfig の作成・変更                                                                                                                                                                                                                                           |
| DynamicFeeConfig 管理者         | Treasury マルチシグ（3/5）              | `CreateDynamicFeeConfig` / `UpdateDynamicFeeConfig` — `CreateCustomizablePool` 呼び出しが選択できる動的手数料ティアの調整                                                                                                                                                       |
| `limit_order_admin`（プログラム全体） | **オフチェーンの運用ホットウォレット（マルチシグではない）** | オーナーに代わってリミットオーダーを決済・クローズする。キーパーキーはプログラム全体で単一の定数（メインネットとデブネットで異なる値）であり、`SettleLimitOrder` / `CloseLimitOrder` では `signer == limit_order.owner \|\| signer == limit_order_admin::ID` でチェックされる。出力は常に元のオーナーの ATA に送られる。キーパーは資金のリダイレクト、オーダーの変更、新規オーダーの発行はできない。 |

`limit_order_admin` は意図的に権限を絞った運用ロールです。オフチェーンのキーパーが、オーナーがオンラインでなくても約定済みオーダーをスイープできるように設けられています。キーパーキーはホット（キーパー VM 上に存在）であり、上記のマルチシグとは独立してローテーションされます。キーパー権限が行える操作は具体的に以下のみです。

* `SettleLimitOrder` — オーダーの指値価格で、約定済み出力を**オーナーの** ATA に送付する。
* `CloseLimitOrder` — 完全決済済みオーダーのアカウントをクローズしてレントを回収する（レントはオーダーオーナーに送られる）。

`OpenLimitOrder`、`IncreaseLimitOrder`、`DecreaseLimitOrder` の呼び出し、プールフィールドの変更、その他の命令への署名はできません。これらの制約は命令の `Accounts` 構造体内のシードおよび `has_one` 制約によってオンチェーンで強制されます。キーパーが侵害された場合、最悪でもキーパーが利用不能になる（オーダーはオーナー自身が決済するまで保留状態になる）か、正当に約定可能なオーダーを順序外で決済・クローズするにとどまります。オーナーがすでに承認した送先以外にユーザー資金を移動させることはできません。

### Farm v6

| ロール            | 権限アドレス            | 実行できること                        |
| -------------- | ----------------- | ------------------------------ |
| プログラムアップグレード   | Squads マルチシグ（3/4） | 新しいプログラムバイトコードのデプロイ            |
| ファーム作成者（各ファーム） | ファームの作成者ウォレット     | 報酬ボールトへの資金追加、スケジュール延長、未使用報酬の回収 |

個々のファームにプロトコル管理者は存在しません。各ファームの作成者は自身のファームのみを制御でき、その権限は制限されています（ユーザーのステークの引き出しや、ステーキングミントの変更はできません）。

### LaunchLab

| ロール            | 権限アドレス            | 実行できること                                    |
| -------------- | ----------------- | ------------------------------------------ |
| プログラムアップグレード   | Squads マルチシグ（3/4） | 新しいプログラムバイトコードのデプロイ                        |
| ローンチ作成者（各ローンチ） | ローンチの作成者ウォレット     | グラデュエーション後の作成者手数料の回収、未グラデュエーションのカーブ残余の引き出し |

ローンチにはカーブの変更や調達資金の差し押さえができるプロトコル管理者は存在しません。

## プログラムアップグレード権限

Raydium のプログラムは標準的な Solana の **BPF Loader v3** アップグレードメカニズムを使用しています。全プログラムのアップグレード権限は 3/4 Squads マルチシグが持ちます。

3/4 を採用している理由：1 人の署名者が侵害されても不十分な水準を確保しつつ、正当なアップグレードの調整が現実的に行える人数です。4 つの権限はそれぞれ独立したエアギャップ・コールドデバイス署名者であり、コアチームメンバーが保有しています。順次署名により同一トランザクションへの並列承認を防ぎ、トランザクションには固定の有効期限が設けられています。マルチシグの操作は **Solana の STRIDE プログラム（Asymmetric Research）** との連携のもと定期的にレビューされます。

### アップグレード権限の削除について

Raydium はいずれのプログラムのアップグレード権限も null に設定していません。バグ修正、Token-2022 などの拡張追加、インテグレーションのずれ修正のためにプログラムをアップグレード可能な状態に保つことが原則です。トレードオフとして、ユーザーは 3/4 マルチシグが十分にレビューされたアップグレードのみをデプロイするという信頼に依存します。

不変性を求めるユーザー向けには、旧来の AMM v4 プログラムが最後の監査以降安定しており、18 ヶ月間アップグレードがゼロです。権限は残存していますが、そのコードパスは実質的にフリーズ状態です。

## AmmConfig 権限

新しい AmmConfig の作成は権限制御されており、3/5 Treasury マルチシグが新しい手数料ティアとティック間隔を承認します。既存のプールは PDA によって AmmConfig を参照しており、プールの手数料ティアは AmmConfig の内容に従います。

**管理者は既存の AmmConfig を変更できますか？** 技術的には可能です。`updateAmmConfig` は管理者が呼び出せます。ただし実際には、デプロイ済みの AmmConfig を変更するとその設定を使用する全プールの経済条件が無通知で変わってしまうため、避けています。プロトコルのポリシーとして、変更が必要な場合は新しい AmmConfig を作成してマイグレーションします。

**管理者はコンフィグを通じてプロトコル手数料を盗めますか？** できません。AmmConfig には手数料パラメータが含まれていますが、プロトコル手数料の受取先アドレスは含まれておらず、それはプールごとに独立した不変のアドレスです。

## プロトコル手数料の請求

スワップ手数料の一部（コンフィグによって異なりますが、通常 25 bps のスワップ手数料のうち 3〜12 bps）がプロトコル手数料ボールトに蓄積されます。マルチシグはこの蓄積された手数料を引き出せます。LP のバランスがこれによって変わることはありません。これはプロトコルにあらかじめ割り当てられた取り分であり、LP の資金ではありません。

## ファーム作成者の権限

Farm v6 では、作成者に以下の権限が与えられます。

* 報酬ボールトへの資金追加（トークンの追加）
* スケジュールの延長（終了時刻を後ろにずらす）
* 終了時刻後に `withdrawReward` を呼び出して未使用ボールト残高を回収

ファーム作成者が**できないこと**：

* ステーキング済みユーザー LP の引き出し
* ステーキングミントの変更
* 排出レートの遡及的変更（`setRewards` による前向きの変更のみ可）
* ユーザーのハーベストの凍結

悪意のあるファーム作成者が引き起こせる最悪の事態は、ボールトの資金が不足してファームが枯渇することです。ユーザーの元本ステークは常に安全です。

## Squads マルチシグの設定

Raydium は異なるリスク面に対応するため、2 つの独立した Squads マルチシグを運用しています。いずれも [Squads Protocol](https://app.squads.so) の UI からオンチェーンで確認できます。

| マルチシグ            | 閾値      | タイムロック    | スコープ                                                                                                                                                                                                                                            |
| ---------------- | ------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **プログラムアップグレード** | **3/4** | **24 時間** | AMM v4、CPMM、CLMM、LaunchLab、Lock、AMM Routing、Stable Swap、およびレガシーの Farm/Staking プログラムに対する新しいプログラムバイトコードのデプロイを唯一担当する権限。[`app.squads.so/.../FytDr…ceZQK`](https://app.squads.so/squads/FytDrVzDybM1TwFQPGb8qaxZR7dBCzNeqT3vtQsceZQK/home) で確認可能。    |
| **Treasury**     | **3/5** | なし        | Treasury 資産、プロトコル収益、運営経費。現時点では AmmConfig の作成、プロトコル手数料のスイープ、プールパラメータの設定など、Raydium の限定的なプログラム管理権限も保有。[`v3.squads.so/dashboard/RVha…dHdtYz09`](https://v3.squads.so/dashboard/RVhaWTdGUGNjTnVFdmdIWk1DTXB3dzJGZW44b0xXQlNKemRnQ3NYM0Rqd20=) で確認可能。 |

アップグレードマルチシグの運用特性：

* **24 時間タイムロック**。すべてのトランザクションに適用。本日承認されたアップグレードは 24 時間後以降にしか実行されないため、ユーザーは対応する時間があります。
* **エアギャップ・コールドデバイス署名。** コールドデバイスはネットワークカードが物理的に取り外されており、ハードウェアウォレットのみに接続し、別のホットデバイスから QR コードでトランザクションデータを読み取ります。
* **順次署名。** 1 台のコールドデバイスがトランザクションを生成・署名して初めて、次のコールドデバイスが署名プロセスを開始できます。これにより同一トランザクションへの競合・並列署名を防ぎます。
* **トランザクション有効期限。** すべてのトランザクションに固定の有効期限が設定されており、古いトランザクションは自動的に無効になります。
* **TOTP + 物理キーの強制。** トランザクション起動とオンチェーンブロードキャストに使用するホットデバイスで適用。
* **パブリックトランザクションキュー。** Squads UI で保留中のアップグレードを誰でも監視できます。

Treasury マルチシグにはタイムロックがありません。そのスコープは限定的であり、AmmConfig の作成や手数料のスイープなどのルーティン操作は同日中に実行する必要があるためです。Treasury マルチシグは上記のプログラム別テーブルに記載された限定的なプログラム管理権限も保有しており、これは暫定的な取り決めとしてプロジェクトのセキュリティパートナーとともに定期的にレビューされます。

## オンチェーンでの権限確認

プログラムの現在のアップグレード権限を確認する最もシンプルな方法：

```bash theme={null}
solana program show <PROGRAM_ID>
```

出力には以下が含まれます：

```
Program Id:          CPMMoo8L3F4NbTegBCKVNunggL7H1Zpdmwpwh8KMoZ0F
Owner:               BPFLoaderUpgradeab1e11111111111111111111111
ProgramData Address: <ProgramDataPDA>
Authority:           <EXPECTED_MULTISIG_ADDRESS>
Last Deployed In Slot: <slot>
Data Length: <n> bytes
```

`Authority` が期待される Squads マルチシグアドレスでない場合、何らかの問題があります。Raydium は期待される権限アドレスを [`reference/program-addresses`](/ja/reference/program-addresses) で公開しています。

AmmConfig / プール管理者ロールについては、オンチェーンアカウントを取得してデコードしてください：

```ts theme={null}
const config = await raydium.cpmm.getAmmConfig(configPda);
console.log("AmmConfig admin:", config.admin.toBase58());
// Expected: 3/5 treasury multisig.
```

## 権限変更の履歴

| 日付      | プログラム  | 変更内容                                    |
| ------- | ------ | --------------------------------------- |
| 2022-12 | AMM v4 | インシデント後、アップグレード権限をシングルシグから 3/4 マルチシグに移行 |
| 2023-02 | 全プログラム | すべての運用ロールを 3/5 Treasury マルチシグに統一        |
| 2023-11 | CLMM   | 露出を減らすため、報酬専用操作用の第二マルチシグを追加             |
| 2024-05 | CPMM   | 初日からマルチシグ権限でデプロイ                        |

## ユーザー側の考慮事項

ユーザー・LP・インテグレーターとして何をすべきか：

1. **大きな配分を行う前にアップグレード権限を確認する。** 公式ドキュメントに記載されたマルチシグと一致しているか確認してください。
2. **マルチシグのアクティビティを監視する。** [Squads UI](https://v4.squads.so) では保留中のトランザクションを確認できます。スケジュールされたアップグレードには 24 時間の猶予があるため、変更に同意できない場合はポジションを解消する時間があります。
3. **タイムロックを考慮した解約戦略。** オートコンパウンダーを運用している場合、解約パスが変更中の命令を必要としないことを確認してください。
4. **プログラムの不変性を前提にしない。** Raydium の全プログラムはアップグレード可能です。それを前提に計画を立ててください。

## インテグレーター向けの注意点

### 1. 権限アドレスのキャッシュ

アップグレード権限や管理者マルチシグアドレスをコードにハードコードしていて後でローテーションされると、検証が失敗します。[`reference/program-addresses`](/ja/reference/program-addresses) から実行時に取得するか、定期的に更新してください。

### 2. AmmConfig が安定していると仮定しない

新しい AmmConfig はいつでも作成される可能性があります。アグリゲーター・ルーターはコンフィグリスト全体を定期的に再取得してください（1 時間ごとで十分です）。

### 3. ファーム作成者による攻撃ベクター

信頼性の低いファームに入金する場合、作成者がファームを早期に終了して報酬ボールトを回収する可能性があります（ユーザーがまだステークしていない場合）。一度ユーザーがステークすると、プログラムによって按分権利が強制されます。回収できるのは合理的な終了後の残余分のみです。

## 関連リンク

* [`reference/program-addresses`](/ja/reference/program-addresses) — 正規の権限アドレス。
* [`security/attack-vectors`](/ja/security/attack-vectors) — 管理者侵害がどのように現れるか。
* [`ray/treasury`](/ja/ray/treasury) — Treasury および手数料回収アドレス。
* [`security/disclosure`](/ja/security/disclosure) — 管理者に関する疑わしい問題の報告。

参考リソース：

* [Squads Protocol](https://v4.squads.so) — マルチシグ UI。
* [Solana BPF Loader ドキュメント](https://docs.solana.com/developing/runtime-facilities/programs#bpf-loader) — アップグレードメカニズム。
