Overview
The Total Supply Monitor is a daily monitoring tool that tracks the total supply of a token contract on a blockchain network. It queries on-chain mint and burn event logs via Dune Analytics and compares the result against user-defined expected values. An alert is emitted on every scheduled run:- Info — the current issued supply is within the expected limit (no anomaly detected)
- Warning / custom — the current issued supply exceeds the expected issued amount (potential over-minting)
Expected Total Supply
The hard cap or maximum authorised supply of the token, expressed as a whole-unit integer (i.e. already divided by token decimals).
Example: for a token with a 1 billion cap and 18 decimals, set this to
1000000000.
Expected Total Issued
The maximum number of tokens that should currently be in circulation. The detector compares the live on-chain issued supply against this value.- If
current issued supply ≤ expected_total_issued→ Info alert (supply is within bounds) - If
current issued supply > expected_total_issued→ Warning alert (supply exceeds expectation)
Decimals
The number of decimal places used by the token contract. Used to convert raw on-chain values to human-readable units before comparison.
Most ERC-20 tokens use 18 decimals. Override this for tokens that use a different precision (e.g. USDC uses
6).
Severity
Controls the severity level assigned to mismatch alerts (when the issued supply exceedsexpected_total_issued).
- Info alerts are always emitted when the supply is within bounds, regardless of this setting.
- This field only affects the severity of anomaly alerts.