caelum-parity

This library contains the configuration and launch scripts for the blockchain.

|Branch|Pipeline|Coverage| |:-:|:-:|:-:| |master|||

Prerequisites

• Ubuntu 18.04
• Node 10.15

Key setup

• Private key in the directory $HOME/.caelum/keystore/Alastria
• Passphase in the file $HOME/.caelum/keystore/pass

Usage

The Caelum blockchain configuration is kept in $HOME/.caelum unless otherwise specified in $CAELUM_PARITY_HOME. This is useful in development configurations.

For production use, set export CAELUM_PARITY_HOME='/data/...' to the local filesystem directory where the Parity installation is present. Then invoke ./scripts/createSymlink to create the necessary symlink for keythereum to find the files it needs.

$CAELUM_PARITY_KEY_DIRECTORY can be set to specify the directory in which Parity is storing the keys. This depends on the name of the blockchain, and the path can vary based on installation, so override this with the substitute for CAELUM_PARITY_HOME/parity/keys/Alastria.

Generate a genesis block spec file

usage:

node index build[Fast]Spec networkName 0xNetNum 0xOwnerAddr 0xValidator1 [0xValidator2 ...]

buildSpec builds a spec file for a regular production-grade network. buildFastSpec builds a spec file for an auto-sealing configuration for testing.

Example: to generate a genesis block with three validator nodes:

node index buildSpec NetworkID 0x21 0x8ad0ba67f8088d1f990f878815173f1dafda0a55 0xdb3288f495605dacbff552b3e6c48b9f0e82db5c 0x832b1f863669ef3c96649bcf1d1d04ded595c0ef 0xdb3288f495605dacbff552b3e6c48b9f0e82db5c > spec.json

Development activities

npm run start [--fast] [--reset]

The --fast option starts a network using the InstantSeal engine. Without it, AuthorityRound is used.

The --reset option deletes the existing blockchain and starts over.

... do things ...

npm run stop

Testing

npm i
npm run lint
npm test

Coverage

npm run coverage

To generate a coverage report in coverage/index.html:

npm run coverage:report