> 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/ru/produkty/oracle-gateway.md).

# Шлюз оракула

Ценовые потоки Pyth и Switchboard за интерфейсом Chainlink AggregatorV3Interface.

Oracle Gateway предоставляет нативные для Solana ценовые фиды (Pyth, Switchboard V3) через интерфейс Chainlink `AggregatorV3Interface`, поэтому протоколы Ethereum, портируемые в Rome, сохраняют существующий код интеграции с оракулом. **Oracle Gateway V2 развернут в Hadrian и Rubicon**, хотя реестр перечисляет адреса фидов только для Hadrian, а регистрацию обрабатывает клиентский портал. Keeper, запущенный в Rome, обновляет кэшированные фиды и фиды книги, но не каждый фид актуален в каждый момент — [какие фиды отвечают сегодня](#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. Читают ценовые данные напрямую из аккаунтов Pyth или Switchboard в Solana (межсостоянийное чтение, не CPI)
2. Разбирают данные в блокчейне
3. Нормализуют цены до 8 знаков после запятой
4. Предоставляют стандартный Chainlink `AggregatorV3Interface`

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

// Тот же интерфейс, что и у Chainlink в Ethereum
(, int256 price,,,) = IAggregatorV3Interface(ADAPTER).latestRoundData();
// price = SOL/USD с 8 знаками после запятой (например, 15000000000 = $150.00)
```

## Потребляйте фид в три шага

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()`. Протухший или неинициализированный фид **завершается с ошибкой** а не выдавать застывшую цену.
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 (цена, доверительный интервал, EMA, время публикации).
* **SwitchboardV3Adapter** — читает аккаунты агрегатора Switchboard (цена, метка времени; без EMA).
* **CachedPyth / CachedFeed adapters** — варианты с кэшированием для экономичных по CU чтений.
* **BookFeedAdapter** — доступное только для чтения совместимое с Chainlink представление одной записи в контракте `PriceBook` . Книга хранит цены для всех зарегистрированных фидов и обновляется пакетами (обновление не требует разрешений); у адаптера каждого фида нет собственного кэша. Приостановленная запись немедленно завершится ошибкой `AdapterPaused`, а не будет ждать устаревания.

Адаптеры развёртываются как минимальные прокси-клоны EIP-1167:  `OracleAdapterFactory` создаёт клоны Pyth, Switchboard и кэшированных адаптеров, и каждый `PriceBook` создаёт собственный `BookFeedAdapter` при регистрации фида. Они предоставляют расширенный интерфейс вместе с `AggregatorV3Interface` (`latestPriceData`, `maxStaleness`, `oracleType`, и `metadata()` (поверхность, используемая для проверок состояния).

## Ключи фидов в реестре

`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, чей `-BOOK` фид завершался как устаревший. Каждый `-CACHED` и `-CACHEDPYTH` фид завершался с ошибкой `UninitializedPriceFeed` (ничего их не обновляло), а `SOL/USD-SB` завершался с ошибкой `StalePriceFeed`. В Hadrian предпочтительнее `-BOOK` фид, и выполните `latestRoundData()` на выбранном вами фиде, прежде чем полагаться на него.
* **Rubicon.** В реестре нет перечисления оракульных фидов для Rubicon, поэтому эта страница их не рассматривает. Там развернута фабрика (см. [Развёрнутые адреса](#deployed-addresses)) и её первые адаптеры отвечают, но адреса фидов следует получать из фабрики (`adapterCount()` и `allAdapters(i)`), а не из реестра.

Revert здесь — ожидаемое поведение: устаревший или неинициализированный фид явно завершает работу с ошибкой, а не возвращает старую цену. Обрабатывайте это в своём контракте.

## Актуальность — keeper оракула

Адаптеры обеспечивают `maxStaleness` окно: если `block.timestamp - publishTime > maxStaleness`, чтение завершается с ошибкой. В основной сети Solana Pyth использует production-keeper'ы. В devnet Solana (где работает Hadrian) push-механизмы Pyth работают по принципу best effort, поэтому Rome запускает собственный **oracle-keeper** sidecar, чтобы поддерживать базовые аккаунты Pyth в актуальном состоянии и обновлять кэшированные фиды и фиды книги. Keeper не покрывает каждый фид в каждой сети в каждый момент (см. [какие фиды отвечают сегодня](#which-feeds-answer-today)).

Проверяйте состояние фида с помощью `BatchReader.getFeedHealth` (который читает `metadata()`каждого адаптера), а не только `latestRoundData` — фид может быть доступен, но устаревшим.

## Клиентский портал

Регистрируйте фиды и настраивайте потребителей по каждой сети через [портал Oracle Gateway](https://oracle.testnet.romeprotocol.xyz/). См. [страницу портала](https://docs.rome.builders/ru/prilozheniya-v-rome/oracle-gateway.md) для списка возможностей.

## Развёрнутые адреса

Канонические адреса по каждой сети (фабрики, реализации адаптеров и активные фиды) находятся в [реестре](https://github.com/rome-protocol/rome-registry/tree/main/chains). Основные фабрики, из `live` записей registry v0.2.0 (версия 5.0.0 в Hadrian; адреса Rubicon — это адреса на [справочнике Contract Addresses](https://docs.rome.builders/ru/spravochnik/contract-addresses.md) странице); см. [Чтение списка контрактов](https://docs.rome.builders/ru/spravochnik/contract-addresses.md#reading-the-contracts-list):

| Контракт             | Hadrian                                      | Rubicon                                      |
| -------------------- | -------------------------------------------- | -------------------------------------------- |
| OracleAdapterFactory | `0x52b008771fc95b4674a4f3533570b3d223f27f68` | `0x6a1340dd86c3951b6f13d9001b3951d56a2fe581` |
| BatchReader          | `0x2869f0a96572e7fb15036656e9a32fd17346499b` | `0x580dc0ecb226530ee8a90b57e0f0cd2555fb4f0f` |

## Ограничения

* **Отсутствие исторических данных раунда** — `getRoundData(roundId)` приводит к revert; поддерживается только `latestRoundData()` поддерживается.
* **EMA Switchboard не поддерживается** — данные EMA доступны только для Pyth.
* **Заданная по каждой сети просрочка** — `maxStaleness` настраивается для каждой среды при запуске: для прямых адаптеров (чтение Pyth) значение по умолчанию составляет \~60 секунд; для кэшированных адаптеров — 3600 секунд (при обновлении keeper делает это значительно чаще).
* **Смещения парсера** проверяются на соответствие текущим структурам Pyth/Switchboard; изменения структуры требуют повторной проверки.

## Что дальше

* [портал Oracle Gateway](https://docs.rome.builders/ru/prilozheniya-v-rome/oracle-gateway.md) — регистрируйте фиды, настраивайте потребителей
* [справочнике Contract Addresses](https://docs.rome.builders/ru/spravochnik/contract-addresses.md) — precompile и адреса по цепочкам


---

# 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/ru/produkty/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.
