Skip to content

Latest commit

 

History

History
141 lines (96 loc) · 4.54 KB

README.md

File metadata and controls

141 lines (96 loc) · 4.54 KB
Raw

Full Node

Quibitous is a Rust based implementation of Bcc-Node. Derived from Cardano's Jormungandr, Quibitous will be utilized for testing purposes during development of the Quantum One Ecosystem. As the beta tag implies, this is not a production repo. This is a stride toward public testnet.

User guide documentation available here

Master current build status

CI Status Description
CircleCI CircleCI Master and PRs

Install from Binaries

Use the Latest Binaries, available for many operating systems and architectures.

Install from Source

Prerequisites

Rust

Get the Rust Compiler (latest stable version is recommended, minimum required: 1.39+).

rustup install stable
rustup default stable
rustc --version # if this fails, try a new command window, or add the path (see below)

Dependencies

  • For detecting build dependencies:
    • Homebrew on macOS.
    • vcpkg on Windows.
    • pkg-config on other Unix-like systems.
  • C compiler (see cc-rs for more details):
    • Must be available as cc on Unix and MinGW.
    • Or as cl.exe on Windows.

Path

  • Win: Add %USERPROFILE%\.cargo\bin to the environment variable PATH.
  • Lin/Mac: Add ${HOME}/.cargo/bin to your PATH.

protobuf

  • The Protocol Buffers version bundled with crate prost-build will be used.
  • For distribution or container builds in general, it's a good practice to install protoc from the official distribution package if available.

Commands

Check <latest release tag> on https://github.com/the-blockchain-company/quibitous/releases/latest

git clone https://github.com/the-blockchain-company/quibitous
cd quibitous
git checkout tags/<latest release tag> #replace this with something like v1.2.3
cargo install --locked --path quibitous # --features systemd # (on linux with systemd)
cargo install --locked --path qcli

This will install 2 tools:

  • quibitous: the node part of the blockchain;
  • qcli: a command line helper tool to help you use and setup the node;

Configuration Basics

A functional node needs 2 configurations:

  1. Its own node configuration: Where to store data, network configuration, logging.
  2. The blockchain genesis configuration, which contains the initial trusted setup of the blockchain: coin configuration, consensus settings, initial state.

In normal use, the blockchain genesis configuration is given to you or automatically fetched from the network.

Quick-Start - Public Mode

To start a new node from scratch on a given blockchain, you need to know the block0 hash of this blockchain for trust purpose and internet peers to connect to. The simplest way to start such a node is:

quibitous --block0-hash <HASH> --trusted-peers <IPs>

Quick-Start - Bcc Sophie Testnet

Quick-Start - Private Mode

Follow instructions on installation, then to start a private and minimal test setup:

mkdir mynode
cd mynode
python3 PATH/TO/SOURCE/REPOSITORY/scripts/bootstrap.py <options>

Use the following recommended bootstrap options:

bootstrap --bft # BFT setup
bootstrap --genesis-optimum --slot-duration 2 # Genesis-optimum setup
bootstrap --help # further help

The bootstrap script creates a simple setup with a faucet with 10 millions coins, a BFT leader, and a stake pool.

Both scripts can be used to do simple limited operation through the qcli debugging tools.

Documentation

Documentation is available in the markdown format here

License

This project is licensed under either of the following licenses: