Shuffle

CashShuffle is a plugin for the Electron Cash BCH wallet. It allows users to make shuffled transactions using CoinJoin.

Installation

Ubuntu users can install using the following command. This command will install the latest version of Electron Cash with CashShuffle in your home directory.

cd ~/ && wget https://electroncash.org/downloads/3.0/win-linux/ElectronCash-3.0.tar.gz && tar -xvzf ElectronCash-3.0.tar.gz && rm -rf ElectronCash-3.0.tar.gz && wget https://github.com/cashshuffle/cashshuffle-electron-cash-plugin/archive/master.zip && unzip master.zip && rm -rf master.zip && mv cashshuffle-electron-cash-plugin-master/shuffle 'Electron Cash-3.0/plugins' && rm -rf cashshuffle-electron-cash-plugin-master && sed -i "s/'electroncash_plugins.virtualkeyboard',/'electroncash_plugins.virtualkeyboard', 'electroncash_plugins.shuffle',/" 'Electron Cash-3.0/setup.py' && cd 'Electron Cash-3.0' && sudo python3 setup.py install

Otherwise, use the following instructions:

1. Place the shuffle folder cashshuffle-electron-cash-plugin-master/shuffle into the Electron Cash plugins folder Electron Cash-3.0/plugins
2. Open the setup.py file Electron Cash-3.0/setup.py and find the line that contains the text

'electroncash_plugins.virtualkeyboard'

Replace this text with

'electroncash_plugins.virtualkeyboard', 'electroncash_plugins.shuffle',

3. cd into your Electron Cash directory, and re-install

sudo python3 setup.py install

Getting started

1. Enable the plugin by going to Tools -> Plugins

The shuffle tab will appear

2. Close the settings dialog window. The shuffle tab will appear

Making a shuffle

1. Choose server from servers list

2. Use Shuffle input address to choose coin which you want to shuffle. This list of coins is formed from the UTXO's of your wallet.

3. From Shuffle change address choose the address for your change. You can leave this as the default setting if you want to use input address as change address.

4. From Shuffle output address choose the address for the shuffled output.

5. In the amount block, choose the amount of coins for shuffling.

6. Fee is fixed and unchanged.

7. If the amount of coins in input is greater than the sum of the shuffling amount fee, then the Shuffle button will become enabled

8. Pressing Shuffle will start the shuffling process. After 5 participants registered on the server, the shuffling process will begin.

9. If all goes well, you will see the outputs and a transaction dialog window. If something goes wrong you will see the errors in the output.

10. In this version of protocol, one of the participants should press broadcast on the transaction dialog window.

Configuring servers servers list

List of servers placed in file shuffle/servers.json

If you want to add your server to the list follow the next structure:

{
   "your.server.here":
   {
     "port" : 31415,
     "ssl": true	
   }
}

port value should be integer value of your server port and ssl should be boolean value of ssl support.