🔍 ChainScope

Multi-chain on-chain data toolkit — scan wallets, track transactions, monitor gas prices, detect whale movements, and check token prices across 7+ EVM chains.

✨ Features

Command	Description
wallet	Scan wallet balance & ERC-20 token holdings
txs	View transaction history with gas costs
gas	Real-time gas prices across all chains
price	Token prices, market cap, 24h change (CoinGecko)
search	Search tokens by name or symbol
whale	Monitor large transfers (whale alerts)
chains	List supported blockchain networks

🔗 Supported Chains

• Ethereum (ETH)
• BNB Smart Chain (BNB)
• Polygon (MATIC)
• Arbitrum One (ETH)
• Optimism (ETH)
• Base (ETH)
• Avalanche C-Chain (AVAX)

🚀 Installation

# From PyPI (coming soon)
pip install chainscope

# From source
git clone https://github.com/0xdariel/chainscope.git
cd chainscope
pip install -e .

📖 Usage

# Scan a wallet
chainscope wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

# Scan on BSC
chainscope wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -c bsc

# View transaction history
chainscope txs 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -n 50

# Check gas prices (all chains)
chainscope gas

# Check gas on specific chains
chainscope gas -c ethereum -c arbitrum -c base

# Token prices
chainscope price ethereum bitcoin solana

# Search for a token
chainscope search "pepe"

# Whale alerts (default: 100+ ETH)
chainscope whale -c ethereum -m 500

# List supported chains
chainscope chains

⚙️ Configuration

Create a .env file for higher rate limits (optional):

cp .env.example .env
# Edit .env and add your API keys

Free tier works without API keys (5 calls/sec per explorer).

Get free API keys at:

• Etherscan
• BSCScan
• PolygonScan
• Arbiscan

🏗️ Architecture

chainscope/
├── cli.py            # Click CLI entry point
├── wallet.py         # Wallet balance & token scanner
├── transactions.py   # Transaction history
├── gas.py            # Gas price tracker
├── prices.py         # Token prices (CoinGecko)
├── whale.py          # Whale movement monitor
└── chains/
    └── __init__.     # Token prices (CoinGecko)
├── whale.py          # Whale movement monitor
└── chains/
    └── __init__.py   # Chain configurations

📝 License

MIT — see LICENSE

🤝 Contributing

PRs welcome! Open an issue first to discuss changes.

---

Built by @0xdariel 🔧