> 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/id/produk/oracle-gateway.md).

# Gateway Oracle

Pyth dan feed harga Switchboard di balik AggregatorV3Interface Chainlink.

Oracle Gateway mengekspos feed harga asli Solana (Pyth, Switchboard V3) melalui Chainlink `AggregatorV3Interface`, sehingga protokol Ethereum yang dipindahkan ke Rome tetap menggunakan kode integrasi oracle yang sudah ada. **Oracle Gateway V2 diterapkan di Hadrian dan Rubicon**, meskipun registry hanya mencantumkan alamat feed untuk Hadrian, dan portal pelanggan menangani pendaftaran. Sebuah keeper yang dijalankan Rome menyegarkan feed cached dan book, tetapi tidak setiap feed selalu segar pada setiap saat — [feed mana yang merespons hari ini](#which-feeds-answer-today) dijelaskan di bawah. Adapter, factory, dan model keeper dibahas dalam [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) repo.

> **Pratinjau.** Oracle Gateway belum diaudit. Portal juga menyatakan hal yang sama: jangan gunakan ini dalam alur nilai produksi.

## Masalahnya

DeFi Ethereum mengharapkan Chainlink `AggregatorV3Interface`:

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

Penyedia oracle Solana (Pyth, Switchboard) memiliki format data yang berbeda. Tanpa penyesuaian, setiap protokol yang dipindahkan akan memerlukan kode oracle khusus.

## Solusinya

Oracle Gateway V2 men-deploy kontrak adapter ringan yang:

1. Membaca data harga langsung dari akun Pyth atau Switchboard di Solana (pembacaan lintas-state, bukan CPI)
2. Mengurai data on-chain
3. Menormalkan harga ke 8 desimal
4. Mengekspos Chainlink standar `AggregatorV3Interface`

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

// Antarmuka yang sama seperti Chainlink di Ethereum
(, int256 price,,,) = IAggregatorV3Interface(ADAPTER).latestRoundData();
// harga = SOL/USD pada 8 desimal (mis. 15000000000 = $150.00)
```

## Gunakan feed dalam tiga langkah

1. **Tentukan alamat adapter dari registry** — jangan pernah hardcode:

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

Registry diinstal dari GitHub (`npm install github:rome-protocol/rome-registry#v0.2.0`). Kunci feed membawa sufiks yang menunjukkan jenis adapter di belakangnya; lihat [Kunci feed di registry](#feed-keys-in-the-registry) sebelum Anda memilih salah satunya.

2. **Baca** dengan antarmuka yang sudah digunakan protokol Anda — `IAggregatorV3Interface(solUsd).latestRoundData()`. Feed yang kedaluwarsa atau belum diinisialisasi **revert** alih-alih menyajikan harga yang membeku.
3. **Beberapa feed sekaligus?** `BatchReader.getLatestPrices(adapters[])` (Hadrian, registry v0.2.0: `0x2869f0a96572e7fb15036656e9a32fd17346499b`) — dan `getFeedHealth(adapters[])` sebelum Anda bergantung padanya. Adapter cached membuat setiap konsumen membaca sebuah `SLOAD`, sehingga transaksi multi-feed (pinjaman multi-collateral, tampilan portofolio) tetap murah.

[cardo](https://github.com/rome-protocol/cardo) membaca feed ini di Hadrian. Karena antarmukanya persis `AggregatorV3Interface`, protokol kelas Compound dan Aave dapat menggunakan feed ini tanpa perubahan kode oracle — arahkan konfigurasi price-feed mereka ke alamat adapter.

## Jenis adapter

* **PythPullAdapter** — membaca akun harga Pyth (harga, confidence, EMA, waktu publikasi).
* **SwitchboardV3Adapter** — membaca akun agregator Switchboard (harga, stempel waktu; tanpa EMA).
* **Adapter CachedPyth / CachedFeed** — varian cached-track untuk pembacaan yang efisien CU.
* **BookFeedAdapter** — tampilan hanya-baca yang kompatibel dengan Chainlink atas satu entri dari sebuah `PriceBook` kontrak. Book menyimpan harga untuk semua feed yang terdaftar dan disegarkan secara batch (penyegarannya permissionless); adapter tiap feed tidak menyimpan cache sendiri. Entri yang dijeda langsung revert dengan `AdapterPaused`, alih-alih menunggu hingga kedaluwarsa.

Adapter di-deploy sebagai clone minimal-proxy EIP-1167: `OracleAdapterFactory` meng-clone adapter Pyth, Switchboard, dan cached, dan setiap `PriceBook` meng-clone miliknya sendiri `BookFeedAdapter` saat sebuah feed didaftarkan. Mereka mengekspos antarmuka yang diperluas bersama `AggregatorV3Interface` (`latestPriceData`, `maxStaleness`, `oracleType`, dan sebuah `metadata()` permukaan yang digunakan untuk pemeriksaan kesehatan).

## Kunci feed di registry

`getOracle(chainId).feeds` memiliki beberapa kunci per aset. Sufiks pada kunci menamai jenis adapter:

| Kunci                | Jenis adapter                        | Cara membacanya                                                                           |
| -------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------- |
| `SOL/USD`            | Pyth langsung (`PythPullAdapter`)    | Mengurai akun Pyth pada setiap pemanggilan.                                               |
| `SOL/USD-BOOK`       | `BookFeedAdapter`                    | Membaca sebuah `PriceBook` entri yang disegarkan oleh keeper.                             |
| `SOL/USD-CACHED`     | Cached (membungkus feed lain)        | Membaca harga tersimpan yang disegarkan oleh keeper.                                      |
| `SOL/USD-CACHEDPYTH` | Pyth cached (`CachedPythAdapter`)    | Membaca harga tersimpan yang disegarkan oleh keeper.                                      |
| `SOL/USD-SB`         | Switchboard (`SwitchboardV3Adapter`) | Mengurai akun Switchboard pada setiap pemanggilan. Registry menandai entri ini `pensiun`. |

Mana yang akan digunakan bergantung pada chain. Periksa bagian berikutnya terlebih dahulu.

### Feed mana yang merespons hari ini

Ini adalah hasil dari `latestRoundData()` pemanggilan read-only pada feed yang tercantum di registry v0.2.0, dilakukan saat halaman ini ditulis. Kesegaran feed berubah dari menit ke menit di devnet, jadi perlakukan ini sebagai snapshot dan jalankan pemanggilan yang sama pada feed yang ingin Anda gunakan.

* **Hadrian.** Feed langsung sering kedaluwarsa: dalam pemeriksaan berulang sebagian besar di antaranya (BONK, BTC, ETH, JITOSOL, JTO, JUP, MSOL, USDC, USDT) revert dengan `StalePriceFeed` setiap kali, dan `SOL/USD` merespons pada beberapa pemanggilan dan tidak pada yang lain.  `-BOOK` feed adalah yang paling andal dan merespons pada setiap pemanggilan untuk setiap aset kecuali JTO, yang feed `-BOOK` revert karena kedaluwarsa. Setiap `-CACHED` dan `-CACHEDPYTH` feed revert dengan `UninitializedPriceFeed` (tidak ada yang menyegarkan mereka), dan `SOL/USD-SB` revert dengan `StalePriceFeed`. Di Hadrian, utamakan `-BOOK` feed, dan jalankan `latestRoundData()` pada feed yang Anda pilih sebelum Anda bergantung padanya.
* **Rubicon.** Registry tidak mencantumkan feed oracle untuk Rubicon, jadi halaman ini tidak membahasnya. Factory di-deploy di sana (lihat [Alamat yang di-deploy](#deployed-addresses)) dan adapter pertamanya merespons, tetapi cari alamat feed dari factory (`adapterCount()` dan `allAdapters(i)`) daripada dari registry.

Revert di sini adalah perilaku yang dirancang: feed yang kedaluwarsa atau belum diinisialisasi gagal dengan jelas alih-alih mengembalikan harga lama. Tangani di kontrak Anda.

## Kesegaran — oracle-keeper

Adapter menerapkan sebuah `maxStaleness` jendela: jika `block.timestamp - publishTime > maxStaleness`, pembacaan revert. Di mainnet Solana, Pyth menjalankan keeper produksi. Di devnet Solana (tempat Hadrian berada), pusher Pyth bersifat best-effort, jadi Rome menjalankan **oracle-keeper** sidecar untuk menjaga akun Pyth yang mendasarinya tetap segar dan untuk menyegarkan feed cached dan book. Keeper ini tidak mencakup setiap feed di setiap chain pada setiap momen (lihat [feed mana yang merespons hari ini](#which-feeds-answer-today)).

Periksa kesehatan feed dengan `BatchReader.getFeedHealth` (yang membaca `metadata()`), bukan hanya `latestRoundData` — sebuah feed bisa dapat dijangkau tetapi kedaluwarsa.

## Portal pelanggan

Daftarkan feed dan konfigurasi konsumen per chain melalui [portal Oracle Gateway](https://oracle.testnet.romeprotocol.xyz/). Lihat [halaman portal](https://docs.rome.builders/id/aplikasi-di-rome/oracle-gateway.md) untuk cakupan yang dimilikinya.

## Alamat yang di-deploy

Alamat kanonik per-chain (factory, implementasi adapter, dan feed aktif) berada di [registry](https://github.com/rome-protocol/rome-registry/tree/main/chains). Factory utama, dari `aktif` entri registry v0.2.0 (versi 5.0.0 di Hadrian; alamat Rubicon adalah yang ada di [Contract Addresses](https://docs.rome.builders/id/referensi/contract-addresses.md) halaman); lihat [Membaca daftar kontrak](https://docs.rome.builders/id/referensi/contract-addresses.md#reading-the-contracts-list):

| Kontrak              | Hadrian                                      | Rubicon                                      |
| -------------------- | -------------------------------------------- | -------------------------------------------- |
| OracleAdapterFactory | `0x52b008771fc95b4674a4f3533570b3d223f27f68` | `0x6a1340dd86c3951b6f13d9001b3951d56a2fe581` |
| BatchReader          | `0x2869f0a96572e7fb15036656e9a32fd17346499b` | `0x580dc0ecb226530ee8a90b57e0f0cd2555fb4f0f` |

## Batasan

* **Tidak ada data ronde historis** — `getRoundData(roundId)` revert; hanya `latestRoundData()` didukung.
* **EMA Switchboard tidak didukung** — data EMA hanya untuk Pyth.
* **Kedaluwarsa per chain** — `maxStaleness` diatur per lingkungan saat inisialisasi: adapter langsung (membaca Pyth) default \~60 detik; adapter cached default 3600 detik (saat keeper menyegarkannya, frekuensinya jauh lebih sering dari itu).
* **Offset parser** divalidasi terhadap tata letak Pyth/Switchboard saat ini; perubahan tata letak memerlukan validasi ulang.

## Langkah Berikutnya

* [portal Oracle Gateway](https://docs.rome.builders/id/aplikasi-di-rome/oracle-gateway.md) — daftarkan feed, konfigurasi konsumen
* [Contract Addresses](https://docs.rome.builders/id/referensi/contract-addresses.md) — precompile dan alamat per chain


---

# 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/id/produk/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.
