Wallet Group Tagging Tool

WHAT IT DOES

Wallet Group Tagging Tool is your organization system for wallet addresses that lets you group and tag addresses with color-coded labels. It automatically detects wallet addresses appearing on transaction pages, wallet interfaces, and address displays, then provides a group-based tagging system where addresses can be assigned to named groups with distinct colors. The tool displays group tags next to detected addresses, supports multi-address tagging, group creation/deletion/editing, batch operations, group statistics and membership views, one-click tagging from the current page, import/export of group data, and auto-applies group tags 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. Create groups by entering a group name and selecting a color—groups appear in the panel with member counts. Tag addresses by entering an address and selecting a group, or use "Tag Current Addresses" to batch-tag all addresses on the page. Group tags appear next to addresses with color-coded styling. Manage groups via the panel with rename/delete controls. Export your group data as JSON for backup or sharing, and import previously exported data. Toggle auto-display to show/hide tags on page. The panel shows group statistics and recent tagged addresses.

GROUP-BASED ADDRESS ORGANIZATION ENGINE WITH PERSISTENT DATA MANAGEMENT

Unlike single-label systems that only support one label per address, this tool implements a group-based tagging engine that supports multiple groups per address with color-coded visual identification. The engine uses a many-to-many relationship model where each address can belong to multiple groups and each group can contain multiple addresses, stored as two persistent JSON objects: groups (id, name, color, timestamps) and addressGroups (address → [groupIds]). The DOM detection engine scans the page for addresses using CSS selectors and text-node analysis, then cross-references each address against the addressGroups database to determine which group tags to display. The rendering engine dynamically inserts color-coded badges (using predefined color classes and inline border styling) next to addresses with minimal DOM interference. The management interface supports full CRUD operations with real-time updates, batch tagging, and statistics showing group membership counts.

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 group count, auto-display status, group list with member counts and color previews, tagged address list, and management controls for creation, tagging, import/export, and settings.

PLEASE NOTE

This script requires the free BotGentz extension to be installed in your browser—it does not run as a standalone extension. Groups and tags 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 group data stays local in your browser storage. The tool provides organizational assistance but does not verify address identities or guarantee group accuracy.