EVM Plugin

The EVM plugin enables Eliza agents to interact with Ethereum and EVM-compatible chains — reading balances, sending tokens, interacting with smart contracts, executing swaps, and participating in DeFi protocols.

Package: @elizaos/plugin-wallet

Overview

The EVM plugin provides the agent with an embedded wallet and a set of on-chain actions covering the most common DeFi operations across all major EVM chains.

Installation

bash

eliza plugins install @elizaos/plugin-wallet

Auto-Enable

The plugin auto-enables when ALCHEMY_API_KEY is set (this is the envKey in plugins.json).

Configuration

Environment Variable	Required	Description
`EVM_PRIVATE_KEY`	Yes	Private key for the agent's wallet (hex, starting with `0x`)
`EVM_RPC_PROVIDER`	No	Default RPC endpoint (mainnet)
`ALCHEMY_API_KEY`	No	Alchemy API key for multi-chain RPC (also the primary auto-enable trigger)
`INFURA_API_KEY`	No	Infura API key for RPC
`ANKR_API_KEY`	No	Ankr API key for RPC
`ETHEREUM_PROVIDER_ETHEREUM`	No	Custom RPC URL for Ethereum mainnet
`ETHEREUM_PROVIDER_BASE`	No	Custom RPC URL for Base
`ETHEREUM_PROVIDER_ARBITRUM`	No	Custom RPC URL for Arbitrum
`ETHEREUM_PROVIDER_OPTIMISM`	No	Custom RPC URL for Optimism
`TEE_MODE`	No	Trusted Execution Environment mode
`WALLET_SECRET_SALT`	No	Salt for wallet key derivation
`SEPOLIA_RPC_URL`	No	RPC URL for Sepolia testnet
`BASE_SEPOLIA_RPC_URL`	No	RPC URL for Base Sepolia testnet

json

{
  "settings": {
    "secrets": {
      "EVM_PRIVATE_KEY": "0x..."
    }
  }
}

Supported Chains

Chain	Chain ID	Native Token
Ethereum Mainnet	1	ETH
Base	8453	ETH
Arbitrum One	42161	ETH
Optimism	10	ETH
Polygon	137	MATIC
BSC	56	BNB
Avalanche C-Chain	43114	AVAX
Zora	7777777	ETH
Mode	34443	ETH
Blast	81457	ETH

Actions

Action	Description
`TRANSFER_TOKEN`	Send ETH or ERC-20 tokens to an address
`SWAP_TOKENS`	Swap tokens via DEX aggregators (1inch, Uniswap)
`GET_BALANCE`	Check ETH and token balances
`DEPLOY_CONTRACT`	Deploy a smart contract
`CALL_CONTRACT`	Read from a smart contract
`SEND_TRANSACTION`	Send a raw transaction
`SIGN_MESSAGE`	Sign an arbitrary message
`GET_TRANSACTION`	Look up a transaction by hash
`BRIDGE_TOKENS`	Bridge tokens cross-chain

Providers

Provider	Description
`walletBalance`	Current ETH and token balances
`walletAddress`	The agent's wallet address
`chainInfo`	Current chain ID and network

Usage Examples

After the plugin is loaded, the agent can execute on-chain operations through natural language:

"Send 0.01 ETH to vitalik.eth"

"Swap 100 USDC for ETH on Base"

"What's my wallet balance on Arbitrum?"

"Deploy the ERC-20 contract to Base Sepolia"

Security Considerations

The private key grants full control of the agent's wallet. Store it securely using the built-in @elizaos/core secrets runtime.
Consider using a dedicated agent wallet with limited funds rather than a primary wallet.
The plugin does not impose spending limits — any action the LLM selects will execute. Configure the character carefully.
Use testnets (Base Sepolia, Arbitrum Sepolia) for development.

Testnet Configuration