Latest commit 8045239 Dec 14, 2018

README.md

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.

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/exonum.git
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 test.sh 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 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.