Track Bear Whale

WHAT IT DOES

This tool monitors whale wallet addresses for balance changes and transaction activity. You provide a whale wallet address, and the tool tracks its native currency balance and scans for new transactions using eth_getLogs with chunked scanning. When the whale's balance changes by more than a minimal threshold, or when a new transaction is detected, the tool logs the activity and displays a visual alert. All tracking configurations are stored in-memory — no data is persisted across page reloads.

HOW TO USE

Connect your MetaMask wallet using the Connect button. Enter the whale wallet address you want to track, give it a name/label, and choose a check interval (5-300 seconds). Click "Track Whale" to start monitoring. Active tracked whales appear in the list with their current balance. When the whale's balance changes or a transaction is detected, the activity appears in the Whale Activity log with a timestamp. Click any transaction hash to view it on the block explorer. Use "Untrack" to stop monitoring a whale or "Clear All" to remove all tracked whales and activity history.

TECHNICAL MECHANISM

The tool uses the BGWallet bridge to access the blockchain provider via ethers.js. For each tracked whale, it creates a JavaScript interval that runs at the user-specified frequency. On each interval tick, it fetches the whale's current native currency balance using provider.getBalance() and compares it against the previously stored balance. If the balance changes by more than 0.001 (to avoid noise from tiny dust transactions), it logs the change. It also scans for new transaction logs using eth_getLogs with the whale address as the filter. To handle varying RPC limits, the tool implements a chunked scanning strategy — it starts with a chunk size of 500 blocks and halves the chunk size if the RPC returns a "limit exceeded" error, continuing until the scan completes. Deduplication is handled using a Set of seen transaction hashes.

WHAT IT CANNOT SEE

This tool cannot persist tracking across page reloads because it runs in an opaque-origin sandboxed frame with no storage access. It cannot send push notifications or emails without external services. It cannot detect activity that occurred before the whale was added to tracking. It cannot monitor wallets other than those specified. It cannot detect pending or failed transactions — only confirmed transactions. It cannot detect token transfers (ERC-20) without additional ABI configuration — only native currency balance and transactions are tracked. It cannot detect activity on networks other than the connected network. It cannot detect transactions sent from the whale wallet to itself. It cannot verify that the tracked address is actually a "whale" (large holder). It cannot detect whale activity across multiple networks simultaneously.

PLEASE NOTE

This tool works only with EVM-compatible wallets connected via the BGWallet bridge. The chunked scanning ensures compatibility with RPC providers that limit eth_getLogs ranges, but scanning large ranges may take time. Frequent polling may hit RPC rate limits on public providers. Tracking is in-memory only and will be lost when the page is refreshed or closed. The tool does not store or transmit any data — all processing occurs in your browser. This tool is provided as a lightweight whale tracking utility and should not be used as a critical financial monitoring system.