> For the complete documentation index, see [llms.txt](https://docs.rome.builders/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rome.builders/ja/zhi-pin/oracle-gateway.md).

# Oracle Gateway

ChainlinkのAggregatorV3Interfaceの背後にあるPythとSwitchboardの価格フィード。

Oracle Gateway は、Solana ネイティブの価格フィード（Pyth、Switchboard V3）を Chainlink の `AggregatorV3Interface`、そのため Ethereum プロトコルを Rome に移植しても、既存のオラクル統合コードをそのまま使えます。 **Oracle Gateway V2 は Hadrian と Rubicon にデプロイされています**、ただしレジストリにフィードアドレスが載っているのは Hadrian のみで、登録はカスタマーポータルが担当します。Rome が運用する keeper は cached と book のフィードを更新しますが、すべてのフィードが常に最新というわけではありません — [どのフィードが今日応答するか](#which-feeds-answer-today) 以下で説明します。アダプター、ファクトリー、keeper モデルについては [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) リポジトリで扱っています。

> **プレビュー。** Oracle Gateway は監査されていません。ポータルにも同様の注意があります。プロダクションの資産フローでは使用しないでください。

## 問題

Ethereum の DeFi は Chainlink の `AggregatorV3Interface`:

```solidity
(, int256 price,,,) = priceFeed.latestRoundData();
```

Solana のオラクル提供元（Pyth、Switchboard）は異なるデータ形式を持っています。適応しなければ、移植された各プロトコルごとにカスタムのオラクルコードが必要になります。

## 解決策

Oracle Gateway V2 は、次のような軽量アダプターコントラクトをデプロイします：

1. Solana 上の Pyth または Switchboard アカウントから価格データを直接読み取る（CPI ではなく cross-state read）
2. オンチェーンデータを解析する
3. 価格を小数点以下 8 桁に正規化する
4. 標準の Chainlink を公開する `AggregatorV3Interface`

```solidity
import {IAggregatorV3Interface} from "@rome-protocol/rome-solidity/contracts/oracle/IAggregatorV3Interface.sol";

// Ethereum 上の Chainlink と同じインターフェース
(, int256 price,,,) = IAggregatorV3Interface(ADAPTER).latestRoundData();
// price = 8 桁小数の SOL/USD（例: 15000000000 = $150.00）
```

## 3 ステップでフィードを利用する

1. **レジストリからアダプターアドレスを解決する** — 決してハードコードしないでください：

```ts
import { getOracle } from "@rome-protocol/registry";
const solUsd = getOracle(200010).feeds["SOL/USD"].address;
// Hadrian、registry v0.2.0: 0x567384ee000ca0418c386A73eC2b7466f9f99D6b
```

レジストリは GitHub（`npm install github:rome-protocol/rome-registry#v0.2.0`）からインストールされます。フィードキーには、その背後にあるアダプター種別を示すサフィックスが付きます。詳しくは [レジストリ内のフィードキー](#feed-keys-in-the-registry) を選んでください。

2. **それを読み取る** プロトコルがすでに使用しているインターフェースで — `IAggregatorV3Interface(solUsd).latestRoundData()`。古い、または未初期化のフィードは **reverts** 固定された価格を返すのではなく、リバートします。
3. **複数のフィードを同時に？** `BatchReader.getLatestPrices(adapters[])` （Hadrian、registry v0.2.0： `0x2869f0a96572e7fb15036656e9a32fd17346499b`）— そして `getFeedHealth(adapters[])` を、依存する前に確認してください。キャッシュ済みアダプターにより、各コンシューマーは単純な `SLOAD`を読むだけで済むため、複数フィードのトランザクション（複数担保借入やポートフォリオ表示）も低コストのままです。

[cardo](https://github.com/rome-protocol/cardo) は Hadrian 上でこれらのフィードを読み取ります。インターフェースがまさに `AggregatorV3Interface`なので、Compound や Aave 級のプロトコルはオラクルコードを変更せずにこれらのフィードを利用でき、価格フィード設定をアダプターアドレスに向ければよいだけです。

## アダプターの種類

* **PythPullAdapter** — Pyth の価格アカウント（price、confidence、EMA、publish time）を読み取ります。
* **SwitchboardV3Adapter** — Switchboard のアグリゲーターアカウント（price、timestamp；EMA なし）を読み取ります。
* **CachedPyth / CachedFeed アダプター** — CU 効率の高い読み取りのためのキャッシュ追跡版です。
* **BookFeedAdapter** — ある `PriceBook` コントラクトの1エントリに対する、読み取り専用の Chainlink 互換ビューです。book は登録済みフィードすべての価格を保持し、バッチで更新されます（更新はパーミッションレスです）。各フィードのアダプター自身はキャッシュを持ちません。停止中のエントリは即座に `AdapterPaused`でリバートし、古くなるまで待つことはありません。

アダプターは EIP-1167 の minimal proxy クローンとしてデプロイされます。 `OracleAdapterFactory` が Pyth、Switchboard、そしてキャッシュ済みアダプターをクローンし、各 `PriceBook` はそれぞれ独自の `BookFeedAdapter` を、フィード登録時にクローンします。これらは次の拡張インターフェースも公開します： `AggregatorV3Interface` (`latestPriceData`, `maxStaleness`, `oracleType`、および `metadata()` （ヘルスチェックで使われる surface）

## レジストリ内のフィードキー

`getOracle(chainId).feeds` は、資産ごとに複数のキーを持ちます。キーのサフィックスがアダプター種別を示します：

| キー                   | アダプター種別                             | 読み取り方法                                                   |
| -------------------- | ----------------------------------- | -------------------------------------------------------- |
| `SOL/USD`            | 直接 Pyth（`PythPullAdapter`)          | 呼び出しのたびに Pyth アカウントを解析します。                               |
| `SOL/USD-BOOK`       | `BookFeedAdapter`                   | を読み取ります。 `PriceBook` keeper が更新するエントリ。                   |
| `SOL/USD-CACHED`     | キャッシュ済み（別のフィードをラップ）                 | keeper が更新する保存済み価格を読み取ります。                               |
| `SOL/USD-CACHEDPYTH` | キャッシュ済み Pyth（`CachedPythAdapter`)   | keeper が更新する保存済み価格を読み取ります。                               |
| `SOL/USD-SB`         | Switchboard（`SwitchboardV3Adapter`) | 呼び出しのたびに Switchboard アカウントを解析します。レジストリはこれらのエントリに `廃止済み`. |

どれを使うかはチェーンによって異なります。まず次のセクションを確認してください。

### 今日応答するフィード

これらは読み取り専用の `latestRoundData()` 呼び出しであり、このページの作成時点で registry v0.2.0 に載っていたフィードに対して行った結果です。devnet ではフィードの鮮度が分単位で変わるため、これはスナップショットとして扱い、実際に使う予定のフィードで同じ呼び出しを実行してください。

* **Hadrian。** 直接フィードはしばしば古くなっています。繰り返し確認すると、その多く（BONK、BTC、ETH、JITOSOL、JTO、JUP、MSOL、USDC、USDT）は毎回 `StalePriceFeed` でリバートし、 `SOL/USD` いくつかの呼び出しでは応答し、他では応答しませんでした。 `-BOOK` のフィードが最も信頼でき、JTO を除くすべての資産で毎回応答しました。JTO の `-BOOK` フィードは古いとしてリバートしました。すべての `-CACHED` および `-CACHEDPYTH` フィードは `UninitializedPriceFeed` でリバートしました（何も更新されていません）。また、 `SOL/USD-SB` でリバートしました。 `StalePriceFeed`Hadrian では、 `-BOOK` フィードを優先し、 `latestRoundData()` 依存する前に、選んだフィードで実行してください。
* **Rubicon。** レジストリには Rubicon のオラクルフィードは載っていないため、このページでは扱いません。そこにもファクトリーはデプロイされています（ [デプロイ済みアドレス](#deployed-addresses)）し、最初のアダプターは応答しますが、フィードアドレスはファクトリーから取得してください（`adapterCount()` および `allAdapters(i)`）レジストリではなく。

ここでのリバートは意図された動作です。古い、または未初期化のフィードは古い価格を返さず、明示的に失敗します。コントラクト側で処理してください。

## 鮮度 — oracle-keeper

アダプターは `maxStaleness` のウィンドウを強制します。もし `block.timestamp - publishTime > maxStaleness`なら、読み取りはリバートします。Solana メインネットでは Pyth が本番 keeper を運用します。Solana devnet（Hadrian がある場所）では Pyth の push はベストエフォートなので、Rome は独自の **oracle-keeper** サイドカーを動かして、基盤となる Pyth アカウントを最新に保ち、cached と book のフィードを更新しています。ただし keeper は、すべてのチェーンのすべてのフィードを常にカバーするわけではありません（ [どのフィードが今日応答するか](#which-feeds-answer-today)).

フィードの健全性は次で確認してください： `BatchReader.getFeedHealth` （各アダプターの `metadata()`） `latestRoundData` — フィードには到達できても、古い場合があります。

## カスタマーポータル

フィードを登録し、チェーンごとにコンシューマーを設定するには [Oracle Gateway ポータル](https://oracle.testnet.romeprotocol.xyz/)をご利用ください。 [ポータルページ](https://docs.rome.builders/ja/romenoapuri/oracle-gateway.md) で、対象範囲を確認してください。

## デプロイ済みアドレス

チェーンごとの正規アドレス（ファクトリー、アダプター実装、および稼働中のフィード）は、 [registry](https://github.com/rome-protocol/rome-registry/tree/main/chains)にあります。主要なファクトリーは、 `live` registry v0.2.0 のエントリ（Hadrian では version 5.0.0；Rubicon のアドレスは [Contract Addresses](https://docs.rome.builders/ja/rifarensu/contract-addresses.md) ページ上のものです）にあります。 [contracts リストを読む](https://docs.rome.builders/ja/rifarensu/contract-addresses.md#reading-the-contracts-list):

| コントラクト               | Hadrian                                      | ルビコン                                         |
| -------------------- | -------------------------------------------- | -------------------------------------------- |
| OracleAdapterFactory | `0x52b008771fc95b4674a4f3533570b3d223f27f68` | `0x6a1340dd86c3951b6f13d9001b3951d56a2fe581` |
| BatchReader          | `0x2869f0a96572e7fb15036656e9a32fd17346499b` | `0x580dc0ecb226530ee8a90b57e0f0cd2555fb4f0f` |

## 制約

* **過去のラウンドデータはありません** — `getRoundData(roundId)` はリバートします。サポートされているのは `latestRoundData()` のみです。
* **Switchboard EMA はサポートされていません** — EMA データは Pyth 専用です。
* **チェーンごとの stale 許容時間** — `maxStaleness` は起動時に環境ごとに設定されます。直接（Pyth 読み取り）アダプターの既定値は約 60 秒、キャッシュ済みアダプターの既定値は 3600 秒です（keeper が更新している場合は、それよりはるかに頻繁に更新されます）。
* **パーサーのオフセット** は現在の Pyth/Switchboard のレイアウトに対して検証されます。レイアウトが変わった場合は再検証が必要です。

## 次は何か

* [Oracle Gateway ポータル](https://docs.rome.builders/ja/romenoapuri/oracle-gateway.md) — フィードを登録し、コンシューマーを設定する
* [Contract Addresses](https://docs.rome.builders/ja/rifarensu/contract-addresses.md) — プリコンパイルとチェーンごとのアドレス


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rome.builders/ja/zhi-pin/oracle-gateway.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
