CENNZnet Node

CENNZnet node built on Substrate. For getting started and technical guides, please refer to the CENNZnet Wiki.

Contributing

All PRs are welcome! Please follow our contributing guidelines here.

---

Community

Join our official CENNZnet Discord server 🤗

• Get CENNZnet technical support 🛠
• Meet startups and DApp developers 👯‍♂️
• Learn more about CENNZnet and blockchain 🙌
• Get updates on CENNZnet bounties and grants 💰
• Hear about the latest hackathons, meetups and more 👩‍💻

Join the Discord server by clicking on the badge below!

Run with Docker

Use the latest CENNZnet docker image to get started quickly

# Start a local validator on a development chain
$ docker run \
    -p 9933:9933 -p 9944:9944 \
    cennznet/cennznet:latest \
    --dev \
    --unsafe-ws-external \
    --unsafe-rpc-external

9944 is Websocket port, 9933 is the HTTP RPC port. Majority of DApps should use 9944, which is accessible via ws://localhost:9944

Run from Source

Follow the steps to build and run a CENNZnet node from the source code.

1) Set up build environment

For Linux (the example below is for Debian-based machines):

$ sudo apt install -y build-essential clang cmake gcc git libclang-dev libssl-dev pkg-config

For MacOS (via Homebrew):

$ brew install openssl cmake llvm

2) Install Rust

Install Rust on your machine through here, and the following rust version and toolchains.

$ cargo --version
$ rustup install nightly
$ rustup target add --toolchain=nightly wasm32-unknown-unknown

3) Build and Run

Clone the repo, build the binary and run it.

$ git clone https://github.com/cennznet/cennznet.git
$ cd cennznet
$ cargo build --release # or remove  '--release' for quick debug build
$ ./target/release/cennznet --help

# start a validator node for development
$ ./target/release/cennznet --dev

Build Docker Image

Prepare your docker engine, and make sure it is running.

# To use the default image name and tag
$ make 

# To custom your image name and tag
$ IMAGE_NAME='cennznet' IMAGE_TAG='v1.5.1' DOCKER_BUILD_ARGS='--no-cache --quiet' make build

# Without using make
$ docker build --no-cache -t cennznet:v1.5.1 .