# Yellowdex Release Notes Every update to the Yellowdex Chrome extension. ## v2.0.0-beta (v2.0.0-beta) — Jul 3, 2026 This is a major release: **your labels now sync across devices.** Sign in with your wallet and your collections, entities, tags, and address labels follow you from one browser to another — local-first, so everything still works instantly offline and syncs in the background. It also reworks tags and entities to live inside collections, and adds a sync status indicator and conflict resolution for edits made on two devices at once. ### What's New - **Cross-device sync (local-first).** Once you sign in, your address labels, entities, tags, and collections sync across every device where you're signed in. Writes still save locally and instantly — sync happens in the background (a periodic pull, a sync shortly after you make changes, and one when you open the popup), so nothing blocks on the network and everything works offline. - **Wallet login.** A new **Account** section in Settings lets you sign in with your wallet using a hosted signature flow (EIP-712) — no password. Signed out, the extension works exactly as before, entirely on your device. - **Sync status at a glance.** A status dot in the popup header shows where sync stands — signed out, syncing, up to date, needs attention, or a conflict to review — with details in the Sync settings. - **Conflict resolution.** If the same label is edited on two devices, the most recent edit wins and the one that lost is set aside for you rather than silently dropped. A review modal lets you keep your version or the other device's, one conflict at a time or all at once. - **Collection-scoped tags & entities.** Tags and entities now belong to a specific collection instead of one global list, matching how the server organizes them. Each collection has its own vocabulary, and the label form's entity/tag pickers show the ones for the collection you're labeling into. ### Fixes & Improvements - **Addresses move cleanly between collections.** Editing an address's collection now moves it (instead of leaving a stray copy), and the popup shows addresses grouped under each collection. - **Export no longer drops references to deleted entities.** Dangling references are handled so exports stay complete. - **Manage Entities shows the owning collection**, so it's clear which collection an entity belongs to. - Fixed invalid NUL bytes that could appear in label data. ### Notes - **Your existing data upgrades automatically.** Tags and entities that were global are split per collection — each collection that used a tag/entity gets its own copy, and anything unreferenced is homed in your Default collection. No action needed, and labels keep working. - **New permissions:** `identity` (for wallet sign-in) and `alarms` (to schedule background sync). Sync and login are opt-in — if you never sign in, neither is used. - **Sync requires signing in.** Signed out, everything stays local exactly as in previous versions; nothing is sent anywhere. ## v1.0.6-beta (v1.0.6-beta) — Jun 30, 2026 This beta adds suggested tags to the Add Address Label form so a fresh install isn't a blank slate, refactors how database upgrades are tracked for more reliable migrations going forward, and fixes several tagging edge cases. ### What Changed - **Suggested tags when labeling an address.** The Add Address Label form now offers a curated set of starter tags (exchange, dex, defi, bridge, whale, scam, and more). A **"Suggested:"** quick-add row appears when the tag field is empty, and suggestions also show up in the type-ahead alongside your own tags. Picking a suggestion creates (or reuses) your own tag, so your labels always reference your personal tags — not shared server data. ### Fixes & Improvements - **Editing a label no longer drops tags it can't display.** If a saved label carried an older tag the client couldn't resolve, editing and re-saving used to silently remove it. Those tags are now preserved through edits. - Fixed a race where rapidly pressing Enter or double-clicking a suggestion could create the same tag twice. - Fixed a case where the tag list could get stuck on its loading spinner. - Real errors when adding a tag are now surfaced instead of being masked as a duplicate. - **More reliable upgrades under the hood.** The local database schema now uses a one-file-per-version migration system with an audit ledger, making future updates easier to apply and verify. Existing data upgrades automatically with no behavior change. ### Notes - Labels created before this update that referenced an old server "system tag" will no longer show that tag chip (its name lived on the server and is no longer fetched). The address label text itself is unaffected, and the underlying tag references are preserved if you edit the label. All new tagging uses your own local tags. ## v1.0.5-beta (v1.0.5-beta) — Jun 19, 2026 This beta adds multi-network support — labels now track which chain they belong to — plus a new network filter in the popup, and fixes the Add Address Label modal on Brave. ### What Changed - **Network-aware labels.** Every saved address now carries the network it belongs to, using standard CAIP-2 chain identifiers (e.g. `eip155:1` for Ethereum). The same address can now be labeled separately on different chains instead of being collapsed into one. - **Popup network filter.** The popup shows a row of network chips for the chains present among the addresses on the current page. Pick a network to narrow the list to labeled addresses on that chain; "All" shows everything. All EVM chains share a single **EVM** badge, while non-EVM networks keep their own short name. - **Network badges on each address.** Address rows now display badges for the networks they're labeled on. ### Fixes & Improvements - **Fixed the Add Address Label modal on Brave.** On Brave, the modal failed to load Collections, Primary Entity, and Tags ("Could not load collections / entities / public tags"). Messaging between the page and the extension now uses the contract Brave requires, so the modal loads correctly. Chrome was unaffected. - Existing labels are migrated automatically to the new network-aware format on update; the cached system-label data refetches itself. - Import/export now uses the CAIP-2 network format, and importing still accepts older exports. - The network filter resets to "All" each time you open the popup, so a chain that isn't on the current page can't hide your results. - Added cross-browser end-to-end tests (Chromium and Brave) covering the in-page modal messaging path. ### Notes - Address detection on pages remains EVM-only (`0x…` addresses). Non-EVM chains are supported in the data model but aren't detected on pages yet. ## v1.0.4-beta (v1.0.4-beta) — Jun 12, 2026 This beta fills two gaps where known addresses weren't getting labeled: plain address links on explorer pages, and system labels for addresses on chains other than Ethereum. ### What Changed - Plain address links that show the full address — like the **Token Contract** under a token's **Other Info** panel on Etherscan — now get Yellowdex add/copy controls, instead of staying as raw, unlabeled text. - System labels now show up on **every supported chain**, not just Ethereum. An address flagged on BNB Smart Chain, Polygon, Arbitrum, and other networks now displays its label when you view it on the matching explorer (e.g. BscScan). ### Fixes & Improvements - Fixed an issue where an address with a known system label appeared unlabeled because the label was registered on a different EVM chain. - Plain navigation links and filtered/age links are left untouched, so controls still only appear on actual wallet and contract addresses. - Added automated coverage for bare address links and for system labels registered on EVM chains. ## v1.0.3-beta (v1.0.3-beta) — Jun 10, 2026 This beta makes Yellowdex labels show up consistently across Etherscan token holder and transfer lists, so more wallet addresses get inline add/copy controls. ### What Changed - The **From** and **To** columns on token transfer lists now show Yellowdex add/copy controls for every wallet, including named exchange rows like `Binance 14`, `Bitget 6`, and `ByBit Dep: 0x…` that previously had no controls. - Token holders list rows shown by name tag (e.g. `Binance: Hot Wallet 20`) now show Yellowdex controls. - Named address links and ENS name chips on explorer pages (e.g. `Relay: Solver`, `monstergirlz.eth`) now get controls even when only the name is displayed. - Controls are appended after the existing name or label, so the page's original text stays intact. ### Fixes & Improvements - Fixed inconsistent tagging where only some From/To addresses received controls. - Token asset rows (token logo + symbol) and filter links remain untagged, so controls only appear on wallet addresses. - Added automated coverage for token holder name tags, transfer From/To holder chips (exchange-logo and plain-name variants), and token-asset exclusions. ## v1.0.2-beta (v1.0.2-beta) — Jun 9, 2026 This beta makes Yellowdex labels more precise on block explorer pages and fixes the add-label modal appearing behind page content. ### What Changed - Yellowdex now adds tags only to visible address displays, reducing unwanted tags on explorer links, filters, and token rows. - Token asset rows on explorer pages no longer show Yellowdex add/copy controls when they are not representing a wallet address. - Address filter links such as `Last 1H` and amount filters no longer receive Yellowdex tags. - The add address label modal now stays visible above page content, including pages with embedded frames. ### Fixes & Improvements - Improved address detection on Etherscan-style pages. - Reduced false-positive inline tags on explorer pages. - Added automated coverage for explorer address displays, token rows, embedded frames, and modal visibility. ## v1.0.1-beta (v1.0.1-beta) — Jun 6, 2026 This beta improves inline labels on Etherscan pages and restores the intended styling for system labels. ### What Changed - System labels injected into web pages now use the purple system-label styling again. - Etherscan token holder rows now resolve the holder address from token-balance links instead of applying the token contract label to holder rows. - Etherscan token-balance links keep their original page text and structure to avoid conflicts with Etherscan's built-in highlighter. - Unlabelled Etherscan token holder links now show Yellowdex add/copy controls again, including name-tag rows like `Bitget 6` and truncated holder rows. - Updated the extension version to `1.0.1-beta`. ### Fixes & Improvements - Improved handling for `/token/?a=` and `/token//holder/` links. - Added coverage for Etherscan token-balance holder links, highlighted holder spans, and inline system-label styling. ## v1.0.0-beta (v1.0.0-beta) — Jun 6, 2026 This release rebuilds Yellowdex on a new extension foundation. The main goal is a more reliable, maintainable local labeling experience for EVM addresses, with a refreshed popup, settings UI, and page-labeling flow. ### What Changed - Rebuilt the extension using the WXT framework and React. - Refreshed the popup and settings experience while keeping the core local labeling workflow. - Improved page address detection and inline label rendering, including better handling for Etherscan-style pages, dynamic content, and iframe content. - Updated local label storage and import/export handling for the new extension foundation. - Added stronger automated coverage for address lists, settings, collections, entities, import/export, site exclusions, and inline page labels. ### Temporarily Removed In This Beta - Sign-in has been removed. - Cloud sync tied to sign-in has been removed. - Shareable collections and share-link import flows have been removed. - They will be back. We are rebuilding this flow on the new extension foundation. ## v0.1.6-beta (v0.1.6-beta) — May 31, 2026 This beta improves label backup/export behavior and cloud sync compatibility. ### What’s New - Cleaner JSON label exports for manual backups and restores. - JSON import/export now stays separate from cloud sync behavior - Export labels to json file continue to use the supported v4 format for backup ### Fixes & Improvements - Existing locally stored generated tag descriptions are cleaned during export, import, and sync preparation. - Cloud sync no longer sends the label-file schema version to the server. - Sync pull no longer depends on label-file version fields from the server. - Removed display-only network metadata from exported label data while preserving the actual network ID. - Improved compatibility for round-tripping labels across export/import and sync flows. ## v0.1.5-beta (v0.1.5-beta) — May 29, 2026 This beta improves label import, export, sharing, and sync reliability for network-aware address labels. ### What’s New - Improved support for labels on the same address across different networks, such as Ethereum and Base. - Label import/export now preserves network-specific address entries more reliably. - Shared collection imports now assign tag colors locally, keeping imported labels visually organized. ### Improvements - Tag colors are now treated as local display preferences instead of portable label data. - Exported label JSON no longer includes tag color values. - Sync no longer sends tag colors to the server. - Pulling synced tags keeps your existing local tag colors when possible. - Tag matching during sync is now case-insensitive, reducing duplicate tags caused by casing differences. ### Fixes - Fixed cases where network IDs could be collapsed during sync/import. - Fixed shared collection payloads so tag color does not leak into portable data. - Improved test coverage for label round-tripping, network-aware entries, and tag color behavior. ## v0.1.4-beta (v0.1.4-beta) — May 21, 2026 This beta focuses on making address labeling more reliable across pages, iframes, and the popup. ### What’s New - Added an About panel showing the installed extension version and server version. - Entity fields now support creating a new entity even when your typed name partially matches an existing one. For example, you can create `U` or `Universal` entities even if `Universal bridge` already exists. - Centralized exchange (CEX) deposit address collections are now labeled, making it easier to recognize known CEX deposit addresses. - Server-side address indexing now supports multi-network data, improving future label coverage beyond a single-chain view. ### Improvements - Improved label editing from the popup and in-page address forms. - The Label Address modal now opens at the page level instead of being trapped inside embedded frames. - Address labels refresh more consistently after storage or sync changes. - Popup sync now routes through the background worker for more consistent behavior. ### Fixes - Fixed duplicate Label Address modals appearing after one click. - Fixed cases where editing a label could reuse an old entity instead of creating the newly typed one. - Fixed legacy label compatibility so older saved labels are preserved when editing or saving. - Fixed address detection edge cases caused by reused regex state. - Reduced repeated event binding that could cause unstable UI behavior. ## v0.1.3-beta (v0.1.3-beta) — Apr 27, 2026 ### Improvements - **Address label prefill restored** — The label input once again pre-fills with the first 6 characters of the address (e.g. `0xd8dA`) when labeling an unlabeled address. This was removed in v0.1.2-beta but user feedback showed it made the labeling flow significantly faster — just pick an entity and save. - **Smarter display format** — Labels now adapt based on whether an entity is set: - With entity: `Uniswap: Hot Wallet` - Without entity: `Hot Wallet` Previously, addresses without an entity would show a redundant `{0xabcd}: {label}` format. Now they display the label cleanly on its own. ## v0.1.2-beta (v0.1.2-beta) — Apr 22, 2026 ### New Features - **Site exclusion list** — Disable the extension on specific sites where DOM injection causes issues. Default exclusion list fetched from server, with the ability to add/remove sites in Settings. Ships with `*.gitbook.io`, `docs.github.com`, and other known-problematic sites pre-excluded. - **Standardised label display** — System address labels now display as `{entity}: {label}` (e.g. "Uniswap V3: USDC/WETH (0.3%)"). Addresses without an entity fall back to `{0xabcd}: {label}` using the truncated address prefix. - **Legacy prefix cleanup** — Labels where users previously typed a redundant address prefix into the label field (e.g. `0xce2e: Hot Wallet` under entity "Uniswap") no longer display the double prefix. Now shows cleanly as "Uniswap: Hot Wallet" instead of "Uniswap: 0xce2e: Hot Wallet". - **Cleaner label modal** — The label input no longer pre-fills with the address prefix; placeholder now reads "Descriptive label (e.g. Hot Wallet)". ### Bug Fixes - **Contenteditable fix** — The extension no longer injects into rich text editors (Google Docs, Notion, etc.), preventing repeated emoji/element duplication. - **Old cache compatibility** — System labels from older cache entries now display correctly and pre-populate the modal with the correct entity and label fields. ## v0.1.1-beta (v0.1.1-beta) — Apr 4, 2026 ## What's Changed - Automatic address labels — Well-known addresses (e.g., Uniswap V3 pools) are now labeled automatically on any page, no sign-in required. - System collections — Browse and toggle system-maintained collections like Uniswap V3 (56k+ addresses) in the popup's collection dropdown and Manage Collections view. - Save to My Collection — Click edit on any system-labeled address to save it to your own collection with pre-populated data. - Visual distinction — System labels appear in purple to differentiate from your personal labels. ## v0.1.0-beta (v0.1.0-beta) — Mar 9, 2026 ## What's Changed - Shareable collections — Create collections of labeled addresses and share them with your team via a link. Recipients import with one click. - Smart search — Find addresses, entities, and tags instantly with ranked scoring that surfaces the best matches first. - Collection picker — Assign addresses to collections directly from the label editor. - Cross-device sync — Labels sync across browsers and devices. Local edits are preserved even when syncing from the server. - Yellowdex theme — Fresh yellow brand identity with updated colors across the extension and overlays.