Skip to content

Installing Breeze on Mac OS X

zeptin edited this page Sep 20, 2017 · 1 revision

DISCLAIMER: This is an Alpha release and still a work in progress. This initial version is to demonstrate the coin-shuffling functionality. The software is still being fine-tuned. If you have questions or comments, please join Slack for assistance.

To get Breeze up and running on a Mac OS X system, please follow the steps written down below.

Install Homebrew

Open up a Terminal and paste the follow into the Terminal

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Wait until it is finished.

Install Tor

In order for the Breeze Privacy Protocol to function correctly, a copy of Tor needs to be running. Without it the client cannot connect to the server. So, to install Tor, simply run the following command in the Terminal:

brew install tor

When it is done you can start Tor by running the following command:

tor -controlport 9051 -cookieauthentication 1

If Tor is working correctly, output similar to the following should appear on the screen:

Sep 20 08:47:05.702 [notice] Tor 0.3.1.7 (git-6babd3d9ba9318b3) running on Darwin with Libevent 2.1.8-stable, OpenSSL 1.0.2l, Zlib 1.2.5, Liblzma N/A, and Libzstd N/A.
Sep 20 08:47:05.703 [notice] Tor can't help you if you use it wrong! Learn how to be safe at https://www.torproject.org/download/download#warning
Sep 20 08:47:05.703 [notice] Configuration file "/usr/local/etc/tor/torrc" not present, using reasonable defaults.
Sep 20 08:47:05.709 [notice] Opening Socks listener on 127.0.0.1:9050
Sep 20 08:47:05.709 [notice] Opening Control listener on 127.0.0.1:9051
Sep 20 08:47:05.000 [notice] Parsing GEOIP IPv4 file /usr/local/Cellar/tor/0.3.1.7/share/tor/geoip.
Sep 20 08:47:05.000 [notice] Parsing GEOIP IPv6 file /usr/local/Cellar/tor/0.3.1.7/share/tor/geoip6.
Sep 20 08:47:05.000 [notice] Bootstrapped 0%: Starting
Sep 20 08:47:06.000 [notice] Starting with guard context "default"
Sep 20 08:47:06.000 [notice] Bootstrapped 80%: Connecting to the Tor network
Sep 20 08:47:07.000 [notice] Bootstrapped 85%: Finishing handshake with first hop
Sep 20 08:47:07.000 [notice] Bootstrapped 90%: Establishing a Tor circuit
Sep 20 08:47:08.000 [notice] Tor has successfully opened a circuit. Looks like client functionality is working.
Sep 20 08:47:08.000 [notice] Bootstrapped 100%: Done

Install Breeze

Now we want to welcome you to the future. We have made a package which you can download from the following location. Only for Mac OS X 10.11 & 10.12

https://github.com/BreezeHub/Breeze/tree/tumblebit-alpha

Unzip it and you will find some files in there as also "breeze-ui". Click it and you will see this image after it is done.

breeze

You need to create 2 wallets. One input (also known as the 'Alice') wallet and one output (also known as 'Bob') wallet. So click on create and make your first wallet. Be sure you create it on the Testnet network.

wallet

When you create the wallet it will give you a 12 word sentence which you need to write down. This is for restoring your wallet.

sentence

When you are done, create another wallet with the link below. This will be your output (Bob) wallet. This wallet is where the coins will arrive after the shuffling process. Also write down the 12 words for this wallet.

output

When you have done that, log in to your input wallet and click on Receive:

receive

Copy your wallet address and go to https://testnet.manu.backend.hamburg/faucet to pick up some test coins.

testcoins

Now that we have received them we need to wait until they are confirmed. This can take up to 20 minutes on the testnet network. When the coins have arrived, we can go to the Privacy tab to start the shuffling process. Be sure you have your Tor client running. Select your destination wallet (the output/Bob wallet) and click on Start. Fill in your wallet password and click Confirm.

tumbling

confirm

tumblingbusy

And now we wait. It takes around 37 blocks until tumbling is finished. In this early stage we don't have a check where you can see where they are at the moment, but overall it takes approximately 6.17 hours to shuffle your coins. This will vary depending on

When shuffling is complete you will see a balance appearing in the destination wallet. You can check the destination column or log into your output wallet to see the incoming transactions.

Tips

Make sure your wallet is synced before trying to use the Privacy tab.

DISCLAIMER: This is an Alpha release and still a work in progress. This initial version is to demonstrate the coin-shuffling functionality. The software is still being fine-tuned. If you have questions, bug reports or comments, please join Slack for assistance.

Clone this wiki locally