• Fabric CA 相关
      • Enroll用户
      • Register用户
    • Channel 相关
      • 创建Channel
      • 将指定Peer join Channel
      • 查询Channel相关信息
      • 动态更新Channel配置信息
    • Chaincode 相关
      • Instantiate Chaincode
      • Invoke Chaincode
      • Query Chaincode
      • 查询Chaincode相关信息
    • Node v8.9.0 或更高 (注意目前v9.0+还不支持)
    • npm v5.5.1 或更高
    • gulp命令。 必须要进行全局安装 npm install -g gulp
    • docker运行环境
    • docker compose工具

    主要fabric环境可参考。

    下载 Demo 工程

    进入 Hyperledger-fabric-node-sdk-demo 目录,查看各文件夹和文件,功能如下。

    该项目提供两种Demo构建方式:

    • 利用本地已经准备好的相关网络资源,启动fabric network。
    • 利用官方fabric-sample项目,动态启动fabric network。

    当然,你也可以使用自己已经创建好的fabric network和其相关的connection-profile来测试Demo。

    1. ##进入项目根目录
    2. ##使用本地资源构建Demo
    3. ./Init.sh local
    4. ##使用官方资源构建Demo
    5. ./Init.sh remote

    执行之后,会在根目录中生成一个文件夹,其就是Demo程序的入口。

    启动Fabric网络

    首先,我们需要准备一个fabric网络来进行测试。进入到demo文件夹。

    本地资源构建网络

    进入资源目录,利用脚本启动网络即可。

    用该脚本启动网络中包含:1个orderer, 2个organisation, 4个peer(每个组织有2个peer)和两个ca(每个组织一个)。

    官方资源构建网络

    在demo目录,利用脚本启动网络即可。

    1. ./net.sh init
    2. ##关闭网络并清理资源
    3. ./net.sh clean

    用该脚本启动网络中包含:1个orderer, 2个organisation, 4个peer(每个组织有2个peer)和两个ca(每个组织一个)。

    • 将官方fabric-sample项目clone到本地
    • 利用fabric-sample/first-network/bynf.sh up启动fabric脚本
    • 将一些资源文件连接到指定位置,方便node程序使用
    • 通过资源文件构建connection-profile(替换密钥等)
    • 创建一个新的channel的binary

    详细信息可以直接查看net.sh脚本。

    资源清单

    无论是remote还是local模式,最终资源和网络准备完成之后,核心资源列表如下:

    网络和相关资源准备成功之后,进入demo/node目录。其主要结构为:

    1. ├── api-handler.js //接口定义文件
    2. ├── *.js //应用实现模块
    3. ├── tools //通用工具类
    4. ├── ca-tools.js
    5. ├── config-tool.js
    6. └── helper.js
    7. ├── app-test.js //Demo程序启动文件
    8. ├── package.json
    9. └── readme.md

    使用命令node app-test.js即可进行一个完整workflow的测试,包括最开始我们提到的所有功能。同时可以使用来运行单个功能。

    持续更新

    如果在使用途中发现任何问题,或者有任何需求可以在该项目的issue中提出改进方案或者建议。Github地址: