Sparrow Wallet Guide

Before you proceed

Do not proceed until your RoninDojo is fully synchronized.

Introduction

Sparrow is a self-custody bitcoin wallet, a hardware wallet interface, and is available on all major desktop computers.

Sparrow can be connected directly to your node to your RoninDojo node.

How to install Sparrow

Follow instructions on the Sparrow Downloads page.

How to connect Sparrow to RoninDojo

1. Login to your RoninUI and navigate to Applcations → Electrum Server

2. Open Sparrow, select Preferences → Server and enter the following.

   • Server type: Private Electrum
   • Paste the indexer .onion address into the URL field
   • Delete :50001 from the end of the address
   • Set the URL port to 50001

3. Copy the Tor address, which ends with .onion.

4. Click Test Connection — you should eventually see a success message.

Tip

You are now ready to connect your hardware wallet to your RoninDojo!

How to use hardware wallets with Sparrow

1. Create a new wallet.

2. Select Connected Hardware Wallet or Airgapped Hardware Wallet and choose your device.

3. Refer to the Sparrow Hardware Wallet Docs for more information.

How to import Ashigaru into Sparrow

Importing an Ashigaru Wallet into Sparrow (also works for the old Samourai Wallet):

• If you choose to import your Ashigaru Wallet into Sparrow, set the derivation path to m/84'/0'/0'.
• After restoring your wallet, add your Whirlpool accounts by navigating to Settings → Add Account → Whirlpool.
• For users with a “deep” postmix account (where the address index is high due to hundreds of Whirlpool remixes), the postmix balance within Sparrow may be inaccurate. If so, carry out the steps below.

1. Go to Settings → Advanced.
2. Change the gap limit to 150, press ENTER, then click Close.
3. Click Apply.
4. Go to View → Refresh Wallet.
5. Wait for your wallet to resync.

Note

Ashigaru Wallet has two additional script types within the deposit wallet: Legacy and Segwit Compatibility (Nested Segwit). These are used to receive bitcoin to addresses beginning with 1 or 3, and for the like-type change address privacy feature. To access bitcoin sent to these addresses, restore two additional wallets in Sparrow using derivation paths m/44'/0'/0' and m/49'/0'/0', setting the script type to Legacy and Nested Segwit respectively in the settings menu.

How to create a watch-only wallet in Sparrow

You can use Sparrow to watch the public keys (xPUB, yPUB, or zPUB) of other bitcoin wallets. This lets you track balances without saving the private key (required for spending) on your desktop.

Create a watch-only wallet in Sparrow by selecting File → New Wallet → add a name → xPUB / Watch Only Wallet.

If you wish to watch a public key from your Ashigaru Wallet, enter the correct derivation path for the intended public key, as below.

Deposit account

• xPUB — m/44'/0'/0'
• yPUB — m/49'/0'/0'
• zPUB — m/84'/0'/0'

Pre-mix account

• zPUB — m/84'/0'/2147483645'

Post-mix account

• zPUB — m/84'/0'/2147483646'

Note

When watching a post-mix account, be sure to carry out the following for an accurate display of your balance:

1. Go to Settings → Advanced.
2. Change the gap limit to 150, press ENTER, then click Close.
3. Click Apply.
4. Go to View → Refresh Wallet.
5. Wait for your wallet to resync.

Missing or wrong wallet balance

Some users may have trouble viewing their entire wallet balance, especially on the post-mix side. This can usually be resolved by increasing the Gap Limit setting to 300. In rare instances, a much higher limit (1000 or more) may be required.

Gap limit explained

The address gap is the number of unused addresses between those that have received funds. For example:

• Address #1 receives coins
• Addresses #2 to #11 go unused (gap here is 10 unused)
• Address #12 receives coins

In the example above, the address gap is 10. If your Sparrow Wallet has a Gap Limit of 5, it would not see the coins in address #12. This is why a very large gap limit (1000+) is unusual.

Setting the gap limit

1. Navigate to Settings → Advanced → Gap Limit.
2. Set Gap Limit to 300.
3. Repeat the above steps for each wallet account (Deposit, Premix, Postmix, Bad Bank).
4. Perform a wallet refresh via View → Refresh Wallet (Ctrl + R).
5. If the balance still doesn’t appear, the Gap Limit may need to be set higher (1000+).

Confirming an address gap in Sparrow

1. Open Sparrow and navigate to Addresses.
2. Scroll through Receive Addresses and observe any large gaps between the most recently used address and the one prior.
   • A very large gap should be fairly obvious (e.g. a gap of 1000).
   • Unused addresses do not display a value — they are blank.
3. Repeat step 2 for each wallet account (Deposit, Premix, Postmix, and Bad Bank) to observe all possible gaps.

Managing address gaps

If you observe an unusually large address gap between the most recently used address and the one prior, that is a rare bug that occurs on Sparrow when using Whirlpool — it is not a RoninDojo issue.

It’s manageable by being aware and setting the appropriate gap limit whenever you recover your wallet. If the gap limit is too big, you may want to consider moving your coins to a new wallet.