{"id":20415741,"url":"https://github.com/unstoppabledomains/resolution-browser-extension","last_synced_at":"2026-03-18T02:31:59.685Z","repository":{"id":41774787,"uuid":"224024324","full_name":"unstoppabledomains/resolution-browser-extension","owner":"unstoppabledomains","description":"Surf the dweb today with chrome extension","archived":false,"fork":false,"pushed_at":"2026-03-06T17:52:55.000Z","size":14280,"stargazers_count":42,"open_issues_count":1,"forks_count":25,"subscribers_count":14,"default_branch":"master","last_synced_at":"2026-03-06T21:07:39.863Z","etag":null,"topics":["blockchain","chrome","decentralized","domain","dweb","extension"],"latest_commit_sha":null,"homepage":"https://unstoppabledomains.com/extension","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unstoppabledomains.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-11-25T19:22:48.000Z","updated_at":"2026-03-06T17:52:59.000Z","dependencies_parsed_at":"2023-12-05T16:43:05.344Z","dependency_job_id":"5ecb5a25-6750-48cb-a40f-036dca139f23","html_url":"https://github.com/unstoppabledomains/resolution-browser-extension","commit_stats":null,"previous_names":[],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/unstoppabledomains/resolution-browser-extension","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unstoppabledomains%2Fresolution-browser-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unstoppabledomains%2Fresolution-browser-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unstoppabledomains%2Fresolution-browser-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unstoppabledomains%2Fresolution-browser-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unstoppabledomains","download_url":"https://codeload.github.com/unstoppabledomains/resolution-browser-extension/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unstoppabledomains%2Fresolution-browser-extension/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30642995,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-18T01:41:58.583Z","status":"online","status_checked_at":"2026-03-18T02:00:07.824Z","response_time":104,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","chrome","decentralized","domain","dweb","extension"],"created_at":"2024-11-15T06:17:23.148Z","updated_at":"2026-03-18T02:31:59.660Z","avatar_url":"https://github.com/unstoppabledomains.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Unstoppable Domains Browser Extension\n\n**The Unstoppable Domains Browser Extension** enables access to onchain applications and domains, facilitating a secure and user-driven experience. The extension includes an integrated wallet with support for multiple blockchains such as Bitcoin, Ethereum, Base, Polygon and Solana. Using the wallet, users can manage their onchain assets directly from the browser and interact with onchain applications. \n\nAdditionally, the extension integrates with decentralized storage networks such as IPFS to resolve domain names stored on the blockchain, such as `.crypto` and `.eth`, directly within the browser.\n\n## Getting Started\n\n### Prerequisites\n\nEnsure that you have `node` (version 16) and `yarn` installed on your machine. If not, you can install it via [Yarn's official documentation](https://classic.yarnpkg.com/en/docs/install).\n\n### Running locally\n\n1. Clone the repository:\n   ```bash\n   git clone \u003crepository-url\u003e\n\n3. Copy .env.template to .env and fill in the required values:\n   ```bash\n   cp .env.template .env\n   ```\n\n4. Install dependencies and setup your environment:\n   ```bash\n   yarn install\n   ```\n\n5. Run the project locally:\n   ```bash\n   yarn dev\n   ```\n\n6. Once the build is complete, open `chrome://extensions` in your Chrome browser, enable Developer mode, and load the unpacked extension by selecting the `dist` folder.\n\n### Distribution\n\nThis package has builds extension releases for Chrome and Firefox browsers. Follow the steps below\nto build a new release version.\n\n1. Update the release version in the `package.json` file\n\n2. Build a release for distribution\n   ```bash\n   ##################################\n   # Build everything\n   ##################################\n\n   yarn dist\n\n   ##################################\n   # Build specific release version\n   ##################################\n\n   # For a mainnet production release\n   NODE_ENV=production; yarn build:all\n\n   # For a testnet development release\n   NODE_ENV=staging; yarn build:all\n   ```\n\n3. Find the release files in the `./releases` directory\n\n## Usage\n\n### Basic instructions\n\n1. Open the extension popup window.\n1. Select a sign in option\n   1. Existing users may enter their user name and password\n   1. New users may create a new account\n1. Manage wallet\n   1. Send / receive crypto by navigating to the desired blockchain asset\n   1. Update wallet settings using the \"Settings\" menu option\n      1. Compatibility mode - emulates MetaMask\n      1. Connections\n1. Interact with blockchain applications\n   1. The extension will automatically popup when a blockchain application requests to interact with your wallet. For example, the extension may popup for the following application scenarios:\n      1. Connection requests\n      1. Permission requests\n      1. Message signatures\n      1. Transaction approvals\n   1. Wallet operations only proceed with your approval\n1. Send a message using XMTP\n   1. Click the menu options at the top right of the extension\n   1. Select the `Messages` option\n   1. Select a conversation\n      1. Find an existing conversation from the list (if available)\n      1. Create a new conversation\n         1. Select the search text box\n         1. Type a wallet address or domain name\n         1. Select the chat partner for a new conversation\n1. Sherlock Assistant\n   1. When enabled, Sherlock Assistant finds onchain domain names associated with Ethereum wallet addresses as you browse the web\n      1. Updates your webpage to display onchain domain name\n   1. Enable / disable Sherlock Assistant\n      1. From settings\n         1. Click the menu options at the top right of the extension\n         1. Update the checkbox option to enable/disable the Sherlock Assistant globally\n      1. From a context menu\n         1. Right click any webpage to enable/disable Sherlock Assistant for a specific website\n1. Decentralized browsing\n   1. Type in a blockchain domain (like matt.crypto) in the browser URL field\n   1. You will be redirected to the IPFS gateway with the domain’s IPFS hash record\n\n## Sample screenshots\n\n### User onboarding\n#### Upgrade to new version screen\n\u003cimg width=\"396\" alt=\"image\" src=\"https://github.com/user-attachments/assets/7983ea80-ea0f-49cb-8444-42eee738ba02\"\u003e\n\n#### Sign in screen\n\u003cimg width=\"397\" alt=\"image\" src=\"https://github.com/user-attachments/assets/3128d366-46a9-469f-be7c-a805cd5681a4\"\u003e\n\n#### Account entry screen\n\u003cimg width=\"397\" alt=\"image\" src=\"https://github.com/user-attachments/assets/e9adb7e8-64dd-413c-92f8-4f8ec020e1b6\"\u003e\n\n### Main screen\n\u003cimg width=\"398\" alt=\"image\" src=\"https://github.com/user-attachments/assets/e4542126-678c-47ef-90d6-e091f2ef14f2\"\u003e\n\n### Menu options\n\u003cimg width=\"396\" alt=\"image\" src=\"https://github.com/user-attachments/assets/1e95566e-6262-4684-a9b6-6f0ba9a67e7b\"\u003e\n\n### Settings\n\u003cimg width=\"394\" alt=\"image\" src=\"https://github.com/user-attachments/assets/c88cd269-4ea0-4619-8909-72c12fabfe71\"\u003e\n\n### Messages\n#### Chat window\n\u003cimg width=\"395\" alt=\"image\" src=\"https://github.com/user-attachments/assets/80ab133c-01b6-488b-b195-a494faea4205\"\u003e\n\n#### Receiving a message notification\n\u003cimg width=\"372\" alt=\"image\" src=\"https://github.com/user-attachments/assets/930a31f8-ea19-4085-bbcd-6800be14023b\"\u003e\n\n### Sending crypto to another wallet\n#### Choose recipient and amount\n\u003cimg width=\"393\" alt=\"image\" src=\"https://github.com/user-attachments/assets/04d29892-9077-4f4f-afbc-d57b9a126862\"\u003e\n\n#### Confirmation\n\u003cimg width=\"396\" alt=\"image\" src=\"https://github.com/user-attachments/assets/f45ec91c-46b2-4c62-9c5f-e13704ff99b1\"\u003e\n\n#### Progress\n\u003cimg width=\"397\" alt=\"image\" src=\"https://github.com/user-attachments/assets/c03c8ca4-fde9-4cf4-b4cd-0d23ecdf09c6\"\u003e\n\n### Interacting with an app\n#### Connecting wallet\n\u003cimg width=\"1044\" alt=\"image\" src=\"https://github.com/user-attachments/assets/b20a2092-f30a-406e-9780-49c4017e3403\"\u003e\n\n#### Approving connection\n\u003cimg width=\"1058\" alt=\"image\" src=\"https://github.com/user-attachments/assets/a40ff586-a24e-4153-9347-d3d72c82fd35\"\u003e\n\n#### Approving a signature\n\u003cimg width=\"1055\" alt=\"image\" src=\"https://github.com/user-attachments/assets/157825a7-fc8f-4df0-aeb9-b895558f465a\"\u003e\n\n#### Context menu to manage connection\n![image](https://github.com/user-attachments/assets/a96f2b7a-a5ff-4694-9f92-a147f4d3adbd)\n\n## Frequently Asked Questions (FAQ)\n\n### Why does this extension require access to `*.google.com` and other search engine domains?\n\nThis access is essential for redirecting queries from major search engines like Google to decentralized addresses. For instance, searching for \"brad.crypto\" will redirect to its decentralized counterpart. Note that this extension _does not_ store or transmit your browsing history; all processing is done locally on your device.\n\n### How can I add support for additional search engines?\n\nAdding a new search engine is straightforward:\n\n1. Update the `manifest-template.json` file to include permissions for intercepting requests from the new search engine.\n2. Modify `src/util/searchEngines.ts` to incorporate the new search engine's specific configurations.\n\nSubmit a pull request with these changes, and we will integrate the support promptly.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funstoppabledomains%2Fresolution-browser-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funstoppabledomains%2Fresolution-browser-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funstoppabledomains%2Fresolution-browser-extension/lists"}