Oracle Gateway

Feed harga Pyth dan Switchboard di balik Chainlink AggregatorV3Interface.

Oracle Gateway mengekspos umpan harga native Solana (Pyth, Switchboard V3) melalui AggregatorV3Interface, jadi protokol Ethereum yang dipindahkan ke Rome tetap menggunakan kode integrasi oracle yang sudah ada. Oracle Gateway V2 sudah aktif di setiap chain publik, dengan keeper yang menjamin kesegaran feed dan portal pelanggan untuk pendaftaran. Adapter, factory, dan model keeper dibahas di rome-oracle-gateway repositori.

Masalahnya

DeFi Ethereum mengharapkan AggregatorV3Interface:

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

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

Solusinya

Oracle Gateway V2 men-deploy kontrak adapter ringan yang:

1. Membaca data harga langsung dari akun Pyth atau Switchboard di Solana (cross-state reads, bukan CPI)

2. Mengurai data on-chain

3. Menormalisasi harga ke 8 desimal

4. Mengekspos standar Chainlink AggregatorV3Interface

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)

Menggunakan sebuah feed dalam tiga langkah

1. Menyelesaikan alamat adapter dari registry — jangan pernah di-hardcode:

import { getOracle } from "@rome-protocol/registry";
const solUsd = getOracle(200010).feeds["SOL/USD"].address;
// Hadrian saat ini: 0x76b92646D63FB1AFEa687C7Dac48b437bF99C1B4

1. Baca dengan antarmuka yang sudah digunakan protokol Anda — IAggregatorV3Interface(solUsd).latestRoundData(). Feed yang kedaluwarsa atau belum diinisialisasi melakukan revert daripada menyajikan harga yang membeku.

2. Beberapa feed sekaligus? BatchReader.getLatestPrices(adapters[]) (Hadrian: 0x306d670dff7f51ae33f263f5122bd2b18d98adc7) — dan getFeedHealth(adapters[]) sebelum bergantung padanya. Adapter cached membuat setiap konsumen membaca sebuah SLOAD, sehingga transaksi multi-feed (pinjaman multi-agunan, tampilan portofolio) tetap murah.

cardo mengonsumsi feed ini di produksi saat ini. Karena antarmukanya persis AggregatorV3Interface, protokol kelas Compound dan Aave drop-in — arahkan konfigurasi price-feed mereka ke alamat adapter; kode oracle mereka tidak perlu diubah sama sekali.

Jenis adapter

• PythPullAdapter — membaca akun harga Pyth (harga, confidence, EMA, waktu publikasi).

• SwitchboardV3Adapter — membaca akun aggregator Switchboard (harga, timestamp; tanpa EMA).

• CachedPyth / CachedFeed adapters — varian cached-track untuk pembacaan yang efisien CU.

Adapter di-deploy sebagai klon minimal-proxy EIP-1167 oleh OracleAdapterFactory dan mengekspos antarmuka yang diperluas bersama AggregatorV3Interface (latestPriceData, maxStaleness, oracleType, serta metadata() yang digunakan untuk pemeriksaan kesehatan).

Kesegaran — oracle-keeper

Adapter menerapkan sebuah maxStaleness jendela: jika block.timestamp - publishTime > maxStaleness, pembacaan melakukan revert. Di mainnet Solana, Pyth menjalankan keeper produksi. Di devnet Solana (tempat chain publik berada), pusher Pyth bersifat best-effort, jadi Rome menjalankan oracle-keeper sidecar sendiri untuk menjaga akun Pyth yang mendasarinya tetap segar. Kesegaran dipantau dan diberi peringatan.

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

Portal pelanggan

Daftarkan feed dan konfigurasikan konsumen per chain melalui portal Oracle Gateway. Lihat halaman portal untuk cakupan yang dibahas.

Alamat yang dideploy

Alamat kanonik per chain (factory, implementasi adapter, dan feed yang aktif) berada di registry. Factory utama:

Kontrak	Hadrian	Martius
OracleAdapterFactory	0xe68e7bc697010c73f1798b356f8ae2f0ba1319db	0xbc06fe9603a02ff4aead265c253f5c6303ee5fbb
BatchReader	0x306d670dff7f51ae33f263f5122bd2b18d98adc7	0xc5e6d932bfd2b4da27643848063905f46861fae8

Batasan

• Tidak ada data ronde historis — getRoundData(roundId) melakukan revert; hanya latestRoundData() yang didukung.

• EMA Switchboard tidak didukung — data EMA hanya untuk Pyth.

• Kedaluwarsa per chain — maxStaleness ditetapkan per lingkungan saat penyiapan: adapter langsung (membaca Pyth) default sekitar 60 detik; adapter cached default 3600 detik (keeper menyegarkan jauh lebih sering — sekitar 25 detik di devnet/testnet saat ini).

• Offset parser divalidasi terhadap layout Pyth/Switchboard saat ini; perubahan layout memerlukan validasi ulang.

Selanjutnya

• portal Oracle Gateway — daftarkan feed, konfigurasikan konsumen

• Alamat Kontrak — precompile dan alamat per chain