Developing Business Blockchain Applications on Hyperledger

Thanachart Numnonda, thanachart@imcinstitute.clockchain App on Hyperledger
Developing Business
Blockchain Applications
on Hyperledger
May 2018
Dr.Thanachart Numnonda
IMC Institute
thanachart@imcinstitute.com

Launch an Ubuntu virtual server
Using Google Cloud Platform
(You can skip this part if you already have an Ubuntu server)

Launch Google Cloud Virtual Server
In this lab, we will use a GCP’s compute engine as our server w
● Ubuntu Server 14.04 LTS
● 2 vCPU, 7.5 GB memory
● 50 GB SSD

cloud.google.com

Create Google Cloud Project

Select Compute Engine

Select Create Instance

Create an instance with the following configuration

Select boot disk as Ubuntu 14.04 and 50 GB

Connect via SSH in browser window

Connect to the instance

Installing Hyperledger
development environment

Installing prerequisites
$ curl -O https://hyperledger.github.io/composer/latest/prereqs-ubu
$ chmod u+x prereqs-ubuntu.sh
$ ./prereqs-ubuntu.sh

Installing the Hyperledger Composer tools
$ npm install -g composer-cli
$ npm install -g composer-rest-server
$ npm install -g generator-hyperledger-composer
$ npm install -g yo
$ npm install -g composer-playground

Installing 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
$ ./downloadFabric.sh

Starting Hyperledger-Fabric
&
Hyperledger composer playground

Starting Hyperledger-Fabric
$ ./startFabric.sh
$ ./createPeerAdminCard.sh

Viewing running process
$ docker ps -a

Starting composer-playground
$ composer-playground

Obtain a server’s external IP

Launch web-playground (http://ip-address:8080)

Running an example business
network

Click Deploy a new business network

Provide basic information and select basic-sample
-network (provide the network admin as Admin@hlfv1 )

Provide credentials information
(Assign the Enrolment id: admin Enrolment secret : adminpw)

Now the network is defined, click Deploy.

The new business network will be shown,
click Connect now

thanachart@imcinstitute.com31
Open another terminal console,
Type command docker ps -a,
You will see another container is running

Exploring a business network
Viewing the following files:
● Model
● Script
● Access control

Basic-sample-network
Definition
● Asset
○ SampleAsset
● Participant
○ SampleParticipant
● Transaction
○ SampleTransaction
● Event
○ SampleEvent

Testing the business network definition,
Click Test tab

Click Create New Participant

Enter the first participant, the click Create New

Enter the second participant, the click Create New

A list of participants will be shown

All transactions show events

Select SampleAsset, the click Create New Asset

Enter the new asset, the click Create New

A list of assets will be shown

Click Submit Transaction

Enter the transaction information, the click Submit

The asset value is now changed

Developing a new business network

my-bank-network
Definition
● Asset
○ Account
● Participant
○ Customer
● Transaction
○ AccountTransfer

Provide basic information and select empty-business
-network (provide the network admin as Admin@hlfv1 )

Edit a model file
○ /**
○ * Sample business network definition.
○ */
○ namespace org.imc.basic
○ asset Account identified by accountId {
○ o String accountId
○ --> Customer owner
○ o Double balance
○ }
○ participant Customer identified by customerId {
○ o String customerId
○ o String firstName
○ o String lastName
○ }
○ transaction AccountTransfer {
○ --> Account from
○ --> Account to
○ o Double amount
○ }

Select Model file, click edit icon

Edit a script file
○ /**
○ * Place a transaction for transfering money
○ * @param {org.imc.basic.AccountTransfer} AccountTransfer
○ * @transaction
○ */
○ function accountTransfer(accountTransfer) {
○ if (accountTransfer.from.balance < accountTransfer.amount) {
○ throw new Error('Insufficient fund');
○ }
○
○ accountTransfer.from.balance -= accountTransfer.amount;
○ accountTransfer.to.balance += accountTransfer.amount;
○ return getAssetRegistry('org.imc.basic.Account')
○ .then(function(assetRegistry) {
○ return assetRegistry.update(accountTransfer.from);
○ })
○

Edit a script file (cont.)
○ .then(function() {
○ return getAssetRegistry('org.imc.basic.Account');
○ })
○ .then(function(assetRegistry) {
○ return assetRegistry.update(accountTransfer.to);
○ });
○ }

Select Add a file

Choose Script File(.js), the click Add

Deploying the updated business network,
Click Deploy change

Click Upgrade

Testing the business network definition,
Click Test tab

Click Create New Participant

Enter the first participant, the click Create New

Enter the second participant, the click Create New

A list of participants will be shown

Select Account, the click Create New Asset

Enter the first account, the click Create New

Enter the second account, the click Create New

A list of accounts will be shown

Click Submit Transaction

Enter the transaction information, the click Submit

The account balances are now changed

All transactions show events

Generate REST APIs

List all of the business cards
$ composer card list

Start the REST server & generate the API
$ composer-rest-server
Enter the name of the business network card to use: Admin@hlfv1
Specify if you want namespaces in the generated REST API: never use namespaces
Specify if you want to use an API key to secure the REST API: No
Specify if you want to enable authentication for the REST API using Passport: No
Specify if you want to enable event publication over WebSockets: Yes
Specify if you want to enable TLS security for the REST API: No

Browse REST APIs (http://ip-address::3000/explorer)

Developing Business Blockchain Applications on Hyperledger

Reference:
https://hyperledger.github.io/composer/latest/installing/installing-index.html

Thanachart Numnonda,Big Data as a Service Using Google Cloud Platform
Thank you
www.imcinstitute.com
www.facebook.com/imcinstitute

Developing Business Blockchain Applications on Hyperledger

More Related Content

What's hot (20)

Similar to Developing Business Blockchain Applications on Hyperledger (20)

More from IMC Institute (20)

Recently uploaded (20)

Developing Business Blockchain Applications on Hyperledger