> 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/tr/urunler/oracle-gateway.md).

# Oracle Gateway

Chainlink'in AggregatorV3Interface'ının arkasında Pyth ve Switchboard fiyat akışları.

Oracle Gateway, Solana'ya özgü fiyat akışlarını (Pyth, Switchboard V3) Chainlink'in `AggregatorV3Interface`, böylece Ethereum protokollerini Rome'a taşırken mevcut oracle entegrasyon kodlarını korur. **Oracle Gateway V2, Hadrian ve Rubicon üzerinde dağıtıldı**, ancak kayıt defteri feed adreslerini yalnızca Hadrian için listeliyor ve kayıt işlemini bir müşteri portalı yönetiyor. Rome tarafından çalıştırılan bir keeper, önbelleğe alınmış ve book feed'lerini yeniler, ancak her feed her an taze değildir — [bugün hangi feed'lerin yanıt verdiği](#which-feeds-answer-today) aşağıda açıklanmıştır. Adaptörler, factory ve keeper modeli [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) repo'da ele alınmıştır.

> **Önizleme.** Oracle Gateway denetlenmemiştir. Portal da aynı şeyi söylüyor: bunu üretim değer akışlarında kullanmayın.

## Sorun

Ethereum DeFi, Chainlink'in `AggregatorV3Interface`:

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

Solana'nın oracle sağlayıcıları (Pyth, Switchboard) farklı veri biçimlerine sahiptir. Uyumlaştırma olmadan, taşınan her protokolün özel oracle koduna ihtiyacı olur.

## Çözüm

Oracle Gateway V2, aşağıdakileri yapan hafif adaptör sözleşmeleri dağıtır:

1. Fiyat verilerini Solana'daki Pyth veya Switchboard hesaplarından doğrudan okur (CPI değil, çapraz durum okumaları)
2. Zincir üzerindeki veriyi ayrıştırır
3. Fiyatları 8 ondalık basamağa normalleştirir
4. Standart Chainlink arayüzünü sunar `AggregatorV3Interface`

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

// Ethereum'daki Chainlink ile aynı arayüz
(, int256 price,,,) = IAggregatorV3Interface(ADAPTER).latestRoundData();
// price = 8 ondalıkla SOL/USD (ör. 15000000000 = $150.00)
```

## Bir feed'i üç adımda tüketin

1. **Adaptör adresini kayıttan çözün** — asla sabitlemeyin:

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

Kayıt defteri GitHub'dan yüklenir (`npm install github:rome-protocol/rome-registry#v0.2.0`). Feed anahtarları, arkalarında hangi adaptör türünün bulunduğunu belirten bir sonek taşır; bkz. [Kayıt defterindeki feed anahtarları](#feed-keys-in-the-registry) seçmeden önce.

2. **Bunu okuyun** protokolünüzün zaten kullandığı arayüzle — `IAggregatorV3Interface(solUsd).latestRoundData()`. Eski ya da başlatılmamış bir feed **geri alınır** donmuş bir fiyat sunmak yerine.
3. **Aynı anda birden fazla feed mi?** `BatchReader.getLatestPrices(adapters[])` (Hadrian, kayıt defteri v0.2.0: `0x2869f0a96572e7fb15036656e9a32fd17346499b`) — ve `getFeedHealth(adapters[])` ona güvenmeden önce bunları kontrol edin. Önbelleğe alınmış adaptörler, her tüketicinin düz bir `SLOAD`okumasını sağlar; böylece çoklu feed işlemleri (çok teminatlı borç alma, bir portföy görünümü) ucuz kalır.

[cardo](https://github.com/rome-protocol/cardo) Hadrian'da bu feed'leri okur. Arayüz tam olarak `AggregatorV3Interface`, Compound- ve Aave sınıfı protokoller bu feed'leri oracle kodu değişikliği olmadan kullanabilir — fiyat feed yapılandırmalarını adaptör adreslerine yöneltin.

## Adaptör türleri

* **PythPullAdapter** — Pyth fiyat hesaplarını okur (fiyat, güven, EMA, yayın zamanı).
* **SwitchboardV3Adapter** — Switchboard toplayıcı hesaplarını okur (fiyat, zaman damgası; EMA yok).
* **CachedPyth / CachedFeed adaptörleri** — CU-verimli okumalar için önbelleğe alınmış izleme varyantları.
* **BookFeedAdapter** — bir PriceBook sözleşmesindeki bir girdinin salt-okunur, Chainlink uyumlu görünümü. `PriceBook` sözleşmesi. Kitap, kayıtlı tüm feed'lerin fiyatlarını tutar ve toplu olarak yenilenir (yenileme izinsizdir); her feed'in adaptörü kendi önbelleğini tutmaz. Duraklatılmış bir girdi doğrudan `AdapterPaused`, ile hata verir; eski hale gelmesini beklemez.

Adaptörler EIP-1167 minimal-proxy klonları olarak dağıtılır: `OracleAdapterFactory` Pyth, Switchboard ve önbelleğe alınmış adaptörleri klonlar ve her `PriceBook` kendi `BookFeedAdapter` bir feed kaydedildiğinde klonlanır. Bunlar, aşağıdakilerin yanında genişletilmiş bir arayüz sunar: `AggregatorV3Interface` (`latestPriceData`, `maxStaleness`, `oracleType`, ve bir `metadata()` arayüzü (sağlık kontrolleri için kullanılır).

## Kayıt defterindeki feed anahtarları

`getOracle(chainId).feeds` varlık başına birkaç anahtar içerir. Anahtar adlarındaki sonek, adaptör türünü belirtir:

| Anahtar              | Adaptör türü                                 | Nasıl okur                                                                                             |
| -------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `SOL/USD`            | Doğrudan Pyth (`PythPullAdapter`)            | Pyth hesabını her çağrıda ayrıştırır.                                                                  |
| `SOL/USD-BOOK`       | `BookFeedAdapter`                            | Bir `PriceBook` girdisini okur; keeper onu yeniler.                                                    |
| `SOL/USD-CACHED`     | Önbelleğe alınmış (başka bir feed'i sarar)   | Keeper'ın yenilediği saklanmış bir fiyatı okur.                                                        |
| `SOL/USD-CACHEDPYTH` | Önbelleğe alınmış Pyth (`CachedPythAdapter`) | Keeper'ın yenilediği saklanmış bir fiyatı okur.                                                        |
| `SOL/USD-SB`         | Switchboard (`SwitchboardV3Adapter`)         | Switchboard hesabını her çağrıda ayrıştırır. Kayıt defteri bu girdileri işaretler `emekliye ayrılmış`. |

Hangisini tüketeceğiniz zincire bağlıdır. Önce sonraki bölümü kontrol edin.

### Bugün hangi feed'ler yanıt veriyor

Bunlar, bu sayfa yazılırken kayıt defteri v0.2.0'da listelenen feed'ler üzerinde yapılan salt-okunur `latestRoundData()` çağrıların sonuçlarıdır. Feed tazeliği devnet'te dakikadan dakikaya değişir, bu yüzden bunu bir anlık görüntü olarak değerlendirin ve kullanmayı planladığınız feed üzerinde aynı çağrıyı çalıştırın.

* **Hadrian.** Doğrudan feed'ler çoğu zaman eskidir: tekrarlanan kontrollerde çoğunun (BONK, BTC, ETH, JITOSOL, JTO, JUP, MSOL, USDC, USDT) her seferinde `StalePriceFeed` ile hata verdi ve `SOL/USD` bazı çağrılarda yanıt verdi, bazılarında vermedi.  `-BOOK` feed'leri en güvenilir olanlardı ve JTO hariç her varlık için her çağrıda yanıt verdi; JTO'nun `-BOOK` feed'i eski diye hata verdi. Her `-CACHED` ve `-CACHEDPYTH` feed'i hata verdi `UninitializedPriceFeed` (bunlar hiç yenilenmedi) ve `SOL/USD-SB` ile hata verdi `StalePriceFeed`. Hadrian'da, tercih edin `-BOOK` feed'ini ve `latestRoundData()` ona güvenmeden önce seçtiğiniz feed üzerinde çalıştırın.
* **Rubicon.** Kayıt defteri Rubicon için oracle feed'lerini listelemiyor, bu yüzden bu sayfa onları kapsamıyor. Factory orada dağıtılmış durumda (bkz. [Dağıtılan adresler](#deployed-addresses)) ve ilk adaptörleri yanıt veriyor, ancak feed adreslerini kayıt defterinden değil factory'den (`adapterCount()` ve `allAdapters(i)`) öğrenin.

Buradaki hata, tasarlanmış davranıştır: eski ya da başlatılmamış bir feed, eski bir fiyat döndürmek yerine yüksek sesle başarısız olur. Bunu sözleşmenizde ele alın.

## Tazelik — oracle-keeper

Adaptörler bir `maxStaleness` pencere uygular: eğer `block.timestamp - publishTime > maxStaleness`, okumalar hata verir. Solana mainnet'te Pyth üretim keeper'larını çalıştırır. Solana devnet'te (Hadrian'ın bulunduğu yerde), Pyth'in push mekanizmaları en iyi çaba esaslıdır, bu yüzden Rome kendi **oracle-keeper** sidecar'ını çalıştırır; alttaki Pyth hesaplarını taze tutmak ve önbelleğe alınmış ile book feed'lerini yenilemek için. Keeper her zincirde her an her feed'i kapsamaz (bkz. [bugün hangi feed'lerin yanıt verdiği](#which-feeds-answer-today)).

Feed sağlığını şununla kontrol edin `BatchReader.getFeedHealth` (her adaptörün `metadata()`latestPriceData `latestRoundData` — bir feed erişilebilir olabilir ama eski olabilir.

## Müşteri portalı

Feed'leri kaydedin ve tüketicileri zincir başına [Oracle Gateway portalı](https://oracle.testnet.romeprotocol.xyz/). Bkz. [portal sayfası](https://docs.rome.builders/tr/rome-uzerindeki-uygulamalar/oracle-gateway.md) kapsadığı şeyler için.

## Dağıtılan adresler

Zincir başına kanonik adresler (factory'ler, adaptör implementasyonları ve canlı feed'ler) içinde yer alır [kaydında](https://github.com/rome-protocol/rome-registry/tree/main/chains). Başlıca factory'ler, `canlı` kayıt defteri v0.2.0 girdilerinden (Hadrian'da sürüm 5.0.0; Rubicon adresleri [Sözleşme Adresleri](https://docs.rome.builders/tr/referans/contract-addresses.md) sayfasındaki adreslerdir); bkz. [Sözleşmeler listesini okuma](https://docs.rome.builders/tr/referans/contract-addresses.md#reading-the-contracts-list):

| Sözleşme             | Hadrian                                      | Rubicon                                      |
| -------------------- | -------------------------------------------- | -------------------------------------------- |
| OracleAdapterFactory | `0x52b008771fc95b4674a4f3533570b3d223f27f68` | `0x6a1340dd86c3951b6f13d9001b3951d56a2fe581` |
| BatchReader          | `0x2869f0a96572e7fb15036656e9a32fd17346499b` | `0x580dc0ecb226530ee8a90b57e0f0cd2555fb4f0f` |

## Kısıtlar

* **Tarihsel round verisi yok** — `getRoundData(roundId)` hata verir; yalnızca `latestRoundData()` desteklenir.
* **Switchboard EMA desteklenmiyor** — EMA verisi yalnızca Pyth'e özgüdür.
* **Zincir başına eskime** — `maxStaleness` kurulum sırasında her ortam için ayarlanır: doğrudan (Pyth-okuma) adaptörler varsayılan olarak \~60 saniye kullanır; önbelleğe alınmış adaptörler varsayılan olarak 3600 saniye kullanır (keeper bunları yenilerken bunu bundan çok daha sık yapar).
* **Ayrıştırıcı ofsetleri** mevcut Pyth/Switchboard düzenlerine karşı doğrulanır; düzen değişiklikleri yeniden doğrulama gerektirir.

## Sırada Ne Var

* [Oracle Gateway portalı](https://docs.rome.builders/tr/rome-uzerindeki-uygulamalar/oracle-gateway.md) — feed'leri kaydedin, tüketicileri yapılandırın
* [Sözleşme Adresleri](https://docs.rome.builders/tr/referans/contract-addresses.md) — ön-derlemeler ve zincir başına adresler


---

# 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/tr/urunler/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.
