NFT Mint Supply Tracker

WHAT IT DOES

NFT Mint Supply Tracker monitors NFT contract supply via on-chain reads, displaying real-time updates with mint progress percentage, supply velocity (rate of change), and threshold alerts. It shows the current total supply, max supply, and a progress bar showing how much of the collection has been minted. The velocity indicator shows how fast supply is changing (items per second). Set custom alert thresholds (e.g., 50%, 75%, 90%)—the tool notifies you when each threshold is crossed. Perfect for monitoring NFT launches, tracking mint progress, and catching supply milestones without constant refreshing.

WHERE IT RUNS

Any webpage with an NFT contract—project launch pages, mint dashboards, NFT marketplaces, and collector portals. The script automatically detects contract addresses from the page content, or you can paste the address manually. Works with any EVM-compatible chain (Ethereum, Polygon, Arbitrum, Optimism, etc.) as long as your wallet is connected to the correct network.

HOW TO USE

Install the script and navigate to any NFT mint page. Click "Connect Wallet" to link your MetaMask or other EVM wallet. The tool will detect the contract address automatically—verify it. Set your alert thresholds as comma-separated percentages (e.g., "50, 75, 90"). Set the check interval (default 10 seconds). Click "Start Watching"—the tool checks the contract at your interval and displays real-time supply updates. When supply crosses a threshold, you'll see a notification and a flash message in the panel. Use "Check Now" to manually refresh the supply. Keyboard shortcut: Ctrl+Shift+S to start/stop watching.

TECHNICAL MECHANISM

The script loads ethers.js v5.7.2 dynamically via a DOM-injected script tag, then creates a Web3Provider from window.ethereum. It builds a contract interface with view functions: totalSupply(), maxSupply(), price(), and mintPrice(). Supply reads use eth_call via the provider. The watch loop runs at the user-configured interval (2-60 seconds), fetching the current total supply and comparing it to the previous value. Supply velocity is calculated as the difference in supply divided by the time elapsed between reads. The progress percentage is calculated as (totalSupply / maxSupply) * 100. Alert thresholds are parsed from the user's comma-separated input and checked against the current percentage. When a threshold is crossed, a GM_notification is shown and the panel flashes the alert. Each threshold triggers only once until the percentage drops below it (unlikely but handled). The progress bar shows the mint completion visually. Price is also read if available for additional context. No transactions are ever submitted—this tool is read-only.

THE PANEL

The tool runs inside BGPanel, a lightweight UI system built into the BotGentz extension. Drag the panel by its header to reposition it anywhere on screen—it snaps to edges and remembers its position per site. Click the header to collapse the panel into a small bubble; click again to expand. Resize the panel by dragging its bottom-right corner. Press Escape at any time to close the panel. The panel stays out of your way but is always accessible via the extension's toolbar.

PLEASE NOTE

Requires the free BotGentz browser extension and a real EVM wallet extension (MetaMask, Coinbase Wallet, or any wallet that injects window.ethereum). The script supports EVM-compatible chains only. This tool is read-only—no transactions are ever submitted. It cannot detect off-chain supply changes, predict mint velocity, or detect supply changes from secondary market sales or burns not reflected in totalSupply. It depends on the contract implementing totalSupply() and maxSupply() view functions—some contracts may use different naming. Always verify the contract address independently. The script does not store or share any data—all processing happens locally in your browser.