Oráculos de Preço
Como o protocolo transforma o estado da posição LP em valores de colateral relevantes para crédito.
Visão Geral
A Avana precifica o colateral LP reconstruindo a posição e avaliando os ativos dentro dela. Para LPs fungíveis, o protocolo deriva o valor a partir de preços externos dos ativos e da reconstrução dos saldos do pool. Para liquidez concentrada, ele decompõe a posição por liquidez, range, tick atual, exposição a tokens e taxas acumuladas.
O resultado é descontado para o valor recuperável do colateral. O poder de empréstimo se baseia no que a posição pode realisticamente suportar sob as premissas de risco do mercado, e não em um NAV otimista.
Essa distinção entre mark value e valor recuperável é o que mantém o oráculo útil para lending, e não só para analytics. LPs ERC-20, LPs NFT e pools multiativos podem compartilhar uma interface de alto nível só porque cada classe passa pelas próprias checagens de validação e resistência a manipulação antes de o valor chegar ao Spoke.
LP collateral value depends on:
- Os preços dos ativos subjacentes
- As reservas do pool ou a divisão de inventário
- Fee accrual
- Para liquidez concentrada, o tick atual em relação ao range da posição
- Se a posição está in-range ou majoritariamente one-sided
Interface do Oráculo: IOracle
Borrow Spokes precisam de uma superfície de contrato única mesmo com formatos de LP bem diferentes entre DEXs. `IOracle` fornece esse formato comum e mantém separados o valor do principal, as taxas acumuladas e os buffers reservados, para que a lógica de risco posterior não tenha de adivinhar qual parte da posição está olhando:
function getValue(uint256 tokenId, address asset)
external view returns (
uint256 fullValue,
uint256 feeValue,
uint256 reserveValue
);A interface esconde o plumbing específico do DEX do Spoke. Isso permite que o mesmo caller trate LPs ERC-20, LPs NFT e pools multiativos com um único formato de retorno, ainda deixando espaço para tratamento conservador específico da família de colateral nos bastidores.
Arquitetura Multicamada
A avaliação de LP é um processo em etapas, e não uma única leitura de spot. O caminho do oráculo passa pelos seguintes passos:
Precificar ativos subjacentes a partir de oráculos externos robustos
Comece por feeds externos resilientes dos ativos subjacentes para que o colateral não herde todo o ruído ou a manipulabilidade do spot cru do pool.
Derivar o valor do LP de forma conservadora
Reconstrua saldos de LP fungível ou decomponha posições de liquidez concentrada a partir de reservas, liquidez, range e taxas, usando um caminho determinístico sobre o qual o Spoke possa raciocinar.
Haircut por perda impermanente e slippage de liquidação
Desconte o mark reconstruído para um valor recuperável de colateral que assume estresse, slippage e saídas imperfeitas, e não um resgate limpo no NAV teórico.
Limitar exposição por família de LP e profundidade do pool
Aplique controles com base na família de LP, classe do pool e profundidade disponível para que mercados mais finos ou complexos não recebam os mesmos limites de empréstimo que mercados mais profundos e simples.
Liquidar com base no valor recuperável de unwind, não em NAV otimista
Use o valor que pode ser realizado de forma razoável pelo caminho de unwind ao conceder poder de empréstimo e decidir liquidação, e não o mark no melhor cenário.
Tratamento Específico por DEX
DEXs diferentes expõem pedaços diferentes de estado, e o oráculo usa esses inputs para reconstruir a posição e verificar a precificação. Dados derivados do pool não são aceitos cegamente como mark direto de colateral.
| DEX / Tipo de LP | Fonte do Oráculo | Notas |
|---|---|---|
| LPs Curve Stable/Stable ERC-20 | Feeds externos de stablecoin + checagens de estado do pool + verificação TWAP | Preços externos ancoram os ativos enquanto saldos do pool e acumulação de taxas determinam o valor descontado do colateral. |
| LPs Uniswap V2 ERC-20 | Chainlink + reconstrução de reservas + verificação TWAP | Tokens LP padrão são avaliados a partir dos saldos subjacentes reconstruídos, com TWAP usado como cross-check resistente a manipulação. |
| LPs Uniswap V3 NFT | Chainlink + decomposição de posição + checagens de tick/TWAP | O NFT é decomposto por liquidez, range ativo e preço atual, e depois recebe haircut para o valor recuperável de liquidação. |
| LPs Balancer Multiativos | Chainlink + reconstrução de inventário ponderado | Pools multi-token usam preços externos e inventário ponderado do pool para estimar um valor conservador de colateral. |
| SushiSwap / Aerodrome | Chainlink + reconstrução de reservas + verificação TWAP | Observações derivadas do pool verificam o valor reconstruído e ajudam a resistir a abuso na mesma transação em mercados de menor liquidez. |
| PancakeSwap | Chainlink + verificação TWAP baseada em bloco | Preços externos permanecem a âncora enquanto observações baseadas em bloco validam o estado da posição e as premissas de unwind. |
Computação de TWAP por DEX
TWAPs são inputs de verificação. Eles ficam ao lado dos preços externos dos ativos e da reconstrução determinística da posição para checar se o estado do pool observado é consistente com um caminho de unwind crível. Ajudam a rejeitar distorções suspeitas ou de curta duração, mas não substituem sozinhos o modelo mais amplo de oráculo.
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
Checagens conscientes da posição incorporam range de tick, distribuição de liquidez e taxas acumuladas para que o protocolo verifique a exposição decomposta a tokens de cada LP NFT, em vez de tratar o NFT como uma caixa-preta.
Balancer
Observações ponderadas de tokens são combinadas com os pesos do pool para validar divisões de inventário multiativo antes de o oráculo atribuir um valor conservador de colateral.
Curve
Observações de stablecoin são usadas principalmente para detectar feeds defasados, drift de reservas e anomalias de curto prazo, enquanto preços externos permanecem a âncora primária.
Trader Joe & Aerodrome
Observações cumulativas de preço em uma janela de 30-60 minutos ajudam a validar o estado de pools de menor liquidez e a resistir a manipulação na mesma transação durante checagens de colateral.
Segurança e Prevenção de Manipulação
- Limiares de Desvio
Novos empréstimos ou liquidações podem ser pausados quando dados de verificação derivados do pool se afastam demais dos preços de referência externos além de
maxDifference. - maxPoolPriceDifference
Isso mantém o estado implícito do pool alinhado aos preços dos tokens subjacentes e limita manipulação instantânea do pool ou abuso de oráculo na mesma transação.
- Tetos de Open Interest
A exposição é limitada por família de LP, profundidade do pool e complexidade do colateral para que mercados mais finos recebam limites de empréstimo mais apertados.
- Recovery Haircuts
O oráculo desconta o valor teórico do LP por perda impermanente, slippage de unwind e premissas de liquidação sob estresse antes de conceder qualquer poder de empréstimo.
- Oracle Sentinel
O Oracle Sentinel observa a saúde dos feeds e os inputs de verificação e pode acionar comportamento de fallback quando os dados estão defasados, comprometidos ou inconsistentes com as checagens de estado da posição.
Parâmetros Configuráveis do Oráculo
Configurações de oráculo específicas do pool são definidas por token via setTokenConfig. A tabela abaixo mostra os parâmetros que definem como um token e seu pool associado devem ser verificados:
| Parâmetro | Descrição |
|---|---|
| Token | Endereço do token de colateral |
| AggregatorV3Interface | Feed Chainlink do token subjacente |
| maxFeedAge | Idade máxima aceitável do feed Chainlink |
| Pool | Pool específico do DEX (Uniswap V3, Balancer, Curve etc.) |
| twapSeconds | Janela para computação de TWAP |
| Modo | Modo operacional do oráculo (standard/fallback) |
| maxDifference | Desvio máximo permitido entre o preço do DEX e o de verificação |
Na prática, o comportamento do oráculo vem da combinação de precificação externa de ativos, lógica de reconstrução de LP, tratamento de valor recuperável e as configurações por token definidas viasetTokenConfig.