GoRestLedger is a REST based API implementation written in Go language to demonstrate the Hyperledger Fabric Blockchain framework. The project repo has been designed to upload employee records into the blockchain and also has the functionality to update, delete the record stored securely in the Hyperledger framework.

However, this explanation guide does not explain how Hyperledger Fabric works, so for the information, you can follow at Hyperledger.

Employeeledger requires Docker & Go to run.

$ sudo apt install docker.io
$ sudo apt install docker-compose

$ sudo apt-get update
$ sudo apt-get install golang-go

$ export GOPATH=$HOME/go
$ export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin

$ source ~/.profile
$ go version
$ go version go1.11 linux/amd64

This sample Hyperledger Fabric blockchain network is built on a single organization consisting of two peer nodes. There are few prerequisites to follow to set up and install a blockchain network in the docker container.

• There are few binaries needs to be download to create the network.
• These binaries contains various commands to setup , install and execute contains written in .yaml file.
• Command Reference Guide : https://hyperledger-fabric.readthedocs.io/en/release-1.4/command_ref.html

There are few configuration files is written, which composed of various configuration details of a network like Certificate Authority (CA), Peer , Orderer , CouchDB.

This configuration file will generate few certificates and key for the organization and it’s related entities like peers, admin, orderer. The cryptogen binary will take the config file as input and after execution, it will create a crypto-config folder in the config directory, which will contains all the generated certificates and key.

./bin/cryptogen generate --config=./crypto-config.yaml

This config file will contains complete details of a channel related to an organization. It will create three artifacts for a network.

• orderer.genesis.block : This will initialize the Fabric’s orderer

    ./bin/configtxgen -profile GoRestLedger -outputBlock ./artifacts/orderer.genesis.block
  

• gorestledger.channel.tx : Channel is a private network between peers to communicate in a network

    ./bin/configtxgen -profile GoRestLedger -outputCreateChannelTx ./artifacts/gorestledger.channel.tx -channelID gorestledger
  

• org1.employeeledger.anchors.tx : This artifact will allow the peers to interact with each other in a network.

    ./bin/configtxgen -profile GoRestLedger -outputAnchorPeersUpdate ./artifacts/org1.gorestledger.anchors.tx -channelID gorestledger -asOrg GoRestLedgerOrganization1
  

Now, we need to deploy the configuration details into a docker container, so we need to use Docker Compose. There will docker-compose.yaml configuration file, which will contain all config details for Orderer, Certificate Authority, Peer, Couch DB.

• The compose file can be deploy into a network, by executing following command

   docker-compose up -d // the docker-compose.yaml has to be located at same command location
  

So, all done , your blockchain network is now deployed into a docker container.

You can check by executing following command

docker ps

1. Hyperledger fabric-sdk-go is still in development. If you do dep ensure for each Gopkg.toml in gorestledger and Chaincode, it will download the govendor folder for each module but it will have some compilation issues while building the project. I have corrected the error for both gorestledger and Chaincode folder.
2. Please download the vendor folder and add it in your project repo.

   gorestledger - https://www.dropbox.com/s/ry1jmw0y9xliose/vendor.zip?dl=0

   Chaincode - https://www.dropbox.com/s/31nnqflpqwaywoa/vendor.zip?dl=0

3. Add vendor folders at the location where Gopkg.toml file is located.

• As you have sucssefully deployed your blockchain network. Now you can run the application.
• There is a master Makefile , you can find in the project root directory.
• Just type “make” in the command line and it will take few minuetes to start the server.
• If all goes well, you can see server running at port 4000
• Now, you can use postman to test the APIs at http://localhost:6000

{
    "name": "Alice McDonnell",
    "email": "[email protected]",
    "password": "Hello@123",
    "company": "Apple",
    "occupation": "Architect",
    "salary": "85,000",
    "userType": "Admin"
}

{
    "id": "eDUwOTo6Q049YW5zaHVtYW4ucGF0dG5haWs1MjRAZ21haWwuY29tLE9VPXVzZXIrT1U9b3JnMTo6Q049Y2Eub3JnMS5nby5yZXN0LmxlZGdlci5jb20sTz1vcmcxLmdvLnJlc3QubGVkZ2VyLmNvbSxMPVNhbiBGcmFuY2lzY28sU1Q9Q2FsaWZvcm5pYSxDPVVT",
    "name": "Alice McDonnell",
    "email": "[email protected]",
    "company": "Apple",
    "occupation": "Architect",
    "salary": "85,000",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdXRob3JpemVkIjp0cnVlLCJleHAiOjE1NjExNTU5OTIsInVzZXIiOiJhbnNodW1hbi5wYXR0bmFpazUyNEBnbWFpbC5jb20ifQ.dIpTAgxnh-4lw06IQwX_bT4fhpvCUrwSZ7EnGVs46EE",
    "userType": "Admin"
}

{
 "email": "[email protected]",
 "password": "Hello@456"
}

{
    "id": "eDUwOTo6Q049YW5zaHVtYW4ucGF0dG5haWs1MjRAZ21haWwuY29tLE9VPXVzZXIrT1U9b3JnMTo6Q049Y2Eub3JnMS5nby5yZXN0LmxlZGdlci5jb20sTz1vcmcxLmdvLnJlc3QubGVkZ2VyLmNvbSxMPVNhbiBGcmFuY2lzY28sU1Q9Q2FsaWZvcm5pYSxDPVVT",
    "name": "Alice McDonnell",
    "email": "[email protected]",
    "company": "Apple",
    "occupation": "Architect",
    "salary": "85,000",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdXRob3JpemVkIjp0cnVlLCJleHAiOjE1NjExNTU5OTIsInVzZXIiOiJhbnNodW1hbi5wYXR0bmFpazUyNEBnbWFpbC5jb20ifQ.dIpTAgxnh-4lw06IQwX_bT4fhpvCUrwSZ7EnGVs46EE",
    "userType": "Admin"
}

list of user records 

{
    "email": "[email protected]"
}

{
    "id": "eDUwOTo6Q049YW5zaHVtYW4ucGF0dG5haWs1MjRAZ21haWwuY29tLE9VPXVzZXIrT1U9b3JnMTo6Q049Y2Eub3JnMS5nby5yZXN0LmxlZGdlci5jb20sTz1vcmcxLmdvLnJlc3QubGVkZ2VyLmNvbSxMPVNhbiBGcmFuY2lzY28sU1Q9Q2FsaWZvcm5pYSxDPVVT",
    "name": "Alice McDonnell",
    "email": "[email protected]",
    "company": "Apple",
    "occupation": "Architect",
    "salary": "85,000",
    "userType": "Admin"
}

{
    "name": "Alice Wrick",
    "company": "Apple Computer",
    "occupation": "Architect Solution",
    "salary": "85,000",
    "userType": "Admin"
}

{
    "id": "eDUwOTo6Q049YW5zaHVtYW4ucGF0dG5haWs1MjRAZ21haWwuY29tLE9VPXVzZXIrT1U9b3JnMTo6Q049Y2Eub3JnMS5nby5yZXN0LmxlZGdlci5jb20sTz1vcmcxLmdvLnJlc3QubGVkZ2VyLmNvbSxMPVNhbiBGcmFuY2lzY28sU1Q9Q2FsaWZvcm5pYSxDPVVT",
    "name": "Alice Wrick",
    "email": "[email protected]",
    "company": "Apple Computer",
    "occupation": "Architect Solution",
    "salary": "85,000",
    "userType": "Admin"
}

{
  "email": "[email protected]"
}

{
    "success": "Succesfully delete the user with email - [email protected]"
}

{
    "email": "[email protected]",
    "userType": "User",
    "oldPassword": "Hello@123",
    "password": "Hello@456"
}

{
    "success": "Password successfully changed for - [email protected]"
}

This project is licensed under the MIT License