Skip to main content


The Tezos blockchain provides serveral networks:

  • a main network which is the real operating network where real cryptocurrency are exchanged
  • several test networks:
    • one in the same version (to test current network)
    • one(s) in the future main net version(s) (to test/preprare future version of smart contracts)
    • optionally several in older versions

Each version of the blockchain is given a name (..., Florence, Granada, ...).

An endpoint is an entry node to the network. You interact with the blockchain through an endpoint. You need to specify the endpoint's URL when interacting with the blockchain.

$completium-cli offers a convenient network management system to register, show and switch networks.

Show current endpoint

Display the endpoint completium is currently using:

completium-cli show endpoint

For example:

$ completium-cli show endpoint
Current network: granada
Current endpoint:

Switch endpoint

Select the current endpoint from menu with the following command:

completium-cli switch endpoint

$completium-cli comes with a set of pre-configured endpoints:

$ completium-cli switch endpoint
Current network: granada
Current endpoint:
? Switch endpoint …
❯ main

Use up/down arrows to select the required endpoint.

Add endpoint

completium-cli add endpoint (main|granada|florence) <ENDPOINT_URL>

Set endpoint

completium-cli set endpoint <ENDPOINT_URL>

The command fails if the endpoint is not registered (see add endpoint above).

Remove endpoint

completium-cli remove endpoint <ENDPOINT_URL>


The mockup mode is used to run smart contracts locally without the need to interact with a network. It is used to speed up the development of smart contracts as it removes the network latency (injection, confirmation, ...).

The following command initialises a new mockup (erases previous one) :

completium-cli mockup init

This command makes all registered accounts available in the mockup mode and tansfers 1000 XTZ to each.

To turn mockup mode on, use the following command:

completium-cli set endpoint mockup

The mockup mode requires the Tezos client to be installed and executed with the command tezos-client. Please refer to this page for installation instructions.


$completium-cli provides utility commands to install and run the Flextesa sandbox locally, a presentation of which is available here.

To install and start the sandbox, run the following command:

completium-cli start sandbox

This command assumes you have docker installed and running. The container is downloaded the first time you run this command; it may then take some time.

Check the container is running with the following docker command:

$ docker container ls
719c8f02f119 tqtezos/flextesa:20210316 "granabox start" 14 hours ago Up 14 hours>20000/tcp my-sandbox

The following command stops the sandbox:

completium-cli stop sandbox


The sandbox endpoint is already available in the list of known endpoints. You need to switch to the sandbox endpoint with:

$ completium-cli switch endpoint
Current network: sandbox
Current endpoint: http://localhost:20000
? Switch endpoint …
❯ sandbox http://localhost:20000


The sandbox comes with two accounts, 'alice' and 'bob':

$ completium-cli switch account
Current account: alice
? Switch account …
❯ alice tz1VSUr8wwNhLAzempoch5d6hLRiTh8Cjcjb
bob tz1aSkwEot3L2kmUvcoxzjMomb9mvBNuzFK6

You can import a faucet account as explained here, but in the sandbox the faucet account does not come with any tezies. You then need to transfer some from Alice or Bob account:

$ completium-cli import faucet admin.json as admin
$ completium-cli transfer 10000tz from alice to admin