First you must setup your CLI backend(Whirlpool CLI Gitlab), this can be done manually on Command Line or via a user friendly implementation like:
For our example we will use RoninDojo
This guide was written by BTCxZelko
Install Whirlpool via Ronin UI
Paste Pairing Payload from your Mobile Device
Hit the 3 dots top right
Settings -> Transactions
Select Pair to Whirlpool GUI and copy the payload and send to your main computer
Paste this payload into the Whirlpool GUI when prompted.
Switch to your Main Device
Head to Samourai Wallet Whirlpool Repo Release page
Download the appropriate download file. For Linux based machines you can do the following from terminal:
wget https://github.com/Samourai-Wallet/whirlpool-gui/releases/download/0.10.2/whirlpool-gui.0.10.2.AppImage
chmod +x whirlpool-gui.0.10.2.AppImage
./whirlpool-gui.0.10.2.AppImage
When you have paired your wallet to whirlpool you should stop the client (by pressing STOP in the top right) and familiarise yourself with the available configuration options. While the default configuration is ready for use immediately, it is worth understanding the client as you use Whirlpool.
General Configuration
| Config Name | Description | Notes |
|---|---|---|
Default Mix Target |
The default number of cycles to complete for new UTXOs added to the pool. | It is safe to leave this as 1, as you can always manually choose to cycle UTXOs again manually. |
Auto Mix |
When enabled this will automatically queue your UTXOs for cycling. | It is safe to turn this off if you prefer to micro manage which UTXOs to cycle. If you have a lot of UTXO's it can be faster to disable this. |
Tor |
When enabled all traffic is routed through the built in Tor layer. | This is enabled by default & should always been enabled for privacy protections. |
Proxy |
Connect through SOCKS/HTTP proxy. | This is intended for advanced users who wish their own Tor or VPN layer for networking. |
Toggle view of these settings by pressing Toggle developers settings
| Config Name | Description | Notes |
|---|---|---|
Server |
Select the Whirlpool server you wish to interact with. | MainNet is default, but you may also wish to use TestNet |
Client Delay |
Delay in seconds between each client connection. | Leaving this as default is good to help prevent flooding the server. |
TX0 Max Outputs |
This determines the number of new mixed UTXOs that will be created. | Leave this at 0 to mix the entire UTXO |
SCODE |
A discount code for reduced cost mixing. | This should be blank by default |
Within the Desktop Client navigate to the Deposit tab directly under Last Activity on the left hand side of the screen. The Deposit account contains all the bech32 UTXOs in your paired Samourai Wallet. Once the deposit tab has been selected a list of your bech32 UTXOs in Samourai Wallet will be displayed.
Toxic Change
Toxic change is just as its name implies, it is toxic to your privacy! The change created during a Tx0 or from post mix spends will be toxic, using this change can link back to those previous UTXOs. Many people have different ways to handle this change, but since it is such a nuanced topic DYOR!
Whirlpool has been designed with extensive privacy enhancing strategies that help make sure you do not undo the privacy gains of Whirlpool when you go to spend your UTXOs.
It is advised that you keep your funds within Whirlpool and directly spend using your Samourai Wallet on an as needed basis. This will allow you to take advantage of our superior coin selection and post mix spending tools, making it very hard to accidentally undo the privacy gains of Whirlpool.
I want to send my cycled UTXOs to another wallet/cold storage device
If you must transfer your UTXOs to another wallet/device then please follow the guidelines below:
DO NOT:
DO:
Send less than half of your Whirlpool Postmix balance to your wallet/cold storage device. This is usually enough to trigger a STONEWALL which will provide a strong amount of entropy within the transaction.
If you need to transfer the entire balance then you should do so on a UTXO by UTXO basis. Using the Address Calculator in your Samourai Wallet generate the private keys for each of the PostMix UTXOs that you want to transfer and sweep them with your other wallet/device or using Sentinel. You should ideally sweep each UTXO spaced apart by a random interval of time to avoid time correlation de-anonymization.
I want to spend my coins at a third party service. Navigate to the PostMix Send Screen in your Samourai Wallet and create a transaction as you normally would. If it is possible your wallet will enable STONEWALL automatically - this will provide you with additional entropy and is considered the minimum requirement for sending from your PostMix balance with minimal privacy loss.
If a STONEWALL cannot be created your wallet will warn you before sending. Please follow the guidelines below if you are unable to activate STONEWALL.
DO NOT:
DO:
Spend a smaller amount. STONEWALL activates when spending less than half of your available balance.
Add more UTXOs to your Whirlpool wallet so that the amount you need to spend is less than half of your available balance.
Enlist the help of a friend to create a STONEWALLx2 transaction. This is very much like a normal STONEWALL but you are using a trusted friends UTXOs in addition to your own. This has the added benefit of additional mixing within the spend transaction and you can spend more than half of your available balance.
I want to spend my coins to another Samourai Wallet user
Sending to another Samourai Wallet user is the same as sending to any bitcoin address and the same privacy rules apply. However, some additional Post Mix spending tools are available only between Samourai Wallet users. An example of this is Stowaway, which is a CoinJoin with a trusted friend that doesn't look like a CoinJoin and masks the true amount spent on the blockchain.