Prerequisite

Gamma uses Docker to run a personal blockchain with multiple nodes locally. Make sure Docker is available on your machine.

On MAC

See installation instructions here.

On Linux

Install the community edition using the convenience script here.

Installing Gamma Command Line Tool

Next, install the Gamma CLI. gamma-cli is the command line tool for developers to interact with a Gamma server instance running on their machine.

On Mac

Use brew​

brew install orbs-network/devtools/gamma-cli

On Linux

Run the gamma-cli install script in terminal:

https://raw.githubusercontent.com/orbs-network/gamma-cli/master/gammacli-linux-install-v0.7.0.sh | bash

Verify

Verify the installation by running:

gamma-cli version

Using Gamma CLI

You can see the various commands supported by the CLI by running in terminal

gamma-cli help

You can use the CLI to start and stop Gamma server, deploy contracts and send transactions.

Installing the Gamma server

Gamma server is an in-memory virtual chain on top of an Orbs blockchain with several nodes on your local machine. The server allows you to test your contracts locally before deploying them to production.

If the server isn't installed yet, gamma-cli installs it automatically.

So far, we only installed the cli tool. Now, start the Gamma server by running the following command in the terminal. The CLI tool will notice the server is not installed and will install it for you:

gamma-cli start-local

If everything went well, you now have a running ORBS blockchain on your local machine. Yes, it's that simple! You can browse to http://localhost:8080/ to view the status of your local ORBS instance.

The start-local comands also runs our block explorer, Prism. You can use Prism to get more info about your blockchain instance by browsing to http://localhost:3000/.

When finished with the server, stop it by running in terminal

gamma-cli stop-local