Whirlpool is a "zerolink coinjoin" implementation created by the Samourai Wallet developer team. It is the most structurally sound and easy to use implementation on the market today. Whirlpool breaks all deterministic links between inputs and outputs. When coupled with "postmix spending tools" offered by the wallet, it provides a handy toolkit for you to maintain your bitcoin privacy.
Anyone that deploys a RoninDojo will notice that Whirlpool CLI is installed by default, and the only thing users need to do is pair the Whirlpool CLI with the Whirlpool desktop application using the instructions below.
Read more about it in this Whirlpool article, see Whirlpool documentation, or take a look at the Whirlpool repository.
Note if you are running a Tor daemon you can skip the Tor browser part
Credentials
→ Whirlpool
http://
and ends .onion
CLI address
. Be sure to include http://
and .onion
. DO NOT include the ":8899" part. The Tor proxy field will auto-populate.
socks5://127.0.0.1:9150
(or leave it at 9050 for Tor Daemon)WARNING: If at anytime during this setup Whirlpool fails to connect, try restarting both Tor Browser and Whirlpool desktop application.
API Key
blank, as this is only required after your Whirlpool CLI has been initialized. Press Connect
and you will be prompted to enter a pairing payload from your Samourai Wallet.
[⋮]
(3 dots) in the upper right corner. Select Settings
→ Transactions
, then select Pair to Whirlpool GUI
. Copy the payload into your Whirlpool desktop application using whatever method you prefer such webcam or encrypted email.
Use Dojo as wallet backend
and Tor is required for Dojo
after entering the pairing payload. Once you have verified the wallet is properly connected, then press Initialize GUI
button. You will be promted to enter your wallet's passphrase, and after doing so Whirlpool will finally open.
The following instructions will help you reset Whirlpool so the user can start from step 1. Please take time to read and understand the information in this section.
You can only connect one Samourai Wallet at a time to the Whirlpool CLI running on your RoninDojo for 24/7 mixing and remixing. If you have changed your Samourai Wallet and wish to instead link a new Samourai Wallet to the Whirlpool CLI on your RoninDojo, you will need to carry out the following steps to clear the previous configuration.
Samourai Toolkit
→ Whirlpool
→ Reset
System
settings, and click on Reset GUI
.OK
.Have you set up Sparrow Wallet, connecting it to your RoninDojo node? Sparrow Wallet is a great desktop wallet for managing hardware wallets. Check out the Sparrow Wallet section.
See Whirlpool documentation for more information on how to use Whirlpool.
Check out the Troubleshooting page for more info.
Need help? Try out our Support Service.
Join the RoninDojo Chatroom and engage the community.