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

Сеть Oracle Gateway предоставляет нативные для Solana ценовые фиды (Pyth Network, Switchboard V3) через интерфейс Chainlink AggregatorV3Interface. Протоколы Ethereum, переходящие на Rome, могут использовать существующий код интеграции оракула без изменений.

Проблема

Протоколы Ethereum DeFi ожидают интерфейс Chainlink AggregatorV3Interface:

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

В Solana используются другие провайдеры оракулов (Pyth, Switchboard) с иными форматами данных. Без адаптации каждому протоколу Ethereum потребовалась бы собственная интеграция оракула.

Решение

Oracle Gateway V2 разворачивает легковесные контрактные адаптеры, которые:

1. Читают ценовые данные из аккаунтов Pyth или Switchboard в Solana через CPI

2. Разбирают данные в цепочке, закодированные в формате Borsh

3. Нормализуют цены до 8 знаков после запятой

4. Предоставляют стандартный интерфейс Chainlink AggregatorV3Interface

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

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

Архитектура

OracleAdapterFactory

Разворачивает и управляет адаптерами оракулов:

OracleAdapterFactory factory = OracleAdapterFactory(0xa4647955a16b72d15f13b51b5277036755d297be);

// Развернуть адаптер ценового фида Pyth
address adapter = factory.createPythFeed(
    pythAccountPubkey,    // Ценовой аккаунт Pyth в Solana
    "SOL/USD",            // описание
    60                    // максимальная допустимая устарелость в секундах
);

// Развернуть адаптер ценового фида Switchboard
address adapter = factory.createSwitchboardFeed(
    sbAccountPubkey,      // агрегатор Switchboard в Solana
    "SOL/USD",
    60
);

Перед развертыванием фабрика проверяет, что аккаунт действительно принадлежит программе Pyth/Switchboard.

Типы адаптеров

PythPullAdapter — Читает Pyth PriceUpdateV2 аккаунты. Поддерживает цену, доверительный интервал, EMA-цену и время публикации.

SwitchboardV3Adapter — Читает Switchboard AggregatorAccountData аккаунты. Поддерживает цену и временную метку. EMA недоступна.

Оба адаптера используют минимальные прокси-клоны EIP-1167 для экономичного по газу развертывания.

Интерфейсы

Стандартный интерфейс Chainlink

interface IAggregatorV3Interface {
    function decimals() external view returns (uint8);          // Всегда 8
    function description() external view returns (string memory);
    function version() external view returns (uint256);
    function latestRoundData() external view returns (
        uint80 roundId,
        int256 answer,        // Цена, нормализованная до 8 знаков после запятой
        uint256 startedAt,
        uint256 updatedAt,
        uint80 answeredInRound
    );
}

Расширенный интерфейс

interface IExtendedOracleAdapter {
    function latestPriceData() external view returns (
        int64 price, uint64 conf, int32 expo, uint64 publishTime
    );
    function latestEMAData() external view returns (        // Только Pyth
        int64 emaPrice, uint64 emaConf, int32 expo, uint64 publishTime
    );
    function priceStatus() external view returns (uint8);   // 0=Торгуется, 1=Устарело, 2=Приостановлено
    function maxStaleness() external view returns (uint256);
    function oracleType() external view returns (uint8);    // 0=PythPull, 1=Switchboard
}

Пакетный считыватель

Читать несколько фидов за один вызов:

BatchReader reader = BatchReader(0x70da375e5680f84032f5b15d35ba0e6f9871d3fd);

address[] memory adapters = new address[](3);
adapters[0] = solUsdAdapter;
adapters[1] = btcUsdAdapter;
adapters[2] = ethUsdAdapter;

// Возвращает массив (адаптер, answer, updatedAt, success)
// Один устаревший фид не откатывает весь пакет
reader.getLatestPrices(adapters);

Защита от устаревания

Адаптеры применяют параметр maxStaleness . Если block.timestamp - publishTime > maxStaleness, вызов завершается с ошибкой StalePriceFeed(). По умолчанию: 60 секунд.

Владелец фабрики может настраивать устаревание для каждого адаптера отдельно или глобально:

factory.setDefaultMaxStaleness(120); // 2 минуты

Развернутые адреса (Devnet)

Контракт	Адрес
OracleAdapterFactory	0xa4647955a16b72d15f13b51b5277036755d297be
PythPullAdapter (impl)	0x4fd11aed44ee5f71df22fb804cfcbb4c50535db9
SwitchboardV3Adapter (impl)	0xb57e3589b880aa3f6b66ce2df6aa42cd9c36925e
BatchReader	0x70da375e5680f84032f5b15d35ba0e6f9871d3fd
SOL/USD (Switchboard)	0xF0864572019c295407CF2ed46e6FD3615e10E19d

См. Адреса контрактов полный список.

Ограничения

• Нет исторических данных по раундам — getRoundData(roundId) завершается с ошибкой HistoricalRoundsNotSupported()

• EMA Switchboard не поддерживается — latestEMAData() завершается ошибкой в адаптерах Switchboard

• Смещения парсера эмпирически проверены — перед повторным развертыванием с новыми версиями Pyth/Switchboard необходимо повторно выполнить проверку с помощью скриптов валидации

• Нормализация цены — цены Pyth нормализуются как price * 10^(expo - (-8)); Switchboard — как (mantissa * 10^8) / 10^scale

Статус

Версия 1 выпущена (2026-04-01) — V2 в разработке с защитой от устаревания, пакетным чтением, адаптером Switchboard, клонами EIP-1167.

Что дальше

• Адреса контрактов — все развернутые адреса оракулов

• Развернуть Solidity — развертывать контракты, которые используют фиды оракулов