> ## 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 Solana plugin safely on mainnet

## Testing Philosophy

Test with small amounts on mainnet. Solana devnet/testnet tokens have no value and often have different behavior than mainnet.

## Safe Testing Practices

### 1. Start Small

Test with minimal amounts:

* 0.001 SOL for transfers (\~\$0.20)
* \$1-5 worth of tokens for swaps
* Use common tokens (USDC, USDT) for reliability

### 2. Transaction Costs

Solana transactions are cheap (\~\$0.00025 per transaction), making mainnet testing affordable.

### 3. Progressive Testing

```
1. Check wallet connection
2. Test SOL transfers
3. Test SPL token transfers  
4. Test small swaps
5. Test larger operations
```

## Testing Checklist

### Environment Setup

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

# Optional - Use premium RPC for reliability
SOLANA_RPC_URL=https://mainnet.helius-rpc.com/?api-key=YOUR_KEY
```

### Basic Tests

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

2. **Balance Check**
   ```
   User: What's my balance?
   Agent: [Should show SOL balance and token holdings]
   ```

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

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

### Swap Testing

Test swaps with small amounts:

```
User: Swap 0.1 SOL for USDC
Agent: [Should execute via Jupiter]
```

### Portfolio Tracking

```
User: What's my portfolio worth?
Agent: [Should show total USD value and token breakdown]
```

## Monitoring Results

1. **Transaction Verification**
   * Check on Solscan.io or Solana Explorer
   * Verify transaction succeeded
   * Confirm balance changes

2. **Common Token Addresses**
   * USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
   * USDT: Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
   * Use these for testing as they're widely supported

## Common Issues

### "Insufficient SOL for fees"

* Need \~0.001 SOL for transaction fees
* Keep some SOL for rent and fees

### "Token account doesn't exist"

* First transfer to a new token creates the account
* Costs \~0.002 SOL for account creation

### "Slippage tolerance exceeded"

* Increase slippage for volatile tokens
* Try smaller amounts

## Production Readiness

Before production use:

1. Test all operations you plan to use
2. Verify error handling
3. Test with your expected token types
4. Monitor transaction success rates
5. Set appropriate slippage (1-3% typical)
6. Ensure adequate SOL for fees