9 unstable releases (3 breaking)

✓ Uses Rust 2018 edition

0.11.0 Mar 15, 2019
0.10.2 Jan 22, 2019
0.10.0 Dec 14, 2018
0.9.3 Jan 23, 2019
0.8.0 Jun 1, 2018

#6 in Cryptocurrencies

Download history 17/week @ 2019-01-11 31/week @ 2019-01-18 10/week @ 2019-01-25 6/week @ 2019-02-01 4/week @ 2019-02-08 4/week @ 2019-02-15 4/week @ 2019-02-22 19/week @ 2019-03-01 4/week @ 2019-03-08 24/week @ 2019-03-15 49/week @ 2019-03-22 3/week @ 2019-03-29 12/week @ 2019-04-05 5/week @ 2019-04-12 11/week @ 2019-04-19

60 downloads per month


30K SLoC

Cryptocurrency Advanced: Service with Data Proofs

The extended version of the Cryptocurrency Service implementing data proofs. This project demonstrates how to bootstrap your own cryptocurrency with Exonum blockchain.

See the documentation for a detailed step-by-step guide how to approach this example.

Cryptocurrency demo

Exonum blockchain keeps balances of users and handles secure transactions between them.

It implements most basic operations:

  • Create a new user
  • Add funds to the user's balance
  • Transfer funds between users

Install and run

Using docker

Simply run the following command to start the cryptocurrency service on 4 nodes on the local machine:

docker run -p 8000-8008:8000-8008 exonumhub/exonum-cryptocurrency-advanced:demo

Ready! Find demo at

Docker will automatically pull image from the repository and run 4 nodes with public endpoints at, ..., and private ones at, ...,

To stop docker container, use docker stop <container id> command.


Getting started

Be sure you installed necessary packages:

Install and run

Below you will find a step-by-step guide to starting the cryptocurrency service on 4 nodes on the local machine.

Build the project:

cd examples/cryptocurrency-advanced/backend

cargo install

Generate template:

mkdir example

exonum-cryptocurrency-advanced generate-template example/common.toml --validators-count 4

Generate public and secrets keys for each node:

exonum-cryptocurrency-advanced generate-config example/common.toml  example/pub_1.toml example/sec_1.toml --peer-address -c example/consensus_1.toml -s example/service_1.toml -n

exonum-cryptocurrency-advanced generate-config example/common.toml  example/pub_2.toml example/sec_2.toml --peer-address -c example/consensus_2.toml -s example/service_2.toml -n

exonum-cryptocurrency-advanced generate-config example/common.toml  example/pub_3.toml example/sec_3.toml --peer-address -c example/consensus_3.toml -s example/service_3.toml -n

exonum-cryptocurrency-advanced generate-config example/common.toml  example/pub_4.toml example/sec_4.toml --peer-address -c example/consensus_4.toml -s example/service_4.toml -n

Finalize configs:

exonum-cryptocurrency-advanced finalize --public-api-address --private-api-address example/sec_1.toml example/node_1_cfg.toml --public-configs example/pub_1.toml example/pub_2.toml example/pub_3.toml example/pub_4.toml

exonum-cryptocurrency-advanced finalize --public-api-address --private-api-address example/sec_2.toml example/node_2_cfg.toml --public-configs example/pub_1.toml example/pub_2.toml example/pub_3.toml example/pub_4.toml

exonum-cryptocurrency-advanced finalize --public-api-address --private-api-address example/sec_3.toml example/node_3_cfg.toml --public-configs example/pub_1.toml example/pub_2.toml example/pub_3.toml example/pub_4.toml

exonum-cryptocurrency-advanced finalize --public-api-address --private-api-address example/sec_4.toml example/node_4_cfg.toml --public-configs example/pub_1.toml example/pub_2.toml example/pub_3.toml example/pub_4.toml

Run nodes:

exonum-cryptocurrency-advanced run --node-config example/node_1_cfg.toml --db-path example/db1 --public-api-address --consensus-key-pass pass --service-key-pass pass

exonum-cryptocurrency-advanced run --node-config example/node_2_cfg.toml --db-path example/db2 --public-api-address --consensus-key-pass pass --service-key-pass pass

exonum-cryptocurrency-advanced run --node-config example/node_3_cfg.toml --db-path example/db3 --public-api-address --consensus-key-pass pass --service-key-pass pass

exonum-cryptocurrency-advanced run --node-config example/node_4_cfg.toml --db-path example/db4 --public-api-address --consensus-key-pass pass --service-key-pass pass

Install frontend dependencies:

cd ../frontend

npm install

Build sources:

npm run build

Run the application:

npm start -- --port=8280 --api-root=

--port is a port for Node.JS app.

--api-root is a root URL of public API address of one of nodes.

Ready! Find demo at


  • Read the frontend tutorial to get detailed information about the interaction of the client with Exonum blockchain.


Cryptocurrency demo is licensed under the Apache License (Version 2.0). See LICENSE for details.


~397K SLoC