Evm Wallet

README

# 👛 EVM Wallet CLI Plugin

Multi-chain wallet management from the command line. Transfer tokens, swap on DEXs, and check balances across 5 EVM chains — all through structured JSON output.

## Features

- **💰 Balance Checks** — Native tokens and any ERC20 (auto-detects symbol + decimals)
- **📤 Transfers** — Send native tokens or ERC20s to any address
- **🔄 Swaps** — Uniswap V3 on Ethereum/Base/Polygon/Arbitrum, PancakeSwap on BSC
- **✅ Approvals** — ERC20 approve for any spender
- **⛓️ 5 Chains** — Ethereum, Base, Polygon, BSC, Arbitrum
- **⛽ Smart Gas** — Auto-adjusted gas pricing per chain

## Quick Start

```bash
# Native balance
./wallet.sh balance --chain polygon

# ERC20 balance (auto-detects symbol + decimals)
./wallet.sh balance-token --chain polygon --token 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174

# Transfer native token
./wallet.sh transfer --chain polygon --to 0x... --amount 1.5

# Transfer ERC20
./wallet.sh transfer-token --chain polygon --token 0x... --to 0x... --amount 100

# Swap tokens (auto fee tier detection)
./wallet.sh swap --chain polygon --from 0x... --to 0x... --amount 100 --slippage 0.5

# Approve ERC20
./wallet.sh approve --chain polygon --token 0x... --spender 0x... --amount 1000000
```

## Requirements

- Node.js 18+
- `POLYMARKET_PRIVATE_KEY` in your `.env` file (or any EVM private key)
- Native gas token on the chain you're using

## Commands

| Command | Description | Required Flags |
|---------|-------------|----------------|
| `balance` | Native token balance | `--chain` |
| `balance-token` | ERC20 token balance | `--chain --token` |
| `transfer` | Send native token | `--chain --to --amount` |
| `transfer-token` | Send ERC20 token | `--chain --token --to --amount` |
| `approve` | ERC20 approve | `--chain --token --spender --amount` |
| `swap` | DEX swap | `--chain --from --to --amount [--slippage]` |

## Supported Chains

| Chain | ID | Native | DEX |
|-------|-----|--------|-----|
| Ethereum | 1 | ETH | Uniswap V3 |
| Base | 8453 | ETH | Uniswap V3 |
| Polygon | 137 | POL | Uniswap V3 |
| BSC | 56 | BNB | PancakeSwap |
| Arbitrum | 42161 | ETH | Uniswap V3 |

## Tech Stack

- TypeScript + ethers.js v5
- Uniswap V3 SwapRouter02 / PancakeSwap SmartRouter
- Auto fee tier detection (100, 500, 3000, 10000)
- Polygon: legacy tx type 0, 2× gas, min 25 gwei
- Other chains: 1.2× gas multiplier