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 estimar o valor recuperável do colateral sob as suposições de risco do mercado. Portanto, a capacidade de empréstimo reflete tanto os ativos subjacentes da posição quanto as condições sob as quais eles poderiam ser recuperados durante a liquidação. A distinção entre valor da posição e valor recuperável é importante porque o oráculo fornece entradas para decisões de empréstimo. ERC-20 LP tokens, posições NFT e pools de múltiplos ativos compartilham uma interface, mas cada formato possui suas próprias verificações de reconstrução, validação e manipulação antes que seu valor alcance o Borrow 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
`IOracle` fornece a Borrow Spokes uma interface de avaliação comum em LP formatos. Seus valores de retorno distinguem principal, taxas acumuladas e reservas, para que o chamador possa contabilizar cada componente separadamente:
function getValue(uint256 tokenId, address asset)
external view returns (
uint256 fullValue,
uint256 feeValue,
uint256 reserveValue
);O adaptador por trás desta interface lida com a reconstrução e validação específicas do DEX. Borrow Spokes recebem os mesmos campos de retorno para ERC-20 LP tokens, posição NFTs e pools multiativos, enquanto cada implementação aplica as verificações exigidas pelo seu tipo de garantia.
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
Os feeds externos fornecem preços de referência para os tokens subjacentes. Isso separa a entrada do preço do ativo do preço de negociação instantâneo do pool, que pode ser afetado por negociações de curta duração ou manipulação.
Derivar o valor do LP de forma conservadora
O oráculo reconstrói saldos fungíveis LP ou decompõe posições de liquidez concentrada usando reservas, liquidez, alcance e taxas acumuladas. Esses elementos determinam os ativos representados pela posição.
Haircut por perda impermanente e slippage de liquidação
O valor reconstruído é descontado para condições de mercado estressadas, deslizamento na liquidação e a rota de saída da posição. O valor resultante estima o que a liquidação poderia recuperar.
Limitar exposição por família de LP e profundidade do pool
Os controles de exposição usam a família LP, o tipo pool e a profundidade de liquidez disponível para limitar quanto endividamento um mercado pode suportar.
Aplicar valor recuperável ao empréstimo e liquidação
A capacidade de empréstimo e as verificações de liquidação utilizam o valor estimado recuperável pela rota de desfazimento configurada.
Tratamento Específico por DEX
Cada DEX expõe uma posição diferente e pool dados. O oráculo reconstrói os ativos subjacentes a partir desses dados e verifica a valoração resultante em relação aos seus preços de referência e controles de risco.
| 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
Os preços médios ponderados pelo tempo (TWAPs) fornecem dados de verificação juntamente com os preços de ativos externos e a reconstrução de posições. Comparar essas entradas ajuda a identificar distorções de preço de curta duração ou estado pool inconsistente. Os dados TWAP complementam o processo de avaliação em vez de fornecer o valor do colateral por conta própria.
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
Para posições de liquidez concentrada, as verificações usam faixa de ticks, distribuição de liquidez e taxas acumuladas para verificar a exposição ao token representada por cada NFT.
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 e 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.
- Descontos de recuperação
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.
- Sentinela do oráculo
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 lista os parâmetros usados para validar o fluxo de preço de um token e o pool associado:
| Parâmetro | Descrição |
|---|---|
| Ficha | Endereço do token de colateral |
| AggregatorV3Interface | Feed Chainlink do token subjacente |
| maxFeedAge | Idade máxima aceitável do feed Chainlink |
| Pool de liquidez | 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.