Oracle Gateway
Fuentes de precios de Pyth y Switchboard detrás de la interfaz AggregatorV3Interface de Chainlink.
El Oracle Gateway expone feeds de precios nativos de Solana (Pyth, Switchboard V3) a través de la de Chainlink AggregatorV3Interfacepor lo que los protocolos de Ethereum que se portan a Rome conservan su código de integración de oráculos existente. Oracle Gateway V2 está desplegado en Hadrian y Rubiconaunque el registro solo lista direcciones de feeds para Hadrian, y un portal para clientes gestiona el registro. Un keeper ejecutado en Rome actualiza los feeds en caché y los del libro, pero no todos los feeds están frescos en todo momento — qué feeds responden hoy se explica a continuación. Los adaptadores, la fábrica y el modelo de keeper se cubren en el rome-oracle-gateway repositorio.
Vista previa. El Oracle Gateway no ha sido auditado. El portal dice lo mismo: no lo uses en flujos de valor de producción.
El problema
DeFi de Ethereum espera la interfaz de Chainlink AggregatorV3Interface:
(, int256 price,,,) = priceFeed.latestRoundData();Los proveedores de oráculos de Solana (Pyth, Switchboard) tienen formatos de datos diferentes. Sin adaptación, cada protocolo portado necesitaría código de oráculo personalizado.
La solución
Oracle Gateway V2 despliega contratos adaptadores ligeros que:
Leen datos de precios directamente desde cuentas de Pyth o Switchboard en Solana (lecturas entre estados, no CPI)
Analizan los datos en cadena
Normalizan los precios a 8 decimales
Exponen el estándar de Chainlink
AggregatorV3Interface
import {IAggregatorV3Interface} from "@rome-protocol/rome-solidity/contracts/oracle/IAggregatorV3Interface.sol";
// Misma interfaz que Chainlink en Ethereum
(, int256 price,,,) = IAggregatorV3Interface(ADAPTER).latestRoundData();
// price = SOL/USD a 8 decimales (p. ej., 15000000000 = $150.00)Consume un feed en tres pasos
Resuelve la dirección del adaptador desde el registro — nunca la codifiques de forma fija:
El registro se instala desde GitHub (npm install github:rome-protocol/rome-registry#v0.2.0). Las claves de feed llevan un sufijo que indica qué tipo de adaptador hay detrás; consulta Claves de feed en el registro antes de elegir uno.
Léelo con la interfaz que tu protocolo ya usa —
IAggregatorV3Interface(solUsd).latestRoundData(). Un feed obsoleto o no inicializado revierte en lugar de servir un precio congelado.¿Varios feeds a la vez?
BatchReader.getLatestPrices(adapters[])(Hadrian, registry v0.2.0:0x2869f0a96572e7fb15036656e9a32fd17346499b) — ygetFeedHealth(adapters[])antes de depender de ellos. Los adaptadores con caché hacen que cada consumidor lea un simpleSLOAD, por lo que las transacciones con varios feeds (un préstamo multicolateral, una vista de cartera) siguen siendo baratas.
cardo lee estos feeds en Hadrian. Como la interfaz es exactamente AggregatorV3Interface, los protocolos de clase Compound y Aave pueden usar estos feeds sin cambios en el código del oráculo: apunten su configuración de feed de precios a las direcciones de los adaptadores.
Tipos de adaptador
PythPullAdapter — lee cuentas de precios de Pyth (precio, confianza, EMA, hora de publicación).
SwitchboardV3Adapter — lee cuentas de agregador de Switchboard (precio, marca de tiempo; sin EMA).
Adaptadores CachedPyth / CachedFeed — variantes con caché para lecturas eficientes en CU.
BookFeedAdapter — una vista de solo lectura compatible con Chainlink sobre una entrada de un
PriceBookcontrato. El libro contiene los precios de todos sus feeds registrados y se refresca por lotes (el refresco no requiere permiso); el adaptador de cada feed no mantiene su propia caché. Una entrada pausada revierte de inmediato conAdapterPaused, en lugar de esperar a quedar obsoleta.
Los adaptadores se despliegan como clones mínimos proxy EIP-1167: el OracleAdapterFactory clona los adaptadores de Pyth, Switchboard y los adaptadores con caché, y cada PriceBook clona la suya propia BookFeedAdapter cuando se registra un feed. Exponen una interfaz extendida junto con AggregatorV3Interface (latestPriceData, maxStaleness, oracleType, y una metadata() interfaz usada para comprobaciones de salud).
Claves de feed en el registro
getOracle(chainId).feeds tiene varias claves por activo. El sufijo en el nombre de la clave indica el tipo de adaptador:
SOL/USD
Pyth directo (PythPullAdapter)
Analiza la cuenta de Pyth en cada llamada.
SOL/USD-BOOK
BookFeedAdapter
Lee una PriceBook entrada que el keeper actualiza.
SOL/USD-CACHED
En caché (envuelve otro feed)
Lee un precio almacenado que el keeper actualiza.
SOL/USD-CACHEDPYTH
Pyth en caché (CachedPythAdapter)
Lee un precio almacenado que el keeper actualiza.
SOL/USD-SB
Switchboard (SwitchboardV3Adapter)
Analiza la cuenta de Switchboard en cada llamada. El registro marca estas entradas retiradas.
Cuál consumir depende de la cadena. Revisa primero la siguiente sección.
Qué feeds responden hoy
Estos son resultados de llamadas latestRoundData() de solo lectura sobre los feeds listados en registry v0.2.0, hechas mientras se escribía esta página. La frescura de los feeds cambia de minuto en minuto en devnet, así que trátalo como una instantánea y ejecuta la misma llamada en el feed que planeas usar.
Hadrian. Los feeds directos suelen estar obsoletos: en comprobaciones repetidas, la mayoría de ellos (BONK, BTC, ETH, JITOSOL, JTO, JUP, MSOL, USDC, USDT) revirtió con
StalePriceFeedcada vez, ySOL/USDrespondió en algunas llamadas y no en otras. Los feeds-BOOKfueron los más fiables y respondieron en cada llamada para todos los activos excepto JTO, cuyo-BOOKfeed revirtió por estar obsoleto. Cada-CACHEDy-CACHEDPYTHfeed revirtió conUninitializedPriceFeed(nada los ha refrescado), ySOL/USD-SBrevirtió conStalePriceFeed.-BOOKfeed, y ejecutalatestRoundData()en el feed que elijas antes de depender de él.Rubicon. El registro no lista feeds de oráculo para Rubicon, así que esta página no los cubre. La fábrica está desplegada allí (véase Direcciones desplegadas) y sus primeros adaptadores responden, pero busca las direcciones de los feeds en la fábrica (
adapterCount()yallAdapters(i)) en lugar de en el registro.
Un revert aquí es el comportamiento diseñado: un feed obsoleto o no inicializado falla ruidosamente en lugar de devolver un precio antiguo. Manejalo en tu contrato.
Frescura — el oracle-keeper
Los adaptadores imponen una maxStaleness ventana: si block.timestamp - publishTime > maxStaleness, las lecturas revierten. En Solana mainnet, Pyth ejecuta keepers de producción. En Solana devnet (donde vive Hadrian), los pushers de Pyth son de mejor esfuerzo, así que Rome ejecuta su propio oracle-keeper sidecar para mantener frescas las cuentas subyacentes de Pyth y para refrescar los feeds en caché y del libro. El keeper no cubre todos los feeds en cada cadena en todo momento (véase qué feeds responden hoy).
Comprueba la salud del feed con BatchReader.getFeedHealth (que lee metadata()de cada adaptador, latestRoundData — un feed puede ser accesible pero estar obsoleto.
Portal para clientes
Registra feeds y configura consumidores por cadena a través del portal Oracle Gateway. Consulta la página del portal para ver qué cubre.
Direcciones desplegadas
Las direcciones canónicas por cadena (fábricas, implementaciones de adaptadores y los feeds en vivo) están en el registro. Fábricas principales, desde el live entradas del registro v0.2.0 (versión 5.0.0 en Hadrian; las direcciones de Rubicon son las que están en la Direcciones de contrato página); véase Leer la lista de contratos:
OracleAdapterFactory
0x52b008771fc95b4674a4f3533570b3d223f27f68
0x6a1340dd86c3951b6f13d9001b3951d56a2fe581
BatchReader
0x2869f0a96572e7fb15036656e9a32fd17346499b
0x580dc0ecb226530ee8a90b57e0f0cd2555fb4f0f
Restricciones
No hay datos históricos de rondas —
getRoundData(roundId)revierte; sololatestRoundData()se admite.EMA de Switchboard no compatible — los datos EMA son solo de Pyth.
Obsolescencia por cadena —
maxStalenessse establece por entorno en la puesta en marcha: los adaptadores directos (de lectura Pyth) tienen un valor predeterminado de ~60 segundos; los adaptadores con caché tienen un valor predeterminado de 3600 segundos (cuando el keeper los refresca, lo hace con mucha más frecuencia que eso).Desplazamientos del analizador se validan frente a los diseños actuales de Pyth/Switchboard; los cambios de diseño requieren nueva validación.
Qué sigue
portal Oracle Gateway — registra feeds, configura consumidores
Direcciones de contrato — precompiles y direcciones por cadena
Última actualización
¿Te fue útil?