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