In This Project you will find a Sample application written in Java and Kotlin Languages that interact with Hyperledger Fabric Network.
- REST API that encapsulates the Blockchain network operations (using the Hyperledger Fabric Java SDK) in order to be available for many developers that doesn't have Blockchain knowledge yet.
- Using Hyperledger Fabric CA (Certificate Authorities) to Register and Enroll Users.
- Create or Use(ReCreate) a Channel Programmatically.
- Deploy Chaincode Programmatically (Including all Approvals and Validations)
- Use of Private Collections to demonstrate privacy between Organizations within the same Channel.
- Hyperledger Fabric Version 2.1
- Java 8 and above
- Maven
- Gradle
- Docker and Docker Compose
- Basic knowledge of Blockchain and Hyperledger Fabric.
- Hyperledger Fabric tools - Please refer to https://hyperledger-fabric.readthedocs.io/en/release-2.0/install.html for further information
The network.sh file will be the main script to work with in order to operate the network
- Start a Network -
./network.sh up - Start a Network with CA -
./network.sh up -ca - Start a Network with CA and CouchDB instead of LevelDB -
./network.sh up -ca -s couchdb - Stop a Network -
./network.sh down
The Network implementation relies on the Hyperledger Fabric Test Network with modification.
You can choose to work with any Hyperledger Fabric network as long as you have the Admin CA materials for Peers and Orderer
Make sure Hyperledger Fabric tools (aka tools in the bin directory) available in the $PATH
cd chaincode
gradle installDist
cd app
mvn clean package
mvn spring-boot:run
Base Url will be: http://localhost:8080
- Deploy Chaincode with Channel Creation: http://localhost:8080/deployChainCode?createChannel=true
- Deploy Chaincode and Use Existing Channel: http://localhost:8080/deployChainCode?createChannel=false
- The app uses a Counter Chaincode for demonstration:
- Increment (aka "Public" for all Orgs) - http://localhost:8080/increment/{orgName}?delta={number}
- Increment (aka "Public" for all Orgs) - http://localhost:8080/increment/{orgName}?delta={number}&private=true&collection={collectionName}
- Delta is Optional, Defaults to 1
- Private collection names configured in the Network e.g. http://localhost:8080/increment/org1?private=true&collection=Org1AndOrg2
- Decrement (aka "Public" for all Orgs) - http://localhost:8080/decrement/{orgName}?delta={number}
- Decrement (aka "Public" for all Orgs) - http://localhost:8080/decrement/{orgName}?private=true&collection={collectionName}
- Delta is Optional, Defaults to 1
- Private collection names configured in the Network e.g. http://localhost:8080/increment/org3?private=true&collection=Org3Only
- Counts - http://localhost:8080/counts/{orgName}
hyperledger:
fabricTLS: true
fabricCATLS: true
channel:
name: counterchannelkotlin
profile: ThreeOrgsChannel
configPath: ../../network/configtx
txFile: ../../artifacts/counterchannel.tx
organizations:
- name: org1
mspId: Org1MSP
domain: org1.delobz.com
caName: ca-org1
peers:
- name: peer0
url: grpcs://localhost:7051
adminUserName: admin
users:
- appUser
props:
pemFile: ../../network/organizations/peerOrganizations/org1.delobz.com/peers/peer0.org1.delobz.com/tls/server.crt
# clientKeyFile:
# clientCertFile:
hostnameOverride: peer0.org1.delobz.com
sslProvider: openSSL
negotiationType: TLS
orderers:
- name: orderer
url: grpcs://localhost:7050
props:
pemFile: ../../network/organizations/ordererOrganizations/delobz.com/orderers/orderer.delobz.com/tls/server.crt
# clientKeyFile:
# clientCertFile:
hostnameOverride: orderer.delobz.com
sslProvider: openSSL
negotiationType: TLS
- name: org2
mspId: Org2MSP
domain: org2.delobz.com
caName: ca-org2
peers:
- name: peer0
url: grpcs://localhost:8051
adminUserName: admin
users:
- appUser
props:
pemFile: ../../network/organizations/peerOrganizations/org2.delobz.com/peers/peer0.org2.delobz.com/tls/server.crt
# clientKeyFile:
# clientCertFile:
hostnameOverride: peer0.org2.delobz.com
sslProvider: openSSL
negotiationType: TLS
orderers:
- name: orderer
url: grpcs://localhost:7050
props:
pemFile: ../../network/organizations/ordererOrganizations/delobz.com/orderers/orderer.delobz.com/tls/server.crt
# clientKeyFile:
# clientCertFile:
hostnameOverride: orderer.delobz.com
sslProvider: openSSL
negotiationType: TLS
- name: org3
mspId: Org3MSP
domain: org3.delobz.com
caName: ca-org3
peers:
- name: peer0
url: grpcs://localhost:9051
adminUserName: admin
users:
- appUser
props:
pemFile: ../../network/organizations/peerOrganizations/org3.delobz.com/peers/peer0.org3.delobz.com/tls/server.crt
# clientKeyFile:
# clientCertFile:
hostnameOverride: peer0.org3.delobz.com
sslProvider: openSSL
negotiationType: TLS
orderers:
- name: orderer
url: grpcs://localhost:7050
props:
pemFile: ../../network/organizations/ordererOrganizations/delobz.com/orderers/orderer.delobz.com/tls/server.crt
# clientKeyFile:
# clientCertFile:
hostnameOverride: orderer.delobz.com
sslProvider: openSSL
negotiationType: TLS
fabricCAs:
- name: ca-org1
url: https://localhost:7054
adminUserName: admin
props:
pemFile: ../../network/organizations/peerOrganizations/org1.delobz.com/ca/ca.org1.delobz.com-cert.pem
allowAllHostNames: "true"
- name: ca-org2
url: https://localhost:8054
adminUserName: admin
props:
pemFile: ../../network/organizations/peerOrganizations/org2.delobz.com/ca/ca.org2.delobz.com-cert.pem
allowAllHostNames: "true"
- name: ca-org3
url: https://localhost:9054
adminUserName: admin
props:
pemFile: ../../network/organizations/peerOrganizations/org3.delobz.com/ca/ca.org3.delobz.com-cert.pem
allowAllHostNames: "true"
- name: ca-orderer
url: https://localhost:10054
adminUserName: admin
chaincodes:
- name: counter_cc_kotlin
version: 1
label: CounterLabel
type: java
sourceLocation: ../../chaincode/build/install/counter-chaincode
path:
metadadataSource:
initRequired: false
deployWaitTime: 300000
invokeWaitTime: 32000
proposalWaitTime: 120000
collectionConfigurationPath: ../../network/privatecollections/private-collections.yaml
orgs:
- org1
- org2
- org3
- name: counter_cc_java
version: 1
label: CounterLabel
type: java
sourceLocation: ../../chaincode-java
path:
metadadataSource:
initRequired: true
deployWaitTime: 300000
invokeWaitTime: 32000
proposalWaitTime: 120000
collectionConfigurationPath:
orgs:
- org1
- org2
- org3
- Support adding new Org to an Existing Channel
- Support Endorsment Policies.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent