NFT Mint Reveal Watcher

WHAT IT DOES

NFT Mint Reveal Watcher monitors NFT contracts for token reveals by checking tokenURI changes across a range of token IDs. It detects when hidden tokens (those with placeholder URIs) get revealed to real metadata URLs, displaying the reveal status for each token and sending notifications when reveals happen. The tool shows a summary of revealed vs. hidden tokens, the actual tokenURI for each token, and tracks reveal history. Perfect for collectors waiting for NFT reveals, monitoring mint projects with delayed metadata reveals, or tracking when a collection's artwork becomes visible.

WHERE IT RUNS

Any webpage with NFT minting activity—NFT marketplaces, project launch pages, mint dashboards, 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. Enter the contract address (auto-detected from the page). Set the token ID range to watch (start and end). Configure the check interval (default 30 seconds). Click "Start Watching"—the tool checks tokenURI for each token in the range at the configured interval. When a token's URI changes from a placeholder to a real metadata URL, the tool marks it as revealed and sends a notification. The panel shows a summary of revealed, hidden, and unknown tokens, with a detailed list of each token's status and URI. Keyboard shortcut: Ctrl+Shift+R 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 tokenURI(uint256) and uri(uint256) view functions. The watch loop iterates through the user-specified token ID range (start to end), calling tokenURI for each ID. The returned string is analyzed for reveal status using heuristic checks: placeholder keywords ("placeholder," "hidden," "pending," "unrevealed," "not-revealed"), minimum length (>10 characters), and valid URI formats (ipfs://, https://, ar://, data:, or ending in .json). When a tokenURI changes from a placeholder to a non-placeholder value, the token is marked as revealed. Each token's state is cached to detect changes. The UI displays a color-coded list showing each token's ID, reveal status, and truncated URI. Notifications are sent via GM_notification when new reveals are detected.

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 cannot detect metadata changes that occur off-chain (IPFS, Arweave content changes), cannot detect tokenURI changes that don't go through the contract's setTokenURI/updateURI functions, cannot determine if the reveal is "good" or "bad" (quality of metadata), and cannot detect reveals on tokens minted after the watch starts without manual refresh. Reveal detection uses heuristic patterns—some valid metadata may be misclassified as placeholders. Always verify the contract address independently. The script does not store or share any data—all processing happens locally in your browser.