Fabric-v-1.4基础环境搭建+票据应用示例

Fabric已经发布到1.4LTS版本，各个版本对比如下：

来自：超级账本解读 https://hyperledger.mochain.info/

Fabric v1.1版本主要的新特性包括： 

Fabric CA的CRL 

区块以及交易的事件推送 

增加了所有组建间的双向TLS通信 

Node.js Chaincode链码的支持 

Chaincode API新增了creator identity 

性能相对v1.0有了明显的提升

Fabric v1.2开始有了比较大的feature开始出现： 

Private Data Collections：这个特性不得不说在隐私保护上解决了不少项目的痛点，也减少了许多项目为了隐私保护在业务层做的复杂设计。 

Service Discovery：服务发现这个特性，使得客户端拥有了更多的灵活性和可操作性，可以动态感知整个Fabric网络的变化。 

Pluggable endorsement and validation：可插拔的背书及校验机制，采用了Go Plugin机制来实现，避免了之前需要重新编译源代码的操作，提升了灵活性。

Fabric v1.3中，同样增加了十分有用的feature：

基于Identity Mixer的MSP Implementation：基于零知识证明实现的身份的匿名和不可链接，这个feature替代了v0.6版本中的T-cert。 

key-level endorsement policies：更细粒度的背书策略，细化到具体的key-value，更加灵活，不仅限于一个链码程序作背书。 

新增Java Chaincode：至此，v1.3之后支持了Go、Node.js、Java 三种Chaincode，为开发者提供了更多的选择。 

Peer channel-based event services：Channel级别的事件订阅机制，早在v1.1版本中已经亮相了，在v1.3版本中正式发布，至此，旧的Event Hub正式宣告弃用。

Fabric v1.4是一个里程碑式的版本，是首个LTS的版本（Long Term Support的版本）：

可操作性和可维护性的提升： 

开放日志级别设置的接口 

开放节点健康状态的检查接口 

开放节点数据指标的收集接口 

改进了Node SDK的编程模型，简化开发者的代码复杂度，使得SDK更加易用 

Private Data的增强： 

对于后续添加的允许访问节点能够获取之前的隐私数据 

添加客户端层面的隐私数据的权限控制，不需要添加链码逻辑。

这里作一个更新，新建Centos7.4的虚拟机环境。大致搭建过程如下。

实验环境

云主机：Centos 7.4 、CPU：4C、内存：16G，硬盘:200G。

相关前置软件安装

关闭Selinux，关闭防火墙等相关操作，相关操作网络上随处可查。

建议更新后再进行下列操作：

yum update

安装git、curl、pip

yum install git

yum install curl

yum -y install epel-release

yum install python-pip

pip install --upgrade pip

安装docker相关

yum install docker-ce

或者：yum install docker-ce.18.06.3.ce-3.el7  指定具体版本，可以先设置好yum 源（yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo）

pip install docker-compose（可能会失败，那就用以下的命令）

pip install docker-compose --ignore-installed requests

相关软件环境： 

安装完成后查看各个软件版本，如下图： 

注： 可能会碰到docker-compose报错：

File "/usr/lib/python2.7/site-packages/paramiko/ssh_gss.py", line 55, in <module>

GSS_EXCEPTIONS = (gssapi.GSSException,)

AttributeError: 'module' object has no attribute 'GSSException'

那么通过修改配置文件:/usr/lib/python2.7/site-packages/paramiko/ssh_gss.py来解决:

vi /usr/lib/python2.7/site-packages/paramiko/ssh_gss.py

53.55行修改如下解决：

53：import gssapi.error

55：GSS_EXCEPTIONS = (gssapi.error.GSSException,)

安装Golang、Node.js、npm

安装Golang 

如果单独去下载安装包麻烦的话，那么直接通过wget来下载解压，配置环境变量。

wget https://studygolang.com/dl/golang/go1.10.8.linux-amd64.tar.gz

tar -xvf go1.10.8.linux-amd64.tar.gz

配置环境变量。修改/etc/profile文件,路径根据下载安装路径来。

vim /etc/profile

添加

export GOROOT=/usr/go

export GOPATH=/usr/gopath

export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

安装Node.js

wget https://npm.taobao.org/mirrors/node/v11.0.0/node-v11.0.0.tar.gz

tar -xvf node-v11.0.0.tar.gz

解压后进入Node文件夹：

yum install gcc gcc-c++

完成后gcc -v,这时候会发现gcc为4.8.5 建议更新：

wget http://ftp.gnu.org/gnu/gcc/gcc-7.3.0/gcc-7.3.0.tar.gz

更新完成后，解压gcc，并安装：

tar -xvf gcc-7.3.0.tar.gz

进入gcc-7.3.0目录执行：

./contrib/download_prerequisites

mkdir 一个新的目录

进入该目录 cd 目录

../configure --enable-checking=release --enable-languages=c,c++ --disable-multilib

make (请耐心等待，我这里大概等待了2个多小时。。。)

make install

建议重启后再进行之后的操作

重启后看到gcc版本为7.3.0 

安装Node.js

进入Node.js文件夹(这里可能有一个文件夹名的问题，建议修改node7.3.0文件夹名直接为node)

./configure

make （耐心等待）

make install

建议重启后再进行之后的操作

安装npm

npm install npm -g

完成上述操作后，查看各软件版本：

安装Fabric

首先下载Fabric源码，我们在go/src目录下新建文件夹。

mkdir -p github.com/hyperledger

进入该文件夹执行：

git clone https://github.com/hyperledger/fabric.git (耐心等待)

完成后进入 fabric/scripts文件夹，可以看到bootstrap.sh脚本，cat该脚本可以看到fabric版本为1.4.0：

执行bootstrap.sh脚本，自动进行fabric相关镜像的下载,耐心等待

./bootstrap.sh

镜像下载完成后如图： 

通过Fabric-samples提供的BYFN(build your first network)构建网络。

./byfn.sh -m generate -c jackychannel（自定义名字）

过程很快，完成后如图： 

启动网络：

./byfn.sh -m up -c jackychannel

启动后如图： 

完成后如图： 

这个时候出现4个peer节点，通过top命令可以清楚看到： 

注： 关闭命令：./byfn.sh -m down

启动网络服务后会启动排序服务节点、4个Peer节点，以及1个命令行容器cli。

搭建完成后功能测试

上述步骤完成后，可是去看下一些基本的操作和命令。

/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/first-network/channel-artifacts目录中,可称为创世区块目录（目录根据每个人的配置）

可以看到下列文件：

Org1MSPanchors.tx、Org2MSPanchors.tx,两个锚节点配置。 

channel.tx，生成通道配置文件。 

genesis.block，创世区块文件。

/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/first-network/crypto-config目录中，可称为证书目录（目录根据每个人的配置）

该目录存放生成排序服务节点和Peer节点的MSP证书文件，如图： 

使用docker命令查看运行中的镜像：

docker ps

结果如图： 

进入cli来进行一些简单的操作：

docker exec -it cli bash

切换到容器内做一个简单的查询：

peer chaincode query -C jackychannel(刚设置启动的名称) -n mycc -c '{"Args":["query","a"]}'

结果会看到90余额。

票据应用测试

在Fabric官网文档中有一个商业票据的例子，这里简单进行了测试。(停止Fabric网络服务后再进行以下操作。)

两个组织：MagnetoCorp、DigiBank， 

票据网络：PaperNet。

进入该目录启动基本网络：

/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/basic-network

./start.sh

启动完成后查看：docker ps 会出现4个运行中容器。

使用：docker network inspect net_basic命令查看docker网络： 

进入以下目录，启动：

cd commercial-paper/organization/magnetocorp/configuration/cli/

./monitordocker.sh net_basic

出现下图： 

另外开一个终端连接到服务器，在之前目录下，创建MagnetoCorp公司特定的docker容器。

cd commercial-paper/organization/magnetocorp/configuration/cli/

docker-compose -f docker-compose.yml up -d cliMagnetoCorp

再输入：docker ps 可以看到fabric-tools：3f078207c01a已加入网络中： 

MagnetoCorp 管理员通过fabric-tools：3f078207c01a来进行操作。

接下来看下智能合约： 

进入以下目录：

cd /usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/magnetocorp/contract/lib

该目录下三个文件，其中papercontract.js为商业票据的智能合约。可以cat看下具体内容，这里暂不展开。

执行如下部署合约代码：

docker exec cliMagnetoCorp peer chaincode install -n papercontract -v 0 -p /opt/gopath/src/github.com/contract -l node

实例化智能合约：

docker exec cliMagnetoCorp peer chaincode instantiate -n papercontract -v 0 -l node -c '{"Args":["org.papernet.commercialpaper:instantiate"]}' -C mychannel -P "AND ('Org1MSP.member')"

输入如下： 

之前打开的终端中会有输出，也就是logsout容器的中的日志输出内容，具体如下： 

再次docker ps就可以看到：dev-peer0.org1.example.com-papercontract-0，说明此容器是peer0.org1.example.com节点启动的，且正在运行的papercontract链码版本为0。 

MagnetoCorp Application进行票据发行:

过程图： 

MagnetoCorp的Isabella发起整个交易过程。

进入以下目录：

cd /usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/magnetocorp/application

可以看到下列文件: 

eslintrc.js、issue.js、package.json、addToWallet.js、node_modules

node addToWallet.js

在执行上述命令的时候，强烈建议先进行如下操作：这几个坑一般都存在~~

修改package.json文件

vi package.json

把里面1.0.0版本改成1.4.0

npm install（如报错执行下列命令）

npm install --unsafe-perm fabric-network

如有：Error: /lib64/libstdc++.so.6: version `CXXABI_1.3.9' not found 报错那么执行下列命令：

find / -name "libstdc++.so.6*

找到文件的指定目录，笔者这里是6.0.24，复制到/lib64目录、删除之前的libstdc++.so.6文件，执行如下命令链接：

ln -s libstdc++.so.6.0.24 libstdc++.so.6

再删除之前的node_modules文件夹，再次执行：

npm install（如报错执行下列命令）

npm install --unsafe-perm fabric-network

node addToWallet.js

这个时候正常的话会出现done，如图： 

查看钱包的结构：

ll ../identity/user/isabella/wallet/

ll ../identity/user/isabella/wallet/User1\@org1.example.com

结果如下图： 

Isabella钱包信息: 

用户私钥：c75bd6911aca808941c3557ee7c97e90f3952e379497dc55eb903f31b50abc83-priv 

用户公钥：c75bd6911aca808941c3557ee7c97e90f3952e379497dc55eb903f31b50abc83-pub 

用户证书文件：User1@org1.example.com

发起交易： 

Isabella现在可以使用issue.js来提交一个交易（发行MagnetoCorp 公司的商业票据00001）

node issue.js

结果如图： 

以上操作都是在MagnetoCorp的Isabella，接下来是，DigiBank-Balaji ，他将购买刚刚发行的商业票据。

购买流程图： 

进入下列目录：

/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/digibank/configuration/cli

执行：docker-compose -f docker-compose.yml up -d cliDigiBank

结果如图： 

cd /usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/digibank/application

vi buy.js

buy.js文件可查看合约内容.

和之前npm的操作一样、修改相关文件内容：

修改package.json文件

vi package.json

把里面1.0.0版本改成1.4.0

npm install（如报错执行下列命令）

npm install --unsafe-perm fabric-network

创建账户及购买，商业票据00001生命周期的最后一个交易是redeem交易，Balaji 通过运行redeem.js程序来实现这一过程。

node addToWallet.js

node buy.js

node redeem.js

在执行过程中可能会出现： 

那么执行：

npm install -g js-yaml

结果如图： 

整个实验大致完成。（未完待续）

参考文章： 

1.https://www.jianshu.com/p/cb032c42c909 

2.https://blog.csdn.net/ASN_forever/article/details/87859346 

3.https://hyperledger-fabric.readthedocs.io/en/latest/