Protocol Revenue Change Alert Tool

WHAT IT DOES

The Protocol Revenue Change Alert Tool is an analytics tool that monitors revenue changes in protocol fee collectors or treasury addresses. It reads transaction history and balance changes from the connected RPC provider, calculates revenue collected over a configurable block window, and triggers alerts when revenue changes exceed user-defined thresholds. This helps protocol teams, investors, and stakeholders quickly identify significant revenue movements, understand protocol performance, and respond to market conditions.

HOW TO USE

Enter the addresses of your protocol's fee collectors or treasury accounts (one per line). Set the block window to check (default 1000 blocks) and the alert threshold percentage (default 15%). Click "check revenue changes" to run the analysis. The tool compares current balances against historical balances at the specified block offset, calculates the revenue collected as the increase in balance over the period. Results display a summary of total revenue collected, alerts triggered, and a detailed table showing each address's current balance, historical balance, revenue collected, percentage change, and status.

TECHNICAL MECHANISM

The tool connects to the RPC provider and fetches current and historical balances for each revenue address using eth_getBalance. For historical balances, it queries with a specific block number parameter, retrieving the balance as it was at that point in time. The block window determines how far back to look—the tool calculates the historical block number as (currentBlock - blockWindow). Revenue collected is calculated as the difference between the current balance and the historical balance (currentBalance - oldBalance), assuming that all increases in the balance represent revenue collected. The tool computes the percentage change relative to the historical balance. If the percentage change exceeds the user's threshold, an alert is triggered. The tool handles addresses that may not have existed at the historical block by checking for zero or null balances. Results are displayed with color-coded indicators for significant changes.

WHAT IT CANNOT SEE

The tool cannot determine the breakdown of revenue sources without parsing transaction types or event logs. It cannot account for revenue in tokens other than the native chain token without token price data. The tool cannot detect off-chain revenue or revenue from other chains. It cannot predict future revenue trends. The tool cannot distinguish between organic revenue growth and one-time events. It cannot validate the accuracy of revenue data without external verification. The tool cannot account for protocol-specific fee structures or revenue sharing mechanisms. It cannot determine the cause of revenue changes (e.g., user growth, fee changes, market conditions).

PLEASE NOTE

This tool is designed for Ethereum Virtual Machine (EVM) compatible chains only. Revenue is calculated based on increases in ETH balance only—revenue collected in other tokens or stablecoins is not tracked. The block window should be chosen based on the typical block time of the chain and the desired monitoring frequency. The tool provides estimates only and should be used as a starting point for revenue monitoring. For accurate revenue tracking across multiple token types and sources, combine this tool with event log parsing and token price APIs. The tool assumes that all balance increases represent revenue—protocols with complex revenue sharing or multiple revenue sources may need additional analysis.