微众银行、越秀金科。 FISCO BCOS平台基于现有的BCOS开源项目进行开 发，聚焦于金融行业的分布式商业需求，从业务适当性、性能、安全、政策、 技术可行性、运维与治理、成本等多个维度进行综合考虑，打造金融版本的区 块链解决方案。 为了让大家更好的了解FISCO BCOS区块链开源平台的使用方 法。本文档按照Step By Step的步骤详细介绍了FISCO BCOS区块链的构建、安 装、启动，智能合约部 权限管理合约 全网配置合约 节点相关 系统合约在创世节点生成时，脚本已自动将其部署到链上，并设置了节点 config.json文件中的systemproxyaddress来指向系统合约的地址。重新更新 systemproxyaddress的节点需重新启动才能生效。 操作相关 配置：在操作前，需用脚本set_proxy_address.sh配置需要操作的链。 操作目录：FISCO-BCOS/ 接口将新 Filter注册入TransactionFilterChain即可。 全网配置合约 全网配置合约维护了区块链中部分全网运行配置信息。 目标是为了通过交易的全网共识来达成全网配置的一致更新。 源码路径：systemcontract/ConfigAction.sol 全网配置项说明 配置项 说明 默认值 推荐值 intervalBlockTime 块间隔(ms) 1000 1000

会在一个区块中打包若干个交易。一个区块通常由区块头以及区块体组 成。 代码：区块的Proto如下 1 message InternalBlock { 2 // block version 3 // 区块版本 4 int32 version = 1; 5 // Random number used to avoid replay attacks 6 // 随机数，用来避免重放攻击 launch the transaction 24 // 发起交易的时间戳 25 int64 timestamp = 9; 26 // tx format version; tx格式版本号 27 int32 version = 10; 28 // auto generated tx 29 // 该交易是否属于系统自动生成的交易 30 bool autogen 背景：区块链中比较常见的两种操作，包括普通转账以及合约调用，这两 种操作都涉及到了数据状态的引用以及更新。为了描述普通转账涉及到的 数据状态的引用以及更新，引入了UTXO(Unspent Transaction Output)。 功能：一种记账方式，用来描述普通转账时涉及到的数据状态的引用以及 更新。通常由转账来源数据(UtxoInput)以及转账去处数据(UtxoOutput)组 成。 代码：UTXO的Proto如下

"127.0.0.1:47103" 注意，如果节点分布在不同的机器之上，需要把网络地址中的本地ip改为机 器的实际ip。 更新各节点的keys 由于节点目录下的keys都是默认的，node1保持不变，更新node2、node3的 keys。更新前需手动删掉data/keys目录。更新keys命令如下： xchain-clii account newkeys 配置创世块 XuperChain系统 XPoA共识算法中，候选人的变更依赖”验证集合”合约，所以需要部署”验证 集合”合约。通过调用合约中的add_validate方法新增候选人、del_validate方法 删除候选人、update_validate方法更新候选人neturl、get_validates方法查询候 选人列表。通过设置合约方法的ACL，可以限制哪些用户具有变更候选人的 权限，设置方法参考 设置合约方法的ACL。 创建合约账号 合约账号 You need add fee wasm invoke：调用合约 –method get_validates：调用get_validates方法 更新候选人 候选人的netrul发生变化后，需要更新。以更新node3的neturl为例，比如更新 为localhost:47103。修改后等待1分钟，调查看候选人命令，查看是否修改成 功。 [work@]$ node1 -> xchain-clii

"127.0.0.1:47103" 注意，如果节点分布在不同的机器之上，需要把网络地址中的本地ip改为机 器的实际ip。 更新各节点的keys 由于节点目录下的keys都是默认的，node1保持不变，更新node2、node3的 keys。更新前需手动删掉data/keys目录。更新keys命令如下： xchain-clii account newkeys 配置创世块 XuperChain系统 XPoA共识算法中，候选人的变更依赖”验证集合”合约，所以需要部署”验证 集合”合约。通过调用合约中的add_validate方法新增候选人、del_validate方法 删除候选人、update_validate方法更新候选人neturl、get_validates方法查询候 选人列表。通过设置合约方法的ACL，可以限制哪些用户具有变更候选人的 权限，设置方法参考 设置合约方法的ACL。 创建合约账号 合约账号 You need add fee wasm invoke：调用合约 –method get_validates：调用get_validates方法 更新候选人 候选人的netrul发生变化后，需要更新。以更新node3的neturl为例，比如更新 为localhost:47103。修改后等待1分钟，调查看候选人命令，查看是否修改成 功。 [work@]$ node1 -> xchain-clii

"127.0.0.1:47103" 注意，如果节点分布在不同的机器之上，需要把网络地址中的本地ip改为机 器的实际ip。 更新各节点的keys 由于节点目录下的keys都是默认的，node1保持不变，更新node2、node3的 keys。更新前需手动删掉data/keys目录。更新keys命令如下： xchain-clii account newkeys 配置创世块 XuperChain系统 XPoA共识算法中，候选人的变更依赖”验证集合”合约，所以需要部署”验证 集合”合约。通过调用合约中的add_validate方法新增候选人、del_validate方法 删除候选人、update_validate方法更新候选人neturl、get_validates方法查询候 选人列表。通过设置合约方法的ACL，可以限制哪些用户具有变更候选人的 权限，设置方法参考 设置合约方法的ACL。 创建合约账号 合约账号 You need add fee wasm invoke：调用合约 –method get_validates：调用get_validates方法 更新候选人 候选人的netrul发生变化后，需要更新。以更新node3的neturl为例，比如更新 为localhost:47103。修改后等待1分钟，调查看候选人命令，查看是否修改成 功。 [work@]$ node1 -> xchain-clii

"127.0.0.1:47103" 注意，如果节点分布在不同的机器之上，需要把网络地址中的本地ip改为机 器的实际ip。 更新各节点的keys 由于节点目录下的keys都是默认的，node1保持不变，更新node2、node3的 keys。更新前需手动删掉data/keys目录。更新keys命令如下： xchain-clii account newkeys 配置创世块 XuperChain系统 XPoA共识算法中，候选人的变更依赖”验证集合”合约，所以需要部署”验证 集合”合约。通过调用合约中的add_validate方法新增候选人、del_validate方法 删除候选人、update_validate方法更新候选人neturl、get_validates方法查询候 选人列表。通过设置合约方法的ACL，可以限制哪些用户具有变更候选人的 权限，设置方法参考 设置合约方法的ACL。 创建合约账号 合约账号 You need add fee wasm invoke：调用合约 –method get_validates：调用get_validates方法 更新候选人 候选人的netrul发生变化后，需要更新。以更新node3的neturl为例，比如更新 为localhost:47103。修改后等待1分钟，调查看候选人命令，查看是否修改成 功。 [work@]$ node1 -> xchain-clii

本文档版本 2.0：简单、易用、经典、稳定 ====>> 切换至 3.0 版本文档 请根据需求选择FISCO BCOS的版本，并确认周边组件与其版本相匹配。 FISCO BCOS 2.0 技术文档 FISCO BCOS 是一个稳定、高效、安全的区块链底层平台，经过多家机构、多 个应用，长时间在生产环境运行的实际检验。 注解 本技术文档适用于FISCO BCOS 2.x版本, FISCO FISCO BCOS 3.x技术文档请参考 FISCO BCOS 3.x技术文档(latest) [https://fisco-bcos-doc.readthedocs.io] FISCO BCOS 2.x版本源码位于 master-2.0 分支，请参考 这里 [https://github.com/FISCO-BCOS/FISCO-BCOS/tree/master-2.0] generator [https://github 区块链浏览器：区块链数据浏览工具 区块链浏览器将区块链中的数据可视化，并进行实时展示。方便用户以 Web页面的方式，浏览当前区块链中的信息。本浏览器版本适配FISCO BCOS 2.0+，关于2.0+版本的特性可以参考此链接。在使用本浏览器之前需 要先理解2.0+版本的群组特性，详情可以参考此链接。 运维部署工具：企业级用户的区块链管理工具 运维部署工具是为企业用户提供的部署、管理和监控多机构多群组联盟链

本文档版本 2.0：简单、易用、经典、稳定 ====>> 切换至 3.0 版本文档 请根据需求选择FISCO BCOS的版本，并确认周边组件与其版本相匹配。 FISCO BCOS 2.0 技术文档 FISCO BCOS 是一个稳定、高效、安全的区块链底层平台，经过多家机构、多 个应用，长时间在生产环境运行的实际检验。 注解 本技术文档适用于FISCO BCOS 2.x版本, FISCO FISCO BCOS 3.x技术文档请参考 FISCO BCOS 3.x技术文档(latest) [https://fisco-bcos-doc.readthedocs.io] FISCO BCOS 2.x版本源码位于 master-2.0 分支，请参考 这里 [https://github.com/FISCO-BCOS/FISCO-BCOS/tree/master-2.0] generator [https://github 区块链浏览器：区块链数据浏览工具 区块链浏览器将区块链中的数据可视化，并进行实时展示。方便用户以 Web页面的方式，浏览当前区块链中的信息。本浏览器版本适配FISCO BCOS 2.0+，关于2.0+版本的特性可以参考此链接。在使用本浏览器之前需 要先理解2.0+版本的群组特性，详情可以参考此链接。 运维部署工具：企业级用户的区块链管理工具 运维部署工具是为企业用户提供的部署、管理和监控多机构多群组联盟链

本文档版本 2.0：简单、易用、经典、稳定 ====>> 切换至 3.0 版本文档 请根据需求选择FISCO BCOS的版本，并确认周边组件与其版本相匹配。 FISCO BCOS 2.0 技术文档 FISCO BCOS 是一个稳定、高效、安全的区块链底层平台，经过多家机构、多 个应用，长时间在生产环境运行的实际检验。 注解 本技术文档适用于FISCO BCOS 2.x版本, FISCO FISCO BCOS 3.x技术文档请参考 FISCO BCOS 3.x技术文档(latest) [https://fisco-bcos-doc.readthedocs.io] FISCO BCOS 2.x版本源码位于 master-2.0 分支，请参考 这里 [https://github.com/FISCO-BCOS/FISCO-BCOS/tree/master-2.0] generator [https://github 区块链浏览器：区块链数据浏览工具 区块链浏览器将区块链中的数据可视化，并进行实时展示。方便用户以 Web页面的方式，浏览当前区块链中的信息。本浏览器版本适配FISCO BCOS 2.0+，关于2.0+版本的特性可以参考此链接。在使用本浏览器之前需 要先理解2.0+版本的群组特性，详情可以参考此链接。 运维部署工具：企业级用户的区块链管理工具 运维部署工具是为企业用户提供的部署、管理和监控多机构多群组联盟链

个应用，长时间在生产环境运行的实际检验。 注解 本技术文档适用于FISCO BCOS 2.x版本, FISCO BCOS 3.0+技术文档请参考 FISCO BCOS 3.x技术文档(latest) [https://fisco-bcos-doc.readthedocs.io] FISCO BCOS 2.x版本源码位于 master-2.0`分支，请参考 `这里 [https://github.c 区块链浏览器：区块链数据浏览工具 区块链浏览器将区块链中的数据可视化，并进行实时展示。方便用户以 Web页面的方式，浏览当前区块链中的信息。本浏览器版本适配FISCO BCOS 2.0+，关于2.0+版本的特性可以参考此链接。在使用本浏览器之前需 要先理解2.0+版本的群组特性，详情可以参考此链接。 运维部署工具：企业级用户的区块链管理工具 运维部署工具是为企业用户提供的部署、管理和监控多机构多群组联盟链 客户端与节点通 信 JsonRPC，Channel协议 消息订阅服务 AMOP协议 智能合约 合约引擎 支持Solidity和预编译合约 引擎特点 图灵完备，沙盒运行 版本控制 基于CNS支持多版本合约 灰度升级 支持多版本合约共存、灰度升级 生命周期管理 支持合约和账户的冻结、解冻 密码算法和协议 国密算法 支持 国密SSL 支持 哈希算法 Keccak256、SM3 对称加密算法