重 重 重要 要 要: • 本技术文档只适用FISCO BCOS 2.0+，FISCO BCOS 1.3.x版本的技术文档请查看 1.3系列技术文档 • FISCO BCOS 2.0+版本及兼容性说明 这里 Contents 1 FISCO BCOS Documentation, 发 发 发布 布 布 v2.4.0 2 Contents CHAPTER 1 平台介绍 FISCO 并行优化了将交易的编解码、交易的验签和落盘的编码 • 优化了交易执行返回码的逻辑，让返回码更准确 • 升级了存储模块，支持并发读写 其 其 其他 他 他特 特 特性 性 性 • 加入网络数据包压缩 • 加入兼容性配置 • 交易编码中加入chainID和groupID • 交易中加入二进制缓存 • 创世块中加入timestamp信息 • 增加了一些precompile的demo • 支持用Docker搭链 3. 安 安 安装 装 装 CHAPTER 4 教程 本章将介绍使用FISCO BCOS快速上手开发DApp的基本流程和相关的核心概念。 同时，我们还提供了 便于企业用户开发部署的工具包的使用指南。 4.1 关 关 关键 键 键概 概 概念 念 念 区块链是由多个学科交叉组合形成的一门技术，本章将阐述区块链相关的基本概念，对涉及的基本理论 进行科普介绍。如果您已经对这些基本技术很熟悉，可以跳过本章。

修复合约事件推送，推送范围不准确的问题 修复OpenSSL 1.1版本，无法生成证书的问题 修复创世块文件group.x.genesis，初始节点顺序不一致导致创世块不一 致，节点无法共识的问题 兼容性 2.9.0向前兼容，旧版本可以直接替换程序升级 推荐版本 最低版本 说明 控制台 2.9.0 1.0.4 Java SDK 2.9.0 2.6.1 Web3SDK 2.6.0 2.0.4 修复节点通过证书解析机构名错误的问题(issue 1894 [https://github.com/FISCO- BCOS/FISCO-BCOS/issues/1894])。 修复在ARM机器上LevelDB编译失败的问题。 兼容性 FISCO BCOS 2.8.0可编译出两个版本，普通版(2.8.0)，硬件加密版（2.8.0- hsm），这两个版本均与2.7.0等以前的版本兼容。 2.8.0和2.8.0-hsm向前兼容，旧版本可以直接替换程序升级 优化落盘加密，解决落盘加密模式下，存储空间占用大的问题 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 推荐版本 最低版本 说明 控制台 2.7.0 1.0.4 Java SDK 2.7.0 2.6.1 Web3SDK 2.6.0 2.0.4 generator

修复合约事件推送，推送范围不准确的问题 修复OpenSSL 1.1版本，无法生成证书的问题 修复创世块文件group.x.genesis，初始节点顺序不一致导致创世块不一 致，节点无法共识的问题 兼容性 2.9.0向前兼容，旧版本可以直接替换程序升级 推荐版本 最低版本 说明 控制台 2.9.0 1.0.4 Java SDK 2.9.0 2.6.1 Web3SDK 2.6.0 2.0.4 修复节点通过证书解析机构名错误的问题(issue 1894 [https://github.com/FISCO- BCOS/FISCO-BCOS/issues/1894])。 修复在ARM机器上LevelDB编译失败的问题。 兼容性 FISCO BCOS 2.8.0可编译出两个版本，普通版(2.8.0)，硬件加密版（2.8.0- hsm），这两个版本均与2.7.0等以前的版本兼容。 2.8.0和2.8.0-hsm向前兼容，旧版本可以直接替换程序升级 优化落盘加密，解决落盘加密模式下，存储空间占用大的问题 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 推荐版本 最低版本 说明 控制台 2.7.0 1.0.4 Java SDK 2.7.0 2.6.1 Web3SDK 2.6.0 2.0.4 generator

修复合约事件推送，推送范围不准确的问题 修复OpenSSL 1.1版本，无法生成证书的问题 修复创世块文件group.x.genesis，初始节点顺序不一致导致创世块不一 致，节点无法共识的问题 兼容性 2.9.0向前兼容，旧版本可以直接替换程序升级 推荐版本 最低版本 说明 控制台 2.9.0 1.0.4 Java SDK 2.9.0 2.6.1 Web3SDK 2.6.0 2.0.4 修复节点通过证书解析机构名错误的问题(issue 1894 [https://github.com/FISCO- BCOS/FISCO-BCOS/issues/1894])。 修复在ARM机器上LevelDB编译失败的问题。 兼容性 FISCO BCOS 2.8.0可编译出两个版本，普通版(2.8.0)，硬件加密版（2.8.0- hsm），这两个版本均与2.7.0等以前的版本兼容。 2.8.0和2.8.0-hsm向前兼容，旧版本可以直接替换程序升级 优化落盘加密，解决落盘加密模式下，存储空间占用大的问题 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 推荐版本 最低版本 说明 控制台 2.7.0 1.0.4 Java SDK 2.7.0 2.6.1 Web3SDK 2.6.0 2.0.4 generator

修复合约事件推送，推送范围不准确的问题 • 修复OpenSSL 1.1版本，无法生成证书的问题 • 修复创世块文件group.x.genesis，初始节点顺序不一致导致创世块不一致，节点无法共识的 问题 兼容性 2.9.0向前兼容，旧版本可以直接替换程序升级 2.2.2 v2.8.0 标签：v2.8.0 版本特性 变更描述 新增 • 新增使用硬件安全模块进行密码运算的功能。 – 支持使用符合 1951，解决节点接收非法P2P消息包异常崩溃的问题。 • 修复在极端异常情况下，共识模块死锁的问题。 • 修复节点通过证书解析机构名错误的问题(issue 1894)。 • 修复在ARM机器上LevelDB编译失败的问题。 兼容性 FISCO BCOS 2.8.0可编译出两个版本，普通版(2.8.0)，硬件加密版（2.8.0-hsm），这两个版本均 与2.7.0等以前的版本兼容。 2.8.0和2.8.0-hsm向前兼容，旧版本可以直接替换程序升级 Documentation, 发布 v2.9.0 • 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题 • 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 兼容模式回滚至v2.6.x方法 当节点采用兼容模式从v2.6.x升级至v2.7.0后，可直接通过将节点二进制替换回v2.6.x完成回滚。 2.2.6 v2

修复合约事件推送，推送范围不准确的问题 • 修复OpenSSL 1.1版本，无法生成证书的问题 • 修复创世块文件group.x.genesis，初始节点顺序不一致导致创世块不一致，节点无法共识的 问题 兼容性 2.9.0向前兼容，旧版本可以直接替换程序升级 2.2.2 v2.8.0 标签：v2.8.0 版本特性 变更描述 新增 • 新增使用硬件安全模块进行密码运算的功能。 – 支持使用符合 1951，解决节点接收非法P2P消息包异常崩溃的问题。 • 修复在极端异常情况下，共识模块死锁的问题。 • 修复节点通过证书解析机构名错误的问题(issue 1894)。 • 修复在ARM机器上LevelDB编译失败的问题。 兼容性 FISCO BCOS 2.8.0可编译出两个版本，普通版(2.8.0)，硬件加密版（2.8.0-hsm），这两个版本均 与2.7.0等以前的版本兼容。 2.8.0和2.8.0-hsm向前兼容，旧版本可以直接替换程序升级 Documentation, 发布 v2.9.0 • 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题 • 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 兼容模式回滚至v2.6.x方法 当节点采用兼容模式从v2.6.x升级至v2.7.0后，可直接通过将节点二进制替换回v2.6.x完成回滚。 2.2.6 v2

修复合约事件推送，推送范围不准确的问题 • 修复OpenSSL 1.1版本，无法生成证书的问题 • 修复创世块文件group.x.genesis，初始节点顺序不一致导致创世块不一致，节点无法共识的 问题 兼容性 2.9.0向前兼容，旧版本可以直接替换程序升级 2.2.2 v2.8.0 标签：v2.8.0 版本特性 变更描述 新增 • 新增使用硬件安全模块进行密码运算的功能。 – 支持使用符合 1951，解决节点接收非法P2P消息包异常崩溃的问题。 • 修复在极端异常情况下，共识模块死锁的问题。 • 修复节点通过证书解析机构名错误的问题(issue 1894)。 • 修复在ARM机器上LevelDB编译失败的问题。 兼容性 FISCO BCOS 2.8.0可编译出两个版本，普通版(2.8.0)，硬件加密版（2.8.0-hsm），这两个版本均 与2.7.0等以前的版本兼容。 2.8.0和2.8.0-hsm向前兼容，旧版本可以直接替换程序升级 Documentation, 发布 v2.9.0 • 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题 • 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 兼容模式回滚至v2.6.x方法 当节点采用兼容模式从v2.6.x升级至v2.7.0后，可直接通过将节点二进制替换回v2.6.x完成回滚。 2.2.6 v2

优化落盘加密，解决落盘加密模式下，存储空间占用大的问题 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 推荐版本 最低版本 说明 控制台 2.7.0 1.0.4 Java SDK 2.7.0 2.6.1 Web3SDK 2.6.0 2.0.4 generator 的select接口时， 偶现的Gas计算不一致问题 用户自己生成的错误证书导致coredump问题 在Solidity中使用汇编调用以太坊预编译合约0x1-0x9，对错误输入没有返 回0的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 推荐版本 最低版本 说明 控制台 1.1.0 1.0.4 SDK 2.6.0 2.0.4 generator 1.6.0 1.1.0 搭建新链需要使用该版本 题 修复CachedStorage的一个死锁问题 修复开启Binlog情况下，极端情况下，从Binlog恢复出错的问题 修复特定情况下节点重启后Viewchange被拒，无法快速恢复视图的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 推荐版本 最低版本 说明 控制台 1.0.10 1.0.4 SDK 2.5.0 2.0.4 generator 1.5.0 1.1.0 搭建新链需要使用该版本

重 重 重要 要 要: • 本技术文档只适用FISCO BCOS 2.0+，FISCO BCOS 1.3.x版本的技术文档请查看 1.3系列技术文档 • FISCO BCOS 2.0+版本及兼容性说明 这里 Contents 1 FISCO BCOS Documentation, 发 发 发布 布 布 v2.5.0 2 Contents CHAPTER 1 平台介绍 FISCO 并行优化了将交易的编解码、交易的验签和落盘的编码 • 优化了交易执行返回码的逻辑，让返回码更准确 • 升级了存储模块，支持并发读写 其 其 其他 他 他特 特 特性 性 性 • 加入网络数据包压缩 • 加入兼容性配置 • 交易编码中加入chainID和groupID • 交易中加入二进制缓存 • 创世块中加入timestamp信息 • 增加了一些precompile的demo • 支持用Docker搭链 3. 安 安 安装 装 装 CHAPTER 4 教程 本章将介绍使用FISCO BCOS快速上手开发DApp的基本流程和相关的核心概念。 同时，我们还提供了 便于企业用户开发部署的工具包的使用指南。 4.1 关 关 关键 键 键概 概 概念 念 念 区块链是由多个学科交叉组合形成的一门技术，本章将阐述区块链相关的基本概念，对涉及的基本理论 进行科普介绍。如果您已经对这些基本技术很熟悉，可以跳过本章。

使用文档 4.1. 简介 4.2. 安装 4.3. 功能预览 XuperChain 测试环境 1. XuperChain 测试环境说明 2. XuperChain 测试环境使用指南 贡献指南 1. 代码提交指南 其他 1. 操作指导 2. 视频教程 3. 指令介绍(API) 4. 常见问题解答 5. 词汇表 6. XuperChain 小课堂 Indices and tables 索引 平行链的群组特性通过白名单机制来实现，在网络层进行过滤。平行链的群组 架构，如下图 17.4. 设计思路 1. 如何要支持群组，需要在xuper链部署一个系统合约：GroupChain（一个 网络有且仅有一个） 这样是为了保证兼容性，如果没有部署这个GroupChain合约，那么行 为和旧版本一致。 <平行链名字，IP> → Address 为什么把IP放在Key中，是为了方便做过滤的时候查找更快，直接 Get。 平行链 测试环境使用场景 XuperChain 测试环境 适用于 ： 创建测试账号，更为方便的按照教程尝试使用。 开发测试智能合约，而无需担心影响真实数据资产。 XuperChain 新版本上线前的兼容性升级、功能测试等。 XuperChain 测试环境 不适用于 ： 压力测试：如果有压力测试需求，请在自行搭建的测试环境上实验，数据 会更准确。 可用性测试：测试环境并不保证高可用性，可能在某些情况下出现短暂的