atv

Discovers and enumerates tokenized yield vaults across Ethereum and Base networks by querying on-chain vault registries and metadata contracts. Implements network-aware discovery that differentiates between mainnet and Layer 2 deployments, returning vault addresses, underlying asset compositions, and current TVL metrics through MCP tool bindings that abstract RPC calls.

Retrieves historical and real-time performance metrics for vaults including APY, yield distribution history, fee structures, and asset allocation changes. Queries on-chain vault state and event logs to compute performance indicators, then normalizes data into standardized metrics accessible via MCP tools. Handles multi-token vault compositions and fee deductions in APY calculations.

Estimates gas costs for vault operations (deposits, withdrawals, approvals) by simulating transactions and querying current gas prices. Returns gas estimates in wei and USD equivalent using current ETH/USD prices. Supports gas price overrides for custom priority levels.

Assesses vault risks including smart contract risk, liquidity risk, concentration risk, and governance risk. Scores vaults on multiple risk dimensions and provides a composite risk score. Analyzes vault TVL, asset concentration, governance structure, and audit status to produce risk metrics.

Analyzes historical vault performance over multiple time horizons (1 week, 1 month, 3 months, 1 year, etc.) by computing returns, volatility, and Sharpe ratios. Queries historical share prices and yield distributions to compute performance metrics. Supports comparison of vault performance against benchmarks or other vaults.

Simulates vault rebalancing scenarios to show how asset allocation changes would impact returns and fees. Allows users to specify target allocations and simulates the rebalancing process including transaction costs and slippage. Returns projected outcomes and cost analysis for proposed rebalancing.

Generates recommendations for optimizing yield by analyzing user's current vault positions and suggesting alternative vaults or rebalancing actions. Uses multi-vault comparison, performance analysis, and fee optimization to identify opportunities for improved risk-adjusted returns. Ranks recommendations by potential impact and implementation cost.

Aggregates vault positions across Ethereum and Base into a unified view with cross-chain portfolio metrics. Queries vault holdings on both chains, converts to common reference currency, and provides consolidated portfolio analytics. Handles chain-specific gas costs and liquidity considerations in recommendations.

Retrieves governance information for vaults including voting rights, governance token holders, and active proposals. Queries governance contracts to show voting power distribution and proposal details. Enables users to understand vault governance structure and participate in governance decisions.

Analyzes vault liquidity by examining underlying asset liquidity and vault share trading volume. Estimates slippage for deposits and withdrawals of various sizes using liquidity depth analysis. Provides recommendations for optimal transaction sizing to minimize slippage impact.

Constructs unsigned Ethereum transactions for depositing assets into vaults, handling token approvals, slippage calculations, and multi-step transaction sequencing. Generates calldata for vault deposit functions, estimates gas costs, and returns transaction objects ready for signing. Supports both single-token and multi-token vault deposits with automatic approval transaction generation when needed.

Constructs unsigned transactions for withdrawing assets from vaults, handling share-to-asset conversion, withdrawal fees, and multi-token redemptions. Generates calldata for vault withdrawal/redeem functions, calculates expected output amounts accounting for slippage and fees, and returns transaction objects ready for signing. Supports both share-based and asset-based withdrawal specifications.

Tracks user vault holdings across Ethereum and Base by querying vault share balances and converting them to underlying asset values. Aggregates multi-vault positions into a unified portfolio view with total value, per-vault breakdown, and asset composition. Queries on-chain vault state to compute current share prices and converts holdings to USD or other reference currencies using price feeds.

Calculates current share prices for vaults by querying vault total assets and total shares, then computing the ratio. Handles multi-token vaults by converting all underlying assets to a common reference currency before computing per-share value. Returns both raw share prices and USD-denominated prices using integrated price feeds.

Retrieves and analyzes vault fee structures including management fees, performance fees, withdrawal fees, and deposit fees. Queries vault contracts for fee parameters and computes the impact of fees on net returns over various time horizons. Breaks down fee components and shows how fees affect APY calculations.

Compares multiple vaults across standardized metrics (APY, fees, TVL, risk profile, asset composition) and ranks them based on user-specified criteria. Aggregates vault discovery, performance metrics, and fee analysis into a single comparison view. Supports custom ranking functions that weight different metrics (e.g., maximize risk-adjusted returns, minimize fees, maximize TVL for liquidity).

Tracks the underlying asset composition of vaults and how it changes over time. Queries vault holdings and rebalancing events to show what assets are currently held and in what proportions. Supports multi-token vaults and tracks asset allocation changes resulting from yield distributions, rebalancing, or market movements.

Retrieves historical yield distributions from vaults including distribution amounts, timing, and asset types. Queries vault event logs to extract distribution events and computes yield metrics from distribution history. Supports analysis of yield consistency, distribution frequency, and yield sources.