Overview
The EVM plugin handles DeFi operations through a structured flow:
User Message → Action Recognition → Parameter Extraction → Execution → Response
Transfer Flow
1. User Intent
User: Send 0.1 ETH to alice.eth
2. Action Recognition
The plugin identifies this as a transfer action based on keywords (send, transfer, pay).
Using AI, the plugin extracts:
- Amount: 0.1
- Token: ETH
- Recipient: alice.eth (will resolve to address)
- Chain: Detected from context or defaults
4. Execution
- Validates recipient address
- Checks balance
- Builds transaction
- Estimates gas
- Sends transaction
- Waits for confirmation
5. Response
Agent: Successfully transferred 0.1 ETH to alice.eth
Transaction: https://etherscan.io/tx/[hash]
Swap Flow
1. User Intent
User: Swap 1 ETH for USDC
2. Route Discovery
- Queries multiple DEX aggregators (LiFi, Bebop)
- Compares routes for best output
- Considers gas costs
3. Execution
- Approves token if needed
- Executes swap transaction
- Monitors for completion
Bridge Flow
1. User Intent
User: Bridge 100 USDC from Ethereum to Base
2. Bridge Route
- Finds available bridge routes
- Estimates fees and time
- Selects optimal path
3. Multi-Step Execution
- Source chain transaction
- Wait for bridge confirmation
- Destination chain completion
Governance Flow
Proposal Creation
User: Create a proposal to increase treasury allocation
→ Plugin creates proposal transaction with targets, values, and description
Voting
User: Vote FOR on proposal 42
→ Plugin casts vote with correct proposal ID and support value
Error Handling
The plugin handles common errors gracefully:
- Insufficient Balance: Checks before attempting transaction
- Network Issues: Retries with exponential backoff
- Invalid Addresses: Validates all addresses before use
- High Slippage: Warns user if slippage exceeds tolerance
Key Features
- Natural Language Processing: Understands various ways to express intents
- Multi-Chain Support: Automatically handles chain selection
- Gas Optimization: Estimates and optimizes gas usage
- Safety Checks: Validates all parameters before execution
- Real-Time Feedback: Provides transaction status updates
Responses are generated using AI and may contain mistakes.