BSV Browser
BSV Browser is BSV Association’s wallet for the phone. It is a web browser for iOS and Android with a self-custodialOnly you hold the keys. Nobody else can sign payments or recover the wallet for you wallet inside, so a BSV blockchain web app that you open in it can ask the wallet for payments and identity through BRC-100BSV Request for Comments 100, the standard interface between apps and wallets.
When to use BSV Browser
Use BSV Browser when you want a wallet on your phone, or when you want to open a BSV blockchain web app on a phone. Use BSV Desktop when you build and test apps on your computer, as the guides in these docs do.
| BSV Desktop | BSV Browser | |
|---|---|---|
| Runs on | macOS, Windows and Linux | iOS and Android |
| How apps reach the wallet | Apps on the same computer, through ports on your machine | Web apps opened inside the browser |
Download BSV Browser from the App Store or from Google Play.
Browser mode and Web3 mode
BSV Browser starts as a normal web browser, with tabs, bookmarks and history, and no wallet. When you create or import a wallet, the browser switches to Web3 mode, and BSV blockchain web apps can request payments, identity and certificates from it. A permission sheet shows each request, and you approve or reject it.
Connect to a web app on your computer
BSV Browser can also be the wallet for a BSV blockchain web app that you open on your computer. When the app shows a QR code to connect a phone wallet, scan it with the camera of your phone. BSV Browser opens on Connect Wallet and shows the address of the app, so you can check it before you approve. After that, the app sends its wallet requests to your phone, and your keys stay on the phone.
The connection uses Wallet RelayAn encrypted connection between a web app and a phone wallet, through a relay server that cannot read the messages. Any mobile BRC-100 wallet can implement Wallet Relay with the @bsv/wallet-relay package, and a web app adds it as a way to log in next to BSV Desktop.
Where things are
Creating a wallet makes a recovery phrase that anyone can use to spend your coins. Keep it offline and never share it. Check BSV Network in Wallet, Settings before you receive or send coins. Testnet is for learning, and Mainnet moves real BitcoinSV (BSV).
Open the menu with the three dots at the bottom right of the screen, then choose Wallet.
| To do this | Go to |
|---|---|
| Switch network | Wallet, Settings, BSV Network |
| Create a wallet | Pay or Get paid. The wallet is created the first time you use one of them |
| Import a wallet | Import from backup, at the bottom of the wallet screen |
| Back up the key | Wallet, Settings, Backup Wallet Keys |
| Export the wallet data | Wallet, Settings, Export Wallet Data |
Networks
In Wallet, Settings, BSV Network offers Mainnet, Testnet and TeratestA test network for Teranode, the node software of the BSV blockchain. Switching the network rebuilds the wallet on the chain you choose. Use testnet to learn and test, since its coins are free and have no value. A payment on Mainnet moves real BSV and cannot be undone.
Back up your wallet
Your keys are only on your device, and nobody else holds them. If you lose the phone and have no backup, you lose the wallet. Anyone with your recovery phrase can spend your coins, so keep it offline and never share it.
BSV Browser gives you four ways to back up. Use more than one.
Recovery phrase
The recovery phrase is 12 words that restore your keys on any compatible device. Find it in Backup Wallet Keys. It restores only the keys, not the history.
Recovery shares
Choose Print Recovery Shares to split the key into three printed pages. Any two of them restore the wallet. To restore, choose Import from backup, then Scan Backup Shares, and scan two pages. Like the phrase, they restore only the keys.
Wallet data
Choose Export Wallet Data to save the wallet database as a .db file, with the transaction history, the coins and the certificates. To restore it, choose Wallet, Settings, Import Wallet Data and pick the file.
Private backup
The private backup is on by default. BSV Browser keeps an encrypted copy of the wallet database on a BSV Association server. It brings back the history on a new phone after you restore the keys with the phrase or the shares. The copy is encrypted on your device with a key that your phrase restores, so BSV Association cannot read it and cannot restore it for you. Turn it off or delete it in Wallet, Settings, Private backup. With it off, the phrase alone may not recover all of your funds on a new device
Related articles
More about wallets: