NFT Whitelist Mint Detector

WHAT IT DOES

NFT Whitelist Mint Detector checks whether your connected wallet address is on an NFT project's whitelist or allowlist by reading the contract's whitelist mapping directly from the blockchain. It displays your whitelist status (whitelisted or not), allocation amount, and remaining mint slots in real-time. The tool also monitors mint phase status—whitelist mint active, public mint active, paused state—and provides optional notifications when your whitelist status changes or when the whitelist mint phase becomes active. Perfect for tracking eligibility across multiple projects without manually checking each contract.

WHERE IT RUNS

Any webpage with an NFT mint 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. Click "Check Status Now" to read the whitelist status immediately. The status display shows your whitelist status, allocation, remaining mints, mint phase status, contract pause state, mint price, and supply. To monitor continuously, set the check interval (default 10 seconds), toggle notifications for status and phase changes, and click "Start Watching"—the tool checks the contract at your interval and alerts you when something changes. Keyboard shortcuts: Ctrl+Shift+W to start/stop watching, Ctrl+Shift+C to check status immediately.

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 common whitelist functions: isWhitelisted(address), whitelist(address), allowlist(address), whitelistAmount(address), whitelistAllocation(address), userAllocation(address), maxMint(address), and remainingMints(address). For mint phase detection, it checks whitelistMintActive(), publicMintActive(), mintActive(), saleActive(), paused(), and isPaused(). Each call is wrapped in try/catch with fallbacks to support different contract patterns. The tool also reads mint price via price() or mintPrice(), and supply via totalSupply() and maxSupply(). Results are rendered in a structured display with color-coded status indicators. Status changes are compared to previous state and trigger GM_notification when toggled on. All checks are performed via eth_call (read-only), so no gas is spent.

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 reads on-chain data only—no transactions are ever submitted. It cannot detect off-chain whitelist eligibility that is not stored on-chain, cannot verify merkle proof validity, and cannot read merkle proofs without the proof data. Always verify the contract address independently before relying on status checks. The script does not store or share any data—all processing happens locally in your browser.