Crypto Wallet

---
name: crypto-wallet
description: >
  Check cryptocurrency wallet balances, token holdings, transaction history, token approvals,
  ENS name resolution, and on-chain activity. Use when asked about wallet balance, what tokens
  an address holds, transaction history, pending transactions, token allowances, ENS lookup,
  or address portfolio.
---

# Crypto Wallet

Query on-chain wallet data: balances, tokens, transactions, approvals, and ENS resolution.

## Common ERC-20 Function Selectors

| Function | Selector | Params |
|----------|----------|--------|
| `balanceOf(address)` | `0x70a08231` | address (32 bytes, left-padded) |
| `allowance(address,address)` | `0xdd62ed3e` | owner + spender (each 32 bytes) |
| `decimals()` | `0x313ce567` | none |
| `symbol()` | `0x95d89b41` | none |
| `name()` | `0x06fdde03` | none |
| `totalSupply()` | `0x18160ddd` | none |

## APIs

### ETH Balance via Public RPC

**Native ETH balance** (eth_getBalance):
```
exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_getBalance\",\"params\":[\"0xADDRESS\",\"latest\"],\"id\":1}'"
```

**ERC-20 token balance** (eth_call with balanceOf):
```
exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0xTOKEN_CONTRACT\",\"data\":\"0x70a08231000000000000000000000000WALLET_NO_0x\"},\"latest\"],\"id\":1}'"
```

> Result is hex. Convert: `parseInt(result, 16) / 10^decimals`

### Multi-chain Public RPCs

| Chain | RPC URL |
|-------|---------|
| Ethereum | `https://eth.llamarpc.com` |
| Arbitrum | `https://arb1.arbitrum.io/rpc` |
| Optimism | `https://mainnet.optimism.io` |
| Base | `https://mainnet.base.org` |
| Polygon | `https://polygon-rpc.com` |
| BSC | `https://bsc-dataseed.binance.org` |
| Avalanche | `https://api.avax.network/ext/bc/C/rpc` |

### Etherscan / Block Explorers (Free tier, API key optional)

Base URLs:
- Ethereum: `https://api.etherscan.io/api`
- Arbitrum: `https://api.arbiscan.io/api`
- Base: `https://api.basescan.org/api`
- Optimism: `https://api-optimistic.etherscan.io/api`
- Polygon: `https://api.polygonscan.com/api`
- BSC: `https://api.bscscan.com/api`

**Token balances for address** (requires free API key):
```
web_fetch url="https://api.etherscan.io/api?module=account&action=tokentx&address=0xADDRESS&page=1&offset=50&sort=desc&apikey=YOUR_KEY"
```

**Normal transactions**:
```
web_fetch url="https://api.etherscan.io/api?module=account&action=txlist&address=0xADDRESS&startblock=0&endblock=99999999&page=1&offset=20&sort=desc&apikey=YOUR_KEY"
```

**ETH balance** (no key needed, rate limited):
```
web_fetch url="https://api.etherscan.io/api?module=account&action=balance&address=0xADDRESS&tag=latest"
```

### ENS Resolution

**Forward (name to address)** via RPC:
```
exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41\",\"data\":\"0x3b3b57de{NAMEHASH}\"},\"latest\"],\"id\":1}'"
```

**Simpler: use ENS public API**:
```
web_fetch url="https://ensdata.net/ADDRESS_OR_NAME"
```

### Token Approvals

**Check allowance** (how much a spender can use):
```
exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0xTOKEN\",\"data\":\"0xdd62ed3e000000000000000000000000OWNER_NO_0x000000000000000000000000SPENDER_NO_0x\"},\"latest\"],\"id\":1}'"
```

> Unlimited approval = `0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff`

## External Tools (Optional)

- **EVM MCP Server**: `npx @mcpdotdirect/evm-mcp-server` — read balances, tokens, NFTs across 60+ EVM chains
- **Base MCP**: `github.com/base/base-mcp` — Coinbase-official Base chain tools

## Usage Tips

- Always pad addresses to 32 bytes (64 hex chars) in eth_call data fields
- Strip `0x` prefix from address when embedding in calldata, then left-pad with zeros
- Results from eth_call are hex-encoded; parse with `parseInt(hex, 16)`
- For ERC-20 balances, divide by `10^decimals` (USDC=6, most tokens=18)
- For multi-token portfolios, use Etherscan tokentx endpoint rather than individual RPC calls
- Verify chain before querying — same address can exist on multiple chains with different balances