Digital bank transactions using Hyperledger Composer Blockchain.
Install Hyperledger Composer essential CLI tools:
npm install -g composer-cli
Install Hyperledger Composer Playground:
npm install -g composer-playground
Install Hyperledger Composer utility for running a REST Server on your machine to expose your business networks as RESTful APIs:
npm install -g composer-rest-server
In a directory of your choice (we will assume ~/fabric-dev-servers), get the
.tar.gz file that contains the tools to install Hyperledger Fabric:
mkdir ~/fabric-dev-servers && cd ~/fabric-dev-servers
curl -O https://raw.githubusercontent.com/hyperledger/composer-tools/master/packages/fabric-dev-servers/fabric-dev-servers.tar.gz
tar -xvf fabric-dev-servers.tar.gz
You control your runtime using a set of scripts which you'll find in
~/fabric-dev-servers if you followed the suggested defaults.
Start Hyperledger Fabric:
~/fabric-dev-servers/startFabric.sh
The first time you start up a new runtime, you'll need to generate a PeerAdmin card:
~/fabric-dev-servers/createPeerAdminCard.sh
You can start and stop your runtime using ~/fabric-dev-servers/stopFabric.sh,
and start it again with ~/fabric-dev-servers/startFabric.sh.
At the end of your development session, you run
~/fabric-dev-servers/stopFabric.sh and then
~/fabric-dev-servers/teardownFabric.sh. Note that if you've run the teardown
script, the next time you start the runtime, you'll need to create a new
PeerAdmin card just like you did on first time startup.
If you've previously used an older version of Hyperledger Composer and are now setting up a new install, you may want to kill and remove all previous Docker containers, which you can do with these commands:
docker kill $(docker ps -q)
docker rm $(docker ps -aq)
docker rmi $(docker images dev-* -q)
To start the web app, run:
composer-playground
Package the application into a deployable business network archive (.bna)
file:
npm run prepublish
After creating the .bna file, the business network can be deployed to the
Hyperledger Fabric's instance.
To install the business network, run the following command:
composer network install --card PeerAdmin@hlfv1 --archiveFile dist/blockchain-bank.bna
To start the business network, run the following command:
composer network start --networkName blockchain-bank --networkVersion 0.0.1 --networkAdmin admin --networkAdminEnrollSecret adminpw --card PeerAdmin@hlfv1 --file networkadmin.card
To import the network administrator identity as a usable business network card, run the following command:
composer card import --file networkadmin.card
To check that the business network has been deployed successfully, run the following command to ping the network:
composer network ping --card admin@blockchain-bank
Hyperledger Composer can generate a bespoke REST API based on a business network. For developing a web application, the REST API provides a useful layer of language-neutral abstraction.
To create the REST API, navigate to the blockchain-bank directory and run the
following command (enter admin@blockchain-bank as the card name):
composer-rest-server