Tezos Client

This tutorial uses tezos-client - a command line interface to Tezos.


Mac OS

With Homebrew:

brew tap tqtezos/homebrew-tq https://github.com/tqtezos/homebrew-tq.git
brew install tezos

Linux (64-bit)

Download tezos-client binary for 64-bit Linux:

wget https://github.com/serokell/tezos-packaging/releases/download/202001221235/tezos-client-babylonnet

Make it executable and create command line alias:

chmod +x tezos-client-babylonnet
alias tezos-client=$PWD/tezos-client-babylonnet

For more ways to install on Linux see tezos-packaging project


Install one of Linux distributions using Windows Subsystem for Linux (WSL) (e.g. Ubuntu 18.04 LTS) and follow instructions for Linux.


Let's configure tezos-client to use one of public Tezos nodes in the test network (for this tutorial we would like to skip setting up a local Tezos node which tezos-client uses by default:

tezos-client -A rpcalpha.tzbeta.net -P 443 -S config update

Alternatively, one can use an isolated sandboxed network instead of using a public test-network, see the “Sandbox” section.

Verify that you can run tezos-client and that it points to test nework:

$ tezos-client
This is NOT the Tezos Mainnet.
The node you are connecting to claims to be running on the
Do NOT use your fundraiser keys on this network.
Alphanet is a testing network, with free tokens.
tezos-client [global options] command [command options]

Now that we know we are on a test network let's disable this warning so that we don't see it in the output for every command:


Create test wallets:

  • Go to the faucet
  • Click Get Testnet ꜩ, which will download a .json file with a new wallet. The file will be named with the address of the account we're going to be creating, starting with tz1...

Activate the account, passing it the path to the .json wallet you just downloaded:

  • Here, we're calling the account alice
$ tezos-client activate account alice with ~/Downloads/tz1QLne6uZFxPRdRfJG8msx5RouENpJoRsfP.json
Waiting for the node to be bootstrapped before injection...
Current head: BL52YjrSCteP (timestamp: 2019-08-12T15:09:16-00:00, validation: 2019-08-12T15:09:28-00:00)
Node is bootstrapped, ready for injecting operations.
Operation successfully injected in the node.
Operation hash is 'opES9TEa9cazEs1mcc6jcbFAWNFtzLewpCD4evct6oG4T1m2od3'
Waiting for the operation to be included...

Make a variable for Alice's account address (notice that the address is the same as the name of your faucet .json file):


Ensure that the activation was successful:

$ tezos-client get balance for $ALICE_ADDRESS

Now, we'll create a new wallet for Bob, since we'll need a second account so we can perform transfers, etc. Repeat all steps in this section starting with getting a new wallet .json file from the faucet, replacing alice and ALICE_ADDRESS with bob and BOB_ADDRESS, respectively.