¶ Whirlpool Desktop
For an enhanced mixing experience, you can pair the Samourai Wallet on your Android phone to our Whirlpool Desktop application. Our desktop app can be ran in both 'Standalone' and 'Remote' CLI modes.
- The 'standalone' configuration utilises the command line packaged with the app. This means you will only achieve remixes when the application is open
- The 'remote' confiuration utilises a remote command line interface designed to be installed on an 'always on' device like RoninDojo. In this configuration the desktop app does not need to be running 24/7 to achieve remixes as the remote CLI does the heavy lifting.
¶ Download
The latest Whirlpool Desktop can be downloaded from our website
¶ Standalone Setup
-
Download and install OpenJDK
-
Upon opening Whirlpool the default configuration of
Standalone GUIshould be selected. Press continue.
- Within your Samourai Wallet go to Settings > Transactions > Pair to Whirlpool GUI. The wallet will now show a QR code and an option to copy the 'pairing payload'.
- Pressing the QR code icon in Whirlpool will open your computer's camera. Hold your phone up to scan the QR and complete the pairing.
- Alternatively you can copy the pairing payload from your phone, pass this to your computer and paste into the payload box in Whirlpool.
- Enable Tor for network level privacy then click Initialize GUI.
- Enter your Samourai Wallet's passphrase and click Sign in.
- Setup complete and ready to start a mix!
After completing this setup, you can initiate a mix from your Android wallet and the desktop app (if open and running) will takeover and handle remixing for you.
¶ Remote CLI Setup
There are many ways to get your own Whirlpool CLI, each implementation will display their connection info slightly differently but the steps within the desktop app will be almost identical.
- Upon opening Whirlpool, select
Advanced: Remote CLI. Retrieve your Whirlpool address from your chosen implementation and paste into theCLI addressbox - Set your Tor proxy configuaration. For Tor daemon running on your computer, use
9050and for Tor browser use9150. - If this is your first time connecting to your remote CLI, leave the
APIfield blank.
- Ensure your Samourai Wallet is connected to your Dojo
- Within the wallet go to
Settings>Transactions>Pair to Whirlpool GUI. The wallet will now show a QR code and an option to copy the 'pairing payload'. - Pressing the QR code icon in Whirlpool will open your computer's camera. Hold your phone up to scan the QR and complete the pairing.
- Alternatively you can copy the pairing payload from your phone, pass this to your computer and paste into the payload box in Whirlpool.
-
Ensure the next screen shows "Use Dojo as a wallet backend" and "Tor is required for Dojo" then press Initialize GUI.
-
Enter your Samourai Wallet's passphrase and click Sign in.
- Setup complete and ready to start a mix!
After completing this setup, you can initiate a mix from your Android wallet or the Desktop application and the remote CLI on your 24/7 device will takeover and handle remixing for you.
¶ Start a new mix
¶ Deposit funds
- Click the deposit button in the top left corner to reveal the next unusued address in your Samourai Wallet.
- Send the amount you want to mix to the address shown
Your deposit transaciton requires 1 blockchain confirmation before being eligible to start a mix
¶ Add a discount code
We occasionally offer discounted mixing fees called SCODES. Keep any eye on our Twitter and Telegram for these! To benefit from these discounts, carry out the following before initiating a new mixes.
- Click on Configuration
- Enter the SCODE
- Press Save & Restart
¶ Choose UTXOs
- Open the Deposit tab of Whirlpool and select the UTXO(s) you want to include in to be mixed then click Premix at the top of the screen.
¶ Choose miner fee and pool
- Confirm the pool you wish to join
- Confirm the Tx0 fee priority
- Confirm the mix miner fee prioirty
- Press Premix to broadcast your Tx0 to the Bitcoin network
¶ Wait for a confirmation
- After a few seconds, open the Premix tab. Here you will see each UTXO created by the Tx0 waiting to be confirmed into a block. After a single confirmation, each of these UTXOs will, one by one, automatically join their first Whirlpool mix.
If you are using the GUI in standalone mode, remember to keep the application running to achieve mixes.
¶ Postmix
- After each UTXO has its first mixing round it will finish within the Postmix account of your wallet, ready to be spent or remixed (for free).
- Remember, for as long as there are UTXOs in your postmix wallet and a Whirlpool client online, these funds are eligble for free and unlimited remixes.
