FabricBackend

A hyperledger fabric based blockchain backend storage.

Dependencies

• Golang 1.22.5+
  • In linux, please consult go version manager to manage go version.
• jq
• Docker
  • docker-compose (for older version docker)
  • In linux, add current user to the docker group to avoid privilege issue: sudo usermod -a -G docker $USER

On Ubuntu:

sudo apt-get install git curl jq -y

Start docker with

sudo systemctl start docker

On MacOS

brew install git curl jq go

Start docker with Docker Desktop.

To make the server work

1. Clone this repo to the destination of your choice, make sure you have make and docker/docker compose installed.

The following commands are assumed to initiated from the FabricBackend/ directory.

2. Run make check-prerequisite to check prerequisites.
3. Run make install to install the necessary components, including fabric, docker images, and chaincode.
4. Use make drp_couchdb_deploy to bring up the test network and deploy the contract.

This may fail at contract installation in rare occasions, simply trying the command again should resolve the problem.

5. Use make api_server to bring up the api service

Initialize the ledger with csv data

Navigate to FabricBackend/data-import-helper and use go run import_file.go to put the data in ds1.csv to the ledger.

This helper relies on the api server.

To bring it down

1. Use make down to turn the network down
2. Use make clean to clean up the downloaded repos and docker images.

By default all the data will be cleaned when the network is down.

APIs

The default api server address is http://localhost:6999

GET api/record/all

Return all records in standard JSON

GET api/record/{droneID}

Return all records for {droneID} in standard JSON

POST api/record/create

Create a record with the JSON. The JSON needs to be formatted as the sample data.

Ports and Service

Name	Type	Ports
API server	Go	6999
orderer	Docker	7050
peer0.org1	Docker	7051
peer0.org2	Docker	9051
dev-peer.org1	Docker	-
dev-peer.org2	Docker	-
CouchDB0	Docker	5984
CouchDB1	Docker	7984

For live demo, please check the instructions.