Developing applications with Hyperledger Fabric SDK

@horeaporutiu IBM Developer
Horea Porutiu
Developer Advocate, IBM
October 2018
Developing Applications with
Hyperledger Fabric SDK

Agenda
1. Hyperledger Fabric v.
Composer
2. Approaches for
Development
3. Hyperledger Fabric SDK
overview
4. IBM’s BaaS (blockchain-
as-a-service) Demo
5. Use Case
IBM Developer@horeaporutiu
@pluralsight

Hyperledger Fabric
IBM Developer@horeaporutiu https://www.pinterest.com/pin/215469163401716164/

Hyperledger Fabric v. Composer
• Original project
@horeaporutiu IBM Developerhttps://www.hyperledger.org/projects/composerhttps://www.hyperledger.org/projects/fabric

• Learn Fabric SDK -
Node.js, Java
@horeaporutiu IBM Developerhttps://www.hyperledger.org/projects/composerhttps://www.hyperledger.org/projects/fabric

Node.js, Java
• Uses channels to
divide communication
between participants
https://www.hyperledger.org/projects/composerhttps://www.hyperledger.org/projects/fabric

Node.js, Java
•Status: active

Node.js, Java
• Original project • Tool for using Fabric
•Status: active

Node.js, Java
• Easy to generate
REST API
• Tool for using Fabric
•Status: active

Node.js, Java
REST API
•Status: active
• Learn Composer
modeling language

Node.js, Java
REST API
•Status: active
• Learn Composer
modeling language
• Test your contracts in
a sandbox, online

Node.js, Java
REST API
•Status: active
• Learn Composer
modeling language
• Test your contracts in
a sandbox, online
•Status: incubation

Approaches for development
Cloud
• Run docker
containers (peer,
orderer, certiﬁcate
authority, couchDb)
Local

Cloud
• Run docker
containers (peer,
authority, couchDb)
Local
• Inviting other orgs,
viewing blocks is hard

Cloud
• Run docker
containers (peer,
authority, couchDb)
• Network setup is
done for you
Local

Cloud
• Run docker
containers (peer,
authority, couchDb)
done for you
Local
• Nice interface to view
all blocks

Cloud
• Run docker
containers (peer,
authority, couchDb)
done for you
Local
• Nice interface to view
all blocks
• Easy to invite other
organizations to the
network

Our approach
Cloud - via the IBM
Blockchain Platform

How do you get started?
• Intro to Hyperledger Node SDK code pattern -
https://github.com/IBM/car-auction-network-
fabric-node-sdk
• Step by step guide on how to connect local
Node.js app to IBM Blockchain Platform

Actors in Hyperledger
•Michael Scott,
a.k.a. the peer
node. The peer,
(M. Scott) runs
the show
(chaincode). The
manager of The
Office.
http://mtncatholic.com/2016/10/06/no-joke-dante-puts-michael-scott-hell/
• Toby, a.k.a the
CA(Certificate
Authority). The
CA hands out
certificates to
members of the
network. The
H.R. of The
Office - hands
out offer letters.
http://theoffice.wikia.com/wiki/Toby_Flenderson https://www.dailybreak.com/break/chilis-lifts-ban-on-pam-beesly
• Pam, a.k.a. the
orderer
broadcasts
messages to
peers. As the
receptionist in the
office, she relays
messages to other
employees.

Hyperledger Fabric SDK Overview
Blockchain
network - 1 org
Certiﬁcate Authority
Orderer
Peer
(Local)
Node.js app +
Fabric SDK

Node.js app +
Fabric SDK
Blockchain
network - 1 org
Orderer
Peer
(Local)
1. Enrollment - Register
admin with Certificate Auth
Hyperledger Fabric SDK Overview
Chaincode
Database
Blockchain
network - 1 org
Certificate AuthorityCertificate Authority
Orderer
Peer
Chaincode
Database
1.

Enrollment
• Enrollment - process of generating keys and
certiﬁcates from the Certiﬁcate Authority

Enrollment
• First generate certificate for our admin identity
and use those to register a new client identity
• Enrollment - process of generating keys and
certificates from the Certificate Authority

Hyperledger Fabric SDK - Enrollment
Node.js app +
Fabric SDK
Blockchain
network - 1 org
(Local)
1.
Orderer
Peer
Chaincode
Database

Node.js app +
Fabric SDK
Blockchain
network - 1 org
Orderer
(Local)
2. Register users
🔑
Hyperledger Fabric SDK - Enrollment
Peer
Chaincode
Database
Blockchain
network - 1 org
Orderer
Peer
Chaincode
Database
Blockchain
network - 1 org
Orderer
Peer
Chaincode
Database
2.
1.

Hyperledger Fabric SDK - Transaction
Node.js app +
Fabric SDK
Blockchain
network - 1 org
Orderer
(Local)
2. Register users
3. Send transaction to peer
🔑
Peer
Chaincode
Database
Blockchain
network - 1 org
Orderer
Peer
Chaincode
Database
Blockchain
network - 1 org
Orderer
Peer
Chaincode
Database
3.
2.
1.

Using Fabric SDK - Invoking Chaincode 1/2
Node.js app +
Fabric SDK
(Local)
3. Send transaction
proposal to peer
var request = {
chaincodeId: ‘carauction’, //name of chaincode to execute
fcn: ‘initLedger’, // which chaincode function to execute
args: [‘’], //array of args for chaincode function
txId: fabric_client.newTransactionID(); //assign new txn id
}
🔑
Peer
Chaincode
Database
3.

var request = {
chaincodeId: ‘carauction’, //name of chaincode to execute
fcn: ‘initLedger’, // which chaincode function to execute
args: [‘’], //array of args for chaincode function
txId: fabric_client.newTransactionID(); //assign new txn id
}
var channel = fabric_client.newChannel(‘defaultchannel’);
return channel.sentTransactionProposal(request);
var fabric_client = require(‘fabric-client);

Node.js app +
Fabric SDK
(Local)
3. Send transaction
proposal to peer🔑
Peer
Chaincode
Database
3.
• Check endorsement policy - which peers need to
endorse transaction

Node.js app +
Fabric SDK
(Local)
3. Send transaction
proposal to peer🔑
Peer
Chaincode
Database
3.
• Check endorsement policy - which peers need to
endorse transaction
• The transaction proposal will go to the peers in the
endorsement policy

Using Fabric SDK - Writing to the ledger
let member = {
member.balance = 5000; //set balance of member’s account
member.firstName = ‘Amy’; //set first name of member
member.lastName = ‘Williams’; //set last name of member
member.email = ‘amyWilliams@email.com’; //set email
}
await stub.putState(‘amyWilliams@email.com’,
Buffer.from(JSON.stringify(member)));
• putState takes a key value pair, and writes to the ledger

Node.js app +
Fabric SDK
Blockchain
network - 1 org
Orderer
Peer
(Local)
1.
2. Register application
2.
3. Send (txn)transaction to peer
4. Peers return endorsed txn
Using Fabric SDK - Invoking Chaincode
🔑
Peer
Chaincode
Database
4.
3.

Using Fabric SDK - Reading from the ledger
await stub.getState(‘amyWilliams@email.com’);
• getState reads the member object from the ledger.
Note, this does not create a block on the network.
• This will return:
{
balance: ‘5000’;
firstName: ’Amy’;
lastName: ‘Williams’;
email: ‘amyWilliams@email.com’;
}

Node.js app +
Fabric SDK
Peer
(Local)
4. Peers return endorsed
transaction
4.
• Check transaction proposal has not been submitted in
the past and is well formed
🔑

Node.js app +
Fabric SDK
Peer
(Local)
transaction
4.
• Check that signature is valid
🔑

Node.js app +
Fabric SDK
Peer
(Local)
transaction
4.
• Take args from chaincode function, and execute function
🔑

Node.js app +
Fabric SDK
Peer
(Local)
transaction
4.
• Take args from chaincode function, and execute function
• Transaction results + enduring peer signature is sent
back to SDK
🔑

Node.js app +
Fabric SDK
Blockchain
network - 1 org
Orderer
Peer
(Local)
1.
2. Register application
2.
3. Send (txn)transaction to peer
4. Peers return endorsed txn
Using Fabric SDK - Invoking Chaincode
🔑
Peer
Chaincode
Database
4.
3.
5. App sends endorsed txn to ordering service to add to ledger
5.

Using Fabric SDK - Ordering Service
Node.js app +
Fabric SDK
Orderer
(Local)
5. App sends endorsed txn to
ordering service to add to ledger
• App ‘broadcasts’ transaction proposal and response to
the ordering service
5.
🔑

Node.js app +
Fabric SDK
Orderer
(Local)
5.
• Order chronologically and create blocks
🔑

Node.js app +
Fabric SDK
Orderer
(Local)
5.
• Order chronologically and create blocks
• Order transactions from all channels - order
chronologically by channel and create blocks
🔑

Ledger Updated
• Each peer appends block to the channel’s chain,
•For each valid transaction the write sets are committed to
current state database
• Client is notiﬁed that transaction has been immutably
appended to the chain

Demo

Problem
1 in 10 people fall ill
every year from eating
contaminated food -
World Health
Organization

Use Case - IBM Food Trust
• One of the ﬁrst solutions in-production using blockchain

• Smarter, safer, more sustainable food supply chain

• Built on open-source framework - Hyperledger Fabric

• How to join: register your organization with the network

• Solution: Trace - allows user to search the origin of a
product by product name, Purchase Order or GTIN
(Global Trade Item Number)

• Solution: Trace - allows user to search the origin of a
product by product name, Purchase Order or GTIN
(Global Trade Item Number)
• Solution: Certiﬁcate Manager - upload regulation and
inspection documents (fair-trade, organic, etc.)

What if we ﬁnd out
that all products
from Grandma’s
Farm are
contaminated?

Food Contamination - Grandma’s Farm
IBM Developer@horeaporutiu https://tenor.com/view/michael-scott-no-nogod-please-gif-5739001

Hopefully you will feel like this after
IBM Developer@horeaporutiu https://www.pinterest.com/pin/427630927097492361

IBM Blockchain Starter Plan
•http://goo.gl/i9WZcH
• Need either business or student
email address, gmail wont work
• Takes a few business days to
process, please be patient

Code Patterns
• Hello world Hyperledger Fabric Car Auction -
https://github.com/IBM/car-auction-network-
fabric-node-sdk
@horeaporutiu IBM Code
• Blockchain Bean UI - https://www.ibm.com/
thought-leadership/blockchainbean/index.html
• Blockchain Bean Code -https://github.com/IBM/
blockchainbean

Contact
• Questions: horea.porutiu@ibm.com
• Social: Tweets @horeaporutiu
• Site: https://horeaporutiu.github.io/
• Medium: https://medium.com/@horeaporutiu

Questions?
http://www.freeiconspng.com/img/5437

IBM Blockchain Platform UI

Developing applications with Hyperledger Fabric SDK

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Developing applications with Hyperledger Fabric SDK

Similar to Developing applications with Hyperledger Fabric SDK (20)

More from Horea Porutiu

More from Horea Porutiu (8)

Recently uploaded

Recently uploaded (20)

Developing applications with Hyperledger Fabric SDK