Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

Cryptocurrency: Example Service

Build status Gitter

Minimal Exonum blockchain example implementing a simple cryptocurrency.

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


To run this example you need to install Rust compiler and third-party libraries.

Build & Run

Blockchain Node

To build and run a single node use:

# clone the repository with blockchain node
git clone
cd exonum/examples/cryptocurrency

# build and run a zero-configuration demo
cargo run --example demo

Now the node is listening to HTTP requests on http://localhost:8000.

Sample Transactions & Read Requests

When node is launched, you can use transaction examples to check that it works properly. A simplest way to do this is launching the script in the examples directory (for *NIX platforms), or test.ps1 in the same directory (for Windows with PowerShell installed). The script creates two wallets, performs a transfer between them, and then verifies that the wallet status was correctly updated.

Alternatively, you may use command-line utilities, such as curl, to manually POST transactions on the transaction endpoint and read data from wallet endpoints (the script provides a handy way to do this).


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