blockchain-node-workspace

A docker-compose+bash script environment to run GoQuorum + ethAdapter.

This repository :

• Depends on https://github.com/PharmaLedger-IMI/ethadapter.git for the ETH smart contract
• Depends on https://github.com/privatesky/privatesky.git

It is suitable for developers experimenting with OpenDSU blockchain anchoring. It is not suitable for production.

Pre-requesites

1. Same as in https://github.com/ConsenSys/quorum-dev-quickstart#prerequisites (and has not been tested on Windows, so far).

2. The node version documented here is 14, but it could possibly work on 16. Not tested.

1st Time Installation and Startup

nvm use 14
git clone https://gitlab.pdmfc.com/pharmaledger/blockchain-node-workspace.git
cd blockchain-node-workspace
npm install
npm run deploy-blockchain

When the deploy-blockchain finishes, it will leave several docker containers running.

• quorum x 4 - Geth/instanbul nodes using a local IPv4 bridge network private dsu-bc-net 172.16.16.*/24. Node 1 is at 172.16.16.11.
• web3labs/epirus-free-*,nginx,mongo - ethereum explorer available on host port 8700 (also available on https://www.web3labs.com/epirus-explorer)
• ethadapter - from ePi workspace - exposed on dsu-bc-net private address:port 172.16.16.16:3000

WARNING: Only run this once. If you repeat the npm run deploy-blockchain the smart contract will be deployed again at a different address, the ethAdapter will be re-configured for that address and will not be able to see any previous hashes. (So you will loose access to previous anchors.)

Starting up for the 2nd Time

npm run start-blockchain

Stopping

npm run stop-blockchain

Stopping does not looses data. (Several docker external volumes where created on the 1st-time installation, and these will keep the required data between stop/start).

Stopping and Removing

npm run down-blockchain

Does delete private networks, but DOES NOT DELETE the volumes containg the blockchain data. Nevertheless there have been problems reported on startup where consensus/mining seems to become broken (breaks adding anchors).

Remove and release space for the docker images, volumes and network

Must execute the "Stopping" procedure first.

Then run:

docker container prune
docker volume prune
docker network prune

Use with care: If that does not work, the following will stop and remove all docker images on your system (even from other workspaces):

docker kill $(docker ps -q)
docker rm $(docker ps -a -q)
docker rmi $(docker images -q)

Eliminate ALL docker volumes (even from other workspace):

docker volume rm $(docker volume ls -q)

Then eliminate unused image space and networks.

docker system prune -af
docker network prune -f

Running ethdapter outside docker

If you want to test changes to ethadapter, it can run outside the docker environment. These steps should help you accomplish that.

# 1 - run que quorum dockers
cd quorum && docker-compose up -d
cd ..
# 2 - create account
node bin/createOrgAcc.js
# 3 - deploy smart contract Anchoring.sol
node bin/deployAnchoringSC.js
# 4 - write ./ethadapter/EthAdapter/docker-compose.yml and tmpenv.sh with environment updated
node bin/deployAnchoringSC.js
# 5 - Include environment variables and run EthAdapter
cd ethadapter/EthAdapter/ ; . tmpenv.sh ; node index.js