Oracoli di prezzo
Come il protocollo trasforma lo stato della posizione LP in valori di collaterale rilevanti per il credito.
Panoramica
Avana valorizza il collaterale LP ricostruendo la posizione e valutando gli asset al suo interno. Per gli LP fungibili, il protocollo deriva il valore da prezzi esterni degli asset e dalla ricostruzione dei saldi del pool. Per la liquidità concentrata, decompone la posizione per liquidità, range, tick corrente, esposizione ai token e fee maturate.
Il risultato viene scontato nel valore di collaterale recuperabile. La capacità di prestito si basa su ciò che la posizione può sostenere in modo realistico sotto le assunzioni di rischio del mercato, non su un NAV ottimistico.
Quella distinzione tra valore di mark e valore recuperabile è ciò che rende l'oracolo utile per il lending e non solo per l'analytics. LP ERC-20, LP NFT e pool multi-asset possono condividere un'interfaccia di alto livello solo perché ogni classe passa dai propri controlli di validazione e resistenza alla manipolazione prima che il valore raggiunga lo Spoke.
LP collateral value depends on:
- I prezzi degli asset sottostanti
- Le riserve del pool o la suddivisione dell'inventario
- Fee accrual
- Per la liquidità concentrata, il tick corrente rispetto al range della posizione
- Se la posizione è in-range o prevalentemente one-sided
Interfaccia oracolo: IOracle
I Borrow Spoke hanno bisogno di una superficie di contratto unica anche se i formati LP differiscono molto tra DEX. `IOracle` fornisce quella forma comune e mantiene separati valore del principale, fee maturate e buffer riservati, così la logica di rischio successiva non deve indovinare quale parte della posizione sta osservando:
function getValue(uint256 tokenId, address asset)
external view returns (
uint256 fullValue,
uint256 feeValue,
uint256 reserveValue
);L'interfaccia nasconde il plumbing specifico del DEX allo Spoke. Così lo stesso caller può gestire LP ERC-20, LP NFT e pool multi-asset attraverso una sola forma di ritorno, lasciando spazio a un trattamento conservativo e specifico della famiglia di collaterale dietro le quinte.
Architettura multi-layer
La valorizzazione LP è un processo a stadi piuttosto che una singola lettura di spot price. Il percorso dell'oracolo passa attraverso i seguenti passi:
Prezzare gli asset sottostanti da oracoli esterni robusti
Parti da feed esterni resilienti per gli asset sottostanti, così il collaterale non eredita tutto il rumore o la manipolabilità dello stato spot grezzo del pool.
Derivare il valore LP in modo conservativo
Ricostruisci i saldi LP fungibili o decompone le posizioni a liquidità concentrata da riserve, liquidità, range e fee usando un percorso deterministico su cui lo Spoke può ragionare.
Haircut per impermanent loss e slippage di liquidazione
Sconta la mark ricostruita a un valore di collaterale recuperabile che assume stress, slippage e uscite imperfette invece di un redemption pulito al NAV teorico.
Limitare l'esposizione per famiglia LP e profondità del pool
Applica controlli basati su famiglia LP, classe di pool e profondità disponibile, così mercati più sottili o complessi non ricevono gli stessi limiti di prestito di quelli più profondi e semplici.
Liquidare in base al valore di unwind recuperabile, non al NAV ottimistico
Usa il valore che può ragionevolmente essere realizzato attraverso il percorso di unwind quando concedi capacità di prestito e decidi la liquidazione, invece del valore di mark nel caso migliore.
Gestione specifica per DEX
DEX diversi espongono pezzi di stato diversi, e l'oracolo usa quei input per ricostruire la posizione e verificare il pricing. I dati derivati dal pool non vengono accettati alla cieca come mark diretta del collaterale.
| DEX / tipo LP | Fonte oracolo | Note |
|---|---|---|
| LP Curve Stable/Stable ERC-20 | Feed esterni di stablecoin + controlli sullo stato del pool + verifica TWAP | I prezzi esterni ancorano gli asset mentre saldi del pool e maturazione delle fee determinano il valore di collaterale scontato. |
| LP Uniswap V2 ERC-20 | Chainlink + ricostruzione delle riserve + verifica TWAP | I token LP standard vengono valorizzati dai saldi sottostanti ricostruiti, con il TWAP usato come cross-check resistente alla manipolazione. |
| LP Uniswap V3 NFT | Chainlink + decomposizione della posizione + controlli tick/TWAP | L'NFT viene decomposto per liquidità, range attivo e prezzo corrente, poi haircut per il valore di liquidazione recuperabile. |
| LP Balancer multi-asset | Chainlink + ricostruzione dell'inventario weighted | I pool multi-token usano prezzi esterni e inventario weighted del pool per stimare un valore di collaterale conservativo. |
| SushiSwap / Aerodrome | Chainlink + ricostruzione delle riserve + verifica TWAP | Le osservazioni derivate dal pool verificano il valore ricostruito e aiutano a resistere ad abusi nella stessa transazione nei mercati a liquidità più bassa. |
| PancakeSwap | Chainlink + verifica TWAP basata su block | I prezzi esterni restano l'ancora mentre le osservazioni basate su block validano lo stato della posizione e le assunzioni di unwind. |
Calcolo TWAP per DEX
I TWAP sono input di verifica. Stanno accanto ai prezzi esterni degli asset e alla ricostruzione deterministica della posizione per controllare se lo stato del pool osservato è coerente con un percorso di unwind credibile. Aiutano a rifiutare distorsioni sospette o di breve durata, ma non sostituiscono da soli il modello di oracolo più ampio.
Uniswap V2 e 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
I controlli position-aware incorporano range dei tick, distribuzione della liquidità e fee maturate così il protocollo può verificare l'esposizione token decomposta di ogni LP NFT invece di trattare l'NFT come una black box.
Balancer
Le osservazioni weighted dei token vengono combinate con i pesi del pool per validare le suddivisioni di inventario multi-asset prima che l'oracolo assegni un valore di collaterale conservativo.
Curve
Le osservazioni sulle stablecoin servono principalmente a rilevare feed stale, drift delle riserve e anomalie di breve termine, mentre i prezzi esterni restano l'ancora primaria.
Trader Joe e Aerodrome
Le osservazioni cumulative di prezzo su una finestra di 30-60 minuti aiutano a validare lo stato di pool a liquidità più bassa e a resistere alla manipolazione nella stessa transazione durante i controlli sul collaterale.
Sicurezza e prevenzione della manipolazione
- Soglie di deviazione
Nuovi prestiti o liquidazioni possono essere messi in pausa quando i dati di verifica derivati dal pool si allontanano troppo dai prezzi di riferimento esterni oltre
maxDifference. - maxPoolPriceDifference
Questo mantiene lo stato implicito del pool allineato ai prezzi dei token sottostanti e limita la manipolazione istantanea del pool o l'abuso dell'oracolo nella stessa transazione.
- Cap di open interest
L'esposizione è limitata per famiglia LP, profondità del pool e complessità del collaterale, così i mercati più sottili ricevono limiti di prestito più stretti.
- Haircut di recovery
L'oracolo sconta il valore LP teorico per impermanent loss, slippage di unwind e assunzioni di liquidazione sotto stress prima che venga concessa qualsiasi capacità di prestito.
- Oracle Sentinel
Oracle Sentinel monitora la salute dei feed e gli input di verifica e può attivare un comportamento di fallback quando i dati sono stale, compromessi o inconsistenti con i controlli sullo stato della posizione.
Parametri oracolo configurabili
Le impostazioni oracolo specifiche del pool vengono configurate per token tramite setTokenConfig. La tabella seguente mostra i parametri che definiscono come un token e il pool associato devono essere controllati:
| Parametro | Descrizione |
|---|---|
| Token | Indirizzo del token di collaterale |
| AggregatorV3Interface | Feed Chainlink per il token sottostante |
| maxFeedAge | Età massima accettabile per il feed Chainlink |
| Pool | Pool DEX specifico (Uniswap V3, Balancer, Curve, ecc.) |
| twapSeconds | Finestra per il calcolo TWAP |
| Mode | Modalità operativa dell'oracolo (standard/fallback) |
| maxDifference | Deviazione massima consentita tra prezzo DEX e prezzo di verifica |
In pratica, il comportamento dell'oracolo nasce dalla combinazione di pricing esterno degli asset, logica di ricostruzione LP, trattamento del valore recuperabile e impostazioni per token configurate tramitesetTokenConfig.