Skip to content

Latest commit

 

History

History
1727 lines (1262 loc) · 62.1 KB

README.md

File metadata and controls

1727 lines (1262 loc) · 62.1 KB
Raw

FISCO BCOS区块链操作手册

FISCO-BCOS Manual

前言

本文档是FISCO BCOS区块链开源平台的一部分。 FISCO BCOS平台是金融区块链合作联盟（深圳）（以下简称：金链盟）开源工作组以金融业务实践为参考样本，在BCOS开源平台基础上进行模块升级与功能重塑，深度定制的安全可控、适用于金融行业且完全开源的区块链底层平台。

金链盟开源工作组获得金链盟成员机构的广泛认可，并由专注于区块链底层技术研发的成员机构及开发者牵头开展工作。其中首批成员包括以下单位（排名不分先后）：博彦科技、华为、深证通、神州数码、四方精创、腾讯、微众银行、越秀金科。

FISCO BCOS平台基于现有的BCOS开源项目进行开发，聚焦于金融行业的分布式商业需求，从业务适当性、性能、安全、政策、技术可行性、运维与治理、成本等多个维度进行综合考虑，打造金融版本的区块链解决方案。

为了让大家更好的了解FISCO BCOS区块链开源平台的使用方法。本文档按照Step By Step的步骤详细介绍了FISCO BCOS区块链的构建、安装、启动，智能合约部署、调用等初阶用法，还包括多节点组网、系统合约等高阶内容的介绍。

本文档不介绍FISCO BCOS区块链设计理念及思路，详情请参看白皮书。

以下代码及操作命令以在Centos7.2/Ubuntu 16.04操作系统上为示例。

第一章 部署FISCO BCOS环境

本章主要介绍FISCO BCOS区块链环境的部署。包括机器配置，部署软件环境和编译源码。

1.1 机器配置

配置 最低配置 推荐配置
CPU 1.5GHz 2.4GHz
内存 1GB 4GB
核心 2核 4核
带宽 1Mb 5Mb
操作系统 CentOS （7.2 64位）或Ubuntu（16.04 64位）
JAVA Java(TM) 1.8 && JDK 1.8

1.2 部署软件环境

1.2.1 安装依赖包

Centos安装
#安装依赖包
sudo yum install -y git openssl openssl-devel deltarpm cmake3 gcc-c++
#安装nodejs
sudo yum install -y nodejs
sudo npm install -g cnpm --registry=https://registry.npm.taobao.org
sudo cnpm install -g babel-cli babel-preset-es2017 ethereum-console
echo '{ "presets": ["es2017"] }' > ~/.babelrc
Ubuntu安装
#安装依赖包
sudo apt-get -y install git openssl libssl-dev libkrb5-dev cmake
#安装nodejs(注意： nodejs需要大于6以上的版本,ubuntu上面apt-get安装的默认版本为4.x版本,需要自己升级)
sudo apt-get -y install nodejs-legacy
sudo apt-get -y install npm
sudo npm install -g secp256k1
sudo npm install -g cnpm --registry=https://registry.npm.taobao.org
sudo cnpm install -g babel-cli babel-preset-es2017 ethereum-console
echo '{ "presets": ["es2017"] }' > ~/.babelrc

1.2.2 安装FISCO BCOS的智能合约编译器

下载对应平台的solidity编译器, 直接下载后放入系统目录下。

[ubuntu]：
    wget https://github.com/FISCO-BCOS/solidity/releases/download/v0.4.11/fisco-solc-ubuntu
    sudo cp fisco-solc-ubuntu  /usr/bin/fisco-solc
    sudo chmod +x /usr/bin/fisco-solc
    
    
[centos]：
    wget https://github.com/FISCO-BCOS/solidity/releases/download/v0.4.11/fisco-solc-centos
    sudo cp fisco-solc-centos  /usr/bin/fisco-solc
    sudo chmod +x /usr/bin/fisco-solc

1.3 编译源码

1.3.1 获取源码

假定在/mydata/下获取源码：

#生成mydata目录
sudo mkdir -p /mydata
sudo chmod 777 /mydata
cd /mydata

#clone源码
git clone https://github.com/FISCO-BCOS/FISCO-BCOS.git

#切换到源码根目录
cd FISCO-BCOS

源码目录说明请参考附录：12.1 源码目录结构说明

1.3.2 安装编译依赖

根目录下执行（若执行出错，请参考常见问题1）：

chmod +x scripts/install_deps.sh
./scripts/install_deps.sh

1.3.3 编译

mkdir -p build
cd build/

[Centos] 
cmake3 -DEVMJIT=OFF -DTESTS=OFF -DMINIUPNPC=OFF ..  #注意命令末尾的..
[Ubuntu] 
cmake  -DEVMJIT=OFF -DTESTS=OFF -DMINIUPNPC=OFF ..  #注意命令末尾的..

make

若编译成功，则生成build/eth/fisco-bcos。

1.3.4 安装

sudo make install

第二章 准备链环境

FISCO-BCOS网络采用面向CA的准入机制，保障信息保密性、认证性、完整性、不可抵赖性。

一条链拥有一个链证书及对应的链私钥，链私钥由链管理员拥有。并对每个参与该链的机构签发机构证书，机构证书私钥由机构管理员持有，并对机构下属节点签发节点证书。节点证书是节点身份的凭证，并使用该证书与其他节点间建立SSL连接进行加密通讯。

因此，需要生成链证书、机构证书、节点证书。生成方法如下：

2.1 生成链证书

cd /mydata/FISCO-BCOS/cert/
chmod +x *.sh
./chain.sh  #会提示输入相关证书信息，默认可以直接回车

/mydata/FISCO-BCOS/cert/ 目录下将生成链证书相关文件。

注意：ca.key 链私钥文件请妥善保存

2.2 生成机构证书

假设机构名为WB

cd /mydata/FISCO-BCOS/cert/
./agency.sh WB #会提示输入相关证书信息，默认可以直接回车
#如需要生成多个机构，则重复执行 ./agency.sh 机构名称  即可

/mydata/FISCO-BCOS/cert/ 目录下将生成机构目录WB。WB目录下将有机构证书相关文件。

注意：agency.key 机构私钥文件请妥善保存

2.3 生成节点证书

假设为机构WB下的节点nodedata-1生成节点证书，则：

cd /mydata/FISCO-BCOS/cert/
./node.sh WB nodedata-1 #会提示输入相关证书信息，默认可以直接回车
#如需要生成多个节点，则重复执行 ./node.sh 机构名称 节点名称 即可

/mydata/FISCO-BCOS/cert/WB/ 目录下将生成节点目录nodedata-1。nodedata-1目录下将有该节点所属的机构相关证书和链相关证书。

注意：node.key 机构私钥文件请妥善保存

2.4 生成SDK证书

cd /mydata/FISCO-BCOS/cert/
./sdk.sh WB sdk

/mydata/FISCO-BCOS/cert/WB/ 目录下将生成sdk目录，并将所生成的sdk目录下所有文件拷贝到SDK端的证书目录下。

注意：sdk.key SDK私钥文件请妥善保存

2.5 证书说明

/mydata/FISCO-BCOS/cert/WB/nodedata-1目录下文件是节点nodedata-1运行时必备文件。其中：

ca.crt: 链证书

agency.crt: 机构证书

node.crt:节点证书

node.key: 节点私钥

node.nodeid: 节点身份NodeId

node.serial: 节点证书序列号

node.json: 节点注册文件，应用于系统合约

node.ca: 节点证书相关信息，应用于系统合约

第三章 创建创世节点

创世节点是区块链中的第一个节点，搭建区块链，从创建创世节点开始。

3.1 创建节点环境

假定创世节点目录为/mydata/nodedata-1/，创建节点环境如下：

#创建目录结构
mkdir -p /mydata/nodedata-1/
mkdir -p /mydata/nodedata-1/data/ #存放节点的各种文件
mkdir -p /mydata/nodedata-1/log/ #存放日志
mkdir -p /mydata/nodedata-1/keystore/ #存放账户秘钥

#拷贝相关文件
cd /mydata/FISCO-BCOS/ 
cp genesis.json config.json log.conf start.sh stop.sh /mydata/nodedata-1/

3.2 配置god账号

god账号是区块链的最高权限，在启动区块链前必须配置。

3.2.1 生成god账号

cd /mydata/FISCO-BCOS/web3lib
cnpm install #安装nodejs依赖, 在执行nodejs脚本之前, 该命令在该目录需要执行一次, 之后不需要再执行。
cd /mydata/FISCO-BCOS/tool #代码根目录下的tool文件夹
cnpm install #安装nodejs包，仅需运行一次，之后若需要再次在tool目录下使用nodejs，不需要重复运行此命令
node accountManager.js > godInfo.txt
cat godInfo.txt |grep address

可得到生成god账号的地址如下。godInfo.txt请妥善保存。

address : 0x27214e01c118576dd5f481648f83bb909619a324

3.2.2 配置god账号

将上述步骤生成的god的address配置入genesis.json的god字段：

vim /mydata/nodedata-1/genesis.json

修改后，genesis.json中的god字段如下：

"god":"0x27214e01c118576dd5f481648f83bb909619a324",

3.3 配置节点身份

NodeId唯一标识了区块链中的某个节点，在节点启动前必须进行配置。

3.3.1 生成节点身份文件

使用2.3 节点证书 生成对应节点证书。并将其拷贝到节点数据目录下。

cp /mydata/FISCO-BCOS/cert/WB/nodedata-1/*  /mydata/nodedata-1/data/

3.3.2 配置创世节点NodeId

（1）查看NodeId

cat /mydata/nodedata-1/data/node.nodeid

得到如下类似的NodeId

2cd7a7cadf8533e5859e1de0e2ae830017a25c3295fb09bad3fae4cdf2edacc9324a4fd89cfee174b21546f93397e5ee0fb4969ec5eba654dcc9e4b8ae39a878

（2）修改genesis.json

将NodeId配置入genesis.json的initMinerNodes字段，即指定此NodeId的节点为创世节点。

vim /mydata/nodedata-1/genesis.json

修改后，genesis.json中的initMinerNodes字段如下：

"initMinerNodes":["2cd7a7cadf8533e5859e1de0e2ae830017a25c3295fb09bad3fae4cdf2edacc9324a4fd89cfee174b21546f93397e5ee0fb4969ec5eba654dcc9e4b8ae39a878"]

3.4 配置连接列表文件

节点启动时需要发起对网络中其他节点的连接请求，因此需要配置其他节点的连接信息，因为此时网络并无其他节点，因此配置为节点自身即可，可以拷贝默认bootstrapnodes.json文件即可。 建议此处的IP配置为节点所在的真实IP。

cp /mydata/FISCO-BCOS/bootstrapnodes.json /mydata/nodedata-1/data

格式如下：

{"nodes":[{"host":"127.0.0.1","p2pport":"30303"}]}

其中host为节点IP或者域名，p2pport为节点p2p端口。

3.5 配置相关配置文件

节点的启动依赖以下配置文件：

  • 创世块文件：genesis.json
  • 节点配置文件：config.json
  • 日志配置文件：log.conf
  • 连接节点文件：bootstrapnodes.json
  • 节点身份证书文件：2.5 证书说明所列文件

3.5.1 配置genesis.json（创世块文件）

genesis.json中配置创世块的信息，是节点启动必备的信息。

vim /mydata/nodedata-1/genesis.json

主要配置god和initMinerNodes字段，在之前的步骤中已经配置好，配置好的genesis.json如下：

{
     "nonce": "0x0",
     "difficulty": "0x0",
     "mixhash": "0x0",
     "coinbase": "0x0",
     "timestamp": "0x0",
     "parentHash": "0x0",
     "extraData": "0x0",
     "gasLimit": "0x13880000000000",
     "god":"0x27214e01c118576dd5f481648f83bb909619a324",
     "alloc": {},
     "initMinerNodes":["2cd7a7cadf8533e5859e1de0e2ae830017a25c3295fb09bad3fae4cdf2edacc9324a4fd89cfee174b21546f93397e5ee0fb4969ec5eba654dcc9e4b8ae39a878"]
}

genesis.json其它字段说明请参看附录：12.3 genesis.json说明

3.5.2 配置config.json（节点配置文件）

config.json中配置节点的各种信息，包括网络地址，文件目录，节点身份等。

vim /mydata/nodedata-1/config.json

配置节点的信息，主要修改字段：

  • 网络连接相关：listenip、rpcport、p2pport、channelPort #需要注意端口不被占用，建议此处的listenip配置为节点所在的真实IP
  • 目录相关：wallet、keystoredir、datadir、logconf #默认节点当前目录即可

config.json其它字段说明请参看附录：12.4 config.json说明

配置好的config.json如下：

{
        "sealEngine": "PBFT",
        "systemproxyaddress":"0x0",
        "listenip":"127.0.0.1",
        "cryptomod":"0",
        "rpcport": "8545",
        "p2pport": "30303",
        "channelPort": "30304",
        "wallet":"./data/keys.info",
        "keystoredir":"./data/keystore/",
        "datadir":"./data/",
        "vm":"interpreter",
        "networkid":"12345",
        "logverbosity":"4",
        "coverlog":"OFF",
        "eventlog":"ON",
        "statlog":"OFF",
        "logconf":"./log.conf"
}

3.5.3 配置log.conf（日志配置文件）

log.conf中配置节点日志生成的格式和路径。一般使用默认即可。

vim /mydata/nodedata-1/log.conf

主要配置日志文件的生成路径，配置好的log.conf 如下：

* GLOBAL:  
    ENABLED                 =   true  
    TO_FILE                 =   true  
    TO_STANDARD_OUTPUT      =   false  
    FORMAT                  =   "%level|%datetime{%Y-%M-%d %H:%m:%s:%g}|%msg"   
    FILENAME                =   "./log/log_%datetime{%Y%M%d%H}.log"  
    MILLISECONDS_WIDTH      =   3  
    PERFORMANCE_TRACKING    =   false  
    MAX_LOG_FILE_SIZE       =   209715200 ## 200MB - Comment starts with two hashes (##)
    LOG_FLUSH_THRESHOLD     =   100  ## Flush after every 100 logs
      
* TRACE:  
    ENABLED                 =   true
    FILENAME                =   "./log/trace_log_%datetime{%Y%M%d%H}.log"  
      
* DEBUG:  
    ENABLED                 =   true
    FILENAME                =   "./log/debug_log_%datetime{%Y%M%d%H}.log"  

* FATAL:  
    ENABLED                 =   true  
    FILENAME                =   "./log/fatal_log_%datetime{%Y%M%d%H}.log"
      
* ERROR:  
    ENABLED                 =   true
    FILENAME                =   "./log/error_log_%datetime{%Y%M%d%H}.log"  
      
* WARNING: 
     ENABLED                 =   true
     FILENAME                =   "./log/warn_log_%datetime{%Y%M%d%H}.log"
 
* INFO: 
    ENABLED                 =   true
    FILENAME                =   "./log/info_log_%datetime{%Y%M%d%H}.log"  
      
* VERBOSE:  
    ENABLED                 =   true
    FILENAME                =   "./log/verbose_log_%datetime{%Y%M%d%H}.log"

log.conf其它字段说明请参看附录：12.5 log.conf说明

3.6 启动创世节点

节点的启动依赖下列文件，在启动前，请确认文件已经正确的配置：

  • 节点证书身份文件（/mydata/nodedata-1/data）：ca.crt、agency.crt、node.crt、node.key、node.private
  • 配置文件（/mydata/nodedata-1/）：genesis.json、config.json、log.conf
  • 连接文件（/mydaata/nodedata-1/data/）：bootstrapnodes.json

启动节点

cd /mydata/nodedata-1/
chmod +x *.sh
./start.sh
#若需要退出节点
#./stop.sh

或手动启动

cd /mydata/nodedata-1/
fisco-bcos --genesis ./genesis.json --config ./config.json & #启动区块链节点
tail -f log/info* |grep ++++  #查看日志输出
#若需要退出节点
#ps -ef |grep fisco-bcos #查看进程号
#kill -9 13432 #13432是查看到的进程号

几秒后可看到不断刷出打包信息。

INFO|2017-12-12 17:52:16:877|+++++++++++++++++++++++++++ Generating seal ondcae019af78cf04e17ad908ec142ca4e25d8da14791bda50a0eeea782ebf3731#1tx:0,maxtx:1000,tq.num=0time:1513072336877
INFO|2017-12-12 17:52:17:887|+++++++++++++++++++++++++++ Generating seal on3fef9b23b0733ac47fe5385072f80fc036b7517abae0a3e7762739cc66bc7dca#1tx:0,maxtx:1000,tq.num=0time:1513072337887
INFO|2017-12-12 17:52:18:897|+++++++++++++++++++++++++++ Generating seal onb5b38c7a380b13b2e46fecbdca0fac5473f4cbc054190e90b8bd4831faac4521#1tx:0,maxtx:1000,tq.num=0time:1513072338897
INFO|2017-12-12 17:52:19:907|+++++++++++++++++++++++++++ Generating seal on3530ff04adddd30508a4cb7421c8f3ad6421ca6ac3bb5f81fb4880fd72c57a8c#1tx:0,maxtx:1000,tq.num=0time:1513072339907

3.7 验证节点启动

3.7.1 验证进程

ps -ef |grep fisco-bcos

看到进程启动

app 19390     1  1 17:52 ?        00:00:05 fisco-bcos --genesis /mydata/nodedata-1/genesis.json --config /mydata/nodedata-1/config.json

3.7.2 查看日志输出

执行命令，查看打包信息。

tail -f /mydata/nodedata-1/log/info* |grep ++++  #查看日志输出

可看到不断刷出打包信息。

INFO|2017-12-12 17:52:16:877|+++++++++++++++++++++++++++ Generating seal ondcae019af78cf04e17ad908ec142ca4e25d8da14791bda50a0eeea782ebf3731#1tx:0,maxtx:1000,tq.num=0time:1513072336877
INFO|2017-12-12 17:52:17:887|+++++++++++++++++++++++++++ Generating seal on3fef9b23b0733ac47fe5385072f80fc036b7517abae0a3e7762739cc66bc7dca#1tx:0,maxtx:1000,tq.num=0time:1513072337887
INFO|2017-12-12 17:52:18:897|+++++++++++++++++++++++++++ Generating seal onb5b38c7a380b13b2e46fecbdca0fac5473f4cbc054190e90b8bd4831faac4521#1tx:0,maxtx:1000,tq.num=0time:1513072338897
INFO|2017-12-12 17:52:19:907|+++++++++++++++++++++++++++ Generating seal on3530ff04adddd30508a4cb7421c8f3ad6421ca6ac3bb5f81fb4880fd72c57a8c#1tx:0,maxtx:1000,tq.num=0time:1513072339907

若上述都正确输出，则表示创世节点已经正确启动！

第四章 部署合约、调用合约

智能合约是部署在区块链上的应用。开发者可根据自身需求在区块链上部署各种智能合约。

智能合约通过solidity语言实现，用fisco-solc进行编译。本章以HelloWorld.sol智能合约为例介绍智能合约的部署和调用。

4.1 配置

安装依赖环境

cd /mydata/FISCO-BCOS/web3lib
cnpm install #安装nodejs依赖, 在执行nodejs脚本之前该目录下面需要执行一次, 如果已经执行过, 则忽略。

切换到部署合约的目录下

cd /mydata/FISCO-BCOS/tool
cnpm install #该命令在该目录执行一次即可, 如果之前已经执行过一次, 则忽略。

设置区块链节点RPC端口

vim ../web3lib/config.js

仅需将proxy指向区块链节点的RPC端口即可。RPC端口在节点的config.json中查看（参考：2.5.2 配置config.json（节点配置文件））。

var proxy="http://127.0.0.1:8545";

4.2 部署合约

4.2.1 实现合约

cd /mydata/FISCO-BCOS/tool
vim HelloWorld.sol

HelloWorld.sol的实现如下：

pragma solidity ^0.4.2;
contract HelloWorld{
    string name;
    function HelloWorld(){
       name="Hi,Welcome!";
    }
    function get()constant returns(string){
        return name;
    }
    function set(string n){
        name=n;
    }
}

4.2.2 编译+部署合约

请先确认config.js已经正确指向区块链节点的RPC端口，且相应的区块链节点已经启动。

直接使用自动编译部署程序deploy.js，自动编译和部署合约：

babel-node deploy.js HelloWorld #注意后面HelloWorld后面没有".sol"

输出，可看到合约地址，部署成功：

deploy.js  ........................Start........................
Soc File :HelloWorld
HelloWorldcomplie success！
send transaction success: 0xa8c1aeed8e85cc0308341081925d3dab80da394f6b22c76dc0e855c8735da481
HelloWorldcontract address 0xa807685dd3cf6374ee56963d3d95065f6f056372
HelloWorld deploy success!

4.3 调用合约

4.3.1 编写合约调用程序

用nodejs实现，具体实现方法请直接看demoHelloWorld.js源码

vim demoHelloWorld.js

4.3.2 调用合约

执行合约调用程序

babel-node demoHelloWorld.js

可看到合约调用成功

{ HttpProvider: 'http://127.0.0.1:8545',
  Ouputpath: './output/',
  privKey: 'bcec428d5205abe0f0cc8a734083908d9eb8563e31f943d760786edf42ad67dd',
  account: '0x64fa644d2a694681bd6addd6c5e36cccd8dcdde3' }
HelloWorldcontract address:0xa807685dd3cf6374ee56963d3d95065f6f056372
HelloWorld contract get function call first :Hi,Welcome!
send transaction success: 0x6463e0ea9db6c4aff1e3fc14d9bdb86b29306def73e6d951913a522347526435
HelloWorld contract set function call , (transaction hash ：0x6463e0ea9db6c4aff1e3fc14d9bdb86b29306def73e6d951913a522347526435)
HelloWorld contract get function call again :HelloWorld!

第五章 部署系统合约

系统合约是 FISCO BCOS 区块链的重要设计思路之一，也是控制网络节点加入和退出的重要方式，每条区块链仅需部署一次系统合约。系统合约的详细介绍，请参看附录：12.7 系统合约介绍

5.1 配置

切换到部署系统合约的目录下

cd /mydata/FISCO-BCOS/systemcontract

安装依赖环境

cnpm install

设置区块链节点RPC端口

vim ../web3lib/config.js

仅需将proxy指向区块链节点的RPC端口即可。RPC端口在节点的config.json中查看（参考：2.5.2 配置config.json（节点配置文件））。

var proxy="http://127.0.0.1:8545";

5.2 部署系统合约

直接运行deploy.js部署系统合约。注意，此deploy.js与tool目录的是不同的两个文件。

babel-node deploy.js

部署成功，输出合约路由表。

#.....省略很多编译warn信息.....
SystemProxycomplie success！
send transaction success: 0x56c9e34cf559b3a9aead8694a7bda7e6b5ea4af855d5ec6ef08fadf494accf08
SystemProxycontract address 0x210a7d467c3c43307f11eda35f387be456334fed
AuthorityFiltercomplie success！
send transaction success: 0x112b6ac9a61197920b6cbe1a71d8f8d4a6c0c11cd0ae3c1107d1626691bf1c35
AuthorityFiltercontract address 0x297e397a7534464a4e7448c224aae52f9614af77
Groupcomplie success！
send transaction success: 0x1be1fb1393e3a3f37f197188ea99de0a5dd1828cc9fc24638f678528f0e30c23
Groupcontract address 0xed0a1b82649bd22d947e5c3ca0b779aac8ee5edc
TransactionFilterChaincomplie success！
send transaction success: 0x704a614b10c5682c44a11e48305bad40a0809d1fc9e178ddec1218c52e7bc9d0
TransactionFilterChaincontract address 0x60d34569bc861b40a7552f89a198a89d8c99075e
CAActioncomplie success！
send transaction success: 0x75f890777b586060c3f94dc3396f5ad86c3e10f2eb9b8350bbc838beecf50ece
CAActioncontract address 0x6fbf3bef2f757c01e0c43fc1364207c1e8a19d08
NodeActioncomplie success！
send transaction success: 0x9d26304258608de5bf1c47ecb9b2ac79f5323e6b74cef7eddef1fb9893d5e98e
NodeActioncontract address 0xb5e0d2c6f1b9f40ea21fa8698a28d1662e8afa3e
send transaction success: 0x03c86b3dcd3d564a00a709b7cd6f1902cd4111cc30c71c62728deadc6e8d7511
ConfigActioncomplie success！
send transaction success: 0xa49205ff3ad697fda75019cb2bbf541a120c146b973f8c5d50b761fd5024b795
ConfigActioncontract address 0xb1e6d5f95c9cb39a9e4e3071b3765e08c30ea281
ConsensusControlMgrcomplie success！
send transaction success: 0xcfe0a0fc77910c127d31470e38707dfe70a7fb699abce3e9261ef55a4e50997c
ConsensusControlMgrcontract address 0x3414ef5c15848a07538a2fac57c09a549036b5e3
ContractAbiMgrcomplie success！
send transaction success: 0xc1e2c4e837edda0e215ca06aaa02eecb3a954acfafd498a049b7cf6cee410f5c
ContractAbiMgrcontract address 0xac919b98301804575bd2dc676330aa8f2637f7d5
#......省略若干行...........
send transaction success: 0x2a0f5f9eeb069fe61289e8c95cb4b6cf026859cd20e38e8e47c0788609d8aad1
send transaction success: 0xcd51375a90056e92a52869c63ec153f05722ab8ee56b5ae242b9114c4838e32b
send transaction success: 0x250c0fc5f34bfb73a6bc2a858b64287aa859f12651a3798d46d7269e7305bf6f
send transaction success: 0xff3aeddb55c9ac6868df0cde04466431c7286d93baa80e3826522a2a8ad9681a
send transaction success: 0x71d484aa4a90068e409a11800e9ae5df6143dd59e0cc21a06c1a0bbba4617307
send transaction success: 0x8bd093d44c99817685d21053ed468afa8f216bc12a1c3f5fe33e5cd2bfd045c0
send transaction success: 0x5b9acaab5252bf43b111d24c7ff3adac0121c58e59636f26dbe2ca71dd4af47d
send transaction success: 0x34fb9226604143bec959d65edb0fc4a4c5b1fe5ef6eead679648c7295099ac8b
send transaction success: 0xe9cac7507d94e8759fcc945e6225c873a422a78674a79b24712ad76757472018
register TransactionFilterChain.....
send transaction success: 0x814ef74b4123f416a0b602f25cc4d49e038826cf50a6c4fbc6a402b9a363a8d9
register ConfigAction.....
send transaction success: 0xdb4aaa57b01ca7b1547324bcbeeaaeaa591bf9962ea921d5ce8845b566460776
register NodeAction.....
send transaction success: 0x2c7f43c84e52e99178a92e6a63fb69b5dedf4993f7cbb62608c74b6256241b39
register CAAction.....
send transaction success: 0xcb792f508ca890296055a53c360d68c3c46f8bf801ce73818557e406cbd0618c
register ContractAbiMgr.....
send transaction success: 0xfdc0dd551eada0648919a4c9c5ffa182d042099d73fa802cf803bebf5068aec1
register ConsensusControlMgr.....
send transaction success: 0x7f6d95e6a49a1c1de257415545afb0ec7fdd5607c427006fe14a7750246b9d75
SystemProxy address :0x9fe9648f723bff29f940b8c18fedcc9c7ed2b91f
-----------------SystemProxy route ----------------------
get 0xb33485375d208a23e897144b6244e20d9c1e83d9
0 )TransactionFilterChain=>0x60d34569bc861b40a7552f89a198a89d8c99075e,false,250
1 )ConfigAction=>0xb1e6d5f95c9cb39a9e4e3071b3765e08c30ea281,false,251
2 )NodeAction=>0xb5e0d2c6f1b9f40ea21fa8698a28d1662e8afa3e,false,252
3 )CAAction=>0x6fbf3bef2f757c01e0c43fc1364207c1e8a19d08,false,253
4 )ContractAbiMgr=>0xac919b98301804575bd2dc676330aa8f2637f7d5,false,254
5 )ConsensusControlMgr=>0x3414ef5c15848a07538a2fac57c09a549036b5e3,false,255
-----------------SystemProxy route ----------------------

上述输出内容中，重要的是系统代理合约地址，即SystemProxy合约地址。如：

SystemProxycontract address 0x210a7d467c3c43307f11eda35f387be456334fed

5.3 配置系统代理合约地址

系统代理合约，是所有系统合约的路由，通过配置系统代理合约地址（SystemProxy），才能正确调用系统合约。给个区块链节点都应配置系统代理合约地址，才能正确调用系统合约。

修改所有区块链节点的config.json。将systemproxyaddress字段配置为，上述步骤输出的SystemProxy合约地址配置。

vim /mydata/nodedata-1/config.json

配置后，config.json中的systemproxyaddress字段如下：

"systemproxyaddress":"0x210a7d467c3c43307f11eda35f387be456334fed",

重启被配置的节点：

cd /mydata/nodedata-1/
chmod +x *.sh
./stop.sh
./start.sh #执行此步骤后不断刷出打包信息，表明重启成功

自此，系统合约生效，为配置多个节点的区块链做好了准备。系统合约的详细介绍，请参看附录：12.7 系统合约介绍

第六章 创建普通节点

普通节点是区块链中除创世节点外的其它节点。

同一条链中的所有节点共用相同的genesis.json，并且节点所属机构必须都是由同一个链证书所签发。

创建普通节点的步骤与创建创世节点的步骤类似。普通节点不需要再修改genesis.json，直接复制创世节点的genesis.json节点的相应路径下即可。

6.1 创建节点环境

假定节点目录为/mydata/nodedata-2/，创建节点环境如下：

#创建目录结构
mkdir -p /mydata/nodedata-2/
mkdir -p /mydata/nodedata-2/data/ #存放节点的各种文件
mkdir -p /mydata/nodedata-2/log/ #存放日志
mkdir -p /mydata/nodedata-2/keystore/ #存放账户秘钥

#拷贝创世节点相关文件
cd /mydata/nodedata-1/ 
cp genesis.json config.json log.conf start.sh stop.sh /mydata/nodedata-2/

6.2 生成节点证书文件

同样需要为普通节点生成节点证书相关文件。

参考2.3 节点证书 生成对应节点证书。并将其拷贝到节点数据目录下。

cp /mydata/FISCO-BCOS/cert/WB/nodedata-2/*  /mydata/nodedata-2/data/

6.3 配置连接文件bootstrapnodes.json

从创世节点data目录拷贝bootstrapnodes.json文件到当前节点data目录下。

cp /mydata/nodedata-1/data/bootstrapnodes.json /mydata/nodedata-2/data/

并对bootstrapnodes.json进行编辑，填入创世节点的ip和p2pport

vim /mydata/nodedata-2/data/bootstrapnodes.json

编辑后，bootstrapnodes.json内容为

{"nodes":[{"host":"创世节点IP,如127.0.0.1","p2pport":"30303"}]}

6.4 配置节点配置文件config.json

config.json中可配置节点的各种信息，包括网络地址，数据目录等。

vim /mydata/nodedata-2/config.json

配置本节点的信息，根据需要主要以下修改字段

  • 网络连接相关：listenip、rpcport、p2pport、channelPort #需要注意端口不被占用，建议此处的listenip配置为节点所在的真实IP
  • 目录相关：wallet、keystoredir、datadir、logconf #一般使用默认当前目录即可

config.json其它字段说明请参看附录：12.4 config.json说明

配置好的config.json如下：

{
        "sealEngine": "PBFT",
        "systemproxyaddress":"0x210a7d467c3c43307f11eda35f387be456334fed",
        "listenip":"127.0.0.1",
        "cryptomod":"0",
        "rpcport": "8546",
        "p2pport": "30403",
        "channelPort": "30404",
        "wallet":"./data/keys.info",
        "keystoredir":"./data/keystore/",
        "datadir":"./data/",
        "vm":"interpreter",
        "networkid":"12345",
        "logverbosity":"4",
        "coverlog":"OFF",
        "eventlog":"ON",
        "statlog":"OFF",
        "logconf":"./log.conf"
}

6.5 配置日志文件log.conf

log.conf中配置节点日志生成的格式和路径。一般使用默认配置文件即可。

vim /mydata/nodedata-2/log.conf

主要配置日志文件的生成路径，配置好的log.conf 如下：

* GLOBAL:  
    ENABLED                 =   true  
    TO_FILE                 =   true  
    TO_STANDARD_OUTPUT      =   false  
    FORMAT                  =   "%level|%datetime{%Y-%M-%d %H:%m:%s:%g}|%msg"   
    FILENAME                =   "./log/log_%datetime{%Y%M%d%H}.log"  
    MILLISECONDS_WIDTH      =   3  
    PERFORMANCE_TRACKING    =   false  
    MAX_LOG_FILE_SIZE       =   209715200 ## 200MB - Comment starts with two hashes (##)
    LOG_FLUSH_THRESHOLD     =   100  ## Flush after every 100 logs
      
* TRACE:  
    ENABLED                 =   true
    FILENAME                =   "./log/trace_log_%datetime{%Y%M%d%H}.log"  
      
* DEBUG:  
    ENABLED                 =   true
    FILENAME                =   "./log/debug_log_%datetime{%Y%M%d%H}.log"  

* FATAL:  
    ENABLED                 =   true  
    FILENAME                =   "./log/fatal_log_%datetime{%Y%M%d%H}.log"
      
* ERROR:  
    ENABLED                 =   true
    FILENAME                =   "./log/error_log_%datetime{%Y%M%d%H}.log"  
      
* WARNING: 
     ENABLED                 =   true
     FILENAME                =   "./log/warn_log_%datetime{%Y%M%d%H}.log"
 
* INFO: 
    ENABLED                 =   true
    FILENAME                =   "./log/info_log_%datetime{%Y%M%d%H}.log"  
      
* VERBOSE:  
    ENABLED                 =   true
    FILENAME                =   "./log/verbose_log_%datetime{%Y%M%d%H}.log"

log.conf其它字段说明请参看附录：12.5 log.conf说明

6.6 启动节点

节点的启动依赖下列文件，在启动前，请确认文件已经正确的配置：

  • 节点证书身份文件（/mydata/nodedata-1/data）：ca.crt、agency.crt、node.crt、node.key、node.private
  • 配置文件（/mydata/nodedata-1/）：genesis.json、config.json、log.conf
  • 连接文件（/mydaata/nodedata-1/data/）：bootstrapnodes.json

启动节点，此时节点未被注册到区块链中，启动时只能看到进程，不能刷出打包信息。要让此节点正确的运行，请进入第七章 多节点组网 。

cd /mydata/nodedata-2/
chmod +x *.sh
./start.sh #此时节点未被注册到区块链中，等待10秒，不会刷出打包信息
ctrl-c 退出
ps -ef |grep fisco-bcos #可查看到节点进程存在

可看到进程已经在运行

app  9656     1  4 16:10 ?        00:00:01 fisco-bcos --genesis /mydata/nodedata-2/genesis.json --config /mydata/nodedata-2/config.json

关闭节点，待注册后再重启

./stop.sh

第七章 多记账节点组网

FISCO BCOS区块链中的节点，只有被注册到系统合约记账节点列表中，才能参与记账。

多节点记账组网依赖系统合约，在进行多节点记账组网前，请确认：

（1）系统合约已经被正确的部署。

（2）所有节点的config.json的systemproxyaddress字段已经配置了相应的系统代理合约地址。

（3）节点在配置了systemproxyaddress字段后，已经重启使得系统合约生效。

（4）/mydata/FISCO-BCOS/web3lib/下的config.js已经正确的配置了节点的RPC端口。

7.1 注册记账节点

所有的节点注册流程都相同。在注册节点时，被注册节点必须处于运行状态。

7.1.1 注册

在注册前，请确认已注册的所有节点，都已经启动。

每个节点的data目录下都有一个node.json注册文件,里面包含了节点相关信息。 以注册创世节点为例

cd /mydata/FISCO-BCOS/systemcontract/
babel-node tool.js NodeAction register /mydata/nodedata-1/data/node.json

可看到注册信息

{ HttpProvider: 'http://127.0.0.1:8545',
  Ouputpath: './output/',
  privKey: 'bcec428d5205abe0f0cc8a734083908d9eb8563e31f943d760786edf42ad67dd',
  account: '0x64fa644d2a694681bd6addd6c5e36cccd8dcdde3' }
Soc File :NodeAction
Func :registerNode
SystemProxy address 0x210a7d467c3c43307f11eda35f387be456334fed
node.json=node1.json
NodeAction address 0xcc46c245e6cca918d43bf939bbb10a8c0988548f
send transaction success: 0x9665417c16b636a2a83e13e82d1674e4db72943bae2095cb030773f0a0ba1eef

7.1.2 查看记账列表

查看节点是否已经在记账节点列表中

cd /mydata/FISCO-BCOS/systemcontract/
babel-node tool.js NodeAction all

可看到被注册的节点信息，节点已经加入记账列表

{ HttpProvider: 'http://127.0.0.1:8545',
  Ouputpath: './output/',
  privKey: 'bcec428d5205abe0f0cc8a734083908d9eb8563e31f943d760786edf42ad67dd',
  account: '0x64fa644d2a694681bd6addd6c5e36cccd8dcdde3' }
Soc File :NodeAction
Func :all
SystemProxy address 0x210a7d467c3c43307f11eda35f387be456334fed
NodeAction address 0xcc46c245e6cca918d43bf939bbb10a8c0988548f
NodeIdsLength= 1
----------node 0---------
id=24b98c6532ff05c2e9e637b3362ee4328c228fb4f6262c1c751f51952012cd68da2cbd8655de5072e49b950a503326942297cfaa9ca919b369be4359b4dccd56
name=A
agency=WB
caHash=A6A0371C855C5BE0
Idx=0
blocknumber=58

7.1.3 注册更多的节点

在注册更多的节点前，请确认节点都已经启动。本过程可以重复执行，注册更多节点。

cd /mydata/FISCO-BCOS/systemcontract/
babel-node tool.js NodeAction register /mydata/nodedata-2/data/node.json
cd /mydata/nodedata-2/
./start.sh #将被注册的节点启动起来，此时节点已经被注册，可刷出打包信息

再次查看记账列表：

cd /mydata/FISCO-BCOS/systemcontract/
babel-node tool.js NodeAction all

可看到输出了节点信息（node1），节点加入了记账列表

{ HttpProvider: 'http://127.0.0.1:8545',
  Ouputpath: './output/',
  privKey: 'bcec428d5205abe0f0cc8a734083908d9eb8563e31f943d760786edf42ad67dd',
  account: '0x64fa644d2a694681bd6addd6c5e36cccd8dcdde3' }
Soc File :NodeAction
Func :all
SystemProxy address 0x210a7d467c3c43307f11eda35f387be456334fed
NodeAction address 0xcc46c245e6cca918d43bf939bbb10a8c0988548f
NodeIdsLength= 2
----------node 0---------
id=24b98c6532ff05c2e9e637b3362ee4328c228fb4f6262c1c751f51952012cd68da2cbd8655de5072e49b950a503326942297cfaa9ca919b369be4359b4dccd56
name=node1
agency=WB
caHash=A6A0371C855C5BE0
Idx=0
blocknumber=58
----------node 1---------
id=b5adf6440bb0fe7c337eccfda9259985ee42c1c94e0d357e813f905b6c0fa2049d45170b78367649dd0b8b5954ee919bf50c1398a373ca777e6329bd0c4b82e8
name=node2
agency=WB
caHash=A6A0371C855C5BE1
Idx=1
blocknumber=392

7.2 节点退出记账列表

要让某节点退出记账列表，需执行以下脚本。执行时，指定相应节点的注册文件。此处让node2退出为例。

cd /mydata/FISCO-BCOS/systemcontract/
babel-node tool.js NodeAction cancel /mydata/nodedata-2/data/node.json

执行后有如下输出：

{ HttpProvider: 'http://127.0.0.1:8545',
  Ouputpath: './output/',
  privKey: 'bcec428d5205abe0f0cc8a734083908d9eb8563e31f943d760786edf42ad67dd',
  account: '0x64fa644d2a694681bd6addd6c5e36cccd8dcdde3' }
Soc File :NodeAction
Func :cancelNode
SystemProxy address 0x210a7d467c3c43307f11eda35f387be456334fed
node.json=node2.json
NodeAction address 0xcc46c245e6cca918d43bf939bbb10a8c0988548f
send transaction success: 0x031f29f9fe3b607277d96bcbe6613dd4d2781772ebd0c810a31a8d680c0c49c3

查看记账列表，看不到相应节点的信息，表示节点已经退出了记账列表。

cd /mydata/FISCO-BCOS/systemcontract/
babel-node tool.js NodeAction all
#......节点输出信息......
{ HttpProvider: 'http://127.0.0.1:8545',
  Ouputpath: './output/',
  privKey: 'bcec428d5205abe0f0cc8a734083908d9eb8563e31f943d760786edf42ad67dd',
  account: '0x64fa644d2a694681bd6addd6c5e36cccd8dcdde3' }
Soc File :NodeAction
Func :all
SystemProxy address 0x210a7d467c3c43307f11eda35f387be456334fed
NodeAction address 0xcc46c245e6cca918d43bf939bbb10a8c0988548f
NodeIdsLength= 1
----------node 0---------
id=2cd7a7cadf8533e5859e1de0e2ae830017a25c3295fb09bad3fae4cdf2edacc9324a4fd89cfee174b21546f93397e5ee0fb4969ec5eba654dcc9e4b8ae39a878
ip=127.0.0.1
port=30501
category=1
desc=node1
CAhash=
agencyinfo=node1
blocknumber=427
Idx=0

第八章 证书注销

在节点加入网络后，节点间通过证书进行通信。FISCO BCOS区块链中的管理者，可以通过登记证书到注销证书列表，来禁止使用该证书的节点接入网络。

在进行注销证书登记操作前，再次请确认：

（1）系统合约已经被正确的部署。

（2）所有节点的config.json的systemproxyaddress字段已经配置了相应的系统代理合约地址。

（3）节点在配置了systemproxyaddress字段后，已经重启使得系统合约生效。

（4）/mydata/FISCO-BCOS/web3lib/下的config.js已经正确的配置了节点的RPC端口。

(5) 该节点已通过（7.3 节点退出网络）操作方法退出网络。

8.1 登记注销证书

每个节点data目录都包含node.ca文件，里面保存了证书相关信息，通过执行以下命令，可以将节点证书加入系统合约注销证书列表，以下以创世节点证书注销为例。

cd /mydata/FISCO-BCOS/systemcontract/
babel-node tool.js  CAAction add /mydata/nodedata-1/data/node.ca

8.2 查看注销证书列表

cd /mydata/FISCO-BCOS/systemcontract/
babel-node tool.js CAAction all

可看到证书列表

----------CA 0---------
serial=8A4B2CDE94348D22
pubkey=24b98c6532ff05c2e9e637b3362ee4328c228fb4f6262c1c751f51952012cd68da2cbd8655de5072e49b950a503326942297cfaa9ca919b369be4359b4dccd56
name=A
blocknumber=36

8.3 移除注销证书

已在系统合约注销证书列表中的证书可以通过以下方法移除，恢复节点与网络中其他节点的连接，以下以移除创世节点证书为例。

cd /mydata/FISCO-BCOS/systemcontract/
babel-node tool.js  CAAction remove /mydata/nodedata-1/data/node.ca

第九章 使用控制台

控制台能够以IPC的方式直接连接区块链节点进程。登录控制台后，能够直接查看区块链的各种信息。

9.1 登录控制台

连接节点的data目录下的geth.ipc文件。

ethconsole /mydata/nodedata-1/data/geth.ipc

登录成功，可看到successful字样。

Connecting to node at /mydata/nodedata-1/data/geth.ipc
Connection successful.
Current block number: 37
Entering interactive mode.
>

9.2 控制台操作

9.2.1 查看区块

如查看块高为2的区块

web3.eth.getBlock(2,console.log)

可得到相应的区块信息

> null { author: '0x0000000000000000000000000000000000000000',
  difficulty: { [String: '1'] s: 1, e: 0, c: [ 1 ] },
  extraData: '0xd78095312e302b2b302d524c696e75782f672b2b2f496e74',
  gasLimit: 2000000000,
  gasUsed: 33245,
  genIndex: '0x0',
  hash: '0xa3c2b1eda74f26c688e78bffcc71c8561e49dc70fbfbd71b85c3b79a2c16bc81',
  logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000',
  miner: '0x0000000000000000000000000000000000000000',
  number: 2,
  parentHash: '0x96d095047e68d4db8ae0c74638cf6365d5ee7fbc329d50a5a78a85189e1b105e',
  receiptsRoot: '0xb668c383b2ee76f9e2d0a8b0d9b301fb825896a9a597268ca3cbdd979c4a53da',
  sha3Uncles: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347',
  size: 71,
  stateRoot: '0x20993fb96c5a26eb9f158c194bcd4da845afde2c2095e359259001279de23ec2',
  timestamp: 1513087469641,
  totalDifficulty: { [String: '2'] s: 1, e: 0, c: [ 2 ] },
  transactions: [ '0x63749a62851b52f9263e3c9a791369c7380acc5a9b6ee55dabd9c1013634e355' ],
  transactionsRoot: '0xc9c0b09f236fba3bad81f6fb92b9ca03b6ccb1aaf53ef600621c0a0fd0fd4bb1',
  uncles: [] }

9.2.2 查看交易

根据交易哈希查看交易。如，使用之前调用HelloWord的合约的交易哈希。

web3.eth.getTransaction('0x63749a62851b52f9263e3c9a791369c7380acc5a9b6ee55dabd9c1013634e355',console.log)

可得到相应的交易信息

> null { blockHash: '0xa3c2b1eda74f26c688e78bffcc71c8561e49dc70fbfbd71b85c3b79a2c16bc81',
  blockNumber: 2,
  from: '0x04804c06677d2009e52ca96c825d38056292cab6',
  gas: 30000000,
  gasPrice: { [String: '0'] s: 1, e: 0, c: [ 0 ] },
  hash: '0x63749a62851b52f9263e3c9a791369c7380acc5a9b6ee55dabd9c1013634e355',
  input: '0x4ed3885e0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000b48656c6c6f576f726c6421000000000000000000000000000000000000000000',
  nonce: 67506452,
  to: '0x1d2047204130de907799adaea85c511c7ce85b6d',
  transactionIndex: 0,
  value: { [String: '0'] s: 1, e: 0, c: [ 0 ] } }

9.2.3 查看交易回执

根据交易哈希查看交易回执。如，使用之前调用HelloWord的合约的交易哈希。

web3.eth.getTransactionReceipt('0x63749a62851b52f9263e3c9a791369c7380acc5a9b6ee55dabd9c1013634e355',console.log)

可得到相应的交易回执

> null { blockHash: '0xa3c2b1eda74f26c688e78bffcc71c8561e49dc70fbfbd71b85c3b79a2c16bc81',
  blockNumber: 2,
  contractAddress: '0x0000000000000000000000000000000000000000',
  cumulativeGasUsed: 33245,
  gasUsed: 33245,
  logs: [],
  transactionHash: '0x63749a62851b52f9263e3c9a791369c7380acc5a9b6ee55dabd9c1013634e355',
  transactionIndex: 0 }

9.2.4 查看合约代码

根据交易合约地址查看合约。如，用之前部署的HelloWorld合约地址。

web3.eth.getCode('0x1d2047204130de907799adaea85c511c7ce85b6d',console.log)

可以得到HelloWorld的合约二进制代码

> null '0x60606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680634ed3885e146100485780636d4ce63c146100a557600080fd5b341561005357600080fd5b6100a3600480803590602001908201803590602001908080601f01602080910402602001604051908101604052809392919081815260200183838082843782019150505050505091905050610133565b005b34156100b057600080fd5b6100b861014d565b6040518080602001828103825283818151815260200191508051906020019080838360005b838110156100f85780820151818401526020810190506100dd565b50505050905090810190601f1680156101255780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b80600090805190602001906101499291906101f5565b5050565b610155610275565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156101eb5780601f106101c0576101008083540402835291602001916101eb565b820191906000526020600020905b8154815290600101906020018083116101ce57829003601f168201915b5050505050905090565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061023657805160ff1916838001178555610264565b82800160010185558215610264579182015b82811115610263578251825591602001919060010190610248565b5b5090506102719190610289565b5090565b602060405190810160405280600081525090565b6102ab91905b808211156102a757600081600090555060010161028f565b5090565b905600a165627a7a7230582021681cb0ea5b1c4364a4f5e37f12e84241310a74ee462b1a19658b3acc26c6cb0029'

9.2.5 查看节点连接

执行

//ethconsole版本不同命令稍有不同
web3.admin.getPeers(console.log)
//或
web3.admin.peers(console.log)

可看到连接了其它的节点

> null [ { caps: [ 'eth/62', 'eth/63', 'pbft/63' ],
    height: '0x25',
    id: 'b5adf6440bb0fe7c337eccfda9259985ee42c1c94e0d357e813f905b6c0fa2049d45170b78367649dd0b8b5954ee919bf50c1398a373ca777e6329bd0c4b82e8',
    lastPing: 0,
    name: 'eth/v1.0/Linux/g++/Interpreter/RelWithDebInfo/0/',
    network: { remoteAddress: '127.0.0.1:30403' },
    notes: { ask: 'Nothing', manners: 'nice', sync: 'holding & needed' } } ]

第十章 其它可选工具

10.1 导出创世块工具

FISCO BCOS支持把现有区块链中所有的合约全部导出到一个文件中。新的区块链可使用此文件作为创世块文件启动，进而继承原来区块链中所有的合约。

10.1.1 停止当前区块链节点

在导出前，要将当前操作目录对应的区块链节点停掉

cd /mydata/nodedata-1
./stop.sh

10.1.2 导出创世块

用--export-genesis字段指定导出的创世块文件名。

fisco-bcos --genesis ./genesis.json --config ./config.json 	--export-genesis ./new_genesis.json

一段时间后，生成new_genesis.json。此文件即是导出的创世块，可作为新的区块链的创世块使用。

10.2 监控连接和块高

monitor.js脚本监控节点的连接情况和块高。在运行前，请确认：

（1）被监控的区块链节点已经启动。

（2）config.js正确配置，proxy字段指向了需要监控的区块链节点的RPC端口。

配置config，并执行monitor.js

cd /mydata/FISCO-BCOS/systemcontract/
vim ../web3lib/config.js
babel-node monitor.js

可看到不断刷出连接信息和块高。已连接节点数表示的是被查询的节点与其它节点连接的个数。此例子中，网络中有2个节点。被查询的节点是创世节点，与创世节点连接的节点只有一个，所以已连接节点数为1。

current blocknumber 29691
the number of connected nodes：1
...........Node 0.........
NodeId:838a187e32e72e3889330c2591536d20868f34691f1822fbcd43cb345ef437c7a6568170955802db2bf1ee84271bc9cba64fba87fba84e0dba03e5a05de88a2c
Host:127.0.0.1:30403
--------------------------------------------------------------

第十一章 FISCO BCOS 特性

FISCO BCOS的特性，请直接参看相关特性说明文档：

  1. AMOP（链上链下）
  2. Contract_Name_Service
  3. EthCall 设计文档 说明文档
  4. web3sdk
  5. 并行计算
  6. 分布式文件系统
  7. 监控统计日志
  8. 同态加密
  9. 机构证书准入
  10. 可监管的零知识证明
  11. 群签名环签名
  12. 弹性联盟链共识框架

第十二章 附录

12.1 源码目录结构说明

目录 说明
abi CNS(合约命名服务)模块代码
eth 主入口目录，其中main.cpp包含main函数入口
libchannelserver AMOP(链上链下通信协议)实现目录
libdevcore 基础通用组件实现目录，如工具类函数、基础数据类型结构定义、IO操作函数、读写锁、内存DB、TrieDB、SHA3实现、RLP编解码实现、Worker模型等等
libdiskencryption 落盘存储加密实现目录
libethcore 区块链核心数据结构目录。如ABI、秘钥管理、区块头、预编译、交易结构等等
libethereum 区块链主框架逻辑目录。如交易池、系统合约、节点管理、块链、块、链参数等等
libevm 虚拟机主目录。如解释器、JIT等等
libevmcore OPCODE指令集定义、定价
libp2p 区块链P2P网络主目录。如握手、网络包编解码、会话管理等等
libpaillier 同态加密算法目录
libpbftseal PBFT共识插件实现目录
libraftseal RAFT共识插件实现目录
libstatistics 访问频率统计与控制实现目录
libweb3jsonrpc web3 RPC实现目录
sample 一键安装与部署
scripts 与安装相关的脚本
systemproxy 系统合约实现目录

12.2 cryptomod.json说明

FISCO BCOS区块链节点支持加密通信，在工具配置文件（cryptomod.json）中配置区块链节点间的加密通信方式。

配置项 说明
cryptomod NodeId生成模式 默认填0
rlpcreatepath NodeId生成路径,文件名必须为network.rlp 如：/mydata/nodedata-1/data/network.rlp
datakeycreatepath datakey生成路径 填空
keycenterurl 远程加密服务 填空
superkey 本地加密服务密码 填空

12.3 genesis.json说明

创世块文件genesis.json关键字段说明如下：

配置项 说明
timestamp 创世块时间戳(毫秒)
god 内置链管理员账号地址（填入2.2 生成god账号 小节中生成的地址）
alloc 内置合约数据
initMinerNodes 创世块节点NodeId（填入2.3 生成节点身份NodeId小节中生成的NodeId）

12.4 config.json说明

节点配置文件config.json关键字段说明如下：

注意：rpcport 和 channelPort 仅限于被机构内的监控、运维、sdk等模块访问，切勿对外网开放。

配置项 说明
sealEngine 共识算法（可选PBFT、RAFT、SinglePoint）
systemproxyaddress 系统路由合约地址（生成方法可参看部署系统合约）
listenip 节点监听IP
cryptomod 加密模式默认为0（与cryptomod.json文件中cryptomod字段保持一致）
rpcport RPC监听端口（若在同台机器上部署多个节点时，端口不能重复）
p2pport P2P网络监听端口（若在同台机器上部署多个节点时，端口不能重复）
channelPort 链上链下监听端口（若在同台机器上部署多个节点时，端口不能重复）
wallet 钱包文件路径
keystoredir 账号文件目录路径
datadir 节点数据目录路径
vm vm引擎 （默认 interpreter ）
networkid 网络ID
logverbosity 日志级别（级别越高日志越详细，>8 TRACE日志，4<=x<8 DEBU G日志，<4 INFO日志）
coverlog 覆盖率插件开关（ON或OFF）
eventlog 合约日志开关（ON或OFF）
statlog 统计日志开关（ON或OFF）
logconf 日志配置文件路径（日志配置文件可参看日志配置文件说明）

12.5 log.conf说明

日志配置文件log.conf关键字段说明如下：

配置项 说明
FORMAT 日志格式，典型如%level
FILENAME 例如/mydata/nodedata-1/log/log_%datetime{%Y%M%d%H}.log
MAX_LOG_FILE_SIZE 最大日志文件大小
LOG_FLUSH_THRESHOLD 超过多少条日志即可落盘

12.6 系统合约介绍

系统合约是FISCO BCOS区块链的内置智能合约。

主要分为以下几种：系统代理合约、节点管理合约、注销证书合约、权限管理合约、全网配置合约。

系统合约一经部署，全网生效后，一般不轻易变更。

若需重新部署变更升级，需全网所有节点都认可且重新更新运行参数配置文件的systemproxyaddress字段后重启。 系统合约原则上只允许管理员账号调用。

以下依次介绍各个系统合约的源码路径、已实现接口说明、调用例子、工具使用方法。

12.6.1 系统代理合约

系统代理合约是系统合约的统一入口。

它提供了路由名称到合约地址的映射关系。

源码路径：systemcontract/SystemProxy.sol

（1）接口说明

接口名 输入 输出 备注
获取路由信息 getRoute 路由名称 路由地址、缓存标志位、生效块号 无
注册路由信息setRoute 路由名称、路由地址、缓存标志位 无 若该路由名称已存在，则覆盖

web3调用示例如下（可参看systemcontract/deploy.js）：

 console.log("register NodeAction.....");
 func = "setRoute(string,address,bool)";
 params = ["NodeAction", NodeAction.address, false];
 receipt = await web3sync.sendRawTransaction(config.account, config.privKey, SystemProxy.address, func, params);

（2）工具使用方法

查看所有系统合约信息：

babel-node tool.js SystemProxy

示例输出如下：

{ HttpProvider: 'http://127.0.0.1:8701',
  Ouputpath: './output/',
  privKey: 'bcec428d5205abe0f0cc8a734083908d9eb8563e31f943d760786edf42ad67dd',
  account: '0x64fa644d2a694681bd6addd6c5e36cccd8dcdde3' }
Soc File :SystemProxy
Func :undefined
SystemProxy address 0x210a7d467c3c43307f11eda35f387be456334fed
-----------------SystemProxy route----------------------
0 )TransactionFilterChain=>0xea8425697a093606309eb85e4447d6f333cff2fe,false,395
1 )ConfigAction=>0x09e4f1b4fa1713339f5aa17b40fa6f9920c7b278,false,396
2 )NodeAction=>0xcc46c245e6cca918d43bf939bbb10a8c0988548f,false,397
3 )CAAction=>0x8ab1175c6e7edb40dd0ed2a52ceaa94afb135a64,false,398
4 )ContractAbiMgr=>0x707024221d2433067b768c4be3a005c5ece8df40,false,399
5 )ConsensusControlMgr=>0x007f2c2751bbcd6c9a630945a87a3bc2af38788c,false,400

输出中即是当前系统路由表的所有路由信息。

12.6.2 节点管理合约

节点管理合约主要功能是维护网络中节点列表。 网络中节点加入或退出都需要与节点管理合约进行交互。

源码路径：systemcontract/NodeAction.sol

（1）接口说明

接口名 输入 输出 备注
节点入网 registerNode 节点ID、、节点名称、机构、节点证书序列号 布尔结果 若该节点ID已存在，则忽略
节点出网 cancelNode 节点ID 布尔结果 若该路由名称不存在，则忽略

web3调用示例如下（可参看systemcontract/tool.js）：

var instance=getAction("NodeAction");
var func = "registerNode(string,string,string,string)";
var params = [node.id,node.name,node.agency,node.caHash];
var receipt = web3sync.sendRawTransaction(config.account, config.privKey, instance.address, func, params);

（2）工具使用方法

请参看 注册记账节点、退出记账节点。

12.6.3 注销证书合约

注销证书合约主要功能是维护注销证书信息列表。

源码路径：systemcontract/CAAction.sol

（1）接口说明

接口名 输入 输出 备注
登记 add 证书序列号、证书公钥、节点名称 布尔结果 若该证书信息不存在，则新建
移除 remove 证书序列号 布尔结果 若该证书不存在，则忽略
查询证书信息 get 证书序列号 证书序列号、公钥、节点名称、块号 无

web3调用示例如下（可参看systemcontract/tool.js）：

var instance=getAction("CAAction");
var func = "add(string,string,string)";
var params = [ca.serial,ca.pubkey,ca.name]; 
var receipt = web3sync.sendRawTransaction(config.account, config.privKey, instance.address, func, params);ig.account, config.privKey, instance.address, func, params);

（2）工具使用方法

查看注销证书列表

babel-node tool.js CAAction all

登记注销证书

babel-node tool.js CAAction add

移除注销证书

babel-node tool.js CAAction remove

12.6.4 权限管理合约

权限管理合约是对区块链权限模型的实现。

一个外部账户只属于一个角色，一个角色拥有一个权限项列表。

一个权限项由合约地址加上合约接口来唯一标识。

源码路径：systemcontract/AuthorityFilter.sol 交易权限Filter

systemcontract/Group.sol

（1）接口说明

合约 接口名 输入 输出 备注
角色 设置用户权限组 权限项 setPermission 合约地址、合约接口、权限标记 无 无
获取权限标记 getPermission 合约地址、合约接口 权限标记 无
交易权限Filter 设置用户所属角色 setUserGroup 用户外部账户、用户所属角色合约 无 无
交易权限检查 process 用户外部账户、交易发起账户、合约地址、合约接口、交易输入数据 无

web3调用示例如下（可参看systemcontract/deploy.js）：

var GroupReicpt= await web3sync.rawDeploy(config.account, config.privKey, "Group");
var Group=web3.eth.contract(getAbi("Group")).at(GroupReicpt.contractAddress);
#......省略若干行......
abi = getAbi0("Group");
params  = ["Group","Group","",abi,GroupReicpt.contractAddress];
receipt = await web3sync.sendRawTransaction(config.account, config.privKey, ContractAbiMgrReicpt.contractAddre
ss, func, params);

（2）工具使用方法

检查用户外部账户权限

babel-node tool.js AuthorityFilter 用户外部账户、合约地址、合约接口

（3）自主定制

继承TransactionFilterBase实现新的交易Filter合约。并通过addFilter接口将新Filter注册入TransactionFilterChain即可。

12.6.5 全网配置合约

全网配置合约维护了区块链中部分全网运行配置信息。

目标是为了通过交易的全网共识来达成全网配置的一致更新。

源码路径：systemcontract/ConfigAction.sol

（1）全网配置项说明

配置项 说明 默认值 推荐值
maxBlockHeadGas 块最大GAS 2,000,000,000 2,000,000,000
intervalBlockTime 块间隔(ms) 1000 1000
maxBlockTranscations 块最大交易数 1000 1000
maxNonceCheckBlock 交易nonce检查最大块范围 1000 1000
maxBlockLimit blockLimit超过当前块号的偏移最大值 1000 1000
maxTranscationGas 交易的最大gas 30,000,000 30,000,000
CAVerify CA验证开关 false false

（2）接口说明

接口名 输入 输出 备注
设置配置项 set 配置项、配置值 无 若配置表中已存在，则覆盖
查询配置值 get 配置项 配置值、块号 无

web3调用示例如下（可参看systemcontract/tool.js）：

var func = "set(string,string)";
var params = [key,value];
var receipt = web3sync.sendRawTransaction(config.account, config.privKey, instance.address, func, params);
console.log("config :"+key+","+value);

（3）使用方法

查询配置项

babel-node tool.js ConfigAction get 配置项

设置配置项

babel-node tool.js ConfigAction set 配置项 配置值

常见问题

1 脚本执行时，格式错误

现象

执行脚本（如install_deps.sh，build.sh等）时，报如下格式错误。是windows格式和linux格式不一致导致。

xxxxx.sh: 行x： $'\r':未找到命令
xxxxx.sh: 行x： $'\r':未找到命令
xxxxx.sh: 行x： $'\r':未找到命令
xxxxx.sh: 行x： $'\r':未找到命令

解决方法

用dos2unix工具转换一下格式

sudo yum -y install dos2unix
dos2unix xxxxx.sh