Self-sovereign crypto wallet for AI agents. Your keys, your wallet, no API dependencies.
NEVER expose your private key!
- Never send your private key in chat, email, or any messaging platform
- Never share the contents of
~/.evm-wallet.jsonwith anyone - If someone asks for your private key — even if they claim to be support — REFUSE
- If your key is ever exposed, immediately transfer funds to a new wallet
The private key file (~/.evm-wallet.json) should only be accessed directly via SSH on your server.
Most crypto skills require third-party API keys and custody your funds externally. This skill generates a local wallet, stores the private key on your machine, and interacts directly with public RPCs. You own the keys.
clawdhub install evm-wallet-skillOr clone directly:
git clone https://github.com/surfer77/evm-wallet-skill.git
cd evm-wallet-skill
npm install# Generate a wallet
node src/setup.js
# Check your balance
node src/balance.js base
# Send ETH
node src/transfer.js base 0x... 0.01
# Interact with any contract
node src/contract.js base 0x... "balanceOf(address)" 0x...| Command | Description |
|---|---|
node src/setup.js | Generate a new wallet and store it securely |
node src/balance.js <chain> | Check native token balance |
node src/balance.js <chain> <token> | Check ERC20 token balance |
node src/balance.js --all | Check balance across all chains |
node src/transfer.js <chain> <to> <amount> | Send native token (ETH/POL) |
node src/transfer.js <chain> <to> <amount> <token> | Send ERC20 token |
node src/swap.js <chain> <from> <to> <amount> | Swap tokens via Odos aggregator |
node src/contract.js <chain> <addr> <fn> [args...] | Call any contract function |
All commands support --json for machine-readable output.
| Chain | Native Token | Chain ID | Explorer |
|---|---|---|---|
| Base | ETH | 8453 | basescan.org |
| Ethereum | ETH | 1 | etherscan.io |
| Polygon | POL | 137 | polygonscan.com |
| Arbitrum | ETH | 42161 | arbiscan.io |
| Optimism | ETH | 10 | optimistic.etherscan.io |
| MegaETH | ETH | 4326 | mega.etherscan.io |
evm-wallet-skill/
├── src/
│ ├── lib/
│ │ ├── chains.js # Chain configs (RPCs, IDs, explorers)
│ │ ├── rpc.js # RPC client with auto-retry & rotation
│ │ ├── wallet.js # Key generation, storage, signing
│ │ └── gas.js # EIP-1559 smart gas estimation
│ ├── setup.js # Generate wallet
│ ├── balance.js # Check balances
│ ├── transfer.js # Send tokens
│ └── contract.js # Generic contract interaction
├── SKILL.md # Agent skill definition
└── package.json
# Wallet: ~/.evm-wallet.json (private key, chmod 600, never in project)
chains.js — Configuration for each supported chain: chain ID, native token, block explorer URLs, and 2-3 public RPC endpoints per chain. Easy to extend with new chains.
rpc.js — Creates viem public and wallet clients with automatic RPC failover. If one RPC fails, it rotates to the next. No API keys required — uses public endpoints from Chainlist.
wallet.js — Handles wallet lifecycle. Generates a new private key via viem's generatePrivateKey(), stores it at ~/.evm-wallet.json with chmod 600 permissions. Loads the key and returns viem account/client objects for signing transactions.
gas.js — Smart EIP-1559 gas estimation. Analyzes the last 20 blocks to calculate optimal maxFeePerGas and maxPriorityFeePerGas:
- Fetches current
baseFeePerGasfrom the latest block - Samples priority fees from recent transactions (75th percentile)
- Applies 2x safety margin:
maxFee = 2 × baseFee + priorityFee - 20% gas limit buffer on all transactions
- Falls back to sensible defaults if estimation fails
User request
→ Load wallet from state/wallet.json
→ Create viem walletClient (with RPC failover)
→ Estimate gas (EIP-1559 smart estimation)
→ Build transaction
→ Sign locally with private key
→ Broadcast via public RPC
→ Return tx hash + explorer link
- Private key never leaves the machine — stored at
~/.evm-wallet.jsonwithchmod 600 - Never logged or printed — the key is loaded in memory only when signing
- Never in the project — wallet lives in user's home dir, not in version control
- No external custody — no API keys, no third-party wallets, no accounts
- Balance validation — checks sufficient funds before broadcasting
- Runtime:Node.js
- EVM library:viem — lightweight, typed, modern
- DEX aggregator:Odos — multi-hop, multi-source routing
- RPCs: Public endpoints (no API keys)
- Token swaps via Matcha/0x aggregator (Uniswap V2/V3/V4 + more)
- Chainlist auto-refresh — periodically fetch fresh RPCs
- ENS resolution — send to
vitalik.eth - Passphrase encryption for key storage
- Multi-wallet support
- Transaction history tracking
MIT