evm-wallet

name	evm-wallet
description	Manage EVM wallets across Ethereum, Arbitrum, Base, Polygon, BSC, and Optimism. Check native and ERC20 token balances, transfer tokens, view transaction history, manage token approvals, and estimate gas costs. Use when the user asks about wallet balances, token transfers, approvals, gas fees, or EVM portfolio overview.
license	MIT
allowed-tools	Bash(uv *)
metadata	{"author":"gigabrain","version":"1.0"}

EVM Wallet Management

Manage wallets across EVM chains — balances, transfers, approvals, gas.

Resolve SKILL_DIR as the directory containing this SKILL.md, then run scripts from absolute paths under that directory. Do not rely on the current working directory or any injected CLAUDE_* skill path variable.

uv run "$SKILL_DIR/scripts/evm_wallet.py" <command> [args]

All commands return JSON to stdout with a success field.

Environment

Variable	Required	Description
EVM_WALLET_ADDRESS	Yes	Your EVM wallet address
EVM_PRIVATE_KEY	For transfers	Signing key — enables transfers and approvals

Without EVM_PRIVATE_KEY, all read commands work but write commands return an error.

Supported Chains

ethereum, arbitrum, base, polygon, bsc, optimism

Default chain is ethereum if --chain is omitted.

Commands

Configuration

# Show config status and supported chains
uv run "$SKILL_DIR/scripts/evm_wallet.py" config

Balances

# Native + top ERC20 token balances on a chain
uv run "$SKILL_DIR/scripts/evm_wallet.py" balances --chain base

# Balances across all supported chains
uv run "$SKILL_DIR/scripts/evm_wallet.py" balances --all-chains

# Balance of a specific token
uv run "$SKILL_DIR/scripts/evm_wallet.py" balance-of --chain base --token USDC
uv run "$SKILL_DIR/scripts/evm_wallet.py" balance-of --chain base --token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Transfers

# Transfer native token (ETH, MATIC, etc.)
uv run "$SKILL_DIR/scripts/evm_wallet.py" transfer --chain base --token ETH --to 0x... --amount 0.1

# Transfer ERC20 token
uv run "$SKILL_DIR/scripts/evm_wallet.py" transfer --chain base --token USDC --to 0x... --amount 100

Token Approvals

# Check current approval
uv run "$SKILL_DIR/scripts/evm_wallet.py" allowance --chain base --token USDC --spender 0x...

# Approve token spending
uv run "$SKILL_DIR/scripts/evm_wallet.py" approve --chain base --token USDC --spender 0x... --amount 1000

# Revoke approval
uv run "$SKILL_DIR/scripts/evm_wallet.py" revoke --chain base --token USDC --spender 0x...

Gas

# Current gas price on chain
uv run "$SKILL_DIR/scripts/evm_wallet.py" gas --chain ethereum

Token Info

# Look up token by symbol or address
uv run "$SKILL_DIR/scripts/evm_wallet.py" token-info --chain base --token USDC

Safety Rules

1. ALWAYS check balance before transfers
2. After EVERY transfer, verify with balances
3. NEVER retry failed transfers without user confirmation
4. Explain what approvals do before requesting them
5. Double-check recipient address with user before transfers