eth-prices 0.0.11

[!IMPORTANT] eth-prices aims to provide ethereum price estimation only. It is not intended for nor provides guarantees of exchange rates.

Quickstart

cargo add eth-prices

use eth_prices::{
    quoter::{Quoter, RateDirection},
    asset::Asset,
};

// Define your data sources
let quoter = vec![
    UniswapV2Quoter::from_selector(provider, UniswapV2Selector::Pair { pair_address }).await,
    UniswapV3Quoter::from_selector(provider, UniswapV3Selector::Pool { pool_address }).await,
    ERC4626Quoter::new(vault_address, provider).await,
    FixedQuoter::new(fixed_rate, provider).await,
];

// Create a router
let router = QuoterGraph::new(quoters);

// Compute a route
let token_in = TokenIdentifier::ERC20 { address: address!("0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48") };
let token_out = TokenIdentifier::Fiat { symbol: "usd".to_string() };
let route = router.compute(&token_in, &token_out).await.unwrap();

// Get the latest block number
let block = provider.get_block_number().await.unwrap();

// Quote the rate
let quote = route.quote(block, amount_in).await.unwrap();

Data Sources

Currently supported data sources include:

• Uniswap V2 - for Uniswap V2 pairs
• Uniswap V3 - for Uniswap V3 pools
• ERC-4626 - for ERC-4626-compatible vaults (Morpho, Aave, etc.)
• Fixed - for static rates, such as WETH to ETH, or USDC to USD
• European Central Bank - for fiat exchange rates (uses single HTTP call and requires feature flag ecb)
• Chainlink - for Chainlink Price Feeds

Examples

This crate has a few examples you can toy around with:

• Uniswap V2 Quoter - to quote rates for Uniswap V2 pairs
• Prometheus Exporter - to export price data to metrics
• Fiat Quoter - to quote fiat rates
• Auto Router - to automatically discover quoters and build a router

Documentation

You can read the documentation at docs.rs/eth-prices.