CashShuffle - How to Install & Test

2019-02-03T14:57:38.000Z Honest Cash

I've written a bit about the Consolidating CoinJoin protocol I am developing for anonymizing Bitcoin Cash. A competing protocol, CashShuffle, is further along in its development cycle. Installing it is only for the technically competent, but if that's you, read on and learn how to install it and start anonymizing your Bitcoin Cash today!

A few things to keep in mind before getting started:

  • CashShuffle development is a moving target, so if a significant period of time has passed since this article was written (2/3/2019), then things might no longer be accurate.

  • CashShuffle is not ready for a mainstream audience. If you have trouble, but don't have the technical skills to figure it out on your own, open a GitHub Issue, then be patient and wait.

  • The instructions below show how to install CashShuffle in Ubuntu 18.04, not Windows or iOS. You can run Ubuntu 18.04 on either of those operating systems using Virtual Box. Here is a video on how to install Ubuntu and VirtualBox on Windows 10. There are lots of videos and instructions on the internet, just Google for your particular case.

It's hard to write technical instructions that work for everyone. That's why I generally start with Ubuntu 18.04 in Virtual Box. I've used Virtual Box on all the major operating systems: Windows, Mac, and Ubuntu. The UI is the same, as well as the experience. It's the only way to write instructions once that works on all systems.

So step 1 is to install Ubuntu 18.04 on Virtual Box. Pause here, and get that setup on your computer first.

From a fresh installation of Ubuntu, open a command line and follow these instructions:

2. Install these required python packages:

sudo apt-get update sudo apt-get install -y python3-pip python3-setuptools 

3. Clone the repository for the Cash Shuffle fork of the Electron Cash wallet:

git clone https://github.com/clifordsymack/Electron-Cash cd Electron-Cash

4. Install the Electron Cash (EC) wallet by running the following:

sudo python3 setup.py install 

5. Install one last dependency:

 sudo pip3 install -I pyqt5 

You can now launch Electron Cash. I like to use the -v flag to see the logs in the background:

./electron-cash -v

Follow the instruction to set up your wallet. Feel free to accept all the default options. Be sure to write down your mnemonic seed, so that you can recover your funds if anything bad happens. A password is optional.

Once the wallet is setup, click the Enable CashShuffle button.

The default server is cashshuffle.c3.com, but most people don't use that server. The majority of testing takes place on the shuffle.imaginary.cash server.

From here, everything is set up! Click on the Receive tab and fund your wallet. Shuffling will automatically start and run in the background. Use the Send tab to retrieve your shuffled Bitcoin Cash.

Responses


RE: CashShuffle - How to Install & Test

by @emergent_reasons

Going to try this as soon as I can. Looking forward to your CoinJoin implementation also.

> The instructions below show how to install CashShuffle in Ubuntu 18.04, not Windows or iOS. You can run Ubuntu 18.04 on either of those operating systems using Virtual Box.

Did you mean macOS? Or do we actually have a vm engine for iOS now?


RE: RE: CashShuffle - How to Install & Test

by @christroutner

Yes, I meant Mac OS. I'm not a Mac person, so I get my terminology confused.

But Virtual Box is VM software that runs on all the major operating systems, and will run an Ubuntu OS consistently on each host OS.


RE: CashShuffle - How to Install & Test

by @Logan

Great thanks. How long does it take to shuffle? Good argument regarding ubuntu. Insalling windows VM is a pain in the ass.


RE: RE: CashShuffle - How to Install & Test

by @christroutner

Right now, shuffling is slow. It depends on the number of users and the amounts they are trying to shuffle. More of each makes the shuffling go faster. If either are zero, then shuffling will take forever.


RE: RE: RE: CashShuffle - How to Install & Test

by @Logan

The fees are so low on BCH if someone can set up a bot people can keep shuffling just for the heck of it.


RE: CashShuffle - How to Install & Test

by @chainxor

Anyone up for a Windows guide? :-)