Install tools for development#

Before you can start developing smart contracts, you need to setup the environment.

Rust and Cargo#

First, install rustup, which will install both Rust and Cargo on your machine. Then use rustup to install the Wasm target, which is used for compilation:

$rustup target add wasm32-unknown-unknown

Cargo Concordium#

Cargo Concordium is the tool for developing smart contracts for the Concordium blockchain. It can be used for compiling and testing smart contracts, and enables features such as building contract schemas.

Cargo Concordium is distributed as part of the Concordium software package. Rename the downloaded file to cargo-concordium for MacOS/Linux, and cargo-concordium.exe for Windows.

The tool should be placed in your PATH. This can be achieved by either:

  • Moving the executable to a folder that is already on your PATH, for example %HOMEPATH%\.cargo\bin\ for Windows, and $HOME/.cargo/bin for MacOS/Linux.

  • Or, by adding its current location to your PATH environment.

If you are running MacOS, you need to make the tool executable by running chmod +x path/to/cargo-concordium in a terminal. Make sure to provide the correct path to the downloaded tool. You also need to grant it permission to run in your Security & Privacy settings .

Once cargo-concordium.exe is on your path, you can invoke it with cargo concordium in the terminal.

For a description of how to use the Cargo Concordium run:

$cargo concordium --help

Concordium software#

The tool to deploy and interact with smart contracts is concordium-client. It is distributed as part of the Concordium software package.


To deploy smart contract modules and interact with the chain, make sure that you are running a node.