Connecting or Migrating your Samourai Wallet to RoninDojo


So, you've watched the livestream, looked at the roadmap and decided you want to dive in head first with RoninDojo. If you're already a Dojo user wanting to migrate to Ronin or a Samourai wallet user that wants to connect to their own node for the first time, this guide should help make things a little easier for you.


If you haven't done so already, check out my RoninDojo 101 for a flavour of what's in store from the Ronin team. It really is a fantastic product with a very exciting roadmap! The following steps assume that you have your RoninDojo and Ronin UI set up and ready to go. If you haven't done so already check out the Wiki page for a complete step by step guide.


Wallet Migration/Connection

If you are a connecting a new wallet to RoninDojo for the first time, start at step 6.

If you are connecting an existing wallet that has never been connected to a Dojo you control, it's best practice from a privacy viewpoint to create a fresh wallet and move the funds across.


1. Open your Samourai Wallet and press the three dots in the top right corner to access the menu. Go to Settings > Wallet > Show mnemonic. Check (and double check) this matches your offline backup.


2. Back to the menu and press Troubleshoot > Passphrase/backup test. Enter your wallet's passphrase. If you entered this correctly you will be notified. Do not move past this step until the wallet confirms you entered the right passphrase. Without this, you cannot access your bitcoin.


3. If you don't already know it, make a note of your PayNym. You can access this from the main wallet screen. Press the blue + and then press PayNyms. This is a good way of testing that you recovered the correct wallet at a later stage.


4. Go to Settings > Wallet > Secure erase wallet.


5. Restart Samourai Wallet.


6. Select main-net and activate Tor.


7. Press the three dots in the top right corner > Connect to existing Dojo.

8. Scan the Dojo connection QR code displayed by your RoninDojo UI. Alternatively if you are choosing not to run Ronin UI, you can find the same QR pairing code within your Dojo Maintenance Tool which is accessed via the Tor browser.


9. If you are a setting up a new wallet, continue with the setup shown on your phone screen screen. If you are migrating an existing wallet, press 'back' and then continue with these steps.


10. Press the three dots again and this time hit 'Import External Wallet'


11. Enter your seed phrase and add in your passphrase that we checked earlier.


12. Set a pin code to secure the app.


13. You will now be prompted to claim your PayNym. Do this and check it matches the one from your old wallet. If it doesn't, you have recovered a completely different wallet. Check your seed and passphrase and repeat the steps above.


You now have your wallet connected to your RoninDojo. Congrats! If you connected a fresh wallet then the following steps are not necessary, skip to the Whirlpool section. If you are restoring an existing wallet, don't be alarmed at this stage that you do not see a balance, we will fix that next.


To recap, we have checked our backups, deleted the wallet from the phone, connected the fresh app to your RoninDojo and then recovered the wallet within the app. Next we need to tell your RoninDojo to rediscover the bitcoin held by your wallet.


Restoring Balances

1. In the Ronin UI go to settings and hit 'Toggle Hidden Values'. You should now see your Dojo URL and Admin Key. Paste the Dojo URL into your Tor browser and then paste the Admin Key when prompted to log in. This will open your Dojo Maintenance Tool.


2. On your Samourai mobile wallet tap the three vertical dots in the top right hand corner of the screen the go to Settings > Wallet > Show XPUB. Which extended public key you choose will depend where your funds you are looking for are located within your wallet.

BIP44 XPUB = Your deposit account for addresses starting with a '1'

Segwit BIP49 YPUB = Your deposit account for addresses starting with a '3'

Segwit BIP84 ZPUB = Your deposit account for addresses starting with 'bc'


By default Samourai Wallet uses BIP84 ZPUB so it's highly likely that this is the one you will need if you are scanning for a balance in your deposit account.


Whirlpool pre-mix ZPUB = The account for any funds sent to Whirlpool that have not yet been mixed

Whirlpool post-mix ZPUB = The account where your mixed funds will be sat

Ensure you send your extended public keys from your mobile wallet to your computer in s secure manner by using encrypted email or an app like Standard Notes.


3. In Dojo Maintenance Tool click on the 'XPUB' tab enter the red text that corresponds to the type of PUB you are working with. Ensuring that you change "your_xpub" with the PUB that you copied from the mobile wallet.


For XPUBs enter xpub=your_xpub&type=restore&force=true

For YPUBs enter xpub=your_ypub&type=restore&force=true&segwit=bip49

For ZPUBs enter xpub=your_zpub&type=restore&force=true&segwit=bip84

Once you hit enter you should get a 'processing' message, this can take a couple of minutes so be patient. Once this is complete you should see a 'Status ok' result.


4. Now we need to navigate to the XPUB INFO tab and paste in the same PUB that we just copied from the mobile wallet. When you hit enter you should see something that looks like the image below. (I have covered up some of the information to preserve my privacy)

The main things to look for here are...

Tracked = True

Balance = Your expected balance (in sats)

Derivation = The derivation scheme relevant to your PUB (see step 3)


5. The following step is only required if you do not see your expected balance during the previous step. Navigate to the XPUB RESCAN tab and paste in the same PUB, and enter the default values into the other two boxes then press go.


Middle box = 100 Right hand box = 0


Once completed, repeat step 4 and you will now see your correct balance. This balance will now also be replicated in your Samourai Wallet.


So now we have successfully restored your wallet that is connected to your RoninDojo. Next step Whirlpool...


Whirlpool Connection

1. If you were already a Whirlpool Desktop user, go to System > Reset GUI.


2. Ensure you have Tor browser installed and running as it provides the proxy Tor connection to allow Whirlpool to connect to your RoninDojo.


3. Select 'Remote CLI'.

4. From your Ronin UI, press 'Start Whirlpool' and from the settings menu grab your Whirlpool hidden service address and paste into the address field of the Whirlpool GUI.

Ensuring the format looks like this http://youraddress.onion


5. The Tor port should automatically change to '9150' but if it doesn't you can change it manually. Press connect.



6. From your mobile wallet go to Settings > Transactions > Pari to Whirlpool GUI. Copy the pairing payload and pass it to the computer with Whirlpool Desktop installed. Paste the payload into the box provided and press continue.



Then press 'Initialise GUI'.



7. You will then be prompted to enter your wallet passphrase.


8. Whirlpool desktop should now open. If you are migrating an existing wallet you will see your UTXO's exactly where you left them prior to your RoninDojo migration.


If at anytime during this setup Whirlpool fails to connect, restart both Tor browser and the Whirlpool GUI.

Congratulations, you have now successfully connected/migrated your Samourai Wallet over to your new RoninDojo! You can now be safe in the knowledge that you are using the best and most private mobile wallet on the market, with your own full node and reaping the benefits of 24/7 remixing via the onboard Whirlpool CLI.


If you are interested in learning more visit their website, drop into the Telegram chat and give this Stephan Livera podcast with Zelko a listen.



If you enjoyed this article and would like to read more from me please visit www.bitcoinqna.com and consider throwing a few sats in the tip jar.



                 Site created by

                       Please

      if you found our site useful!