Wallet Integrations - Start9Labs/bitcoin-core-startos GitHub Wiki

Contents

BitBoxApp

This guide is adapted from Shiftcrypto.

Available For

  • Android
  • Linux
  • macOS
  • Windows

Instructions

  1. Ensure you are running Tor on your device.

  2. In the BitBoxApp sidebar, select Settings > Enable tor proxy.

  3. Enable the proxy and confirm the proxy address (127.0.0.1:9050).

  4. Restart BitBoxApp in order for the new settings to take effect.

  5. In the BitBoxApp sidebar, select Settings > Advanced settings > Connect your own full node.

  6. In the field Enter the endpoint, paste your electrs Tor URL and Port (found in Electrs > Properties). For example: gwdllz5g7vky2q4gr45zGuvopjzf33czreca3a3exosftx72ekppkuqd.onion:50001

  7. Click "Check", and you will be prompted with the message "Successfully established a connection".

  8. Click "Add" to add your node to the node list at the top of the page.

  9. Remove the other servers if you want to exclusively connect to your own node.

Blockstream Green

Available For

  • Android
  • iOS
  • Linux
  • macOS
  • Windows

Instructions

  1. In Green, click the hamburger menu, then App Settings (at the bottom).

  2. Enable the Connect with Tor toggle.

  3. Under Custom servers and validation, enable the Personal Electrum Server toggle.

  4. For Bitcoin Electrum server, enter your electrs Quick Connect URL (found in Services > electrs > Properties)

  5. Click Save.

Blue Wallet

Available For

  • iOS
  • Android

Blue Wallet on Mac cannot use Tor and is therefore not supported by StartOS.

Instructions

  1. Ensure you are running Tor on your device.

  2. In Blue Wallet, go to the settings menu and click "Network".

  3. Click "Electrum Server".

  4. Enter your electrs host (hostname) and port (found in Services -> electrs -> Properties). For example: gwdllz5g7vky2q4gr45zGuvopjzf33czreca3a3exosftx72ekppkuqd.onion:50001

  5. Click 'Save'

Electrum

[!warning] Completing this guide will add your StartOS Electrum Server (electrs) to the list of servers used by Electrum. If, instead, you only want to connect to your own server, ignoring all others, you will need to run Electrum in Single Server Mode from the CLI.

Available For

  • Mac
  • Linux
  • Windows
  • Android/Graphene

Instructions

  1. Ensure you are running Tor on your device.

  2. Open Electrum and go to Tools > Network or, if you are running for the first time, choose "Select server manually," and click "Next".

  3. Uncheck "Select server automatically", and enter your electrs Quick Connect URL (found in Services > electrs > Properties). Then click "Next".

  4. Select "Use Tor" and "Use Proxy" and enter "127.0.0.1" for the address and "9050" for the port. Click "Next"

  5. That's it! You will be prompted to create a wallet if this is your first time. You can check your connection by clicking the orb in the bottom right, which should be blue in color. If your server settings persist, you are connected.

Fully Noded

Available For

  • Mac
  • iOS

Instructions

  1. In Fully Noded, go to Settings > Node Manager > +

  2. Enter your Bitcoin Core credentials. You can do this in one of two ways:

    • Use Fully Noded to scan your Quick Connect URL (found in Services > Bitcoin Core > Properties); OR

    • Enter your Bitcoin Core Tor URL (found in Services > Bitcoin Core > Interfaces) with :8332 appended, as well as you RPC Username and Password (found in Services > Bitcoin Core > Properties).

Nunchuck

Available For

  • Mac
  • Linux
  • Windows
  • Android/Graphene
  • iOS

Instructions

Nunchuck Mobile

  1. Ensure you are running Tor on your device.

  2. If using Android/Graphene, add Nunchuck to the list of VPN apps in Orbot.

  3. Open Nunchuck and select Profile > Network Settings.

  4. In the "Mainnet server" field, enter your electrs hostname and port (found in Services > electrs > Properties).

  5. Click "Save network settings" and restart Nunchuck.

Nunchuck Desktop

  1. Ensure you are running Tor on your device.

  2. Open Nunchuck and go to Profile (bottom left) > Settings > Network Settings.

  3. In the "MAINNET SERVER" field Enter your electrs hostname and port (found in Services > electrs > Properties).

  4. Select "Enable TOR Proxy" and enter "127.0.0.1" for the address and "9050" for the port.

  5. Click "Save network settings" and restart Nunchuck.

Sparrow

Available For

  • StartOS
  • Mac
  • Linux
  • Windows

Instructions

Sparrow on StartOS

  1. Ensure Sparrow is installed and running if not already.

  2. Click "Launch UI".

Sparrow Desktop

  1. If you plan to connect remotely over Tor, ensure you are running Tor on your device. If connecting locally, you can skip this step.

  2. If this is your first time using Sparrow, you will be guided to a screen to configure your Bitcoin server. Otherwise, you can find the server setup in File > Preferences > Server > Configure Server.

    • Connecting to Bitcoin Core (recommended):

      1. In the URL field, enter your Bitcoin Core RPC URL (found in Services > Bitcoin Core > Interfaces).

        • If connecting locally, copy the LAN Address. Remove the https:// prefix and enter "443" for the port.

        • If connecting over Tor, copy the Tor Address. Remove the http:// prefix and enter 8332 for the port.

      2. In the User / Pass field, enter you Bitcoin Core RPC Username and Password (found in Services > Bitcoin Core > Properties)

    • Connecting to electrs:

      1. In the URL field, enter your electrs Tor hostname and port (found in Services > electrs > Properties). Currently, electrs can only be used over Tor.

  3. If you are connecting over Tor

    • Enable Use Proxy.

    • For URL, enter "localhost".

    • For Port, enter "9050".

  4. Click "Test Connection".

Specter

Available For

  • StartOS
  • Mac
  • Linux
  • Windows

Instructions

Specter on StartOS

  1. Ensure Specter is installed and running if not already.

  2. Click "Launch UI".

Specter Desktop

@TODO

Trezor Suite

Available For

  • Mac
  • Linux
  • Windows

Instructions

  1. CLick the gear icon to enter the settings menu.

  2. Inside the Application tab, enable Tor.

  3. Inside the Coins tab, hover over over Bitcoin to show the gear icon. Click it.

  4. Under Backends, click the dropdown menu and select "Custom Electrum Server".

  5. Enter your electrs Quick Connect URL (found in Services > electrs > Properties) and click "Confirm".