GusOGrady

DOCTYPE html>
Braavos Wallet Extension Installation Issues and Connection Problems Fix Guide

If the add-on fails to appear in your browser's toolbar after installation, immediately check its management page. Navigate to chrome://extensions/ or the equivalent for your browser, enable "Developer mode," and confirm the component is both present and toggled to an active state. A disabled or corrupted installation requires a fresh download from the official source, followed by a complete browser restart–not just a tab refresh.
Persistent connection failures often stem from network interference. Configure your device's firewall or security software to allow traffic on standard ports like 443. Attempt switching from a public Wi-Fi to a mobile data hotspot or a wired connection, as some public networks block the necessary RPC endpoints. Clearing the browser's cached data and hard reloading the interface (Ctrl+F5) can eliminate outdated scripts causing handshake errors.
Seed phrase entry errors are critical. The mnemonic recovery field is case-sensitive and requires exact spacing–typically a single space between each of the 12 or 24 words. Verify each word against the official wordlist; a single typographical error will generate a completely different set of addresses. Manually typing the phrase is more reliable than pasting, which can introduce hidden characters or formatting.
Transaction signing problems frequently relate to conflicting browser elements. Disable all other cryptocurrency management tools and ad blockers for the session, as they can intercept and modify API calls. Ensure your browser is updated to its latest stable version, as outdated JavaScript engines may not properly execute the required cryptographic functions. If a transaction stalls, check the network status page for real-time congestion alerts before resubmitting.
Verifying Browser Compatibility and Add-on Support

Confirm your browser is either Chrome (version 98 or newer), Firefox (version 102 or newer), or a Chromium-based derivative like Brave, Edge, or Opera. These are the only environments where the software's core modules will initialize correctly. Older builds lack required Web3 APIs and will cause silent failures during installation or transaction signing.
In Firefox, navigate to `about:addons`, click the gear icon, and select "Check for Updates." For Chrome-based applications, go to `chrome://extensions/`, enable "Developer mode" in the top-right corner, and then click the "Update" button. This manually refreshes the component's manifest and can resolve version mismatch errors that block its icon from appearing in the toolbar.
Third-party content blockers, script modifiers, or aggressive privacy tools frequently interfere. Temporarily disable add-ons like Privacy Badger, NoScript, or certain ad-blockers to test if the interface loads. Hardware acceleration in your browser can also conflict with cryptographic processes; turning this setting off in your browser's advanced options has resolved graphical glitches for some users.
Check.
A corrupted user profile prevents proper storage of seed phrases and network data. Create a new browser profile specifically for financial applications to isolate it from potential conflicts. If the problem persists across clean profiles and updated browsers, the issue likely resides with the application's own service workers, which can be reset via the developer console on its details page.
Adding the Extension from the Official Chrome Web Store

Navigate directly to the Chrome Web Store using your browser and search for the exact name of the tool.
Verify the developer's identity matches the official project name before proceeding. Check the user rating and review count; a legitimate add-on typically has thousands of reviews and a high score. Click the blue 'Add to Chrome' button, then confirm the installation in the subsequent dialog by selecting 'Add extension'.
A new icon should appear to the right of your address bar. Pinning it ensures constant access. If the icon is missing, click the puzzle piece (extensions menu) and pin it from the list. Initialization will begin upon first click.
Some browsers block installations from unofficial sources. If the process fails, ensure you are not on a third-party mirror site. The only secure source is the store linked from the project's main website.
Complete the installation by following the on-screen prompts to create a new vault or restore an existing one. This step is mandatory for functionality.
Generating a New Wallet vs. Importing an Existing One

Choose creation if you are initiating your first digital asset portfolio. This action produces a fresh seed phrase, typically a 12 or 24-word sequence you must physically record and store offline; this phrase is the absolute master key for fund recovery and access, and its digital capture–via screenshot or text file–creates a critical vulnerability. The software will never request this phrase, so any prompt for it is a definitive sign of fraudulent activity.
Opt for the import function to regain command of a portfolio on a new browser or device. This requires your original secret recovery phrase. Accuracy in entering each word in the exact order is non-negotiable for success. An incorrect or out-of-sequence phrase will fail, locking you out. This method does not duplicate or reset your holdings; it merely restores access to your existing ledger on the blockchain, allowing you to resume transactions and view your current balance and history immediately.
Fixing the "Connection Failed" or "Network Error" Message

Immediately verify your internet connection's stability by trying to load other secure websites; a simple router reboot often resolves transient glitches.
Your installed add-on might be blocked by overly restrictive security software. Temporarily disable your firewall and antivirus to test the connection, and whitelist the application in their settings if this fixes the issue. Concurrently, check for any pending operating system updates, as outdated network drivers can cause persistent failures.
Potential CauseSpecific Action
Incorrect RPC ConfigurationManually switch to a different network provider endpoint in the interface settings.
Local Network ConflictClear your browser's cache and hosted data, then restart the application.
Port BlockingEnsure your VPN or proxy isn't interfering, and try connecting from a different network.
If problems persist, the service's nodes might be experiencing temporary downtime. Consult their official social media channels or status page for real-time outage reports before proceeding with a complete reinstallation of the software, which should be your final step after exporting any necessary recovery phrases.
Handling Extension Permissions and Site Access

Manually review and grant only the permissions your add-on requires for core functions; for instance, a tool needing to read website addresses doesn't automatically require permission to modify data on all pages. Check these settings in your browser's management menu under Site permissions or Site access. If a dApp fails to connect, first verify its URL is correctly listed in the "Allowed" sites list for the plugin, and clear any cached data from the dApp's site before attempting reconnection.
Specific connection failures often stem from overly restrictive browser settings. Adjust these three parameters: disable any built-in pop-up blocker for the dApp's domain, ensure "Third-party cookies" are allowed, and confirm the "Connections" permission for the plugin is set to "On specific sites" with the correct address included. Regularly audit and remove unused site authorizations from the permissions list to minimize surface area for potential conflicts.
Restoring Your Wallet with a Secret Recovery Phrase

Always input your 12 or 24-word mnemonic phrase manually using your device's keyboard; copy-pasting from a digital document creates a critical security vulnerability by exposing the phrase to potential malware or clipboard monitoring.
The sequence is non-negotiable. Enter each word exactly as provided during the initial creation, in the correct order, with a single space between them. Double-check for typos, especially with similar-sounding words like "there," "their," and "they're." Most interfaces will not offer auto-complete for these terms to prevent accidental leaks.
Common errors during this process include:

• Incorrect word order (transposing the 5th and 6th word).
• Adding extra spaces or punctuation.
• Using a phrase from a different vault or application.
• Network timeouts causing a partial import.

If the application reports an invalid phrase, verify the physical copy you stored. Do not attempt to guess or modify words.
Successful recovery will repopulate your interface with all associated accounts, transaction history, and digital assets. This process does not create a new vault; it regenerates the original cryptographic keys on your current device. You should immediately see your existing balances and can resume transactions.
After regaining access, establish a fresh backup of your recovery details on durable, offline media and review your security settings, as this restoration may have occurred on a new or different machine.
Upgrading or Reinstalling the Braavos Extension

Before a fresh installation, export your secret recovery phrase from the add-on's security settings; this 12 or 24-word sequence is the only way to fully restore your account and assets on a new instance.
Remove the existing plugin entirely via your browser's extension manager, then clear the cache and restart the program to eliminate corrupted local data that can cause persistent sync errors or transaction failures. A clean browser state is critical for the new installation to function correctly without inheriting previous conflicts.
Install the latest version from the official Chrome Web Store or Firefox Add-ons site, import your existing account using the saved phrase, and immediately verify the network and account details match your expectations to confirm a successful restoration.
FAQ:

Braavos wallet won't install from the Chrome Web Store. The button just says "Remove from Chrome" or it fails with an error. What can I do?

This usually means the extension is already installed but might be disabled or corrupted. First, open Chrome and go to `chrome://extensions/`. Check if Braavos is in the list. If it's disabled, click "Enable." If you see it and want a fresh start, click "Remove." After that, restart your browser completely and try installing again from the official store. Ensure you have a stable internet connection during the install. If the error persists, your browser cache might be interfering. Try clearing your browser's cache and cookies for the last hour, then attempt the installation once more.
I completed the setup, but my wallet shows zero balance even though I funded it. The transaction was confirmed on the blockchain explorer.

This is a common display issue, not a loss of funds. First, try a hard refresh of the extension page. Click the Braavos icon, then while the pop-up is open, press Ctrl+F5 (or Cmd+Shift+R on Mac). This forces a reload. If the balance is still incorrect, the issue is likely a network mismatch. Check the selected network in your wallet's settings. You might be looking at the "Testnet" network while your funds are on "Mainnet," or vice versa. Switch to the correct network. As a final step, log out and back into the extension. Your private keys and funds are secure on the blockchain; this is purely an interface synchronization problem.
During the seed phrase backup, I got an error saying "Failed to save" or the screen froze. Is my phrase still valid, and how do I proceed?

Yes, your generated seed phrase is valid from the moment it was created on your device. The error relates to the app's interface, not the security of your phrase. Do not close the extension window yet. If the 12 or 24 words are visible on the screen, write them down manually on paper in the exact order. This is your only backup. After recording them, you can close the frozen tab. Then, go to the Braavos Wallet Extension Braavos Wallet Browser Extension Braavos Wallet Chrome Extension Braavos Web3 Wallet Braavos Wallet Download Extension Braavos Wallet dApp Braavos Wallet Recovery Phrase Braavos Wallet Seed Phrase extension, click "I already have a wallet," and enter the seed phrase you wrote down. This will restore your wallet. The initial setup error won't affect the restoration process. Always ensure you are in a private space when your seed phrase is visible.
After updating my browser, Braavos extension disappeared and my password doesn't work on a fresh install. How do I recover my wallet?

Browser updates can sometimes wipe extension data. Your password is stored locally on that specific browser installation, so it's lost. Don't panic; you don't need the password to recover. You need your original seed phrase. Install the Braavos extension anew. On the welcome screen, select "I already have a wallet." You will be prompted to enter your 12 or 24-word recovery phrase. This is the backup you created during the initial wallet setup. Typing this phrase will restore full access to your wallet and all its assets. You can then set a new password. If you don't have your seed phrase, recovery is impossible. This highlights why the paper backup is the most critical step.