Cryptocurrency Tutorial

Minimal Exonum blockchain example that uses the Exonum framework to implement a simple cryptocurrency.

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

Prerequisites

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 git@github.com:exonum/cryptocurrency.git
cd cryptocurrency

# build and run
cargo run

Now the node is listening HTTP requests on 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 test.sh script in the examples directory. This script creates two wallets, performs a transfer among 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 wallets_info.sh script provides a handy way to do this).

License

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