Price Oracles
Wie das Protokoll LP-Positionszustand in credit-relevante Collateral-Werte verwandelt.
Überblick
Avana bepreist LP-Collateral, indem es die Position rekonstruiert und die Assets darin bewertet. Bei fungiblen LPs leitet das Protokoll Wert aus externen Asset-Preisen und Pool-Saldo-Rekonstruktion ab. Bei Concentrated Liquidity zerlegt es die Position nach Liquidität, Range, aktuellem Tick, Token-Exposure und aufgelaufenen Fees.
Das Ergebnis wird auf erzielbaren Collateral-Wert abgezinst. Ausleihkraft basiert darauf, was die Position unter den Risikoannahmen des Marktes realistisch tragen kann — nicht auf einem optimistischen Net Asset Value.
Dieser Unterschied zwischen Mark-Wert und erzielbarem Wert hält das Oracle für Lending nützlich, nicht nur für Analytics. ERC-20-LPs, NFT-LPs und Multi-Asset-Pools können eine gemeinsame High-Level-Schnittstelle teilen, weil jede Klasse eigene Validierungs- und Manipulationsschutz-Checks durchläuft, bevor der Wert den Spoke erreicht.
LP collateral value depends on:
- Die Preise der Underlying-Assets
- Die Pool-Reserven oder Inventaraufteilung
- Fee accrual
- Bei Concentrated Liquidity der aktuelle Tick relativ zur Positions-Range
- Ob die Position in-range oder überwiegend einseitig ist
Oracle Interface: IOracle
Borrow Spokes brauchen eine Contract-Oberfläche, auch wenn LP-Formate über DEXs stark variieren. `IOracle` liefert diese gemeinsame Form und hält Principal-Wert, aufgelaufene Fees und reservierte Buffer getrennt, damit spätere Risikologik nicht raten muss, welchen Teil der Position sie betrachtet:
function getValue(uint256 tokenId, address asset)
external view returns (
uint256 fullValue,
uint256 feeValue,
uint256 reserveValue
);Das Interface verbirgt DEX-spezifisches Plumbing vor dem Spoke. Derselbe Caller kann so ERC-20-LPs, NFT-LPs und Multi-Asset-Pools über eine Return-Form handhaben und trotzdem konservative, collateral-familien-spezifische Behandlung hinter den Kulissen lassen.
Multi-Layer-Architektur
LP-Bewertung ist ein gestufter Prozess, kein einzelner Spot-Preis-Read. Der Oracle-Pfad durchläuft die folgenden Schritte:
Underlying-Assets über robuste externe Oracles bepreisen
Starten Sie mit resilienten externen Feeds für die Underlying-Assets, damit Collateral nicht das volle Rauschen oder die Manipulierbarkeit des rohen Pool-Spot-Zustands erbt.
LP-Wert konservativ ableiten
Fungible LP-Salden rekonstruieren oder Concentrated-Liquidity-Positionen aus Reserven, Liquidität, Range und Fees über einen deterministischen Pfad zerlegen, den der Spoke nachvollziehen kann.
Haircut für Impermanent Loss und Liquidations-Slippage
Diskontieren Sie den rekonstruierten Mark auf einen erzielbaren Collateral-Wert, der Stress, Slippage und unvollkommene Exits annimmt — keine saubere Einlösung zum theoretischen NAV.
Exposure nach LP-Familie und Pool-Tiefe begrenzen
Kontrollen nach LP-Familie, Pool-Klasse und verfügbarer Tiefe anwenden, damit dünnere oder komplexere Märkte nicht dieselben Ausleihlimits wie tiefere, einfachere erhalten.
Liquidieren auf Basis erzielbaren Unwind-Werts, nicht optimistischem NAV
Nutzen Sie den Wert, der über den Unwind-Pfad vernünftig realisierbar ist, wenn Sie Ausleihkraft gewähren und Liquidation entscheiden — nicht den Best-Case-Mark.
DEX-spezifisches Handling
Unterschiedliche DEXs exponieren unterschiedliche State-Teile; das Oracle nutzt diese Inputs, um die Position zu rekonstruieren und Pricing zu verifizieren. Pool-abgeleitete Daten werden nicht blind als direkter Collateral-Mark akzeptiert.
| DEX / LP-Typ | Oracle-Quelle | Hinweise |
|---|---|---|
| Curve Stable/Stable ERC-20 LPs | Externe Stablecoin-Feeds + Pool-State-Checks + TWAP-Verifikation | Externe Preise verankern die Assets, während Pool-Salden und Fee-Accrual den abgezinsten Collateral-Wert bestimmen. |
| Uniswap V2 ERC-20 LPs | Chainlink + Reserve-Rekonstruktion + TWAP-Verifikation | Standard-LP-Token werden aus rekonstruierten Underlying-Salden bewertet; TWAP dient als manipulationsresistenter Cross-Check. |
| Uniswap V3 NFT LPs | Chainlink + Positionszerlegung + Tick-/TWAP-Checks | Das NFT wird nach Liquidität, aktiver Range und aktuellem Preis zerlegt und dann für erzielbaren Liquidationswert abgezinst. |
| Balancer Multi-Asset LPs | Chainlink + gewichtete Inventarrekonstruktion | Multi-Token-Pools nutzen externe Preise und gewichtetes Pool-Inventar, um konservativen Collateral-Wert zu schätzen. |
| SushiSwap / Aerodrome | Chainlink + Reserve-Rekonstruktion + TWAP-Verifikation | Pool-abgeleitete Observations verifizieren rekonstruierten Wert und helfen, Same-Transaction-Missbrauch in märkten mit niedrigerer Liquidität zu widerstehen. |
| PancakeSwap | Chainlink + blockbasierte TWAP-Verifikation | Externe Preise bleiben Anker, während blockbasierte Observations Positionszustand und Unwind-Annahmen validieren. |
TWAP-Berechnung nach DEX
TWAPs sind Verifikationsinputs. Sie stehen neben externen Asset-Preisen und deterministischer Positionsrekonstruktion, um zu prüfen, ob der beobachtete Pool-Zustand mit einem glaubwürdigen Unwind-Pfad konsistent ist. Sie helfen, verdächtige oder kurzlebige Verzerrungen abzulehnen, ersetzen aber nicht allein das breitere Oracle-Modell.
Uniswap V2 & 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
Positionsbewusste Checks beziehen Tick-Range, Liquiditätsverteilung und aufgelaufene Fees ein, damit das Protokoll die zerlegte Token-Exposure jedes NFT-LP verifizieren kann — statt das NFT als Black Box zu behandeln.
Balancer
Gewichtete Token-Observations werden mit Pool-Weights kombiniert, um Multi-Asset-Inventaraufteilungen zu validieren, bevor das Oracle einen konservativen Collateral-Wert zuweist.
Curve
Stablecoin-Observations dienen vor allem dazu, stale Feeds, Reserve-Drift und kurzfristige Anomalien zu erkennen, während externe Preise primärer Anker bleiben.
Trader Joe & Aerodrome
Kumulierte Preisobservations über ein 30–60-Minuten-Fenster helfen, Pool-Zustand mit niedrigerer Liquidität zu validieren und Same-Transaction-Manipulation bei Collateral-Checks zu widerstehen.
Sicherheit & Manipulationsschutz
- Deviation Thresholds
Neue Kredite oder Liquidationen können pausiert werden, wenn pool-abgeleitete Verifikationsdaten zu weit von externen Referenzpreisen abweichen jenseits von
maxDifference. - maxPoolPriceDifference
Das hält pool-implizierten State an Underlying-Tokenpreisen ausgerichtet und begrenzt instantane Pool-Manipulation oder Same-Transaction-Oracle-Missbrauch.
- Open Interest Caps
Exposure wird nach LP-Familie, Pool-Tiefe und Collateral-Komplexität begrenzt, damit dünnere Märkte engere Ausleihlimits erhalten.
- Recovery Haircuts
Das Oracle diskontiert theoretischen LP-Wert für Impermanent Loss, Unwind-Slippage und gestresste Liquidationsannahmen, bevor Ausleihkraft gewährt wird.
- Oracle Sentinel
Oracle Sentinel überwacht Feed-Health und Verifikationsinputs und kann Fallback-Verhalten auslösen, wenn Daten stale, kompromittiert oder inkonsistent mit Positions-State-Checks sind.
Konfigurierbare Oracle-Parameter
Pool-spezifische Oracle-Settings werden pro Token konfiguriert über setTokenConfig. Die Tabelle unten zeigt die Parameter, die definieren, wie ein Token und sein zugehöriger Pool geprüft werden sollen:
| Parameter | Beschreibung |
|---|---|
| Token | Collateral-Token-Adresse |
| AggregatorV3Interface | Chainlink-Feed für Underlying-Token |
| maxFeedAge | Maximal akzeptables Alter für Chainlink-Feed |
| Pool | Spezifischer DEX-Pool (Uniswap V3, Balancer, Curve usw.) |
| twapSeconds | Fenster für TWAP-Berechnung |
| Mode | Oracle-Betriebsmodus (standard/fallback) |
| maxDifference | Maximal erlaubte Abweichung zwischen DEX- und Verifikationspreis |
In der Praxis entsteht Oracle-Verhalten aus der Kombination von externem Asset-Pricing, LP-Rekonstruktionslogik, Behandlung erzielbaren Werts und den per-Token-Settings konfiguriert übersetTokenConfig.