Standard library for writing smart contracts for the Concordium blockchain

This repository consists of the core standard library for writing smart contracts for the Concordium blockchain in the Rust programming languages, as well as some sample smart contracts. The core library is concordium-std.

The core library provides procedural macros to reduce the amount of boilerplate the user needs to write, while the concordium-std library exposes a high-level API that smart contract writers can use when writing contracts, alleviating them from the need to deal with low-level details of how the interaction with the chain works.

Versions

• concordium-std prior to version 3 supported version 0 contracts
• concordium-std version 3 only supports building version 1 contracts

cargo-concordium version dependencies

• concordium-std version 4 only works with cargo-concordium version 2.1+.
• concordium-std version 5 only works with cargo-concordium version 2.4+.

Examples

The examples directory contains some smart contracts that are used to test the standard library.

These contracts are not meant for production, they are used to illustrate how to use the standard library and the tooling Concordium provides. There is no claim that the logic of the contract is reasonable, or safe.

Do not use these contracts as-is for anything other then experimenting.

Submodules

The repository has concordium-contracts-common as a submodule, and testing and builds are set-up to use the submodule version. When changes are made in concordium-contracts-common they should be propagated to this repository.

Contributing

This repository's CI automatically checks formatting and common problems in rust. Changes to any of the packages must be such that

• cargo clippy --all produces no warnings
• rustfmt makes no changes.

Everything in this repository should build with rust version 1.65 however the fmt tool must be from a nightly release since some of the configuration options are not stable. One way to run the fmt tool is

cargo +nightly-2023-04-01 fmt

(the exact version used by the CI can be found in .github/workflows/linter.yml file). You will need to have a recent enough nightly version installed, which can be done via

rustup toolchain install nightly-2023-04-01

or similar, using the rustup tool. See the documentation of the tool for more details.

In order to contribute you should make a pull request and ask at least two people familiar with the code to do a review.