NFT Unwrap Helper

WHAT IT DOES

NFT Unwrap Helper is a specialized browser extension that reverses the wrapping process for tokenized NFTs, converting wrapped ERC-20 or ERC-1155 representations back into the original NFT asset. When you view an NFT detail page on a supported marketplace, the tool detects the token contract and ID, checks your wallet for any wrapped versions of that NFT, and verifies whether the wrapper contract still supports the unwrap function. If the NFT is wrapped and you own the corresponding wrapped tokens, the panel displays an "Unwrap NFT" button. On click, it constructs and executes a transaction that burns your wrapped tokens and redeems the original NFT from the wrapper contract, transferring it directly to your wallet. The tool supports both ERC-20 style unwrapping (burn + withdraw) and ERC-1155 style unwrapping (safeTransferFrom), automatically detecting which interface the wrapper contract implements. Optional batch unwrapping allows you to redeem multiple wrapped tokens in a single transaction when the wrapper contract supports it.

WHERE IT RUNS

This overlay operates on OpenSea asset detail pages, LooksRare token pages, and Rarible token pages. It works in any browser that supports the BotGentz extension framework and has an EVM-compatible wallet extension installed. The panel automatically resets its state when you navigate between different NFT pages, ensuring you always see the correct ownership and wrapper status for the current token.

HOW TO USE

Install the extension and navigate to an NFT detail page for a token you believe is wrapped. The panel will automatically detect the contract address and token ID from the page. Enter the wrapper contract address (or use the "Try Common Wrappers" button to check known registries). The tool will check your wallet for wrapped token balances at that address and display the result. If wrapped tokens are detected, configure your unwrap settings: enable batch unwrap if needed, set a batch size (max 10), choose a gas multiplier, and toggle high-value warnings. Click "Unwrap NFT" to begin the process. Your wallet will prompt you to confirm the unwrap transaction, and the panel will display real-time status updates including gas costs and ownership verification after completion.

MECHANISM: DUAL-INTERFACE WRAPPER DETECTION WITH SEQUENTIAL BURN-WITHDRAW PIPELINE

Unlike generic token tools that assume a single standard, this extension implements a heuristic detection system that determines which interface a wrapper contract implements before constructing the unwrap transaction. It first attempts to call the ERC-20 balanceOf() function—if successful, it proceeds with the ERC-20 unwrap path, which involves burning the wrapped token balance via burn() or a combined unwrap() function, then withdrawing the original NFT from the vault using withdraw(). If the ERC-20 call fails, the tool attempts the ERC-1155 balanceOf() call with the token ID as the second parameter. If successful, it constructs an ERC-1155 safeTransferFrom() call to transfer the wrapped tokens back to the wrapper contract (or to a burn address), triggering the redemption of the original NFT. The tool also attempts to detect and use a combined unwrap(uint256 tokenId) function if present, which performs both steps atomically in a single transaction, saving gas. Gas estimation is performed separately for each step, and the tool applies a user-specified multiplier to prioritize transaction confirmation speed. After the transaction completes, the tool verifies ownership by calling ownerOf() on the original NFT contract and displays confirmation.

THE PANEL

The overlay panel is fully draggable via its title bar and remembers its position per-site using GM_setValue. It snaps to the nearest edge when dragged within 40px of any screen boundary. The panel includes clear sections for NFT details (contract and token ID display), wrapper configuration (address input with common wrapper lookup), unwrap settings (batch toggle, batch size input, gas multiplier dropdown, high-value warning toggle), and action buttons. The status area provides real-time feedback on wallet connection, ownership verification, balance checks, transaction progress, and gas costs. Pressing Escape temporarily dismisses the panel until you navigate to a new NFT page or manually reactivate via the extension toolbar button. The panel automatically refreshes its data when you navigate to a new NFT, re-checking ownership and wrapped token balances.

PLEASE NOTE

This extension requires the free BotGentz framework extension to be installed and active. You must also have a real EVM-compatible wallet extension (such as MetaMask, WalletConnect, Coinbase Wallet, or Rabby) already installed in your browser—the overlay uses your wallet's RPC provider to make eth_call requests and to sign transactions. This tool works exclusively with Ethereum Virtual Machine chains including Ethereum mainnet, Polygon, Arbitrum, Optimism, and Base. The wrapper contracts supported are those that implement common ERC-721 to ERC-20/ERC-1155 wrapping standards. Because NFT marketplace interfaces, wrapper contract addresses, and unwrap function signatures may change, the tool's detection and transaction-building scripts may require periodic updates. We commit to releasing compatibility updates within 48 hours of any reported major marketplace or wrapper contract change. No private keys, wallet balances, browsing history, or NFT ownership data are ever collected, transmitted, or stored—all blockchain reads and writes are performed directly from your local wallet RPC provider to public blockchain nodes. The tool cannot detect wrapper contracts deployed without on-chain registries, cannot verify that the wrapper contract is still functional or safe (users should verify the wrapper address independently), cannot protect against malicious wrapper implementations, and does not support marketplaces or wrappers that use non-standard interfaces beyond ERC-20 and ERC-1155 patterns.