# BSV Browser

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

BSV Browser is BSV Association's mobile wallet for iOS and Android, a web browser with a self-custodial wallet inside.

**BSV Browser** is BSV Association's wallet for the phone. It is a web browser for iOS and Android with a self-custodial (Only 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-100 (BSV 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](https://apps.apple.com/app/bsv-browser/id6755637932) or from [Google Play](https://play.google.com/store/apps/details?id=org.bsvassociation.browser).

## 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 Relay (An 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 **Teratest** (A 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:

- [Wallets overview](https://bsvblockchain.com/docs/wallets/)
- [BSV Desktop](https://bsvblockchain.com/docs/wallets/bsv-desktop/)
- [Back up and recover a BSV Desktop wallet](https://bsvblockchain.com/docs/wallets/backup-recovery/)
- [How wallets and BRC-100 work](https://bsvblockchain.com/docs/concepts/wallet-model/)