Mint Limit Per Wallet Checker

WHAT IT DOES

Mint Limit Per Wallet Checker watches the current page for the user's wallet address, reads the number of mints already performed by the wallet from the mint contract via eth_call, and displays the remaining mint allowance (max mints per wallet minus already minted), with alerts when the wallet is approaching or has reached the mint limit. It helps you track your mint allowance and avoid failed transactions due to limit restrictions.

WHERE IT RUNS

This tool operates as a userscript within the BotGentz extension framework, running directly in your browser on any website. It works on any EVM-compatible blockchain page—Ethereum, Polygon, Arbitrum, Optimism, and more—where mint contracts with wallet limits are deployed. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you prepare to mint.

HOW TO USE

Enter the mint contract address and the mint count function name (e.g., "getMintCount", "mintCount", "numberMinted") in the "Contract Setup" section. Set the maximum number of mints allowed per wallet (if known) and the refresh interval. Toggle desktop notifications on or off. Click "Connect & Check Limit" to connect your real wallet extension, which will begin checking your mint allowance at your specified interval. The panel displays the current mint count, remaining allowance, and total supply. When your remaining allowance drops to 2 or fewer, you'll receive a notification. When the limit is reached, a warning is displayed. Use "Check Now" for an immediate check, or "Stop Monitoring" to disconnect.

TECHNICAL OPERATION

Mint Limit Per Wallet Checker uses raw JSON-RPC calls via window.ethereum.request() to interact with the blockchain. It loads ethers at runtime using a simple script tag injection for ABI encoding and contract interactions. The tool reads the number of mints for the connected wallet using eth_call with the user-specified view function. It attempts multiple common function names (mintCount, getMintCount, minted, getMinted, numberMinted, walletMintCount) as fallbacks. The tool calculates the remaining allowance by subtracting the mint count from the configured max mints per wallet. It also attempts to read the total supply using totalSupply. The tool displays color-coded status: green for sufficient remaining allowance, yellow for low remaining (2 or less), and red when the limit is reached. Notifications are triggered when the remaining allowance is low or when the limit is reached.

THE PANEL

The Mint Limit Per Wallet Checker panel is fully draggable and remembers its position between sessions using GM_setValue. It snaps to the edge of the viewport for a clean interface and can be collapsed to a small icon when not in use. The panel is resizable to accommodate longer content. Press Escape to quickly close or collapse the panel. The design is optimized for productivity with a dark theme, clear visual hierarchy, and responsive controls that adapt to your workflow.

PLEASE NOTE

This tool requires the free BotGentz extension installed in your browser and a real EVM wallet extension (MetaMask, Rabby, etc.) already installed. EVM chains only—this does not work on non-EVM blockchains. The tool cannot read mint count if the contract does not expose a view function for it, cannot detect off-chain mint activity, cannot track mints across multiple wallets, and cannot predict if the mint will sell out before the user mints. No private keys are stored or transmitted—all data is read-only from the blockchain. Always verify the contract address and function name before starting monitoring.