AgentFi — DeFi Tools for AI Agents

Executes token swaps across EVM chains (Ethereum, Base, Arbitrum, Polygon) by constructing swap transactions through DEX aggregator integration, simulating execution on-chain via eth_call to validate slippage and gas costs before broadcasting to the network. Uses Safe smart wallet as execution context with MPC key management via Turnkey, ensuring swaps are policy-constrained and reversible until final broadcast.

Queries real-time token balances and market prices across EVM chains by calling ERC-20 balanceOf() for on-chain state and integrating with price oracles (Chainlink, Uniswap TWAP, or DEX spot prices) to return current portfolio value. Caches price data with configurable TTL to reduce oracle calls and RPC load, returning structured balance/price tuples for agent decision-making.

Simulates pending transactions using eth_call RPC method to execute transactions in a read-only mode, returning the expected output (swap amounts, collateral ratios, transfer status, etc.) without modifying blockchain state. Detects transaction failures (reverts, out-of-gas, insufficient balance) before broadcast, and provides detailed error messages to help agents understand why transactions would fail. Integrates with all DeFi operations to provide pre-broadcast validation.

Supplies ERC-20 tokens to Aave lending pools and manages collateral by calling Aave V3 contract functions (supply, withdraw, borrow, repay) through Safe smart wallet. Validates collateral ratios and liquidation thresholds before execution via simulation, preventing over-leveraged positions. Tracks aToken balances and interest accrual to enable yield farming strategies.

Enforces agent-specific transaction policies (spending limits, token whitelists, counterparty restrictions) by validating each transaction against a policy rule engine before Safe smart wallet execution. Policies are defined as JSON schemas and evaluated server-side; transactions violating policies are rejected before broadcast. Supports approval workflows where high-value transactions require human or oracle confirmation.

Provisions a dedicated Safe smart wallet for each agent by deploying a Safe proxy contract and registering MPC-managed keys via Turnkey's key management service. Turnkey handles key generation, signing, and rotation without exposing private keys to the application layer. Each agent receives a unique wallet address and can execute transactions through Safe's multi-sig interface with MPC-backed signatures.

Transfers ERC-20 tokens or native chain assets (ETH, MATIC, ARB) from agent wallet to recipient addresses via Safe smart wallet, with optional recipient validation (checking if address is a contract, known exchange, or whitelisted address) and memo/note attachment for transaction tracking. Validates recipient address format and checks for common mistakes (sending to token contract address, zero address).

Exposes DeFi capabilities as MCP (Model Context Protocol) tools with JSON schema definitions, allowing LLM agents to discover and invoke DeFi functions through standard MCP function-calling interface. Each tool includes input/output schemas, descriptions, and error handling. Agent can call tools via MCP client library, which handles schema validation, parameter marshalling, and response parsing.

Simulates transactions before broadcast using eth_call to predict execution outcomes, gas consumption, and failure modes. Extracts revert reasons from failed simulations by parsing contract error messages and ABI-decoded error data, providing agents with actionable failure diagnostics. Estimates gas costs based on simulation results and current network gas prices.

Orchestrates transactions across multiple EVM chains (Ethereum, Base, Arbitrum, Polygon) by managing nonce sequences, gas price adjustments, and execution ordering to maintain state consistency. Handles transaction ordering to prevent race conditions (e.g., ensuring token approval completes before swap execution) and provides rollback mechanisms if a transaction fails mid-sequence.

Monitors on-chain transaction status and emits events as transactions progress through mempool, confirmation, and finality states. Tracks transaction receipts, logs, and state changes to provide agents with real-time execution feedback. Integrates with event listeners to trigger agent actions on transaction confirmation or failure (e.g., rebalance portfolio after swap confirms).