Braavos Wallet Extension Installation Issues and Connection Problems Fix
If the add-on fails to appear in your browser after installation, first check its management page. Navigate to chrome://extensions/ for Chromium-based browsers or about:addons in Firefox. Ensure the toggle is enabled and the visibility icon is active. A required browser restart is often the simplest fix for this state.
Connection errors frequently stem from network interference. Configure your firewall or security software to allow traffic on ports 8545 and 1317. If you use a VPN or proxy, temporarily disable it to test the connection. Switching your DNS provider to a service like Google DNS (8.8.8.8) or Cloudflare (1.1.1.1) can resolve domain resolution failures.
Persistent interface freezing usually indicates a conflict. Disable all other blockchain-related add-ons and test functionality in isolation. Clear the application’s local storage data via your browser’s settings for the specific plug-in; this resets the UI without affecting your secured keys. Ensure your browser version is updated to at least the two most recent stable builds.
For transaction signing failures, verify your network selection matches the destination. Manually increase the gas limit by 20% above the estimated default. If a transaction remains pending indefinitely, use a blockchain explorer to locate its hash and attempt a cancellation by sending a zero-value transaction with the same nonce and a higher fee.
Braavos Wallet Extension Setup Troubleshooting Guide
Confirm your browser is updated to the latest version; Chrome, Firefox, and Brave often block older add-on APIs. If the interface fails to load, clear your browser’s cached data and hard reload the page (Ctrl+Shift+R on Windows/Linux, Cmd+Shift+R on Mac). Disable conflicting plugins like other crypto managers or ad blockers temporarily during the installation process.
A corrupted local storage state can halt initialization. Resetting this via the browser’s developer console (Application > Local Storage > right-click to clear) often resolves persistent UI freezes without affecting your seed phrase. For transaction signing errors, verify your network node is synced and check RPC endpoint settings–mainnet failures might require switching to a custom, reliable provider. Always ensure your secret recovery phrase is physically recorded before any corrective action.
Extension Not Appearing in the Browser Toolbar
First, pin the add-on. Click the puzzle piece icon in Chrome or the jigsaw piece in Firefox to open your list of installed add-ons. Locate the Braavos tool and click its pin icon. This action forces it to remain visible on your toolbar.
If pinning doesn’t work, the installation may be incomplete or corrupted. Visit your browser’s dedicated management page (chrome://extensions/ or about:addons). Ensure the toggle next to the add-on is enabled. A grayed-out or missing status often indicates it was blocked by the browser; you might need to reinstall it directly from the official store.
- Check for conflicting software, like aggressive antivirus suites or other privacy tools, which can sometimes disable add-ons silently.
- Verify your browser version is updated; outdated builds can cause compatibility issues.
- Create a new browser profile to test if the problem is specific to your current configuration.
A corrupted local browser cache can interfere. Try a hard refresh (Ctrl+F5) on the active tab, or restart the browser completely. For persistent cases, resetting the toolbar to its default layout through the browser’s settings menu can clear a graphical glitch.
Reinstallation is the definitive step. Remove the tool from your extensions page, restart the browser, and obtain a fresh copy from the official distribution source. This replaces all local files and typically resolves deep-seated visibility problems.
Connecting the Extension to a New or Existing Wallet
Select “Create a new vault” only if you are prepared to generate and securely store a fresh 12 or 24-word secret recovery phrase; this action cannot import an existing account.
For an existing account, click “I already have one” and input your precise seed phrase. Ensure every word is spelled correctly and entered in the exact original order, with a single space between each term. The most common failure point is a single misplaced or misspelled word, so verify meticulously against your backup. This process does not require network connectivity.
After phrase entry, the interface will prompt you to set a local password for encrypting the vault’s data on this specific browser. This password is separate from your seed phrase and is not stored or recoverable by the service; losing it will require re-importing the account using the seed phrase again. Following successful decryption, your portfolio’s assets and transaction history will populate automatically.
Resolving “Installation Corrupted” or Similar Browser Errors
Force a fresh download by clearing your browser’s cached data. Navigate to your browser’s settings, find the privacy or history section, and select “Cached images and files” for removal. After completing this, restart the application completely and attempt the add-on installation again from the official source.
If the problem persists, a conflict with existing browser data is likely. Execute these steps in sequence:
- Disable all other add-ons temporarily and try the installation.
- Create a new, clean browser user profile via your settings menu and attempt the install within it.
- As a definitive measure, uninstall the software using your browser’s extension management page, then manually delete any remaining folder for this add-on from your computer’s directory (common locations include `%LocalAppData%\[Browser Name]\User Data\Default\Extensions` on Windows or `~/Library/Application Support/[Browser Name]/Default/Extensions` on macOS) before reinstalling.
This method isolates and eliminates corrupted local files that cause integrity check failures.
Fixing “Transaction Failed” or “Signing Failed” Messages
Immediately check the network congestion status on the blockchain explorer; high gas fees often cause automatic cancellations. Manually increase the max fee by at least 15% above the current suggested rate to push your operation through during peak times.
An outdated application version frequently breaks signature processes. Visit the official store page to force an update, then completely restart your browser to load the new binaries.
Review your connected dApp’s permissions. Revoke any stale or excessive allowances through a dedicated security portal, as corrupted permission sets can block new actions.
| Error Prefix | Likely Cause | Immediate Action |
|---|---|---|
| “RPC Error” | Network node issue | Switch to a custom, reliable RPC endpoint. |
| “User Rejected” | Popup was closed | Ensure all modal windows are visible and not blocked. |
| “Insufficient Funds” | Balance for fees | Confirm native token amount covers the network cost. |
Browser privacy features like “Hardening” in Brave or aggressive script blockers prevent necessary pop-ups. Whitelist the dApp’s site and disable these shields for the transaction duration.
If failures persist, export your private key (using your secret recovery phrase) into a different, updated interface to isolate the problem to the original software. This confirms whether the asset itself is functional.
Clear the local transaction cache and nonce data from your interface’s advanced settings. Corrupted state here sends incorrect parameters, guaranteeing a rejection by the network.
FAQ:
I installed the Braavos extension but the icon is gray and won’t open. What should I do?
This is a common first-step issue. The extension icon will remain inactive until you interact with a StarkNet application. Open a dApp website that supports Braavos, or go to the official Braavos account interface. A prompt should appear on that page asking you to connect your wallet, which will activate the extension. If that doesn’t work, check your browser’s extension management page to ensure the Braavos extension is enabled and not blocked by an ad blocker.
During setup, my recovery phrase doesn’t work for importing my existing wallet. What could be wrong?
Verify each word carefully against the official seed phrase word list. The most frequent causes are simple typos, an incorrect word order, or an extra space. Braavos uses a standard 12 or 24-word mnemonic phrase. If you are certain the phrase is correct, ensure you selected the correct network during import (Mainnet vs. Testnet). If the problem continues, you may be attempting to use a recovery phrase from a different type of wallet that isn’t compatible.
After updating the extension, I can’t see my tokens or NFTs. Are they gone?
Your assets are safe on the blockchain. This is typically a display or synchronization problem. First, confirm you are logged into the correct wallet account within the extension. Then, check the selected network in the extension’s settings matches where your assets are held (e.g., StarkNet Mainnet). Often, a hard refresh of your browser cache (Ctrl+Shift+R) or simply waiting a few minutes for the extension to sync with the network resolves this. You can verify your holdings independently using a StarkNet block explorer.
The transaction keeps failing with a “Max Fee too low” error. How do I fix this?
This error means the network fee you approved is now insufficient due to increased network demand. The solution is to increase the max fee for the transaction. In the Braavos extension, you should see an option to “Speed Up” or adjust the fee for the pending transaction. Approve a higher max fee. To avoid this in the future, you can adjust your default fee settings in the wallet’s preferences to be more flexible when network activity is high.
I’m trying to connect Braavos to a dApp, but the connection popup never appears. What steps can I take?
This is usually a browser or permission issue. First, click the Braavos extension icon in your toolbar and make sure you are unlocked and on the correct account. Then, try these steps: 1) Refresh the dApp webpage. 2) Disable any ad-blocking or script-blocking extensions for that site. 3) Check if the dApp requires a specific network and switch to it in 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. 4) Clear your browser’s cached images and files for the site. If none work, try reinstalling the Braavos extension, as your local data may be corrupted.
