This project demonstrates using the Hyperledger Fabric blockchain to store a document hash so that its existence can be later proved through transaction queries.
- Docker - 18.03.1-ce or higher
- Docker Compose - v1.21.1 or higher
- node - v8.10.0
- Git client
- Windows needs OpenSSL installed into C:/OpenSSL-Win64
- Goto https://slproweb.com/products/Win32OpenSSL.html and pick the full Win64 package
git clone https://github.com/blocledger/poe-v1.git
cd poe-v1
npm install -g gulp
npm install -g mocha
npm install -g bower
npm install
A Hyperledger Fabric blockchain network can be run on your local machine using docker containers. The configuration and setup files will build a network that consists of one orderer, two peers, and one CA.
The instructions below assume that you already have docker installed and running.
Pull the fabric chaincode environment image using the 1.2.0 tag.
docker pull hyperledger/fabric-ccenv:1.2.0
Run the network setup script which will download the rest of the docker images, build docker-compose.yaml, create all certificates, and build the genesis block.
cd test/fixtures-V1
./network_setup.sh up mychannel
To check that the containers are running
docker ps
To see what version peer you are running
docker exec -it peer0.org1.blocledger.com bash
peer version
exit
Go back to the top poe directory and create the channel
cd ../..
node createChannel.js
node api.js
Once the application is running launch the web interface
using localhost:3000 as the URL. Once it's up go to
/Admin/Add User/ and add a user such as test@blocledger.com with a password
of your choice.
Once the user has been added, login by clicking on Click to log in in the
upper right corner of the page.
Next click the Deploy button on the Admin page to install the poe chaincode.
After the chaincode has been installed documents can be added and verified.
To stop the containers
cd test/fixures-V1
docker-compose -p poe stop
To start the previously created network
cd test/fixures-V1
docker-compose -p poe start
Use this procedure to completely delete the network and clean up all of the files for a fresh start.
ctrl-c the node application
cd test/fixures-V1
./network_setup.sh down
cd ../..
rm -r tmp/keyValStore_v1/
To run both the linter and code style checker run gulp with no parameters.
To run testing that will generate transactions and exercise all of the server
capabilities run gulp test.
Note: The chaincode needs to be deployed before running the test.
Turn additional debug prints with
DEBUG='poe' HFC_LOGGING='{"debug": "console"}' node api.js
or
export DEBUG='poe'
export HFC_LOGGING='{"debug": "console"}'
node api.js
This project uses the Hyperledger Fabric node SDK and its examples to connect to Hyperledger Fabric.