> 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/de/produkte/oracle-gateway.md).

# Oracle Gateway

Pyth- und Switchboard-Preisfeeds hinter Chainlinks AggregatorV3Interface.

Das Oracle Gateway stellt Solana-native Preis-Feeds (Pyth, Switchboard V3) über Chainlinks `AggregatorV3Interface`, sodass Ethereum-Protokolle, die nach Rome portiert werden, ihren bestehenden Oracle-Integrationscode beibehalten. **Oracle Gateway V2 ist auf Hadrian und Rubicon bereitgestellt**, obwohl das Register Feed-Adressen nur für Hadrian aufführt, und ein Kundenportal die Registrierung übernimmt. Ein von Rome betriebener Keeper aktualisiert die zwischengespeicherten und Book-Feeds, aber nicht jeder Feed ist zu jedem Zeitpunkt frisch — [welche Feeds heute antworten](#which-feeds-answer-today) ist unten erläutert. Die Adapter-, Factory- und Keeper-Architektur werden im [rome-oracle-gateway](https://github.com/rome-protocol/rome-oracle-gateway) Repo behandelt.

> **Vorschau.** Das Oracle Gateway wurde nicht auditiert. Das Portal sagt dasselbe: Verwenden Sie es nicht in produktiven Wertströmen.

## Das Problem

Ethereum-DeFi erwartet Chainlinks `AggregatorV3Interface`:

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

Die Oracle-Anbieter von Solana (Pyth, Switchboard) haben unterschiedliche Datenformate. Ohne Anpassung würde jedes portierte Protokoll eigenen Oracle-Code benötigen.

## Die Lösung

Oracle Gateway V2 setzt leichte Adapter-Verträge ein, die:

1. Preisdaten direkt aus Pyth- oder Switchboard-Konten auf Solana lesen (Cross-State-Reads, kein CPI)
2. Die On-Chain-Daten parsen
3. Preise auf 8 Dezimalstellen normalisieren
4. die standardmäßige Chainlink-Schnittstelle bereitstellen `AggregatorV3Interface`

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

// dieselbe Schnittstelle wie Chainlink auf Ethereum
(, int256 price,,,) = IAggregatorV3Interface(ADAPTER).latestRoundData();
// Preis = SOL/USD mit 8 Dezimalstellen (z. B. 15000000000 = 150,00 $)
```

## Einen Feed in drei Schritten nutzen

1. **Die Adapteradresse aus dem Register auflösen** — niemals fest eincodieren:

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

Das Register wird von GitHub installiert (`npm install github:rome-protocol/rome-registry#v0.2.0`). Die Feed-Keys tragen ein Suffix, das angibt, welche Adapterart dahintersteht; siehe [Feed-Keys im Register](#feed-keys-in-the-registry) bevor Sie einen auswählen.

2. **Lesen Sie ihn** mit der Schnittstelle, die Ihr Protokoll bereits verwendet — `IAggregatorV3Interface(solUsd).latestRoundData()`. Ein veralteter oder nicht initialisierter Feed **revertiert** anstatt einen eingefrorenen Preis bereitzustellen.
3. **Mehrere Feeds auf einmal?** `BatchReader.getLatestPrices(adapters[])` (Hadrian, Register v0.2.0: `0x2869f0a96572e7fb15036656e9a32fd17346499b`) — und `getFeedHealth(adapters[])` bevor Sie sich auf sie verlassen. Zwischengespeicherte Adapter lassen jeden Verbraucher einfach ein `SLOAD`, sodass Multi-Feed-Transaktionen (eine Multi-Collateral-Anleihe, eine Portfolioansicht) kostengünstig bleiben.

[cardo](https://github.com/rome-protocol/cardo) liest diese Feeds auf Hadrian. Da die Oberfläche exakt `AggregatorV3Interface`, können Protokolle der Compound- und Aave-Klasse diese Feeds ohne Änderungen am Oracle-Code verwenden — richten Sie ihre Preis-Feed-Konfiguration auf die Adapteradressen.

## Adaptertypen

* **PythPullAdapter** — liest Pyth-Preiskonten (Preis, Konfidenz, EMA, Veröffentlichungszeit).
* **SwitchboardV3Adapter** — liest Switchboard-Aggregatorkonten (Preis, Zeitstempel; kein EMA).
* **CachedPyth / CachedFeed-Adapter** — Varianten mit Cache-Spur für CU-effiziente Lesezugriffe.
* **BookFeedAdapter** — eine schreibgeschützte, Chainlink-kompatible Ansicht über einen Eintrag eines `PriceBook` Vertrags. Das Buch hält die Preise aller seiner registrierten Feeds und wird in Batches aktualisiert (die Aktualisierung ist erlaubnisfrei); der Adapter jedes Feeds hält keinen eigenen Cache. Ein pausierter Eintrag bricht sofort mit `AdapterPaused`, statt darauf zu warten, veraltet zu werden.

Adapter werden als EIP-1167-Minimal-Proxy-Klone bereitgestellt: Der `OracleAdapterFactory` klont die Pyth-, Switchboard- und Cache-Adapter, und jeder `PriceBook` klont seinen eigenen `BookFeedAdapter` wenn ein Feed registriert wird. Sie stellen neben `AggregatorV3Interface` (`latestPriceData`, `maxStaleness`, `oracleType`, und einen `metadata()` der für Gesundheitsprüfungen verwendeten Oberfläche).

## Feed-Keys im Register

`getOracle(chainId).feeds` hat mehrere Schlüssel pro Asset. Das Suffix im Schlüssel benennt die Adapterart:

| Schlüssel            | Adapterart                              | Wie es liest                                                                                      |
| -------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `SOL/USD`            | Direktes Pyth (`PythPullAdapter`)       | Parst das Pyth-Konto bei jedem Aufruf.                                                            |
| `SOL/USD-BOOK`       | `BookFeedAdapter`                       | Liest einen `PriceBook` Eintrag, den der Keeper aktualisiert.                                     |
| `SOL/USD-CACHED`     | Gecacht (umschließt einen anderen Feed) | Liest einen gespeicherten Preis, den der Keeper aktualisiert.                                     |
| `SOL/USD-CACHEDPYTH` | Gecachtes Pyth (`CachedPythAdapter`)    | Liest einen gespeicherten Preis, den der Keeper aktualisiert.                                     |
| `SOL/USD-SB`         | Switchboard (`SwitchboardV3Adapter`)    | Parst das Switchboard-Konto bei jedem Aufruf. Das Register markiert diese Einträge `stillgelegt`. |

Welchen Sie verwenden, hängt von der Chain ab. Prüfen Sie zuerst den nächsten Abschnitt.

### Welche Feeds heute antworten

Dies sind Ergebnisse schreibgeschützter `latestRoundData()` Aufrufe der in Register v0.2.0 aufgeführten Feeds, die ausgeführt wurden, während diese Seite geschrieben wurde. Die Frische der Feeds ändert sich auf dem Devnet von Minute zu Minute, behandeln Sie dies also als Momentaufnahme und führen Sie denselben Aufruf auf dem Feed aus, den Sie verwenden möchten.

* **Hadrian.** Die direkten Feeds sind oft veraltet: Bei wiederholten Prüfungen brach die Mehrheit von ihnen (BONK, BTC, ETH, JITOSOL, JTO, JUP, MSOL, USDC, USDT) jedes Mal mit `StalePriceFeed` ab, und `SOL/USD` antwortete bei manchen Aufrufen und bei anderen nicht. Die `-BOOK` Feeds waren am zuverlässigsten und antworteten bei jedem Aufruf für jedes Asset außer JTO, dessen `-BOOK` Feed als veraltet zurückwies. Jeder `-CACHED` und `-CACHEDPYTH` Feed brach mit `UninitializedPriceFeed` (nichts hat sie aktualisiert), und `SOL/USD-SB` brach mit `StalePriceFeed`. `-BOOK` Auf Hadrian sollten Sie den `latestRoundData()` Feed, den Sie auswählen, vor dem Einsatz darauf prüfen.
* **Rubicon.** Das Register führt keine Oracle-Feeds für Rubicon auf, daher werden sie auf dieser Seite nicht behandelt. Die Factory ist dort eingesetzt (siehe [Bereitgestellte Adressen](#deployed-addresses)) und seine ersten Adapter antworten, aber rufen Sie die Feed-Adressen aus der Factory ab (`adapterCount()` und `allAdapters(i)`) statt aus dem Register.

Ein Revert hier ist das beabsichtigte Verhalten: Ein veralteter oder nicht initialisierter Feed schlägt laut fehl, statt einen alten Preis zurückzugeben. Behandeln Sie das in Ihrem Vertrag.

## Frische — der Oracle-Keeper

Adapter erzwingen ein `maxStaleness` -Fenster: wenn `block.timestamp - publishTime > maxStaleness`, schlagen Lesezugriffe fehl. Auf Solana-Mainnet betreibt Pyth Produktions-Keeper. Auf Solana-Devnet (wo Hadrian läuft) sind Pyths Pusher Best-Effort, daher betreibt Rome seinen eigenen **Oracle-Keeper** Sidecar, um die zugrunde liegenden Pyth-Konten frisch zu halten und die gecachten und Book-Feeds zu aktualisieren. Der Keeper deckt nicht zu jedem Zeitpunkt jeden Feed auf jeder Chain ab (siehe [welche Feeds heute antworten](#which-feeds-answer-today)).

Prüfen Sie die Feed-Gesundheit mit `BatchReader.getFeedHealth` (das die `metadata()`Metadaten jedes Adapters liest), nicht nur `latestRoundData` — ein Feed kann erreichbar, aber veraltet sein.

## Kundenportal

Registrieren Sie Feeds und konfigurieren Sie Consumer pro Chain über das [Oracle-Gateway-Portal](https://oracle.testnet.romeprotocol.xyz/). Siehe die [Portal-Seite](https://docs.rome.builders/de/apps-auf-rome/oracle-gateway.md) für den Umfang.

## Bereitgestellte Adressen

Kanonische Adressen pro Chain (Factories, Adapter-Implementierungen und Live-Feeds) stehen im [Registry](https://github.com/rome-protocol/rome-registry/tree/main/chains). Die wichtigsten Factories aus den `live` Einträgen von Register v0.2.0 (Version 5.0.0 auf Hadrian; die Rubicon-Adressen sind die auf der [Contract Addresses](https://docs.rome.builders/de/referenz/contract-addresses.md) Seite); siehe [Das Lesen der Contract-Liste](https://docs.rome.builders/de/referenz/contract-addresses.md#reading-the-contracts-list):

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

## Beschränkungen

* **Keine historischen Round-Daten** — `getRoundData(roundId)` bricht ab; nur `latestRoundData()` wird unterstützt.
* **Switchboard-EMA nicht unterstützt** — EMA-Daten gibt es nur bei Pyth.
* **Veralterung pro Chain** — `maxStaleness` wird pro Umgebung beim Hochfahren festgelegt: direkte (Pyth-gelesene) Adapter haben standardmäßig \~60 Sekunden; gecachte Adapter standardmäßig 3600 Sekunden (wenn der Keeper sie aktualisiert, tut er das deutlich häufiger).
* **Parser-Offsets** werden gegen die aktuellen Pyth-/Switchboard-Layouts validiert; Layoutänderungen erfordern eine erneute Validierung.

## Wie es weitergeht

* [Oracle-Gateway-Portal](https://docs.rome.builders/de/apps-auf-rome/oracle-gateway.md) — Feeds registrieren, Consumer konfigurieren
* [Contract Addresses](https://docs.rome.builders/de/referenz/contract-addresses.md) — Precompiles und chain-spezifische Adressen


---

# 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/de/produkte/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.
