This repository allows to start small RChain network on local machine using docked-compose. It might be useful for those who wish to test changes to RNode, to get familiar with how network operates and how to configure and start private network. The behaviour is equal to normal network with each node having dedicated machine.
By default shard of 3 nodes is created, connected with the virtual network
rchain-net. Each node exposes API ports via docker port mapping. Please see corresponding
ports section to know exact port numbers.
Initially network state is clean. Once shard is started, nodes will perform genesis ceremony and create genesis block. This takes some time, but after that network can be stopped and started much faster. To clean the state of the network and start with the new genesis block, clear or remove
The following data has to be downloaded first: Rchain-docker-cluster
List of publick keys of validators bonded in genesis block (bonds file): [./genesis/bonds.txt]
REV balances in genesis block (wallets file): [./genesis/wallets.txt]
Private keys and REV addresses for public keys in bonds file (format
PublicKeyHex, PrivateKeyHex, RevAddress.): [./resources/keys.txt].
Configuration files for network nodes: [./conf]
Start a network of 3 nodes: containers
$ docker-compose -f ./shard.yml up
To start only a standalone node (container
$ docker-compose -f ./standalone.yml up
Make sure shard is up and running and all nodes printed
Making a transition to Running state., which means Casper instance is ready to accept connections.
$ docker-compose -f ./propose.yml up
Observer nodes are same as validators but started without private key provided, so they cannot sign and propose blocks. Such instances allow execution of so-called
exploratory deploys to query the state of the DAG.
$ docker-compose -f ./read-only.yml up