LACChain Network Docker

Prerequisites

To run these tutorials, you must have the following installed:

• Docker and Docker-compose

• On Windows ensure that the drive that this repo is cloned onto is a "Shared Drive" with Docker Desktop
• On Windows we recommend running all commands from GitBash
• Nodejs and Truffle if using the DApp

Description

There are multiple examples in this repo, and each has a POA example. You can choose the default setup which comprises a 4 node network with the Block Explorer and our Prometheus & Grafana dashboard to track the progress of the chain; or the whole setup with logging via ELK.
Please use the following use cases personas as guidelines only:

All the architecture diagrams below generally use the POA (IBFT2) setup, to view the architecture diagrams for the POW (ethash) setup please see the images folder, where the files share the same name but have different suffixes.

Start Services and Network

./run.sh starts all the docker containers in POA mode

./run.sh -v -w starts all the docker containers in POA mode using the IBFT2 Consensus algorithm

There are two parameters -v and -w parameters which specify the number of validators and writers nodes, respectively.

Basic 4 Node Network with Block Explorer and Prometheus & Grafana to track the progress of your chain

Use this scenario:

• if you are a DApp Developer looking for a robust, simple network to use as an experimental testing ground for POCs

Where the node details are as follows:

Testing Privacy between Orion nodes

Prerequisites

• Nodejs

Follow the eeajs-multinode-example which deploys an EventEmitter contract and then sends a couple of Private Transaction from Node1 -> Node2 (& vice versa) with an arbitrary value (1000).

At the end of both transactions, it then reads all three Orion nodes to check the value at an address, and you should observe that only Node1 & Node2 have this information becuase they were involved in the transaction and that Orion3 responds with a 0x value for reads at those addresses

There is an additional erc20 token example that you can also test with: executing node example/erc20.js deploys a HumanStandardToken contract and transfers 1 token to node2.

This can be verified from the data field of the logs which is 1.

Prerequisites

• Nodejs
• Yarn
• JQ
• Install metamask as an extension in your browser
• Once you have setup your own private account, select 'My Accounts' by clicking on the avatar pic and then 'Import Account' for the following private keys:
  • 0x8f2a55949038a9610f50fb23b5883af3b4ecb3c3bb792cbcefbd1542c692be63
  • 0xc87509a1c067bbde78beb793e6fa76530b6382a4c0241e5e4a9ec0a0f44dc0d3
  • 0xae6ae8e5ccbfb04590405997ee2d52d2b330726137b875053c36d94e974d162f

Stop Services and Network

./stop.sh stops all the docker containers created.

Remove stopped containers and volumes

./remove.sh stops and removes all the containers and volumes.

Copyright 2020 LACChain

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.