StuartFowell
img width: 750px; iframe.movie width: 750px; height: 450px;
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 wallet extension setup troubleshooting guide
Braavos Wallet Extension Setup Fix Common Installation and Connection Issues
If the add-on fails to appear in your browser's toolbar after installation, first verify it is enabled. Navigate to your browser's extension management page (often found at chrome://extensions or about:addons). Locate the plugin and ensure the toggle is switched on. Some browsers require a restart before the icon becomes visible next to the address bar.
Connection errors frequently stem from conflicting local data. Clear the cache within the plugin's own settings menu. If problems persist, a full reinstallation may be necessary. Before removing the add-on, securely store your secret recovery phrase. Uninstall the tool, restart your browser, and then install it again from the official source. Use your phrase to restore access to your existing accounts and assets.
Transaction stalls or rejections often relate to network configuration. Within the plugin's interface, confirm the active network matches your intended destination. For persistent RPC errors, manually switch to a reliable alternative endpoint in the network settings. Ensure your browser has not automatically updated, causing a temporary compatibility lag; developer teams typically issue a patch within 48 hours of a major browser release.
Braavos Wallet Extension Setup Troubleshooting Guide
Clear your browser's cache and cookies, then restart it before attempting the installation again.
A failed installation often stems from conflicting add-ons. Disable all other browser add-ons temporarily, then try adding this tool once more. This isolates the problem.
Your browser must be up-to-date. Using Chrome? Go to chrome://settings/help. Firefox users should visit about:support. An outdated browser will block the add-on from functioning correctly.
Check if your operating system meets the minimum requirements. For desktop, you need Windows 10 (64-bit) or macOS Monterey 12.0 and later. Mobile users require iOS 15 or Android 10.
Security software or corporate firewalls can interfere. You may need to add an exception for the add-on's domain in your antivirus or firewall settings. Consult your network administrator if on a managed network.
If the interface loads but fails to connect, check your network's RPC endpoint settings. Manual configuration might be necessary; use a reliable, fast endpoint URL specific to your network.
Reinstalling often fixes corrupted local data. Remove the add-on completely via your browser's extension manager. Shut down the browser, then re-download the installer from the official source only–never from third-party sites.
Still stuck? The transaction log inside the add-on's settings can reveal specific error codes. Note these down. Official community forums and support channels require this data to provide targeted assistance; screenshots help.
Checking Browser Compatibility and Version
Confirm your browser is Chrome, Firefox, Brave, or Edge, as these are the only supported environments.
Navigate to your browser's settings menu and select 'About' (Chrome, Brave, Edge) or 'Help' > 'About Firefox' to see the exact version number. You require Chrome/Edge version 100 or later, or Firefox version 101+. Older builds lack necessary security protocols and modern web APIs, causing the interface to malfunction or fail to load entirely.
If your version is outdated, the browser will typically prompt you to restart for an update; allow this immediately.
Disable any conflicting add-ons, especially those that block scripts or modify page behavior, as they can interfere with core functionality. Test in a private browsing window with all extensions disabled to isolate the issue.
An unsupported browser, like Safari or Opera, will not work and requires switching to a recommended platform.
Installing the Extension from the Official Source
Navigate directly to the Chrome Web Store using your browser's address bar.
Search for the correct add-on by its exact, verified name to avoid fraudulent copies; counterfeit versions often appear in search engine ads.
Confirm the developer's identity matches the official project team before proceeding. The store listing should show a high user count and a recent publication date, indicating active maintenance.
ElementWhat to VerifyPublisher NameMust be "Braavos" or the specified corporate entity.User ReviewsCheck for consistent, recent feedback.Update HistoryLook for regular version releases.
Click the 'Add to Chrome' button and carefully read the permission request pop-up. This step is non-negotiable for security; understand what data the tool requires, such as access to specific websites or transaction approval capabilities.
After the installation completes, its icon should appear in your browser's toolbar. If it doesn't, access your browser's extension management page (chrome://extensions/) and ensure the toggle is activated. A browser restart often resolves this visibility issue.
Pin the new utility to your toolbar for immediate access, then launch it to begin the account creation or import process directly within the interface.
Granting Necessary Extension Permissions
Click the puzzle icon in your browser's toolbar, find the add-on's icon, and select "This can read and change site data" from its menu. Choose "On specific sites" for maximum security, then manually enter the URLs of the decentralized applications you actively use, rather than selecting the less secure "On all sites" option.
If a dapp's interface remains unresponsive, your permission settings might be blocking it. Verify the active permission rule for that specific domain in the management menu; a single typo in the URL will prevent the connection. Correctly formatted addresses typically begin with 'https://'.
Some advanced blockchain interactions require additional consent for transaction simulation. This is not a standard data access permission but a separate prompt that appears directly within the dapp's interface when you initiate a swap or a contract call–always review the details in this pop-up before approving.
Revoke access for unused applications periodically from your browser's settings under 'Privacy and Security' > 'Site Settings' > 'Additional permissions'. This limits exposure and keeps your authorized list current.
Creating a New Wallet vs. Importing an Existing One
Choose to generate a fresh vault if this is your first time interacting with the network. This action will produce a new seed phrase–a unique set of 12 or 24 words that is the absolute master key to your funds and identity on-chain. Guard this phrase with extreme care; write it down on physical paper, store it offline, and never share it with any person, website, or application. A new genesis also provides the highest security assurance, as you can be certain the recovery phrase has never been exposed elsewhere.
Opt for the import function to regain access to a portfolio you already own from another interface or a backup. This requires your original secret recovery phrase. Entering it will restore all associated accounts and transaction history. Use this path when:
Migrating from a mobile application to this browser add-on.
Recovering access after a device failure or reinstallation.
Consolidating management of an older account into this tool.
Security implications differ fundamentally. A newly created mnemonic is pristine, while an imported one carries the security history of its previous storage. If you suspect your phrase was ever viewed, copied, or stored digitally, do not import it; instead, move assets to a brand-new account immediately after restoration. The import process itself does not risk the seed, but it does bring any prior compromises into the new environment.
Test a successful import with a tiny transaction before moving large sums.
Connecting the Wallet to a StarkNet DApp
Ensure your software is updated; mismatched versions between the DApp's required StarkNet provider and your interface cause most connection failures.
When the DApp's connect button does nothing, check your browser's pop-up blocker for the domain. Manually allow pop-ups and redirects for the application's site. A missing connection request often hides in the browser's address bar as a blocked icon.
If the DApp displays an "account not found" error, your selected address in the portfolio interface might be on a different network. StarkNet mainnet and testnet are separate. Verify the DApp's supported network in its footer or settings, then switch your active account's network accordingly using your portfolio's dropdown menu before reattempting the link.
Clear the DApp's locally stored data. Cached information from a prior session can conflict with a fresh handshake. Use the browser's site settings to clear "Site data" or "Cookies and other site data" specifically for that DApp's URL, then reload the page completely.
For persistent silent failures, a hard refresh (Ctrl+Shift+R or Cmd+Shift+R) bypasses the cache and forces the DApp to reload all scripts, which can resolve a stalled provider injection.
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 management page. The icon should become colored, allowing you to click it and begin setup or login. If it stays gray, try a full browser restart.
During wallet creation, my recovery phrase backup failed. Is my seed phrase still safe?
Yes, your phrase is generated locally in your browser the moment you start the process. A backup error usually relates to the interface, not the phrase itself. Do not refresh the page. Write down the 12 or 24 words manually on paper. Double-check each word for accuracy. After manually recording them, you can use the "Verify" step in the setup to confirm your backup is correct before proceeding.
After setup, my wallet shows zero balance, but I sent funds to it. How long should a transaction take?
StarkNet transactions have variable confirmation times. First, check your wallet address on a StarkNet block explorer to confirm the transaction was successful on the network. If it is confirmed there but not in your extension, the issue is likely a local sync problem. Disconnect the wallet from any dApps, lock it, and then unlock it again. If the balance still doesn't appear, try clearing your browser cache for the dApp site or restarting your browser.
I'm getting a "Transaction Failed" error every time I try to approve an action, even though I have enough ETH for fees.
This can have a few causes. The most frequent is an out-of-date fee estimate. Wait a minute and try the transaction again. If it persists, check your network connection and switch to a different RPC provider in the wallet's settings. Also, ensure you are not in "Ledger" or "Hardware Wallet" mode if you are using a standard software wallet. Finally, some complex smart contract interactions may require more ETH for fees than the initial estimate; try a slightly higher fee multiplier if the wallet allows it.
My Braavos wallet works on Chrome but not on Firefox. What are the specific compatibility steps for Firefox?
Firefox handles extensions differently. First, confirm you downloaded the extension from the official Firefox Add-ons store, not the Chrome Web Store. Firefox has stricter privacy settings. Go to Firefox's site permissions (the padlock icon in the address bar) and ensure the dApp website has permission to use "Install Add-ons". Also, disable any privacy-focused extensions temporarily, as they can interfere with wallet connection scripts. Ensure your Firefox browser is updated to the latest version.