SDK应用开发指南 手工搭链 环境要求 程序部署 基础配置 创世节点 增加节点 环境要求 配置 最低配置 推荐配置 CPU 1.5GHz 2.4GHz 内存 2GB 4GB 核心 2核 4核 带宽 1Mb 5Mb 操作系统 CentOS （7.2 64位）或Ubuntu（16.04 64位） JAVA Java(TM) 1.8 && JDK 1.8 程序部署 获取代码 新建一个目录，例如/mydata https://github.com/FISCO-BCOS/FISCO-BCOS.git 安装FISCO-BCOS 切换到FISCO-BCOS目录下，执行FISCO-BCOS安装脚本。脚本自动下载并安 装程序。 cd FISCO-BCOS && git checkout master-1.3 bash build.sh #若需要源码编译安装 使用 bash build.sh -b 检查是否安装成功 deploy success! 调用合约 编写合约调用程序 用nodejs实现，具体实现方法请直接看demoHelloWorld.js源码。 # 进入合约所在目录 cd /mydata/FISCO-BCOS/FISCO-BCOS/tools/contract vim demoHelloWorld.js 调用合约 执行合约调用程序 # 进入合约所在目录 cd /mydata/FISCO

自研并实现了一套 基于账号的去中心化的合约权限系统。支持权 模块 特性 重累计、集合运算等灵活的策略，可以满足 不同的业务场景 3. 核心数据结构 3.1. 背景 众所周知，程序=数据结构+算法，了解一个程序的数据结构有助于掌握一个程 序的关键设计。本文从背景、功能以及各个字段的用意来剖析XuperChain底层 核心数据结构，从而方便XuperChain开发者以及用户更深入地了解XuperChain 此节点的地址，具有全局唯一性 │ ··· ├─ netkeys 此节点的网络标识ID，具有全局唯一性 │ ··· └─ config 包括创始的共识，初始的资源数，矿工奖励机制等 ├─ logs 程序日志目录 ├─ plugins so扩展的存放目录 ├─ xchain xchain服务的二进制文件 目录名 功能 ├─ xchain-cli xchain客户端工具 └─ wasm2c wasm工具（智能合约会用到） XuperModel合约验证 2. XuperBridge 2.1. 内核调用设计 XuperBridge为所有合约提供统一的合约接口，从抽象方式上类似于linux内核 对应于应用程序，内核代码是一份，应用程序可以用各种语言实现，比如 go,c。类比到合约上就是各种合约的功能，如KV访问，QueryBlock, QueryTx 等，这些请求都会通过跟xchain通信的方式来执行，这样在其上实现的各种合

修复OpenSSL 1.1版本，无法生成证书的问题 • 修复创世块文件group.x.genesis，初始节点顺序不一致导致创世块不一致，节点无法共识的 问题 兼容性 2.9.0向前兼容，旧版本可以直接替换程序升级 2.2.2 v2.8.0 标签：v2.8.0 版本特性 变更描述 新增 • 新增使用硬件安全模块进行密码运算的功能。 – 支持使用符合国密《GMT0018-2012密码设备应用接口规范》标准的密码机/密码卡进 BCOS 2.8.0可编译出两个版本，普通版(2.8.0)，硬件加密版（2.8.0-hsm），这两个版本均 与2.7.0等以前的版本兼容。 2.8.0和2.8.0-hsm向前兼容，旧版本可以直接替换程序升级 2.2.3 v2.7.2 变更描述 • 修复国密环境内存泄露问题 2.2. 更多版本 11 FISCO BCOS Documentation, 发布 v2.9.0 2.2.4 v2 9.0 • 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题 • 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 兼容模式回滚至v2.6.x方法 当节点采用兼容模式从v2.6.x升级至v2.7.0后，可直接通过将节点二进制替换回v2.6.x完成回滚。 2.2.6 v2.6.0 标签：v2.6.0 版本特性

修复OpenSSL 1.1版本，无法生成证书的问题 • 修复创世块文件group.x.genesis，初始节点顺序不一致导致创世块不一致，节点无法共识的 问题 兼容性 2.9.0向前兼容，旧版本可以直接替换程序升级 2.2.2 v2.8.0 标签：v2.8.0 版本特性 变更描述 新增 • 新增使用硬件安全模块进行密码运算的功能。 – 支持使用符合国密《GMT0018-2012密码设备应用接口规范》标准的密码机/密码卡进 BCOS 2.8.0可编译出两个版本，普通版(2.8.0)，硬件加密版（2.8.0-hsm），这两个版本均 与2.7.0等以前的版本兼容。 2.8.0和2.8.0-hsm向前兼容，旧版本可以直接替换程序升级 2.2.3 v2.7.2 变更描述 • 修复国密环境内存泄露问题 2.2. 更多版本 11 FISCO BCOS Documentation, 发布 v2.9.0 2.2.4 v2 9.0 • 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题 • 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 兼容模式回滚至v2.6.x方法 当节点采用兼容模式从v2.6.x升级至v2.7.0后，可直接通过将节点二进制替换回v2.6.x完成回滚。 2.2.6 v2.6.0 标签：v2.6.0 版本特性

修复OpenSSL 1.1版本，无法生成证书的问题 • 修复创世块文件group.x.genesis，初始节点顺序不一致导致创世块不一致，节点无法共识的 问题 兼容性 2.9.0向前兼容，旧版本可以直接替换程序升级 2.2.2 v2.8.0 标签：v2.8.0 版本特性 变更描述 新增 • 新增使用硬件安全模块进行密码运算的功能。 – 支持使用符合国密《GMT0018-2012密码设备应用接口规范》标准的密码机/密码卡进 BCOS 2.8.0可编译出两个版本，普通版(2.8.0)，硬件加密版（2.8.0-hsm），这两个版本均 与2.7.0等以前的版本兼容。 2.8.0和2.8.0-hsm向前兼容，旧版本可以直接替换程序升级 2.2.3 v2.7.2 变更描述 • 修复国密环境内存泄露问题 2.2. 更多版本 11 FISCO BCOS Documentation, 发布 v2.9.0 2.2.4 v2 9.0 • 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题 • 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼容性 向前兼容，旧版本可以直接替换程序升级 兼容模式回滚至v2.6.x方法 当节点采用兼容模式从v2.6.x升级至v2.7.0后，可直接通过将节点二进制替换回v2.6.x完成回滚。 2.2.6 v2.6.0 标签：v2.6.0 版本特性

e清理缓存导致节点宕机的问题 • 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级 兼 兼 兼容 容 容模 模 模式 式 式回 回 回滚 滚 滚至 至 至v2.6.x方 方 方法 法 法 当节点采用兼容模式从v2.6.x升级至v2.7.0后，可直接通过将节点二进制替换回v2 题 • 在Solidity中使用汇编调用以太坊预编译合约0x1-0x9，对错误输入没有返回0的问题 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级 兼 兼 兼容 容 容模 模 模式 式 式回 回 回滚 滚 滚至 至 至v2.5.x方 方 方法 法 法 当节点采用兼容模式从v2.5.x升级至v2.6.0后，可直接通过将节点二进制替换回v2 log恢复出错的问题 • 修复特定情况下节点重启后Viewchange被拒，无法快速恢复视图的问题 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级 兼 兼 兼容 容 容模 模 模式 式 式回 回 回滚 滚 滚至 至 至v2.4.x方 方 方法 法 法 当节点采用兼容模式从v2.4.x升级至v2.5.0后，可直接通过将节点二进制替换回v2

e清理缓存导致节点宕机的问题 • 修复MySQL存储模式下，CNS合约名过长导致区块提交异常的问题 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级 兼 兼 兼容 容 容模 模 模式 式 式回 回 回滚 滚 滚至 至 至v2.6.x方 方 方法 法 法 当节点采用兼容模式从v2.6.x升级至v2.7.0后，可直接通过将节点二进制替换回v2 题 • 在Solidity中使用汇编调用以太坊预编译合约0x1-0x9，对错误输入没有返回0的问题 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级 兼 兼 兼容 容 容模 模 模式 式 式回 回 回滚 滚 滚至 至 至v2.5.x方 方 方法 法 法 当节点采用兼容模式从v2.5.x升级至v2.6.0后，可直接通过将节点二进制替换回v2 log恢复出错的问题 • 修复特定情况下节点重启后Viewchange被拒，无法快速恢复视图的问题 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级 兼 兼 兼容 容 容模 模 模式 式 式回 回 回滚 滚 滚至 至 至v2.4.x方 方 方法 法 法 当节点采用兼容模式从v2.4.x升级至v2.5.0后，可直接通过将节点二进制替换回v2

修复国密模式下ecRecover接口不可用问题 • 修复国密模式、非国密模式下sha256接口返回值不一致的问题 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级，替换后的节点修复v2.3.x中的bug，并新增了2.4.0的动态群组 生命周期管理功能、网络统计功能，若要启用v2.4.0版本所有新特性，需重新搭链。 兼 兼 兼容 容 容模 模 模式 式 式回 推荐使用MySQL直连的存储模式替代External存储模式 修 修 修复 复 复 • 修复特定兼容场景下的内存问题 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级，但无法启动此版本的新特性。若需要用此版本的新特性，需 重新搭链。 兼 兼 兼容 容 容模 模 模式 式 式回 回 回滚 滚 滚至 至 至v2.2.x方 方 方法 法 法 当节点采用兼容模式从v2 优化交易广播策略 • 优化交易转发策略 修 修 修复 复 复 • 修复特定兼容场景下的缓存bug 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级，但无法启动此版本的新特性。若需要用此版本的新特性，需 重新搭链。 兼 兼 兼容 容 容模 模 模式 式 式回 回 回滚 滚 滚至 至 至v2.1.x方 方 方法 法 法 当节点采用兼容模式从v2

log恢复出错的问题 • 修复特定情况下节点重启后Viewchange被拒，无法快速恢复视图的问题 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级 兼 兼 兼容 容 容模 模 模式 式 式回 回 回滚 滚 滚至 至 至v2.4.x方 方 方法 法 法 当节点采用兼容模式从v2.4.x升级至v2.5.0后，可直接通过将节点二进制替换回v2 修复国密模式下ecRecover接口不可用问题 • 修复国密模式、非国密模式下sha256接口返回值不一致的问题 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级，替换后的节点修复v2.3.x中的bug，并新增了2.4.0的动态群组 生命周期管理功能、网络统计功能，若要启用v2.4.0版本所有新特性，需重新搭链。 兼 兼 兼容 容 容模 模 模式 式 式回 3.0 11 FISCO BCOS Documentation, 发 发 发布 布 布 v2.5.0 兼 兼 兼容 容 容性 性 性 向 向 向前 前 前兼 兼 兼容 容 容，旧版本可以直接替换程序升级，但无法启动此版本的新特性。若需要用此版本的新特性，需 重新搭链。 兼 兼 兼容 容 容模 模 模式 式 式回 回 回滚 滚 滚至 至 至v2.2.x方 方 方法 法 法 当节点采用兼容模式从v2

修复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 generator 1.7.0 1.1.0 BCOS 2.8.0可编译出两个版本，普通版(2.8.0)，硬件加密版（2.8.0- hsm），这两个版本均与2.7.0等以前的版本兼容。 2.8.0和2.8.0-hsm向前兼容，旧版本可以直接替换程序升级 推荐版本 最低版本 说明 控制台 2.8.0 1.0.4 Java SDK 2.8.0 或 2.8.0-GMT0018 2.6.1 推荐版本 最低版本 说明 Web3SDK 2.6.0 优化落盘加密，解决落盘加密模式下，存储空间占用大的问题 修复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 1.7.0 1.1.0