> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elizaos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Testing Guide

> How to test the EVM plugin safely on real networks

## Testing Philosophy

The best way to test DeFi plugins is with small amounts on real networks. Test networks often have reliability issues and don't reflect real-world conditions.

## Safe Testing Practices

### 1. Start Small

Always test with minimal amounts first:

* 0.001 ETH for transfers
* \$1-5 worth of tokens for swaps
* Smallest viable amounts for bridges

### 2. Test on Low-Cost Chains First

Start testing on chains with low transaction fees:

* Polygon: \~\$0.01 per transaction
* Base: \~\$0.05 per transaction
* Arbitrum: \~\$0.10 per transaction

### 3. Progressive Testing

```
1. Test basic transfers first
2. Test token transfers
3. Test swaps with small amounts
4. Test bridges last (they're most complex)
```

## Testing Checklist

### Environment Setup

```env theme={null}
# Use a dedicated test wallet
EVM_PRIVATE_KEY=test_wallet_private_key

# Start with one chain
ETHEREUM_PROVIDER_BASE=https://base-mainnet.g.alchemy.com/v2/YOUR_KEY
```

### Basic Tests

1. **Wallet Connection**
   ```
   User: What's my wallet address?
   Agent: [Should show your wallet address]
   ```

2. **Balance Check**
   ```
   User: What's my balance?
   Agent: [Should show balances across configured chains]
   ```

3. **Small Transfer**
   ```
   User: Send 0.001 ETH to [another test address]
   Agent: [Should execute the transfer]
   ```

4. **Token Transfer**
   ```
   User: Send 1 USDC to [test address]
   Agent: [Should handle ERC20 transfer]
   ```

### Swap Testing

Test swaps with minimal amounts:

```
User: Swap 0.01 ETH for USDC
Agent: [Should find best route and execute]
```

### Error Handling

Test error scenarios:

* Insufficient balance
* Invalid addresses
* Network issues
* High slippage

## Monitoring Results

1. **Transaction Verification**
   * Check block explorers (Etherscan, BaseScan, etc.)
   * Verify transaction status
   * Confirm balances updated

2. **Gas Usage**
   * Monitor gas costs
   * Ensure reasonable gas estimates
   * Check for failed transactions

## Common Issues

### "Insufficient funds for gas"

* Ensure you have native tokens for gas
* Each chain needs its native token (ETH, MATIC, etc.)

### "Transaction underpriced"

* RPC may be congested
* Try alternative RPC endpoints

### "Nonce too low"

* Previous transaction may be pending
* Wait for confirmation or reset nonce

## Production Readiness

Before using in production:

1. Test all intended operations
2. Verify error handling works
3. Ensure proper logging
4. Set appropriate gas limits
5. Configure slippage tolerances
6. Test with your expected volumes


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.