Hyperledger Composer使用

内存要求：

To run Hyperledger Composer and Hyperledger Fabric, we recommend you have at least 4Gb of memory.

 

开发工具：

Operating Systems: Ubuntu Linux 14.04 / 16.04 LTS (both 64-bit), or Mac OS 10.12

Docker Engine: Version 17.03 or higher

Docker-Compose: Version 1.8 or higher

Node: 8.9 or higher (note version 9 is not supported)

npm: v5.x

git: 2.9.x or higher

Python: 2.7.x

 

如果系统是Ubuntu，可以使用以下命令安装相应工具：

$ curl -O https://hyperledger.github.io/composer/prereqs-ubuntu.sh

$ chmod u+x prereqs-ubuntu.sh

$ ./prereqs-ubuntu.sh

 

开发环境

CLI tools：

$ npm install -g composer-cli

REST Server：

$ npm install -g composer-rest-server

generating application assets：

$ npm install -g generator-hyperledger-composer

Yeoman：

$ npm install -g yo

 

浏览器应用(可选)：

$ npm install -g composer-playground

启动composer-playground：

$ composer-playground

 

安装Hyperledger Fabric

$ mkdir ~/fabric-tools && cd ~/fabric-tools

$ curl -O https://raw.githubusercontent.com/hyperledger/composer-tools/master/packages/fabric-dev-servers/fabric-dev-servers.tar.gz

$ tar -zxvf fabric-dev-servers.tar.gz

下载本地Hyperledger Fabric runtime：

$ ./downloadFabric.sh

启动Hyperledger Fabric

$ ./startFabric.sh

生成PeerAdmin card

$ ./createPeerAdminCard.sh

 

======================================================================

Start a clean Hyperledger Fabric by running the following commands:

$ cd ~/fabric-tools

$ ./stopFabric.sh

#$ ./teardownFabric.sh

#$ ./downloadFabric.sh

$ ./startFabric.sh

 

Delete any business network cards that may exist in your wallet. It is safe to ignore any errors that state that the business network cards cannot be found:

$ composer card delete -n PeerAdmin@fabric-network

$ composer card delete -n admin@tutorial-network

======================================================================

 

Step 1: Creating a business network structure.

1、Create a skeleton business network using Yeoman

$ yo hyperledger-composer:businessnetwork

2、Enter tutorial-network for the network name, and desired information for description, author name, and author email.

3、Select Apache-2.0 as the license.

4、Select org.acme.biznet as the namespace.

 

Step 2: Defining a business network

1、Open the org.acme.biznet.cto model file.

2、Replace the contents with the following:

/**

 * My commodity trading network

 */

namespace org.acme.biznet

asset Commodity identified by tradingSymbol {

    o String tradingSymbol

    o String description

    o String mainExchange

    o Double quantity

    --> Trader owner

}

participant Trader identified by tradeId {

    o String tradeId

    o String firstName

    o String lastName

}

transaction Trade {

    --> Commodity commodity

    --> Trader newOwner

}

3、save

 

1、Open the logic.js script file.

2、Replace the contents with the following:

/**

 * Track the trade of a commodity from one trader to another

 * @param {org.acme.biznet.Trade} trade - the trade to be processed

 * @transaction

 */

function tradeCommodity(trade) {

    trade.commodity.owner = trade.newOwner;

    return getAssetRegistry('org.acme.biznet.Commodity')

        .then(function (assetRegistry) {

            return assetRegistry.update(trade.commodity);

        });

}

3、save

 

1、Create a permissions.acl file in the tutorial-network directory.

2、Add the following access control rules to permissions.acl:

/**

 * Access control rules for tutorial-network

 */

rule Default {

    description: "Allow all participants access to all resources"

    participant: "ANY"

    operation: ALL

    resource: "org.acme.biznet.*"

    action: ALLOW

}

 

rule SystemACL {

  description:  "System ACL to permit all access"

  participant: "ANY"

  operation: ALL

  resource: "org.hyperledger.composer.system.**"

  action: ALLOW

}

3、save

 

Step 3: Generate a business network archive

1、Using the command line, navigate to the tutorial-network directory.

2、From the tutorial-network directory, run the following command:

$ composer archive create -t dir -n .

会生成 [e-mail] 文件

 

Step 4: Building a connection profile

1、Create a connection profile file called connection.json.

2、example

{

  "name": "fabric-network",

  "type": "hlfv1",

  "mspID": "Org1MSP",

  "peers": [

      {

          "requestURL": "grpc://localhost:7051",

          "eventURL": "grpc://localhost:7053"

      }

  ],

  "ca": {

      "url": "http://localhost:7054",

      "name": "ca.org1.example.com"

  },

  "orderers": [

      {

          "url" : "grpc://localhost:7050"

      }

  ],

  "channel": "composerchannel",

  "timeout": 300

}

3、save

 

Step 5: Locating the certificate and private key for the Hyperledger Fabric administrator

为方便操作，可将以下文件拷贝到同一个目录

文件1：connection.json

文件2：[e-mail] 位置(~/fabric-tools/fabric-scripts/hlfv1/composer/crypto-config/peerOrganizations/org1.example.com/users/[e-mail]/msp/signcerts/[e-mail])

文件3：xxxx_sk 位置(~/fabric-tools/fabric-scripts/hlfv1/composer/crypto-config/peerOrganizations/org1.example.com/users/[e-mail]/msp/keystore/114aab0e76bf0c78308f89efc4b8c9423e31568da0c340ca187a9b17aa9a4457_sk)

 

Step 6: Creating a business network card for the Hyperledger Fabric administrator

$ composer card create -p connection.json -u PeerAdmin -c [e-mail] -k 114aab0e76bf0c78308f89efc4b8c9423e31568da0c340ca187a9b17aa9a4457_sk -r PeerAdmin -r ChannelAdmin

会生成[e-mail]文件

 

 

Step 7: Importing the business network card for the Hyperledger Fabric administrator

$ composer card import -f [e-mail]

 

Step 8: Installing the Hyperledger Composer runtime onto the Hyperledger Fabric peer nodes

即：Install Chaincode

$ composer runtime install -c PeerAdmin@fabric-network -n tutorial-network

 

Step 9: Starting the blockchain business network

即：Instantiate Chaincode

$ composer network start -c PeerAdmin@fabric-network -a [e-mail] -A admin -S adminpw

会生成[e-mail]文件

 

Step 10: Importing the business network card for the business network administrator

$ composer card import -f [e-mail]

 

Step 11: Testing the connection to the blockchain business network

$ composer network ping -c admin@tutorial-network

 

Step 12: Generating a REST server

1、To create the REST API, navigate to the tutorial-network directory and run the following command:

$ composer-rest-server

2、Enter admin@tutorial-network as the card name.

3、Select never use namespaces when asked whether to use namespaces in the generated API.

4、Select No when asked whether to secure the generated API.

5、Select Yes when asked whether to enable event publication.

6、Select No when asked whether to enable TLS security.

 

=====================================================================

Appendix: destroy a previous setup

$ docker kill $(docker ps -q)

$ docker rm $(docker ps -aq)

$ docker rmi $(docker images dev-* -q)

=====================================================================

 

=====================================================================

After changing the files in a business network, the business network must be repackaged as a business network archive (.bna) and redeployed to the Hyperledger Fabric instance.

Regenerate your business network archive

$ composer archive create --sourceType dir --sourceName . -a [e-mail]

 

Deploy the updated business network definition

$ composer network update -a [e-mail] -c admin@tutorial-network

 

Test that the network is deployed

$ composer network ping -c admin@tutorial-network

=====================================================================