Skip to main content
Version: 1.3-rc1

Setup and Requirements

Supported Architectures

The tooling currently supports the Intel-compatible x86_64 architecture and ARM (e.g. M1 Macs).

Supported Environments

The following operating systems are officially supported. Other operating systems may also be compatible, but have not officially been tested for compatibility by our teams.

Note: Throughout most of our demos and walkthroughs, Ubuntu Linux 20.04 is used. This is the preferred platform by most developers.

Prerequisite Development Software

  • Build Tools
  • Curl
  • 7zip (optional)
  • Unzip (optional)
  • Git
  • Node.js 16.13.x (LTS)
  • Python 2.7.x
  • Yarn
  • Docker

Prerequisite Wallet Software

Setup Instructions

Ubuntu 20.04 (Native or Windows 10 + WSL2)

Build Tools + Git + Curl + 7zip + Unzip

$ sudo apt install build-essential git curl p7zip-full unzip

Node.js

The default version of Node.js included with Ubuntu 20.04 is v10.19.0, and this is not sufficient.

For these tasks, version 16.13.x is needed. Versions lower than this may not work. This can be installed using NVM (Node Version Manager), or the normal Node.js installation instructions. We recommend using NVM because it allows you to change between any version of Node.js quickly.

Python 2.7.x

Ubuntu 20.04 ships with Python 3.8.x installed, but Python 2.7.x is still available for compatibility with old tooling using the python package.

$ sudo apt install python

Yarn

Yarn can easily be installed using NPM once Node.js is installed.

$ npm i -g yarn

Docker

Docker will be used for running the Solidity compiler to compile smart contracts. You can find information on how to install it on the official Docker website. If you're using Windows + Windows Subsystem For Linux it will be the easiest if you download and install the official "Docker for Windows" desktop application. It makes using Docker easy thanks to the graphical interface.

Note: The current user must have permission to manage Docker instances. How to manage Docker as a non-root user.

MacOS (10.13+)

Build Tools + Git

Download and install the Xcode Command Line Tools from developer.apple.com.

Curl

Curl should be installed by default on recent versions of macOS.

7zip

There are several decompressors available for macOS that can handle 7z files. Still, we recommend p7zip since it will be fully compatible with our scripts. This can be installed using Homebrew.

Node.js

Node.js can be installed on macOS using NVM, or the Node.js installer. For these tasks, version 16.13.x is needed. Versions lower than this may not work.

Python 2.7.x

To install Python 2.7.x on macOS, please visit the official Python download page.

Yarn

Yarn can easily be installed using NPM once Node.js is installed.

$ npm i -g yarn

Docker

Docker will be used for running the Solidity compiler to compile smart contracts. You can find information on how to install it from the official Docker website.

Note: The current user must have permission to manage Docker instances. How to manage Docker as a non-root user.

Windows 10 + PowerShell

  1. node-gyp dependencies
  2. Docker or Docker Desktop

Checking Your Node.js and Yarn Versions

One of the most common causes of errors is having the incorrect version of Node.js or Yarn. These tasks specifically require Node.js v16.x.x, and a recent version of Yarn. You can check these versions using the commands below:

$ node -v
v16.13.0
$ yarn -v
1.22.11