img width: 750px; iframe.movie width: 750px; height: 450px;
Braavos wallet setup recovery and dapps usage guide



Braavos Wallet Setup Recovery Steps and Practical DApp Usage Instructions

Immediately secure your 12-word seed phrase offline; this mnemonic sequence is the absolute key to your digital assets. Write it on paper, store it in a metal backup device, and never digitize these words. Losing this phrase equates to irrevocably losing access, as no central authority can restore it for you.


During initialization, the application will request you to establish a 6-digit PIN. This code, required for every session entry, encrypts the vault's local data. For heightened security, activate biometric authentication like a fingerprint scan within the settings menu post-deployment, adding a physical layer of protection against unauthorized access attempts.


Should you need to regain entry on a new device, select the "restore" option. You will be prompted to input your secret recovery phrase in the exact order. The interface may then ask you to verify a subset of words, confirming their correct sequence. This process reconstructs your entire profile, including transaction history and associated addresses.


Interacting with decentralized applications requires explicit confirmation for each transaction. When you connect your vault to a platform, carefully review the contract details and permission requests. Every action, from swapping tokens to minting an asset, demands a final authorization via your PIN or biometrics, ensuring you maintain direct control over all operations.

Installing the Braavos Browser Extension

Navigate directly to the Chrome Web Store or Firefox Add-ons marketplace using your preferred browser.


Search for the official plugin by name; verify the developer is listed as 'Braavos' to avoid counterfeit imitations. A single click on 'Add to Browser' initiates the process–confirm any permissions prompt to proceed with the integration.


Post-installation, the extension's icon will appear in your toolbar. Click it to launch the interface; this action does not automatically create or restore a vault. You must generate a new secret phrase or input an existing one to proceed. Never share this 12 or 24-word sequence.


Establish a strong password for encrypting the local vault data on this machine. This password is distinct from your secret recovery phrase and is required each session.


Pin the extension for immediate access.


With the portal active, you can now interact with decentralized applications on the Starknet network. The plugin will propose transactions for your approval directly within your browsing flow.

Creating and Securing a New Seed Phrase

Generate your mnemonic phrase exclusively through the application's official interface during initial vault creation.


This 12 or 24-word sequence is the absolute master key; its compromise guarantees permanent loss of all associated assets. The software will never legitimately request it after setup.


Record each term in the exact presented order. Verify spelling twice, as a single incorrect word can render the sequence useless. Consider this comparison of methods:


MethodDurabilityRisk
Paper sheetHigh (if stored properly)Fire, water, physical loss
Metal plateVery HighInitial transcription error
Digital photoNoneExtremely High (hacking, cloud sync)


Never store a digital copy. Screenshots, cloud notes, or text files create catastrophic vulnerabilities.


Split the phrase for sophisticated protection. One method divides it between two secure locations; alone, each fragment is meaningless. For a 12-word phrase, you might store words 1-8 in one place and 9-12 with a copy of 1-4 in another.


Inform a trusted individual about the location of your backup, not the phrase itself, to ensure estate access.


Test restoration before depositing significant value. Use the recorded phrase on a clean device to confirm it perfectly rebuilds the vault.


Treat this process with the gravity of securing a physical safe deposit box key; its permanence and sensitivity define your cryptographic asset sovereignty.

Recovering Your Account with a 12-Word Phrase

Open the application and select the option to import an existing vault, then carefully type your secret phrase into the designated field. Enter each word in its exact order, with a single space between them, ensuring every character matches perfectly; even a minor typo in one term will generate a completely different set of cryptographic keys and prevent access.


Verify the sequence twice before proceeding, as this phrase is the absolute master key to your digital assets and smart contract interactions. Once confirmed, the interface will reconstruct your addresses and transaction history. You must then establish a new password for securing the local instance of your restored portfolio.


Test functionality with a small transaction.

Adding and Managing STARK and STRK Tokens

Manually import the STARK token contract address 0xca14298823b51b4e5e0a8f3add089eedcd791c97f09e2c2e7a6c8b4a5d6c5b4a to your asset list.


STRK, the network's native token for transaction fees, typically appears automatically; if missing, a network switch often triggers its detection.


Verify token details on a block explorer before confirming any addition to prevent fraudulent assets.


For regular STRK transactions, maintain a small balance separate from your main holdings to mitigate gas fee surprises during interactions with complex smart contracts.


Track your STARK holdings by connecting your portfolio to a dedicated portfolio tracker that supports the Starknet ecosystem, providing a clearer view of your position beyond the interface's basic balance display.


Always use the 'Add Token' feature via the contract address, never through unverified links sent in messages or displayed on unofficial forums.


Implement a dedicated vault for long-term STARK storage, moving only operational amounts to your primary, frequently used address for improved security management.

Connecting to and Using Starknet Dapps

Confirm the application's legitimacy before linking your interface; inspect its code repositories and community audits to mitigate risk.


Your extension will display a connection request. Scrutinize the permissions: does this smart contract only request public address viewing, or does it seek approval for asset transfers? Never approve blanket transaction signing. Each interaction requires a separate, explicit confirmation, displaying the exact function call and maximum potential fee. Network congestion on Starknet causes fee volatility; manually adjust the fee multiplier for urgent operations.


Verify the URL matches the project's official domain.Reject requests from unsolicited pop-ups or direct messages.Use a dedicated, low-value profile for experimental protocols.Monitor pending transactions with a block explorer like Voyager or Starkscan.


Failed transactions still consume gas. If a process stalls, check explorer status; do not resubmit identical data. For complex swaps or loans, simulate the transaction first via the dapp's own preview function. Maintain a small ETH balance for these gas costs, separate from your main STARK holdings.


Revoke unused contract allowances periodically through a dedicated security tool. This limits exposure if a protocol's logic is later compromised. Keep your signer software updated to ensure compatibility with the latest Starknet OS upgrades and Cairo compiler versions, which can alter how certain calls are processed.

Q&A:
I lost my phone. How do I recover my Braavos wallet on a new device?

You can recover your wallet using your seed phrase. On the new device, install the Braavos Web3 Wallet wallet extension or app. Select the "Import Wallet" or "Recover Wallet" option. You will be asked to enter your 12 or 24-word secret recovery phrase. Type the words in the exact order you saved them, with a single space between each word. After entering the phrase, you will be prompted to set a new password for the wallet on this device. Once confirmed, your complete wallet, including all accounts and transaction history, will be restored. Your funds are safe as long as you have the seed phrase.

Is it safe to connect my Braavos wallet to any dApp I find?

No, you should be selective. Only connect to dApps with a strong reputation. Before connecting, research the dApp. Check community forums, official social media channels, and project documentation for any reports of security issues. When a dApp requests a connection, Braavos will show the permissions it asks for. Review these carefully. A legitimate dApp typically only needs to see your public address and request transaction approvals. Be extremely wary of any site that asks for your seed phrase or private key; this is always a scam. You can also use wallet features like account separation, keeping a main account with large balances separate from a smaller account used for frequent dApp interactions.

What's the difference between the wallet password and the seed phrase?

They serve two distinct purposes. Your wallet password is a local access code. It encrypts the wallet data on your specific device (like your phone or computer). It is used to open the wallet app and approve transactions. If you forget this password, you can uninstall and reinstall the wallet, then use your seed phrase to regain access, setting a new password. Your seed phrase (12 or 24 words) is the master key to your entire wallet and all funds across all blockchains it supports. Anyone with this phrase has full control. It is used only for recovery if your device is lost, stolen, or reset. The password protects your device; the seed phrase protects your assets.

Why did a transaction fail on a dApp even though I paid a fee?

Transaction failure on Starknet can happen for several reasons, and fees are still paid for the computational work attempted. A common cause is the slippage setting being too low for a token swap, meaning the price changed before your transaction was processed. The transaction might also fail if the dApp's contract interaction had an error, or if you did not have enough of a specific token to cover the full cost. Always check the transaction details in your Braavos wallet before signing. After a failure, review the error message in the wallet's transaction history. You may need to adjust parameters like slippage or ensure you have sufficient funds before trying again.

Can I use the same Braavos wallet on my browser and my phone at the same time?

Yes, you can. The wallet is accessible on multiple devices simultaneously. You are not limited to one active session. To set this up, you must first have your wallet created on one device. Then, on your second device, install Braavos and choose the "Import Wallet" option. Enter your secret recovery phrase. This will create a synchronized copy of your wallet. Both instances will show the same accounts and balance, as they are viewing the same data on the blockchain. Actions taken on one device, like sending assets, will be reflected immediately on the other. Remember, you will need to set a separate password for the wallet on each device.