本的区 块链解决方案。 为了让大家更好的了解FISCO BCOS区块链开源平台的使用方 法。本文档按照Step By Step的步骤详细介绍了FISCO BCOS区块链的构建、安 装、启动，智能合约部署、调用等初阶用法，还包括多节点组网、系统合约等 高阶内容的介绍。 本文档不介绍FISCO BCOS区块链设计理念及思路，详情请 参看白皮书。 快速指引 手工搭链 使用指南 高级合约调用（web3sdk） 手工搭链 环境要求 程序部署 基础配置 创世节点 增加节点 环境要求 配置 最低配置 推荐配置 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 pubkey 使用Web3SDK时将ca.crt client.keystore文件拷贝到conf目录下即可。 创世节点 生成创世节点 生成节点的目录、配置文件、启动脚本、身份文件、证书文件。并自动部署系 统合约。 cd /mydata/FISCO-BCOS/tools/scripts/ #sh generate_genesis_node -o 节点文件夹生成位置 -n 节点名 -l 节点监听的IP

documentation 中找到——请不要 忘了一并阅读。 Fabric 是什么？ 如 README 所说： Fabric 是一个 Python (2.5-2.7) 的库和命令行工具，用来提高基于 SSH 的 应用部署和系统管理效率。 更具体地说，Fabric 是： 一个让你通过 命令行 执行 无参数 Python 函数 的工具； 一个让通过 SSH 执行 Shell 命令更加 容易 、 更符合 Python urls.py `-- views.py 注解 在这里我们使用一个 Django 应用为例——不过 Fabric 并s依赖于外部代码， 除了它的 SSH 库。 作为起步，我们希望先执行测试准备好部署后，再提交到 VCS（版本控制系 统）： from fabric.api import local def prepare_deploy(): local("./manage.py test prepare_deploy 任务仍可以像之前那样调用，但现在只要你愿意，就可 以调用更细粒度的子任务。 故障 我们的基本案例已经可以正常工作了，但如果测试失败了会怎样？我们应该抓 住机会即使停下任务，并在部署之前修复这些失败的测试。 Fabric 会检查被调用程序的返回值，如果这些程序没有干净地退出，Fabric 会 终止操作。下面我们就来看看如果一个测试用例遇到错误时会发生什么： $ fab prepare_deploy

documentation 中找到——请不要 忘了一并阅读。 Fabric 是什么？ 如 README 所说： Fabric 是一个 Python (2.5-2.7) 的库和命令行工具，用来提高基于 SSH 的 应用部署和系统管理效率。 更具体地说，Fabric 是： 一个让你通过 命令行 执行 无参数 Python 函数 的工具； 一个让通过 SSH 执行 Shell 命令更加 容易 、 更符合 Python urls.py `-- views.py 注解 在这里我们使用一个 Django 应用为例——不过 Fabric 并s依赖于外部代码， 除了它的 SSH 库。 作为起步，我们希望先执行测试准备好部署后，再提交到 VCS（版本控制系 统）： from fabric.api import local def prepare_deploy(): local("./manage.py test prepare_deploy 任务仍可以像之前那样调用，但现在只要你愿意，就可 以调用更细粒度的子任务。 故障 我们的基本案例已经可以正常工作了，但如果测试失败了会怎样？我们应该抓 住机会即使停下任务，并在部署之前修复这些失败的测试。 Fabric 会检查被调用程序的返回值，如果这些程序没有干净地退出，Fabric 会 终止操作。下面我们就来看看如果一个测试用例遇到错误时会发生什么： $ fab prepare_deploy

2. 核心数据结构 4. 智能合约 5. 权限系统 6. 隐私和保密 7. 性能 8. 总结 快速入门 1. XuperChain环境部署 1.1. 准备环境 1.2. 编译XuperChain 2. XuperChain基本操作 2.1. 部署xchain服务 2.2. 基本功能的使用 技术设计文档: 1. XuperModel 2. XuperBridge 2.1. 内核调用设计 1.1. 访问控制列表（ACL） 1.2. 合约账号创建 1.3. 合约账号基本操作 2. 多节点部署 2.1. p2p网络配置 2.2. 搭建TDPoS共识网络 2.3. 选举TDPOS候选人 2.4. 常见问题 3. 创建合约 3.1. 编写合约 3.2. 部署wasm合约 3.3. 部署native合约 4. 发起提案 5. 配置变更 5.1. 配置多盘存储 5.2. 替换扩展插件 在架构方面，其可插拔、插件化的设计使得用户可以方便选择适合自己业务场 景的解决方案，通过独有的XuperBridge技术，可插拔多语言虚拟机，从而支 持丰富的合约开发语言。 在网络能力方面，XuperChain具备全球化部署能力，节点通信基于加密的P2P 网络，支持广域网超大规模节点，且底层账本支持分叉管理，自动收敛一致 性，TDPOS算法确保了大规模节点下的快速共识。在账号安全方面， XuperChain内置了多私钥

259 12 区块链功能接口列表 493 13 使用链上信使 533 14 开发期问题排查 537 15 开发部署工具(build_chain.sh) 559 16 命令行交互控制台 571 17 WeBASE管理平台 665 18 区块链浏览器 669 19 运维部署工具 693 20 数据治理通用组件 745 21 多方协作治理组件 751 22 区块链应用开发组件 759 的国产开源联盟链生态圈之一。 注解: FISCO BCOS以联盟链的实际需求为出发点，兼顾性能、安全、可运维性、易用性、可扩展性， 支持多种SDK，并提供了可视化的中间件工具，大幅缩短建链、开发、部署应用的时间。此外，FISCO BCOS通过信通院可信区块链评测功能、性能两项评测，单链TPS可达两万。 1.1 关键特性 1.2 架构 FISCO BCOS 在2.0中，创新性提出“一体两翼多 一体指代群组架构，支持快速组建联盟和建链，让企业建链像建聊天群一样便利。根据业务场景和业务 关系，企业可选择不同群组，形成多个不同账本的数据共享和共识，从而快速丰富业务场景、扩大业务 规模，且大幅简化链的部署和运维成本。 两翼指的是支持并行计算模型和分布式存储，二者为群组架构带来更好的扩展性。前者改变了区块中按 交易顺序串行执行的做法，基于DAG（有向无环图）并行执行交易，大幅提升性能；后者支持企业（节

259 12 区块链功能接口列表 493 13 使用链上信使 533 14 开发期问题排查 537 15 开发部署工具(build_chain.sh) 559 16 命令行交互控制台 571 17 WeBASE管理平台 665 18 区块链浏览器 669 19 运维部署工具 693 20 数据治理通用组件 745 21 多方协作治理组件 751 22 区块链应用开发组件 759 的国产开源联盟链生态圈之一。 注解: FISCO BCOS以联盟链的实际需求为出发点，兼顾性能、安全、可运维性、易用性、可扩展性， 支持多种SDK，并提供了可视化的中间件工具，大幅缩短建链、开发、部署应用的时间。此外，FISCO BCOS通过信通院可信区块链评测功能、性能两项评测，单链TPS可达两万。 1.1 关键特性 1.2 架构 FISCO BCOS 在2.0中，创新性提出“一体两翼多 一体指代群组架构，支持快速组建联盟和建链，让企业建链像建聊天群一样便利。根据业务场景和业务 关系，企业可选择不同群组，形成多个不同账本的数据共享和共识，从而快速丰富业务场景、扩大业务 规模，且大幅简化链的部署和运维成本。 两翼指的是支持并行计算模型和分布式存储，二者为群组架构带来更好的扩展性。前者改变了区块中按 交易顺序串行执行的做法，基于DAG（有向无环图）并行执行交易，大幅提升性能；后者支持企业（节

259 12 区块链功能接口列表 493 13 使用链上信使 533 14 开发期问题排查 537 15 开发部署工具(build_chain.sh) 559 16 命令行交互控制台 571 17 WeBASE管理平台 665 18 区块链浏览器 669 19 运维部署工具 693 20 数据治理通用组件 745 21 多方协作治理组件 751 22 区块链应用开发组件 759 的国产开源联盟链生态圈之一。 注解: FISCO BCOS以联盟链的实际需求为出发点，兼顾性能、安全、可运维性、易用性、可扩展性， 支持多种SDK，并提供了可视化的中间件工具，大幅缩短建链、开发、部署应用的时间。此外，FISCO BCOS通过信通院可信区块链评测功能、性能两项评测，单链TPS可达两万。 1.1 关键特性 1.2 架构 FISCO BCOS 在2.0中，创新性提出“一体两翼多 一体指代群组架构，支持快速组建联盟和建链，让企业建链像建聊天群一样便利。根据业务场景和业务 关系，企业可选择不同群组，形成多个不同账本的数据共享和共识，从而快速丰富业务场景、扩大业务 规模，且大幅简化链的部署和运维成本。 两翼指的是支持并行计算模型和分布式存储，二者为群组架构带来更好的扩展性。前者改变了区块中按 交易顺序串行执行的做法，基于DAG（有向无环图）并行执行交易，大幅提升性能；后者支持企业（节

核心数据结构 4. 智能合约 5. 权限系统 6. 隐私和保密 7. 性能 8. 可信账本 9. 总结 快速入门 1. XuperChain环境部署 1.1. 准备环境 1.2. 编译XuperChain 2. XuperChain基本操作 2.1. 部署xchain服务 2.2. 基本功能的使用 技术设计文档: 1. XuperModel 2. XuperBridge 2.1. 内核调用设计 访问控制列表（ACL） 1.2. 合约账号创建 1.3. 合约账号基本操作 2. 多节点部署 2.1. p2p网络配置 2.2. 搭建TDPoS共识网络 2.3. 选举TDPOS候选人 2.4. 常见问题 3. 创建合约 3.1. 编写合约 3.2. 部署 wasm合约 3.3. 部署native合约 3.4. 部署solidity合约 3.5. 合约升级 3.6. 设置合约方法的ACL 4. 发起提案 合约使用方法 9.3. 中继同步进程 10. 搭建XPoA共识的 XuperChain 网络 10.1. 搭建XPoA共识网络 10.2. 验证集合合约部署和调用 10.3. 常见问题 11. 可信账本使用文档 11.1. 服务部署 11.2. 可信应用开发 12. 监控使用文档 12.1. XuperChain 监控项 12.2. XuperChain 监控系统搭建 13. 下载发行版

核心数据结构 4. 智能合约 5. 权限系统 6. 隐私和保密 7. 性能 8. 可信账本 9. 总结 快速入门 1. XuperChain环境部署 1.1. 准备环境 1.2. 编译XuperChain 2. XuperChain基本操作 2.1. 部署xchain服务 2.2. 基本功能的使用 技术设计文档: 1. XuperModel 2. XuperBridge 2.1. 内核调用设计 1.1. 访问控制列表（ACL） 1.2. 合约账号创建 1.3. 合约账号基本操作 2. 多节点部署 2.1. p2p网络配置 2.2. 搭建TDPoS共识网络 2.3. 选举TDPOS候选人 2.4. 常见问题 3. 创建合约 3.1. 编写合约 3.2. 部署wasm合约 3.3. 部署native合约 3.4. 设置合约方法的ACL 4. 发起提案 5. 配置变更 5.1. 配置多盘存储 中继同步合约 9.2. 合约使用方法 9.3. 中继同步进程 10. 搭建XPoA共识的超级链网络 10.1. 搭建XPoA共识网络 10.2. 验证集合合约部署和调用 10.3. 常见问题 11. 可信账本使用文档 11.1. 服务部署 11.2. 可信应用开发 12. 监控使用文档 12.1. 超级链监控项 12.2. 超级链监控系统搭建 13. 下载发行版 13.1. v3.10

核心数据结构 4. 智能合约 5. 权限系统 6. 隐私和保密 7. 性能 8. 可信账本 9. 总结 快速入门 1. XuperChain环境部署 1.1. 准备环境 1.2. 编译XuperChain 2. XuperChain基本操作 2.1. 部署xchain服务 2.2. 基本功能的使用 技术设计文档: 1. XuperModel 2. XuperBridge 2.1. 内核调用设计 1.1. 访问控制列表（ACL） 1.2. 合约账号创建 1.3. 合约账号基本操作 2. 多节点部署 2.1. p2p网络配置 2.2. 搭建TDPoS共识网络 2.3. 选举TDPOS候选人 2.4. 常见问题 3. 创建合约 3.1. 编写合约 3.2. 部署wasm合约 3.3. 部署native合约 3.4. 设置合约方法的ACL 4. 发起提案 5. 配置变更 5.1. 配置多盘存储 中继同步合约 9.2. 合约使用方法 9.3. 中继同步进程 10. 搭建XPoA共识的超级链网络 10.1. 搭建XPoA共识网络 10.2. 验证集合合约部署和调用 10.3. 常见问题 11. 可信账本使用文档 11.1. 服务部署 11.2. 可信应用开发 12. 监控使用文档 12.1. 超级链监控项 12.2. 超级链监控系统搭建 13. 下载发行版 13.1. v3.10