Skip to content

CodeChain-io/codechain

Repository files navigation

CodeChain Build Status Gitter: CodeChain License: AGPL v3 Read the Docs

CodeChain is a programmable open source blockchain technology optimal for developing and customizing multi-asset management systems.

Build

Download CodeChain code

git clone git@github.com:CodeChain-io/codechain.git cd codechain 

Build in release mode

cargo build --release 

This will produce an executable in the ./target/release directory.

Run

To run CodeChain, just run

./target/release/codechain 

You can create a block by sending a parcel through JSON-RPC or JavaScript SDK.

Formatting

Make sure you run rustfmt before creating a PR to the repo. You need to install the nightly-2018-05-07 version of rustfmt.

rustup toolchain install nightly-2018-05-07 rustup component add rustfmt-preview --toolchain nightly-2018-05-07 

To run rustfmt,

cargo +nightly-2018-05-07 fmt 

Testing

Developers are strongly encouraged to write unit tests for new code, and to submit new unit tests for old code. Unit tests can be compiled and run with: cargo test --all. For more details, please reference Unit Tests.

User Manual

Under docs folder, run following command.

make html 

User manual will be generated at docs/_build/html.

License

CodeChain is licensed under the AGPL License - see the LICENSE file for details