Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
examples
src
tests
Cargo.toml
LICENSE
README.md

README.md

Cryptocurrency Tutorial

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.