Whale Wallet Interaction Monitor for Your Contract

WHAT IT DOES

This tool connects to your EVM wallet and monitors whale wallet interactions with your smart contract. It reads on-chain transaction logs, event data, and call traces to identify wallet addresses that have interacted with your contract. The tool then fetches token balances and transaction history to categorize wallets by size and activity level, identifying wallets with significant ETH or token holdings (whales). It provides a detailed report showing which whales have interacted with your contract, their balance, transaction volume, and interaction patterns.

HOW TO USE

Connect your Web3 wallet using the Connect button. Enter the contract address you want to monitor in the Contract Address field. Specify the block range to scan (default 1000 blocks) and the minimum wallet balance for whale status (default 100 ETH). Click "Monitor Interactions" to start the analysis. Click "Load Sample" to populate fields with an example address. Results appear in the Results card with a summary of unique whales found, total interactions, and a detailed list of top whales with their balance, sent/received amounts, and transaction count.

TECHNICAL MECHANISM: EVENT-BASED WHALE DETECTION WITH BALANCE ENRICHMENT

The tool uses ethers.js to query on-chain transaction logs from the contract. It creates a Transfer event filter for the contract address and queries events within the specified block range using contract.queryFilter(). For each Transfer event, the tool extracts the from and to addresses and aggregates sent and received amounts per wallet using ethers.BigNumber. After collecting interaction data, the tool fetches the current ETH balance for each unique wallet using provider.getBalance(). Wallets with balance above the configured minimum threshold are classified as whales and sorted by balance descending. The report includes transaction counts, sent/received totals, and balance information.

WHAT IT CANNOT SEE

This tool cannot identify wallets that interact through proxies or contract-based accounts—it only sees the proxy address, not the underlying account. It cannot distinguish between individual users and institutional entities—all addresses are treated equally based on balance. It cannot track off-chain whale activity or social signals—the tool is limited to on-chain data. It relies on on-chain data availability and may miss interactions that are not recorded in logs—some contracts may use custom events or not emit events. It cannot determine the intent or strategy behind whale interactions—the tool provides data but not analysis of why whales are interacting.

PLEASE NOTE

This is a read-only tool—it never signs transactions. All data is fetched on-demand and stored only in memory; nothing is persisted across page reloads. The tool supports EVM chains only—Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, Base, and Fantom. Large block ranges may take time to query—consider using smaller ranges for faster results. Whale classification is based on ETH balance—if your contract uses a different token, adjust the minimum balance threshold accordingly.