Wallet Tracker 👛

Track multiple wallets across EVM chains and Solana. Aggregate your portfolio, monitor holding changes, and get alerts when significant movements happen.

Scenarios & Use Cases

Scenario 1: Personal Portfolio Overview

You hold assets across 5 wallets on Ethereum, Polygon, and Solana. You want a single dashboard.

bash scripts/wallet-tracker.sh portfolio \
  --wallets "0xABC123...,0xDEF456...,5KtPn1..." \
  --chains "ethereum,polygon,solana"

Output: An HTML report showing total value, per-chain breakdown, and per-wallet holdings.

---

Scenario 2: Whale Watching

Track a known whale wallet for large movements:

bash scripts/wallet-tracker.sh watch \
  --wallet "0xWhale..." \
  --chain ethereum \
  --threshold 100000 \
  --interval 300

Output: Console alerts when transfers exceed $100K threshold.

---

Scenario 3: Airdrop Farming Tracker

You're farming airdrops across multiple wallets. Track activity and eligibility:

bash scripts/wallet-tracker.sh activity \
  --wallets-file my-wallets.txt \
  --chain ethereum \
  --since 2024-01-01

Output: Transaction count, unique contracts interacted, active days, and volume per wallet.

---

Scenario 4: Team Treasury Monitoring

Monitor a DAO treasury wallet for unauthorized withdrawals:

bash scripts/wallet-tracker.sh monitor \
  --wallet "0xTreasury..." \
  --chain ethereum \
  --alert-on decrease \
  --output treasury-report.html

---

Scenario 5: Cross-Chain Balance Snapshot

Take a point-in-time snapshot across all chains for accounting:

bash scripts/wallet-tracker.sh snapshot \
  --wallets-file all-wallets.txt \
  --output snapshot-2024-Q1.json

Supported Chains

Chain	Type	Native Token	RPC Default
Ethereum	EVM	ETH	Public RPC
Polygon	EVM	MATIC	Public RPC
Arbitrum	EVM	ETH	Public RPC
Optimism	EVM	ETH	Public RPC
BSC	EVM	BNB	Public RPC
Avalanche	EVM	AVAX	Public RPC
Solana	SVM	SOL	Public RPC

💡 Tip: Set custom RPCs via environment variable WALLET_TRACKER_RPC_<CHAIN>=https://... for better rate limits.

Configuration File

Create ~/.wallet-tracker.json for persistent config:

{
  "wallets": [
    {"address": "0xABC...", "label": "Main ETH", "chains": ["ethereum", "polygon"]},
    {"address": "5KtPn...", "label": "Solana Hot", "chains": ["solana"]}
  ],
  "refresh_interval": 600,
  "alert_threshold_usd": 1000,
  "output_dir": "./wallet-reports"
}

Commands

Command	What it does
portfolio	Full portfolio aggregation across wallets/chains
watch	Real-time monitoring with threshold alerts
activity	Transaction activity summary
monitor	Balance change detection
snapshot	Point-in-time balance export
compare	Compare two snapshots for changes

Privacy Note

This tool queries public blockchain data only. No private keys are ever required or requested. All data is processed locally.