Skip to content

evm.mdx

Latest commit

 

History

History
148 lines (110 loc) · 3.98 KB

evm.mdx

File metadata and controls

148 lines (110 loc) · 3.98 KB
title description
Overview
Integrate EVM blockchain capabilities into your AI agent

The EVM plugin enables AI agents to interact with Ethereum Virtual Machine (EVM) compatible blockchains, supporting token transfers, swaps, bridging, and governance operations across 30+ networks.

Features

  • Multi-chain Support: Works with Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, and many more
  • Token Operations: Transfer native tokens and ERC20 tokens
  • DeFi Integration: Swap tokens and bridge across chains using LiFi and Bebop
  • Governance: Create proposals, vote, queue, and execute governance actions
  • Wallet Management: Multi-chain balance tracking with automatic updates
  • TEE Support: Secure wallet derivation in Trusted Execution Environments

Installation

bun install @elizaos/plugin-evm

Configuration

The plugin requires the following environment variables:

# Required
EVM_PRIVATE_KEY=your_private_key_here

# Optional - Custom RPC endpoints
ETHEREUM_PROVIDER_ETHEREUM=https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY
ETHEREUM_PROVIDER_BASE=https://base-mainnet.g.alchemy.com/v2/YOUR_KEY

# Optional - TEE Configuration
TEE_MODE=true
WALLET_SECRET_SALT=your_secret_salt

Usage

import { evmPlugin } from '@elizaos/plugin-evm';
import { AgentRuntime } from '@elizaos/core';

// Initialize the agent with EVM plugin
const runtime = new AgentRuntime({
  plugins: [evmPlugin],
  // ... other configuration
});

Actions

Transfer Tokens

Transfer native tokens or ERC20 tokens between addresses.

Example prompts:

  • "Send 0.1 ETH to 0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
  • "Transfer 100 USDC to vitalik.eth on Base"
  • "Send 50 DAI to 0x123... on Polygon"

Swap Tokens

Exchange tokens on the same chain using optimal routes.

Example prompts:

  • "Swap 1 ETH for USDC"
  • "Exchange 100 USDT for DAI on Arbitrum"
  • "Trade my WETH for USDC on Base"

Bridge Tokens

Transfer tokens across different chains.

Example prompts:

  • "Bridge 100 USDC from Ethereum to Arbitrum"
  • "Move 0.5 ETH from Base to Optimism"
  • "Transfer DAI from Polygon to Ethereum"

Governance Actions

Participate in DAO governance using OpenZeppelin Governor contracts.

Example prompts:

  • "Create a proposal to increase the treasury allocation"
  • "Vote FOR on proposal #42"
  • "Queue proposal #37 for execution"
  • "Execute the queued proposal #35"

Providers

The plugin includes providers that give your agent awareness of:

  • Wallet balances across all configured chains
  • Token metadata and current prices
  • Transaction history and status

Supported Chains

The plugin supports all chains available in viem, including:

  • Ethereum Mainnet
  • Layer 2s: Arbitrum, Optimism, Base, zkSync
  • Alternative L1s: Polygon, BSC, Avalanche
  • And many more...

Advanced Features

Custom Chain Configuration

Add custom RPC endpoints for any supported chain:

ETHEREUM_PROVIDER_OPTIMISM=https://opt-mainnet.g.alchemy.com/v2/YOUR_KEY
ETHEREUM_PROVIDER_ARBITRUM=https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY

TEE Wallet Derivation

For enhanced security, enable TEE mode to derive wallets in Trusted Execution Environments:

TEE_MODE=true
WALLET_SECRET_SALT=your_unique_salt

Multi-Aggregator Swaps

The plugin automatically finds the best swap routes using multiple aggregators:

  • Primary: LiFi SDK
  • Secondary: Bebop

Error Handling

The plugin includes comprehensive error handling for common scenarios:

  • Insufficient balance
  • Network congestion
  • Failed transactions
  • Invalid addresses
  • Slippage protection

Security Considerations

  • Never hardcode private keys in your code
  • Use environment variables for sensitive data
  • Validate all user inputs
  • Set appropriate slippage tolerances
  • Monitor gas prices and limits

Next Steps