Wallet Label Manager for Site

WHAT IT DOES

Wallet Label Manager for Site is your complete address labeling tool that helps you organize and identify wallet addresses across all supported sites. It automatically detects wallet addresses appearing on transaction pages, wallet interfaces, and address displays, then provides a full-featured local label management system with add, remove, edit, search, and export functionality. The tool displays customizable labels next to detected addresses, supports label color-coding and categorization (Friend, Exchange, Scam, Contract, Personal), provides one-click labeling from the current page, includes import/export of label data, and auto-applies labels to addresses as you browse.

WHERE IT RUNS

This script runs on all major DEX interfaces including Uniswap (app.uniswap.org), SushiSwap (app.sushi.com), Curve (curve.fi), Balancer (balancer.fi), 1inch (1inch.io), CowSwap (cow.fi), major NFT marketplaces including OpenSea (opensea.io), Blur (blur.io), LooksRare (looksrare.org), Zora (zora.co), Rarible (rarible.com), Foundation (foundation.app), and Etherscan (etherscan.io). It works on transaction pages, wallet interfaces, address displays, and any page showing wallet addresses.

HOW TO USE

Install the script through the BotGentz userscript manager. Click "Connect Wallet" to link your EVM wallet extension. Navigate to any supported page displaying wallet addresses. The tool automatically detects addresses on the page. Use the "Add Label" section to label an address with a name and category (Friend, Exchange, Scam, Contract, Personal, Custom). The label appears next to the address on the page with color-coded styling. Use "Label Current Addresses" for one-click labeling of detected addresses. Manage existing labels via the panel display. Export your label database as JSON for backup or sharing, and import previously exported labels. Toggle auto-display to show/hide labels on page.

DOM-BASED ADDRESS DETECTION ENGINE WITH PERSISTENT LABEL DATABASE

Unlike simple address highlighters that just show addresses, this tool implements a comprehensive DOM-based address detection engine that scans the page for wallet addresses using multiple detection methods. The engine uses a combination of CSS selectors targeting common address elements, data-attribute detection, and text-node scanning to find all addresses on the page, regardless of how they're displayed. Each detected address is cross-referenced against the persistent label database, which stores entries with address (normalized to lowercase), custom label, category (Friend/Exchange/Scam/Contract/Personal/Custom), and timestamps. The label rendering engine dynamically inserts color-coded badges next to addresses using non-intrusive DOM manipulation that preserves page functionality. The database supports full CRUD operations with search, import/export in JSON format, and auto-application of labels as new addresses appear through DOM mutation observation.

THE PANEL

The floating panel is fully draggable and snap-to-edge enabled. You can collapse it to a compact bubble when not in use, resize it to your preferred dimensions, and it remembers its position across page loads using persistent storage. Press Escape to quickly dismiss the panel. The panel displays your label count, recent labels, add label form with address input and category selection, and management controls for export/import/clear.

PLEASE NOTE

This script requires the free BotGentz extension to be installed in your browser—it does not run as a standalone extension. Labels are local only and not shared unless exported. The tool relies on the page exposing wallet addresses in a detectable format and cannot automatically verify address identities. No user data is collected or transmitted—all label data stays local in your browser storage. The tool provides address labeling assistance but does not verify address identities or guarantee label accuracy.