Skip to content

Latest commit

 

History

History
61 lines (43 loc) · 2.31 KB

macOS.md

File metadata and controls

61 lines (43 loc) · 2.31 KB

How to install the Bismuth Wallet on macOS

Prerequisites

You need basic knowledge of your Mac and the Terminal app.

Python 3.6 or later is needed, as well as matching pip.

macOS currently still ships with Python 2.7, so you'll need to install Python 3.

We strongly recommend you to use Homebrew as described below, it's the best package manager for macOS and it'll make Python3 installation a breeze. If you don't have Homebrew installed (brew command in the Terminal), please follow the easy instructions on https://brew.sh to install it.

Install Python3

$ brew install python3   # this will also install pip3

macOS default Python 2.7 version remains available via the python and pip commands.

From now on, rather type python3 and pip3 to use the newly installed Python 3.

Manually install this dependency just to make sure you have the latest version:

$ pip3 install --upgrade simple-crypt

Install Wget

macOS ships with curl, but most crypto guides out there rather use wget. It's useful to have wget around and with Homebrew it's super easy to install:

$ brew install wget

Download and Install the wallet

Copy the latest Source code (tar.gz) URL from https://github.com/hclivess/Bismuth/releases (currently 4.2.8.1.tar.gz) and paste it after the wget command as shown below:

$ cd     # go to Home folder. Use another path here if you don't want the wallet in your Home
$ wget https://github.com/hclivess/Bismuth/archive/4.2.8.1.tar.gz

Then:

$ tar -zxvf 4.2.8.1.tar.gz          # Extract the archive
$ mv Bismuth-4.2.8.1 Bismuth        # Rename "Bismuth-4.2.8.1" folder to "Bismuth"
$ cd Bismuth                        # Enter "Bismuth" folder
$ pip3 install -r requirements.txt  # Install wallet dependencies

Note: with the light wallet you don't need a Bismuth node anymore, nor a complete chain sync to run and use the wallet.

Run the wallet

$ python3 wallet.py

This will create a new wallet.der file in the Bismuth folder. This is your wallet, backup that file in a safe place. If you already have a wallet, place your wallet.der in the Bismuth folder before running the wallet.