Documentation

# Installing the Agoric SDK

To write JavaScript smart contracts using the Agoric Zoe framework, first install the Agoric Software Development Kit (SDK). The Agoric SDK is currently supported on MacOS, Linux, and Windows Subsystem for Linux (WSL). There is currently no support for native Windows 10 or native Windows 11.

After installing the Agoric SDK, you can proceed to starting a project with the Agoric CLI to create and deploy smart contracts.

# Quick Start

If you're familar with JavaScript development tools such as node, yarn, and git:

node --version # 14.15.0 or higher
npm install --global yarn
git clone https://github.com/Agoric/agoric-sdk # "community-dev" branch
cd agoric-sdk
yarn install
yarn build
yarn link-cli ~/bin/agoric # creates an Agoric directory to reference
agoric --version # should print the version number of the SDK

Now you are ready proceed to starting a project.

If agoric is not found, then you may need to add the parent directory of where your yarn link-cli command created a folder. For example, if you created a folder called Agoric in your ~/bin directory, you may need to add ~/bin to your PATH.

Watch: Prepare Your Agoric Environment (November 2020)

This presentation is a good overview of the Agoric SDK setup process, though a few details are out of date:

  • node version: 12.x is too old; use 14.15.0 or higher
  • skip git checkout hackathon-2020-11; use the default master branch

Note: Video omits adding the Agoric SDK to your PATH.

# Platform: Linux Shell or Equivalent

The Agoric SDK is supported on Linux, MacOS, and Windows Subsystem for Linux (WSL).

  • To open a terminal on MacOS, see Applications>Utilities>terminal in the Finder.
  • To launch a terminal on Linux, use the Terminal application.
  • To access WSL from Windows, visit the WSL documentation (opens new window).

# Install Node.js 14.15.0 or Higher

Download Node.js from Node.js (opens new window) and follow the instructions for your platform. We recommend installing version 16.18 rather than 18.11.

node --version # 14.15.0 or higher

# Install the Yarn Package Manager

Follow Yarn Installation (opens new window) instructions. For example:

npm install --global yarn
yarn --version # 1.22.10 or higher

# Install Git

Follow Git installation instructions (opens new window) or use your platform's package manager.

npm install --global git
git --version # 2.25.0 or higher

# Clone the Agoric SDK

git clone https://github.com/Agoric/agoric-sdk
cd agoric-sdk

Cloning and installing the Agoric SDK can take a while. Please be patient.

# Install NPM Dependencies

yarn install

Note: If you run into errors during install or build, make sure you have build-essential installed. gcc --version.

# Build Packages

yarn build

Note: MacOS, Linux, and WSL are currently supported. There is currently no support for native Windows 10 or native Windows 11.

# Install Agoric CLI

Install the Agoric CLI (Command Line Interface) in a convenient place in your $PATH such as:

yarn link-cli ~/bin/agoric

or:

sudo yarn link-cli /usr/local/bin/agoric

Note: Run echo $PATH to see your current $PATH. Here you'll see which directory you should use for yarn link-cli.

# Check the Agoric Version

To check that it's installed correctly:

agoric --version # v0.16.0 "community-dev" branch

If the install was successful, you are ready to proceed to starting a project.

Should agoric not be found, then you may need to add the parent directory of where your yarn link-cli command created the "agoric-sdk" directory.

Please see the youtube video Linux add to $PATH: Fix "command not found" error (Linux & Mac) (opens new window) for more information.

Starting a Project →