fisco-bcos / fisco-bcos-doc

FISCO BCOS 技术文档（安装部署、搭链教程、系统原理、社区资源）Document of FISCO BCOS

FISCO BCOS 技术文档

• FISCO BCOS 3.x技术文档（latest）

• FISCO BCOS 2.x 技术文档（stable）

落地应用案例

FISCO BCOS已落地应用达数百个，场景覆盖政务、金融、公益、医疗、教育、交通、版权、商品溯源、供应链、招聘、农业、社交、游戏等多个领域，如：

• 金融业：机构间对账、供应链金融、旅游金融等。
• 司法服务：仲裁链、电子借据等。
• 文化版权：版权存证与交易等。
• 社会管理：不动产登记等。

此处可查看2021FISCO BCOS产业应用白皮书，获取一些具有代表性的落地应用案例。

贡献代码

• 我们欢迎并非常感谢您的贡献，请参阅代码贡献流程。

• 如项目对您有帮助，欢迎star支持！

加入我们的社区

FISCO BCOS开源社区是国内活跃的开源社区，社区长期为机构和个人开发者提供各类支持与帮助。已有来自各行业的数千名技术爱好者在研究和使用FISCO BCOS。如您对FISCO BCOS开源技术及应用感兴趣，欢迎加入社区获得更多支持与帮助。

fisco-bcos-doc's Issues

English version

Hi BCOS team,

Will there be an english version of the documentation for version 2.0 available in the near future?

Regards,
Jason

预编译合约文档，表格编译失败

hbase+phoenix是怎么设计存储的?有更详细的资料吗?

以太坊上基于UTXO模型的转账交易方案--关系图展示不成功

以太坊上基于UTXO模型的转账交易方案——使用手册 文档中图片不显示
1.3节中Token、UTXOTx、Vault三种关系图，展示不成功

3.5Pro版本部署区块链节点监控服务出错

[root]# cd ~/fisco/BcosBuilder/pro
[root]# python3 build_chain.py chain -o deploy -t monitor
generator output dir is ./generated

----------- deploy all nodes monitor -----------
----------- generate graphna&prometheus config -----------

• store monitor config
  path: /root/fisco/BcosBuilder/pro/../docker/host/linux/monitor/prometheus/prometheus.yml
• store monitor config success
  ----------- generate graphna&prometheus config success -----------
  ----------- generate mtail config for group group0 -----------
• store mtail config for agencyAgroup0node0BcosNodeService
  path: chain0/agencyAgroup0node0BcosNodeService/mtail/node.mtail
• store mtail config for agencyAgroup0node0BcosNodeService success
  execute command ansible 172.25.0.3 -m copy -a "src=chain0/agencyAgroup0node0BcosNodeService/mtail dest=chain0/agencyAgroup0node0BcosNodeService/ mode=0755" failed, error message: /bin/sh: ansible: command not found
  chain0/agencyAgroup0node0BcosNodeService/mtail failed copy mtail config for ansible
  

关于官网文档教程的一个建议

地址 https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/tutorial/sdk_application.html
在开发第一个区块链应用部分有拷贝证书操作，有如下示例

问题：安装教程安装的非国密版本证书sdk目录下一共三个证书，但教程上却显示了包含节点证书在内的6个证书，这容易引起误解，初学者在WebBase-Front上导出的SpringBoot工程本地运行时如果conf下像图二一样包含有节点证书在内的证书的话(其实只需要sdk目录下的证书)，会造成无法连接节点的异常信息。

No option to deploy lightnode in FISCO BCOS 3.x.x PRO version

I was using FISCO BCOS 3.x.x AIR with lightnodes, and I need to switch to FISCO BCOS PRO, however I do not see any documentation on how to setup lightnodes in the PRO version.

Please let me know how to do that.

建议智能合约编译读取，需要支持UTF-8 with BOM的文件格式读取。

（1）问题描述：在remix编译器上编译成功的智能合约StudentScoreByCRUD.sol在BCOS上编译失败。

经分析，该文件保存为UTF-8 with BOM格式，自动在头部添加了"EF BB BF"这3个字节。另存为ASCII格式的文件，即可编译成功。
建议： 智能合约编译读取文件的时候，自动去除这3个特殊字符就好。

Uploading StudentScoreByCRUD.zip…

solidity调用delegate call会导致fisco链崩溃

合约部署的deploy命令，能指定 solidity版本吗？

权限管理错误的链接

https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/design/security_control/permission_control.html#id9

中所对应的链接错误。

图片显示不出来

《记一次JavaSDK性能从8000提升至30000的过程》https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/articles/4_tools/44_sdk/javasdk_performance_improvement_8000-30000.html?highlight=%E5%8E%8B%E6%B5%8B：的图片显示不出，目前在edge、chrome和微信都显示不出来

扩容一个新节点（gen_node_cert.sh脚本）：国密和非国密似乎都存在问题

非国密版本：按照官方文档快速搭建4节点的区块链后，按照官方文档扩容新节点（非国密）时，提示找不到文件../cert/agency/channel/cert.cnf，手动将cert.cnf文件移入后，才可以生成新节点文件夹node4。
国密版本：同样按照步骤搭建4节点国密区块链后，按照官方文档扩容新节点（国密）时，没有生成新节点文件夹node4，也没有报错。使用bash -x查看发现，与非国密生成节点相比，gen_node_cert.sh脚本执行时后边很多步骤没有执行。
截图是生成国密节点的脚本执行过程，没有执行完毕。

交易共识中的一个问题

交易共识中写到：
区块链要求节点间就区块的执行结果达成一致才能出块。FISCO BCOS中一般采用PBFT算法保证整个系统的一致性，其大概流程是：各个节点先独立执行相同的区块，随后节点间交换各自的执行结果，如果发现超过2/3的节点都得出了相同的执行结果，那说明这个区块在大多数节点上取得了一致，节点便会开始出块。

假如其中一个节点执行不一致了，这个节点有什么处理机制恢复正确

群组新增节点,报No such file ../cert/agency/channel/cert.cnf

curl -#LO https://raw.githubusercontent.com/FISCO-BCOS/FISCO-BCOS/master-2.0/tools/gen_node_cert.sh
bash gen_node_cert.sh -c ../cert/agency -o newNode

新增节点报：

error on line -1 of ../cert/agency/channel/cert.cnf
140376256989072:error:02001002:system library:fopen:No such file or directory:bss_file.c:175:fopen('../cert/agency/channel/cert.cnf','rb')

解决方案是：

cp ../cert/agency/cert.cnf  ../cert/agency/channel/

来源文档：https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/build_chain.html

run.sh出错

ubuntu 16.04
release-2.0分支
执行bash run.sh出错。出错信息如下：
Exception occurred:
File "/usr/local/lib/python3.5/dist-packages/docutils/parsers/rst/roles.py", line 355, in math_role
text = rawtext.split('`')[1]
IndexError: list index out of range

合约事件推送的SampleCode中BlockNumber是BigInteger所以直接复制过来用会编译错误

https://fisco-bcos-doc.readthedocs.io/zh-cn/latest/docs/sdk/java_sdk/event_sub.html#id7

几个示例中的Block参数是BigInteger，所以编译的时候报错。

    // 全部Event fromBlock设置为 -1 
    params.setFromBlock(-1);  //应该是==> params.setFromBlock(new BigInteger("-1"));

    // toBlock设置为-1，处理至最新区块继续等待新的区块
    params.setToBlock(-1);  //应该是==> params.setToBlock(new BigInteger("-1"));

机构A、C构建群组2中“cp -r ~/generator ~/generator-C”不严谨

文档中有一段话
“初始化机构C，请注意，此时generator目录下有链证书及私钥，实际环境中机构C无法获取链证书及私钥。”
使用cp拷贝目录会把链证书一并拷贝到其他节点，既然大大们已经发现这是一个不严谨的操作，那为什么还刻意为之，在区块链的世界，证书大于一切，相信大家都懂，所以建议除了在机构A、C构建群组2的这个步骤中继续使用上一个文档版本的命令
“git clone https://github.com/FISCO-BCOS/generator.git /bcos/generator-C”

deepin的系统构建链报错

基于角色的权限控制中，如何实现运维账号为合约添加业务账号，从而实现业务账号有调用合约读、写权限？

目前遇到的问题是链上分配了 管理委员、运维账号， 但调用合约的写函数时，必须得是先添加为运维账号后调用才能成功， 基于角色的权限控制文档里有些“运维账号可以为某个合约添加业务账号” 一是没找到文档中如何为合约添加业务账号，二是webbase管理平台里 也没看到有为合约添加业务账号的地方呢？

JavaSDK文档中的一个注释问题

上图注释中路径是否有误？

适配密码机的节点扩容方案-文档修改

FISCO-BCOS-DOC/2.x/docs/tutorial/add_new_hsm_node.md

curl -#LO https://raw.githubusercontent.com/MaggieNgWu/FISCO-BCOS/newoct/tools/gen_gm_hsm_node_cert.sh链接不存在

2x版本无法使用脚本创建账户

我在使用2.x版本时遇到问题，使用脚本创建账户提示

但我的openssl已经安装

console.tar.gz文件地址貌似变动

文件无法完全下载

另外地址貌似变动

console.tar.gz地址疑似变更为：https://github.com/FISCO-BCOS/LargeFiles/blob/master/tools/console.tar.gz

图中应为HC 有误

2.X的浏览器可以兼容3.X的吗？

bcos用的是3.0的，那么浏览器可以用2.0的吗？

Webase界面的数据大屏的账户数

Webase界面的数据大屏，上面的账户数在官方文档没有详解，而且用添加webase的用户或者加载区块链生成的新账户都不能改变这个账户数。
看源码，这个字段没有明确的定义，找不到。希望官方可以整理下资料，给我们这些开发者一些启示。

[caliper-flow] Error: TypeError: Cannot read property 'hasOwnProperty' of undefined

Problem

error [caliper] [caliper-flow] Error: TypeError: Cannot read property 'hasOwnProperty' of undefined
at ClientOrchestrator.init (/Users/linyijing/fisco/benchmarks/node_modules/@hyperledger/caliper-core/lib/client/client-orchestrator.js:41:33)
at Object.module.exports.run (/Users/linyijing/fisco/benchmarks/node_modules/@hyperledger/caliper-core/lib/caliper-flow.js:106:60)
at
at process._tickCallback (internal/process/next_tick.js:189:7)

environment

macos: 10.15.2
caliper: v0.2.0
benckmark: v0.2.0

在此之前通过修改node_modules/ethjs-util/lib/index.js：197 删除或逻辑，以解决问题

“error [caliper] [installSmartContract.js] Depolying error: Error: Cannot convert string to buffer. toBuffer only supports 0x-prefixed hex strings and this string was given: ac3adcb447e84a38bee4477bbc7abf28”

这里的ac3adcb447e84a38bee4477bbc7abf28是randomid，不知道是否因为修改这个地方导致运行失败，请大佬赐教。

另外，文档Caliper压力测试指南中2.3基准测试中工作路径不正确，建议修改成

npx caliper benchmark run --caliper-workspace . --caliper-benchconfig benchmarks/samples/fisco-bcos/transfer/solidity/config.yaml --caliper-networkconfig networks/fisco-bcos/4nodes1group/fisco-bcos.json

以及当前文档对npm和caliper版本有要求，建议安装caliper时使用如下命令

npm install --only=prod @hyperledger/[email protected]

注册预编译合约步骤好像是旧的

https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/precompiled/add_precompiled_impl.html#step4
文档写的是

开发者需要修改bcos-executor/src/executor/TransactionExecutor.cpp文件，在initPrecompiled函数中的m_constantPrecompiled Map中插入合约地址和合约对象实例

但是该文件没有这个函数，是否应该修改为EvmTransactionExecutor.cpp和WasmTransactionExecutor.cpp文件呢？

关于【开发者部署工具】中的使用教程节选的一些建议

使用教程中包含了一个标题为为机构生成新的SDK证书里面的操作是根据机构创建一个新节点的SDK证书，标题描述应该是：生成新节点证书或者是根据结构生成新的节点SDK证书归属于群组新节点，分开也好，冗余也能加深印象。只是个人主观看法，如有不正之处，恳请多多指正。

Webase界面的数据大屏显示的账户数的含义，具体指的啥账户，或者用啥方式可以修改这个值

Webase界面的数据大屏，上面的账户数在官方文档没有详解，而且用添加webase的用户或者加载区块链生成的新账户都不能改变这个账户数。
看源码，这个字段没有明确的定义，找不到。希望官方可以整理下资料，给我们这些开发者一些启示。