Name: global-citizen
Owner: International Business Machines
Description: null
Created: 2018-04-12 19:31:30.0
Updated: 2018-05-24 09:42:23.0
Pushed: 2018-05-23 11:35:42.0
Homepage: null
Size: 13222
Language: JavaScript
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
The goal here is to build a 3-member blockchain application using the IBM Blockchain Platform, consisting of the following entities: an organization representing a government entity, an organization representing an NGO focused on the provision of aid, and an organization representing Global Citizen.
Audience level : Intermediate Developers
Free IBM Cloud account
NPM and Node installed (node version 8.10.0)
If you have used other versions of composer-cli, or have deployed a .bna file before, run these commands
uninstall -g composer-cli
uninstall -g composer-rest-server
rf ~/.composer
.card
rf credentials/
Install composer-cli
install -g composer-cli@0.19.5
A business network is made up of assets, participants, transactions, access control rules, and optionally events and queries. In this skeleton business network, there is a model (.cto) file which will contain the class definitions for all assets, participants, and transactions in the business network. The skeleton business network also contains an access control (permissions.acl) document with basic access control rules, a script (logic.js) file containing transaction processor functions, and a package.json file containing business network metadata.
First we need to clone a repo that contains the three components that are needed to make a BNA file: a logic file(.js) , a model file(.cto), and an access control(.acl) file.
clone https://github.com/IBM/global-citizen.git
To check that the structure of the files is valid, you can now generate a Business Network Archive (BNA) file for your business network definition. The BNA file is the deployable unit – a file that can be deployed to the Composer runtime for execution. Use the following command to generate the network archive:
lobal-citizen
install
You should see the following output:
ting Business Network Archive
ing for package.json of Business Network Definition
Input directory: /Users/ishan/Documents/proj/global-citizens/global-citizens-network/global-citizen
d:
Description: This pattern should be able to Construct a 3-member blockchain application using the IBM Blockchain Platform, consisting of the following entities: an organization representing a government entity, an organization representing an NGO focused on the provision of aid, and an organization representing Global Citizen.
Name: global-citizens-network
Identifier: global-citizens-network@0.0.1
ten Business Network Definition Archive file to
ut file: global-citizens-network@0.0.1.bna
and succeeded
Now you should have a BNA file, (global-citizens-network.bna), that is in your global-citizens/dist
directory.
In your browser go to your shiny new IBM Cloud account
Create a blockchain service:
Launch your blockchain service, and click on connection profile, and view as raw JSON
Scroll all the way down until you see registrar
and then under enrollId
will be enrollSecret
. Copy this secret, we will need it for the next step for creating the a business network card for the certificate authority (CA)
Download the connection profile
Rename the downloaded JSON file to connection-profile.json
Move the connection-profile.json
file to the global-citizen
directory
Using the enrollSecret
from the previous step issue this command to create a business network card for the certificate authority (CA)
oser card create -f ca.card -p connection-profile.json -u admin -s <enrollSecret>
Import the card in your local system wallet with this command
oser card import -f ca.card -c ca
Finally, we request certificates from the CA using the card we imported that contains our enrollSecret
. The certificates are stored in the credentials directory that is created after the completion of this command.
oser identity request --card ca --path ./credentials
Back in the blockchain service, click on the members tab, then add certificate. Go to your global-citizen/credentials
directory, and copy and paste the contents of the admin-pub.pem
file in the certificate box. Submit the certificate and restart the peers.
Note: restarting the peers takes a minute.
Next, we need to synchronize the certificates of the channel. From our blockchain service, under my network
click on Channels
and then the three-dot button. Then click Sync Certificate
.
Now that we have synced certificates with our peers, we can install the Hyperledger Composer runtime and start the network by creating an admin card. Create the admin card with the channel admin and peer admin roles with the following command:
oser card create -f adminCard.card -p connection-profile.json -u admin -c ./credentials/admin-pub.pem -k ./credentials/admin-priv.pem --role PeerAdmin --role ChannelAdmin
Import the card created from the previous command:
oser card import -f adminCard.card -c adminCard
Now we will use the admin card to install the network with the following command:
oser network install --card adminCard --archiveFile global-citizens-network@0.0.1.bna
Note: If you get an error at this point, wait a minute and try again.
Start the business network by providing the admin card, the path to the .bna file, and the credentials received from the CA. This command will issue a card which we will remove, called ?delete_me.card?.
oser network start --networkName global-citizens-network --networkVersion 0.0.1 -c adminCard -A admin -C ./credentials/admin-pub.pem -f delete_me.card
Note: If you get an error at this point, wait a minute and try again.
Next, let?s delete delete_me.card :
elete_me.card
After we have installed the runtime and started the network, we need to create a card which we will deploy to the Starter Plan. Use the following command to create adminCard.card
:
oser card create -n global-citizens-network -p connection-profile.json -u admin -c ./credentials/admin-pub.pem -k ./credentials/admin-priv.pem
Import the business network card:
oser card import -f admin@global-citizens-network.card
Test the business network card:
oser network ping -c admin@global-citizens-network
You can either use composer-playground or composer-rest-server to interact with the business network.
Use the links to get more information about composer-playground and composer-rest-server.
install -g composer-playground@0.19.5
connection-profile.json
oser-playground
Admin card
for global-citizen business network is created in Composer Playground.
Click on Connect now
button present on admin@global-citizens-network
card to connect to global-citizen business network
To test your Business Network Definition, first click on the Test tab:
In the AidOrg
participant registry, create a new participant. Make sure you click on the AidOrg
tab on the far left-hand side first and click on Create New Participant
button
Fill the details for AidOrg
participant and click on Create New
New AidOrg
participant created in participant registry. Similarly create the other participants for the network.
Connection profiles contain the information necessary to connect to a fabric. Business network cards combine a connection profile, identity, and certificates to allow a connection to a business network in Hyperledger Composer Playground.
Now we are ready to add Network Cards for the participants in network. Do this by first clicking on the admin
tab and select ID Registry
to issue new ids to the participants and add the ids to the wallet.
Please follow the instructions as shown in the images below:
Click on Use Now
to select the AidOrg
participant registry to perform transactions on network.
Submit CreateProjectPledge
transaction.
class": "org.global.citizens.net.CreateProjectPledge",
ame": "child care",
ecription": "child care fund",
undsRequired": 100000,
idOrg": "resource:org.global.citizens.net.AidOrg#aid"
New project pledge is created in Asset Registry.
Submit SendPledgeToGlobalCitizen
transaction to send the pledge to global citizen to get the funds for the project.
class": "org.global.citizens.net.SendPledgeToGlobalCitizen",
itizenId": "resource:org.global.citizens.net.GlobalCitizen#gc",
ledgeId": "resource:org.global.citizens.net.ProjectPledge#<ProjectPledge ID>"
Global Citizen participant registry gets update with the new pledge request.
Global Citizen reviews the pledge. After successful verification it submits aSendPledgeToGovOrg
transaction to get funds for the project pledge from government organizations.
class": "org.global.citizens.net.SendPledgeToGovOrg",
ovOrg": ["resource:org.global.citizens.net.GovOrg#gov"],
ledgeId": "resource:org.global.citizens.net.ProjectPledge#<ProjectPledge ID>"
Government organizations reviews the pledge. After reviewing if they decide to fund the project then they submit a UpdatePledge
transaction to update the project pledge asset.
class": "org.global.citizens.net.UpdatePledge",
ovOrgId": "resource:org.global.citizens.net.GovOrg#gov",
ledgeId": "resource:org.global.citizens.net.ProjectPledge#<ProjectPledge ID>",
undingType": "WEEKLY",
pprovedFunding": 100000,
undsPerInstallment": 1000
Government organizations periodically sends the funds to project by submitting TransferFunds
transaction.
class": "org.global.citizens.net.TransferFunds",
ovOrgId": "resource:org.global.citizens.net.GovOrg#gov",
ledgeId": "resource:org.global.citizens.net.ProjectPledge#<ProjectPledge ID>"
Install the composer-rest-server:
install -g composer-rest-server@0.19.5
Now, let?s start up the server. Make sure you are in the same directory as your connection-profile.json
oser-rest-server -c admin@global-citizens-network -n never -w true
In your browser, go to http://localhost:3000/explorer
Now you can use the swagger api to perform operations in business network as shown in Interact using Composer-Playground