This is the original walkthrough, kept for reference. Software and services have changed since it was written. Read the current guide.
This illustrated walkthrough includes older software and hardware. Its screenshots explain the workflow, but menu names, prices, requirements and service availability may differ. Use the linked project documentation for the version you are running. For the current app, step by step, read BlueWallet: a clearer everyday wallet.
What is Blue Wallet?
BlueWallet is an open-source mobile Bitcoin wallet with on-chain wallets and support for LNDHub accounts. BlueWallet’s own hosted LNDHub service retired on 31 May 2023. Using another LNDHub means trusting its operator with that Lightning account; creating an on-chain wallet does not create a self-custodial Lightning node.
Features
Here’s a quick rundown of Blue’s features…
- Connect to your own node via Electrum (local IP only so you will need a VPN for remote access outside your nodes network)
- Connect to your own lightning node via LND Hub
- Manage multiple wallets
- Add entropy via dice rolls when creating a wallet
- Show balances in BTC, sats or fiat
- Watch only wallets
- Plausible deniability feature (hides main balance in case of attack)
- Replace by fee (bump transaction fee option)
- PSBT (works with your **Coldcard*)* ⚠️ COLDCARD is no longer recommended: see this warning.
- Lightning app marketplace
- Local trader interface for buying and selling via HodlHodl
Connecting Blue Wallet to your node
This is not essential to use Blue Wallet but if you have spent any time at all on my website then you would know by now that if you aren’t trusting your own node to interact with Bitcoin, you are trusting someone else’s. If you aren’t interested in this right now feel free to skip this section and continue on with Creating a wallet below.
A wallet server can learn about the addresses it serves. Using your own compatible server reduces that disclosure, but it does not hide on-chain transactions or remove the need to maintain and secure the server.
1. From the home screen tap the three horizontal dots in the top right hand corner and you will be taken to the settings page.
FIG. 01Connecting Blue Wallet to your node
2. Click network
FIG. 02Connecting Blue Wallet to your node
3. From the network page, hit Electrum server.
FIG. 03Connecting Blue Wallet to your node
4. Enter your node’s local IP address in the first box and the secure port (50002) into the third box. Once connected you will be notified with a green status at the top of the page.
FIG. 04Connecting Blue Wallet to your node
Now you’re safely connected to your own node, let’s make a new wallet.
Creating a wallet
An on-chain seed backup is not the same as an LNDHub account backup. The old hosted Lightning default no longer applies. Follow the current wallet-type documentation and retain the appropriate backup before funding.
1. From the home page press add now.
FIG. 05Creating a wallet
2. You can now give your wallet a name, select the wallet type (Bitcoin) and adjust advanced settings which aren’t required to be changed for 99.9% of users. At this stage you have the option to roll a dice to add additional entropy to your wallet generation. This reduces the trust in the app’s inbuilt random number generator. Again this is not a requirement but an optional feature for the more privacy concerned user.
FIG. 06Creating a wallet
3. Press create and you will then be shown a list of 24 words. Ensure you write these words down, keep them safe and share them with no-one. They are the master backup for your bitcoin and anyone with access to them can steal all of your funds.
FIG. 07Creating a wallet
You will then be taken to your home screen where you can view your wallet(s). Clicking on each one will give you the option to send or receive as well as give you the option to view all previous transactions.
BlueWallet includes coin control. In a funded on-chain wallet, open Wallet details → Coins to label, freeze or select individual outputs; Use coin(s) starts a spend with that selection. Inspect the selected inputs before confirming, especially when separating funds with different privacy histories.
Where can I learn more?
If you want to try Blue Wallet for yourself visit their website and for the more technical user that wants to look under the hood, visit their GitHub. You can also drop into their Telegram group to keep up to date with any developments. Finally, if you are interested in using your ColdCard with Blue Wallet, check out this video.
Disclaimer - All views expressed in this article are my own and not those of the BlueWallet team.
