Mint Refund Tracker for Failed Mints

WHAT IT DOES

Mint Refund Tracker for Failed Mints watches the current page for failed mint transactions, reads transaction receipts and logs via eth_getTransactionReceipt and eth_getLogs, detects failed mint attempts and tracks refund eligibility, displaying a list of failed mints with refund status, amount, and steps to claim the refund if applicable. It helps you recover funds from failed mint attempts that may be eligible for refunds.

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 are deployed. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you track refunds.

HOW TO USE

Enter the mint contract addresses you want to monitor in the "Contract Setup" section (comma-separated). Specify the refund eligibility function name (e.g., "getRefundEligibility", "isRefundable", "canRefund"). Set the refresh interval and toggle desktop notifications on or off. Click "Connect & Track Refunds" to connect your real wallet extension, which will begin scanning for failed mint transactions at your specified interval. The panel displays a list of failed mints with their status (Failed, Refundable, Not Refundable, or Checking), contract address, block number, and value. Refundable mints are highlighted with a notification. Use "Check Now" for an immediate scan, "Clear History" to reset the list, or "Stop Tracking" to disconnect.

TECHNICAL OPERATION

Mint Refund Tracker for Failed Mints 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 transaction logs using eth_getLogs to capture events from the monitored contracts. It checks transaction receipts using eth_getTransactionReceipt to determine if a transaction failed (status === 0). For each failed mint, the tool checks refund eligibility using eth_call with the user-specified refund function. It attempts multiple common function names (getRefundEligibility, isRefundable, canRefund, getRefundStatus, refundEligible) as fallbacks. The tool displays the refund status for each failed mint and triggers notifications when a refundable mint is detected. The list is stored in memory and displayed with color-coded status indicators.

THE PANEL

The Mint Refund Tracker for Failed Mints 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 detect failed mints if the contract does not emit events for failures, cannot check refund eligibility if the contract does not expose a view function for it, cannot detect off-chain refund processes, and cannot initiate refund claims on the user's behalf. No private keys are stored or transmitted—all data is read-only from the blockchain. Always verify refund eligibility directly with the contract or project team before taking action.