¶ Introduction
¶ In a nutshell
Samourai Whirlpool is a free and open source (FOSS), non custodial, chaumian CoinJoin platform. Its goal is to mathematically disassociate the ownership of inputs to outputs in a given bitcoin transaction. This is to increase the privacy of the users involved, protect against financial surveillance, and to increase the fungibility of the Bitcoin network as a whole.
Due to the nature of FOSS our software and can be built, run, and hosted completely independently of the our software development team.
¶ Key Concepts
The following section will introduce you to some key concepts regarding Dojo and MyDojo full bitcoin stack.
¶ The Coordinator
Whirlpool requires the use of a blinded coordinator server to pass messages between clients. This server doesn't and crucially cannot know the contents of the messages it is passing.
¶ Pools
The pool determines the minimum and maximum amount you can cycle through that pool and what the denomination the mixed outputs in your postmix account will have.
Whirlpool is different than other CoinJoin services, in that you do not pay a volume based fee per anonymity set, but instead you pay a one time flat fee for an unlimited anonymity set based on the pool you choose.
-
0.01 Pool
- minimum:
0.01 BTC - maximum:
0.75 BTC - pool fee:
0.0005 BTC
- minimum:
-
0.05 Pool
- minimum:
0.05 BTC - maximum:
3.75 BTC - pool fee:
0.0025 BTC
- minimum:
-
0.5 Pool
-
minimum:
0.50 BTC -
maximum:
37.50 BTC -
pool fee:
0.0250 BTC
-
Generally the larger the amount you are cycling, the larger the pool you want to choose.
For example:
- Cycling 0.5 BTC in the 0.01 Pool would create 50 outputs of 0.01 BTC
- Cycling 0.5 BTC in the 0.05 Pool would create 10 outputs of 0.05 BTC
- Cycling 0.5 BTC in the 0.5 Pool would create 1 outputs of 0.5 BTC
¶ Architecture
¶ Usage
Whirlpool can be managed:
- from desktop:
whirlpool-gui - from command line:
whirlpool-cli - from REST API for developers:
whirlpool-cli API - from JAVA & Android:
whirlpool-client
¶ Modules
Whirlpool is modular:
- 4 java modules:
server,client,protocol,cli - 1 electron/react module:
GUIclientandservercommunicate throughprotocol.
¶ Cycle dialog
Dialog is described in whirlpool-protocol, implemented in whirlpool-client and whirlpool-server.
