常见问题解答

版本相关

问: FISCO BCOS 2.0版本与之前版本有哪些变化？
答: 请 参考这里。

问: 开发者如何与FISCO BCOS平台交互？
答: FISCO BCOS提供多种开发者与平台交互的方式，参考如下：

  • FISCO BCOS 2.0版本提供JSON-RPC接口，具体请 参考这里。
  • FISCO BCOS 2.0版本提供Web3SDK帮助开发者快速实现应用，具体请 参考这里。
  • FISCO BCOS 2.0版本提供控制台帮助用户快速了解使用FISCO BCOS，具体请 参考这里。

问: FISCO BCOS 2.0版本如何搭建？
答: FISCO BCOS支持多种搭建方式，常用方式有：

  • build_chain.sh：适合开发者体验、测试FISCO BCOS联盟链，具体请 参考这里。
  • FISCO-Generator：使用企业用户部署、维护FISCO BCOS联盟链，具体请 参考这里。

问: FISCO BCOS 2.0版本的智能合约与之前版本合约有什么不同，兼容性如何？
答: FISCO BCOS 2.0版本支持最新的Solidity合约，同时增加了precompile合约，具体请 参考这里。

问: 国密和普通版本的区别有哪些？
答: 国密版FISCO BCOS将交易签名验签、p2p网络连接、节点连接、数据落盘加密等底层模块的密码学算法均替换为国密算法。同时在编译版本，证书，落盘加密，solidity编译java，Web3SDK使用国密版本和普通版本都有区别，具体请 参考这里。

问: 是否支持从1.3或1.5升级到2.0版本?
答: 不支持。

控制台

问: 控制台指令区分大小写吗？
答: 区分大小写，命令是完全匹配，但是可以采用tab补全命令。

问: 加入共识列表或观察者列表报错，nodeID is not in network，为什么？
答: 节点加入共识列表和观察者列表的节点必须是连接peer的nodeID列表里面的成员。

问: 删除节点操作报错，nodeID is not in group peers，为什么？
答: 节点删除操作中的节点必须是getGroupPeers里面展示的group的peers。

问: 游离节点（非群组节点）是否可以同步group数据？
答: 游离节点不参与group内的共识、同步和出块，游离节点可以通过控制台addSealer/addObserver命令可以将退出的节点添加为共识/观察节点。

问: 某节点属于不同的group，是否可以支持查询多group的信息。
答: 可以，在进入控制台时，输入要查看的groupID: ./start [groupID]

FISCO BCOS使用

问: 2.0版本证书在哪里使用?
答: 请参考证书说明文档

问: 2.0版本交易结构包括哪些字段?
答: 请参考这里

问: 系统配置、群组配置、节点配置分别指什么？
答: 系统配置是指节点配置中一些影响账本功能，并需账本节点共识的配置项。群组配置指节点所属的群组的相关配置，节点的每个群组都有独立的配置。节点配置指所有可配置项。

问: 群组配置都是可改的吗？
答: 从配置项是否可改的维度，分为

  • 节点首次启动生成创世块后不能再修改。这类配置放置于group.x.genesis文件，其中x表示组编号，全链唯一。
  • 通过发交易修改配置项实现账本内一致。
  • 修改自身配置文件后，节点重启生效。这类配置放置于group.x.ini文件。群组配置改后重启可改项就是本地配置，nodeX/conf下的group.*.ini文件，更改重启生效。涉及配置项为[tx_pool].limit（交易池容量），[consensus].ttl(节点转发数)。

问: 群组配置用户可以改的涉及哪些配置？
答: 群组可修改配置分为共识可改配置和手工可改配置

  • 共识可改配置：全组所有节点相同，共识后生效。[consensus].max_trans_num,[consensus].node.X,[tx].gas_limit。
  • 手工可改配置：group.x.ini文件中，修改后重启生效，只影响节点。配置项有[tx_pool].limit。

问: 群组共识可改配置如何更改、查询？
答: 共识可改配置可以通过控制台修改。共识可改配置项查询除了控制台外，还可以通过RPC接口查询，具体请 参考这里。

  • [consensus].max_trans_num，[tx].gas_limit使用接口setSystemConfigByKey更改，对于的配置项为tx_count_limit，tx_gas_limit。具体参见setSystemConfigByKey -h 。
  • [consensus].node.X的更改涉及到节点管理，控制台接口涉及到addSealer，addObserver，removeNode，具体参考《节点管理》。

问: 群组观察节点和共识节点有什么区别？
答: 观察节点能同步群组数据，但不能参与共识。共识节点除了具有观察者权限，还参与共识。

问: 如何将合约纳入CNS管理？
答: 在部署合约时，调用CNS合约接口，将合约name、version、address信息写入CNS表中。

问: 如何查询合约CNS表？
答: 通过Web3SDK控制台指令查询，查询指令根据合约name查询。

问: 为什么本地SDK无法连接云服务器上的FISCO BCOS节点？
答:

  1. 检查云服务器上的节点配置，channel是否监听外网IP，而不是127.0.0.1。端口介绍参考这里
  2. 检查通过云服务器提厂商提供的控制台，检查是否配置了安全组，需要在安全组中开放FISCO BCOS节点所使用的channel端口。
  3. 检查生成的证书是否正确，参考这里

Web3SDK

问: Web3SDK对Java版本有要求吗？
答: 要求JDK8或以上
CentOS的yum仓库的OpenJDK由于缺少JCE(Java Cryptography Extension)，导致Web3SDK无法正常连接区块链节点，在使用CentOS操作系统时，推荐从OpenJDK网站自行下载。 安装指南

问: Web3SDK配置完成，发送交易失败的原因是什么？
答: applicationContext.xml中的ip、端口、群组号填错或者是缺少节点的ca.crt、sdk.crt和sdk.key文件。

企业级部署工具

问： 企业级部署工具使用时出现找不到pip

答： 企业级部署工具依赖python pip，使用以下命令安装：

  1. $ bash ./scripts/install.sh

问: 企业级部署工具使用时出现

  1. Traceback (most recent call last):
  2.    File "./generator", line 19, in <module>
  3.     from pys.build import config
  4.    File "/data/asherli/generator/pys/build/config.py", line 25, in <module>
  5.      import configparse

答: 系统缺少python configparser模块，请按照以下命令安装：

  1.   $ pip install configparser

问: 节点或SDK使用的OpenSSL证书过期了，如何续期？

答: 证书续期操作可以参考证书续期操作