Oráculos de precios
Cómo el protocolo convierte el estado de una posición LP en valores de colateral relevantes para el crédito.
Descripción general
Avana valora el colateral LP reconstruyendo la posición y valorando los activos que contiene. En LPs fungibles, el protocolo deriva el valor a partir de precios externos de activos y de la reconstrucción de saldos del pool. En liquidez concentrada, descompone la posición por liquidez, rango, tick actual, exposición a tokens y comisiones acumuladas. El resultado se descuenta para estimar el valor recuperable del colateral bajo las suposiciones de riesgo del mercado. Por lo tanto, la capacidad de endeudamiento refleja tanto los activos subyacentes de la posición como las condiciones bajo las cuales podrían recuperarse durante la liquidación. La distinción entre el valor de la posición y el valor recuperable es importante porque el oráculo proporciona entradas para las decisiones de préstamo. ERC-20 LP tokens, posición NFTs y pools multi-activo comparten una interfaz, pero cada formato tiene sus propias comprobaciones de reconstrucción, validación y manipulación antes de que su valor llegue al Borrow Spoke.
LP collateral value depends on:
- Los precios de los activos subyacentes
- Las reservas del pool o la división del inventario
- Fee accrual
- En liquidez concentrada, el tick actual relativo al rango de la posición
- Si la posición está in-range o es mayormente unilateral
Interfaz Oracle: IOracle
`IOracle` ofrece a Borrow Spokes una interfaz de valoración común a través de LP formatos. Sus valores de retorno distinguen entre principal, honorarios acumulados y reservas, de modo que el llamador pueda contabilizar cada componente por separado:
function getValue(uint256 tokenId, address asset)
external view returns (
uint256 fullValue,
uint256 feeValue,
uint256 reserveValue
);El adaptador detrás de esta interfaz maneja la reconstrucción y validación específicas de DEX. Borrow Spokes reciben los mismos campos de retorno para ERC-20 LP tokens, posiciones NFT y pools de activos múltiples, mientras que cada implementación aplica las verificaciones requeridas por su tipo de garantía.
Arquitectura multicapa
La valoración LP es un proceso por etapas más que una sola lectura de precio spot. La ruta del oráculo avanza por los siguientes pasos:
Valorar activos subyacentes con oráculos externos robustos
Los feeds externos proporcionan precios de referencia para los tokens subyacentes. Esto separa la entrada del precio del activo del precio de negociación instantáneo de pool, que puede verse afectado por operaciones de corta duración o manipulación.
Derivar el valor LP de forma conservadora
El oráculo reconstruye los saldos fungibles LP o descompone posiciones de liquidez concentrada utilizando reservas, liquidez, rango y comisiones acumuladas. Estas entradas determinan los activos representados por la posición.
Haircut por pérdida impermanente y slippage de liquidación
El valor reconstruido se descuenta por condiciones de mercado estresadas, deslizamiento de liquidación y la ruta de salida de la posición. El valor resultante estima lo que la liquidación podría recuperar.
Limitar la exposición por familia LP y profundidad del pool
Los controles de exposición utilizan la familia LP, el tipo pool y la profundidad de liquidez disponible para limitar cuánto préstamo puede soportar un mercado.
Aplicar valor recuperable a préstamos y liquidación
La capacidad de endeudamiento y las verificaciones de liquidación utilizan el valor estimado recuperable a través de la ruta de deshacer configurada.
Manejo específico por DEX
Cada DEX expone diferentes posiciones y datos pool. El oráculo reconstruye los activos subyacentes a partir de esos datos y verifica la valoración resultante contra sus precios de referencia y controles de riesgo.
| DEX / tipo LP | Fuente del oráculo | Notas |
|---|---|---|
| Curve Stable/Stable ERC-20 LPs | Feeds externos de stablecoins + comprobaciones de estado del pool + verificación TWAP | Los precios externos anclan los activos mientras los saldos del pool y la acumulación de comisiones determinan el valor de colateral descontado. |
| Uniswap V2 ERC-20 LPs | Chainlink + reconstrucción de reservas + verificación TWAP | Los tokens LP estándar se valoran a partir de saldos subyacentes reconstruidos, usando TWAP como verificación resistente a manipulación. |
| Uniswap V3 NFT LPs | Chainlink + descomposición de posición + comprobaciones de tick/TWAP | El NFT se descompone por liquidez, rango activo y precio actual, y luego se aplica haircut al valor recuperable de liquidación. |
| Balancer Multi-Asset LPs | Chainlink + reconstrucción de inventario ponderado | Los pools multi-token usan precios externos e inventario ponderado del pool para estimar un valor de colateral conservador. |
| SushiSwap / Aerodrome | Chainlink + reconstrucción de reservas + verificación TWAP | Las observaciones derivadas del pool verifican el valor reconstruido y ayudan a resistir abusos en la misma transacción en mercados de menor liquidez. |
| PancakeSwap | Chainlink + verificación TWAP basada en bloques | Los precios externos siguen siendo el ancla mientras las observaciones basadas en bloques validan el estado de la posición y los supuestos de unwind. |
Cómputo de TWAP por DEX
Los precios promedio ponderados por tiempo (TWAPs) proporcionan datos de verificación junto con los precios externos de los activos y la reconstrucción de posiciones. Comparar estos insumos ayuda a identificar distorsiones de precios de corta duración o un estado pool inconsistente. Los datos TWAP complementan el proceso de valoración en lugar de suministrar el valor del colateral por sí solos.
Uniswap V2 y SushiSwap
On-chain cumulative price data over a 1-hour window is used to cross-check the reconstructed reserve picture and reduce sensitivity to flash swaps or other short-lived pool distortions.
Uniswap V3
Para las posiciones de liquidez concentrada, las verificaciones utilizan el rango de ticks, la distribución de liquidez y las comisiones acumuladas para verificar la exposición a tokens representada por cada NFT.
Balancer
Las observaciones ponderadas de tokens se combinan con los pesos del pool para validar las divisiones de inventario multi-activo antes de que el oráculo asigne un valor de colateral conservador.
Curve
Las observaciones de stablecoins se usan principalmente para detectar feeds obsoletos, drift de reservas y anomalías de corto plazo, mientras los precios externos siguen siendo el ancla principal.
Trader Joe y Aerodrome
Las observaciones acumuladas de precio en una ventana de 30-60 minutos ayudan a validar el estado de pools de menor liquidez y a resistir la manipulación en la misma transacción durante las comprobaciones de colateral.
Seguridad y prevención de manipulación
- Umbrales de desviación
Los nuevos préstamos o liquidaciones pueden pausarse cuando los datos de verificación derivados del pool se alejan demasiado de los precios de referencia externos más allá de
maxDifference. - maxPoolPriceDifference
Esto mantiene el estado implícito del pool alineado con los precios de los tokens subyacentes y limita la manipulación instantánea del pool o el abuso del oráculo en la misma transacción.
- Límites de open interest
La exposición se limita por familia LP, profundidad del pool y complejidad del colateral para que los mercados más delgados reciban límites de préstamo más estrictos.
- Haircuts de recuperación
El oráculo descuenta el valor teórico del LP por pérdida impermanente, slippage de unwind y supuestos de liquidación estresada antes de otorgar cualquier capacidad de préstamo.
- Centinela del oráculo
Oracle Sentinel vigila la salud de los feeds y las entradas de verificación, y puede activar comportamiento de fallback cuando los datos están obsoletos, comprometidos o son inconsistentes con las comprobaciones de estado de la posición.
Parámetros configurables del oráculo
Los ajustes de oráculo específicos del pool se configuran por token mediante setTokenConfig. La tabla a continuación enumera los parámetros utilizados para validar la fuente de precio de un token y el pool asociado:
| Parámetro | Descripción |
|---|---|
| Ficha | Dirección del token de colateral |
| AggregatorV3Interface | Feed de Chainlink para el token subyacente |
| maxFeedAge | Edad máxima aceptable del feed de Chainlink |
| Fondo de liquidez | Pool DEX específico (Uniswap V3, Balancer, Curve, etc.) |
| twapSeconds | Ventana para el cómputo de TWAP |
| Modo | Modo operativo del oráculo (standard/fallback) |
| maxDifference | Desviación máxima permitida entre el precio DEX y el de verificación |
En la práctica, el comportamiento del oráculo surge de la combinación de pricing externo de activos, lógica de reconstrucción LP, tratamiento de valor recuperable y los ajustes por token configurados mediantesetTokenConfig.