Support & User Guide

The home screen is the whole app

Open the wallet and you see three things: your balance, two buttons, and your recent activity. Tap Pay to send money, Get paid to receive it. Everything else — currency, backups, app connections, network settings — sits behind the gear icon in the top right.

Tap the balance itself to cycle through the ways of showing it: satoshis, whole BSV, or your display currency. Pull the activity list down to refresh it.

"Self-custodial" means exactly what it says. The twelve secret words created when you set up are the only way back into this wallet, and nobody else has them — not the BSV Association, not your phone manufacturer. That is the point, and it is also the responsibility: see Backup & Recovery before you put real money in.

Step 1: Create or import a wallet

On first launch the app offers two routes. Create a new wallet generates a fresh twelve-word recovery phrase on your device. Import an existing wallet takes a phrase you already have — from another BSV wallet, or from this app on an old phone.

Either way your phone asks for Face ID, Touch ID, or your device passcode. That biometric lock is what guards the stored keys from anyone holding your unlocked phone.

Step 2: Save your secret words

The app shows you twelve words in order. Write them on paper and put the paper somewhere only you can reach. Anyone who reads those words owns everything in the wallet, and nobody can reset them for you.

You can always see them again later: Settings → Copy Secret Words. If you would rather have paper than handwriting, Print Recovery Keys produces three sheets and any two of them rebuild the wallet — so losing one page costs you nothing.

Someone nearby — scan their code

They are standing in front of you. They open Get paid → Someone nearby and show a code; you tap Pay → Someone nearby and scan it. If they set an amount, you see it before you confirm. If they left it at zero, you enter what you want to send.

This route needs no address typed and no network lookup of who they are: the code carries everything the two phones need.

Someone remote — pay a handle

They are somewhere else and they use this app too. Choose Someone remote, pick their handle, enter an amount, and send. The payment reaches them the next time their wallet checks in, whether or not their phone is awake right now.

To an address

For everyone else: exchanges, older wallets, anything that gave you a plain BSV address. Choose To an address, then paste or scan it and enter the amount.

Someone nearby — show your code

Choose Someone nearby. The wallet asks for an amount first: type one to request a specific sum, or leave it at zero and let the payer decide. Tap Continue and your payment code appears full-screen for them to scan.

The line under the code tells you what is happening — it waits for a nearby device, then confirms when the payment lands. If it is easier for you to scan them instead, tap Scan the payer's code on the same screen.

Someone remote — share your handle

Your handle is a name other people in this app can pay without needing an address. Choose Someone remote to see it and share it however you like — message, email, out loud.

To an address

When the sender is an exchange or a wallet that only understands plain addresses, choose To an address and the wallet shows one you can copy or let them scan.

Reading the list

Each row shows who the payment involved, what it was for when a description was attached, and the amount — positive for money in, negative for money out. Tap a row to open its details, including the transaction ID you can look up on any block explorer.

A payment that has been broadcast but not yet confirmed is marked as such. It is normal for this to last seconds rather than minutes; the balance updates as soon as the network accepts it.

Export CSV

Export CSV at the top of the activity list writes the whole history to a file you can share or open in a spreadsheet — useful for bookkeeping or tax records. The button is greyed out until there is at least one transaction to export.

Pairing with an app

Go to Settings → Connect to App, tap Scan QR Code, and point your phone at the pairing code the app is showing. If you have the pairing link as text instead, tap Paste URI.

Once paired, the app appears in this list. Anything it wants to do — spend, sign, reveal an identity certificate — arrives on your phone as a request you approve or refuse. Nothing happens silently.

This works with any app that speaks BRC-100, the open wallet standard, so there is no plugin to install and nothing tied to a single vendor.

Your secret words

Twelve words, in order, created when the wallet was. Enter them into this app on a new phone — or into any other BSV wallet that accepts a standard recovery phrase — and your money comes back.

Settings → Copy Secret Words shows them again and copies them to the clipboard. Paste them straight into wherever they are going and do not leave them sitting on the clipboard longer than you need.

Print Recovery Keys

Settings → Print Recovery Keys produces three sheets. Any two of them rebuild the wallet; any one of them on its own is useless to a finder. Store them in three different places — a drawer at home, a relative's house, a safe deposit box.

This is the better option if your handwriting worries you, or if you want a backup that survives one location burning down.

Private backup

The app can also keep an encrypted copy of its database on a server run by the BSV Association, so a new phone can restore not just your keys but your transaction history. It is encrypted with a key derived from your own secrets — the server cannot read it.

Under Settings → Advanced you can switch this off, and you can erase what has already been sent. The two are separate on purpose: switching off stops new copies, erasing removes the old ones.

The everyday rows

• Display Currency — show amounts in satoshis, BSV, or US dollars. This changes how numbers are displayed, never what you hold.
• Connect to App — pair with a desktop or web app by scanning its code.
• Copy Secret Words — reveal and copy your twelve-word recovery phrase.
• Print Recovery Keys — print three sheets, any two of which restore the wallet.

Advanced

• BSV Network — mainnet for real money, testnet for experiments. Switching networks switches wallets: balances and history do not cross over.
• ARC Endpoint — which service broadcasts your transactions. Change it only if you are running your own, or you were told to.
• Auto Spend Up To — the limit under which connected apps can spend without asking each time.
• Trust Network — whose identity certificates this wallet believes, and how much agreement it wants before it shows someone as verified.
• Storage — where the wallet keeps its data, and how much space it is using.
• Export / Import Wallet Data — a full copy of the wallet database as a file you keep. Unlike the recovery phrase this includes your history, so it is the right tool for moving to a new phone deliberately rather than recovering from a lost one.
• Debugging — the app's own logs. Useful to attach when you report a problem.

Log Out

At the bottom, in red. This erases the wallet keys from this device. Your money is not gone — it lives on the blockchain and your recovery phrase brings it back — but without that phrase there is no way in afterwards. The app asks you to confirm before it does anything.