使用工具 开发部署工具：区块链网络快速部署工具 开发部署工具是提供给开发者快速搭建FISCO BCOS区块链网络的脚本工 具。 开发第一个区块链应用 开发手册 关键概念 区块链网络搭建 区块链应用开发 FISCO BCOS Java SDK 问题排查 命令行交互控制台：节点查询与管理工具 命令行交互控制台是提供给开发者使用的节点查询与管理的工具。控制台 区块链底层的复杂度，降低区块链使用的门槛，大幅提高区块链应用的开 发效率，包含节点前置、节点管理、交易链路，数据导出，Web管理平台 等子系统。 区块链浏览器：区块链数据浏览工具 区块链浏览器将区块链中的数据可视化，并进行实时展示。方便用户以 Web页面的方式，浏览当前区块链中的信息。本浏览器版本适配FISCO BCOS 2.0+，关于2.0+版本的特性可以参考此链接。在使用本浏览器之前需 要先理解2 nt)、权限治理组件(Governance-Auth)、 私 钥管理组件(Governance-Key)和证书管理组件（Governance-Cert）。上述组 件都提供了可部署的智能合约代码、易于使用的SDK和可参考的落地实践 Demo等交付物。 区块链应用开发组件：助力低代码开发 WeBankBlockchain-SmartDev应用开发组件包含了一套开放、轻量的开发组 件集，覆盖智能合约

使用工具 开发部署工具：区块链网络快速部署工具 开发部署工具是提供给开发者快速搭建FISCO BCOS区块链网络的脚本工 具。 开发第一个区块链应用 开发手册 关键概念 区块链网络搭建 区块链应用开发 FISCO BCOS Java SDK 问题排查 命令行交互控制台：节点查询与管理工具 命令行交互控制台是提供给开发者使用的节点查询与管理的工具。控制台 区块链底层的复杂度，降低区块链使用的门槛，大幅提高区块链应用的开 发效率，包含节点前置、节点管理、交易链路，数据导出，Web管理平台 等子系统。 区块链浏览器：区块链数据浏览工具 区块链浏览器将区块链中的数据可视化，并进行实时展示。方便用户以 Web页面的方式，浏览当前区块链中的信息。本浏览器版本适配FISCO BCOS 2.0+，关于2.0+版本的特性可以参考此链接。在使用本浏览器之前需 要先理解2 nt)、权限治理组件(Governance-Auth)、 私 钥管理组件(Governance-Key)和证书管理组件（Governance-Cert）。上述组 件都提供了可部署的智能合约代码、易于使用的SDK和可参考的落地实践 Demo等交付物。 区块链应用开发组件：助力低代码开发 WeBankBlockchain-SmartDev应用开发组件包含了一套开放、轻量的开发组 件集，覆盖智能合约

使用工具 开发部署工具：区块链网络快速部署工具 开发部署工具是提供给开发者快速搭建FISCO BCOS区块链网络的脚本工 具。 开发第一个区块链应用 开发手册 关键概念 区块链网络搭建 区块链应用开发 FISCO BCOS Java SDK 问题排查 命令行交互控制台：节点查询与管理工具 命令行交互控制台是提供给开发者使用的节点查询与管理的工具。控制台 区块链底层的复杂度，降低区块链使用的门槛，大幅提高区块链应用的开 发效率，包含节点前置、节点管理、交易链路，数据导出，Web管理平台 等子系统。 区块链浏览器：区块链数据浏览工具 区块链浏览器将区块链中的数据可视化，并进行实时展示。方便用户以 Web页面的方式，浏览当前区块链中的信息。本浏览器版本适配FISCO BCOS 2.0+，关于2.0+版本的特性可以参考此链接。在使用本浏览器之前需 要先理解2 nt)、权限治理组件(Governance-Auth)、 私 钥管理组件(Governance-Key)和证书管理组件（Governance-Cert）。上述组 件都提供了可部署的智能合约代码、易于使用的SDK和可参考的落地实践 Demo等交付物。 区块链应用开发组件：助力低代码开发 WeBankBlockchain-SmartDev应用开发组件包含了一套开放、轻量的开发组 件集，覆盖智能合约

开发第一个区块链应用 33 5 关键概念 57 6 网络搭建 65 7 配置管理 135 8 网络维护 181 9 创建和使用账户 209 10 开发和使用智能合约 215 11 多种语言SDK 259 12 区块链功能接口列表 493 13 使用链上信使 533 14 开发期问题排查 537 15 开发部署工具(build_chain.sh) 559 16 命令行交互控制台 企业（节 点）将数据存储在远端分布式系统中，克服了本地化数据存储的诸多限制。 多引擎是一系列功能特性的总括，比如预编译合约能够突破EVM的性能瓶颈，实现高性能合约；控制台 可以让用户快速掌握区块链使用技巧等。 上述功能特性均聚焦解决技术和体验的痛点，为开发、运维、治理和监管提供更多的工具支持，让系统 处理更快、容量更高，使应用运行环境更安全、更稳定。 4 Chapter 1. FISCO BCOS 区块链多方协作治理组件解决方案：可无缝适配FISCO BCOS的区块链治理组件解决方案。首批开 源的四个组件分别从私钥丢失重置、合约权限细粒度管控、私钥和证书的全生命周期管控等方面 着手，提供了可部署的智能合约代码、易于使用的SDK和可参考的落地实践Demo等交付物。 • 区块链应用开发组件解决方案：一套开放、轻量的开发组件集，覆盖智能合约的开发、调试、 应用开发等环节，包含了Solidity智能合约开发工具库、 智

开发第一个区块链应用 33 5 关键概念 57 6 网络搭建 65 7 配置管理 135 8 网络维护 181 9 创建和使用账户 209 10 开发和使用智能合约 215 11 多种语言SDK 259 12 区块链功能接口列表 493 13 使用链上信使 533 14 开发期问题排查 537 15 开发部署工具(build_chain.sh) 559 16 命令行交互控制台 企业（节 点）将数据存储在远端分布式系统中，克服了本地化数据存储的诸多限制。 多引擎是一系列功能特性的总括，比如预编译合约能够突破EVM的性能瓶颈，实现高性能合约；控制台 可以让用户快速掌握区块链使用技巧等。 上述功能特性均聚焦解决技术和体验的痛点，为开发、运维、治理和监管提供更多的工具支持，让系统 处理更快、容量更高，使应用运行环境更安全、更稳定。 4 Chapter 1. FISCO BCOS 区块链多方协作治理组件解决方案：可无缝适配FISCO BCOS的区块链治理组件解决方案。首批开 源的四个组件分别从私钥丢失重置、合约权限细粒度管控、私钥和证书的全生命周期管控等方面 着手，提供了可部署的智能合约代码、易于使用的SDK和可参考的落地实践Demo等交付物。 • 区块链应用开发组件解决方案：一套开放、轻量的开发组件集，覆盖智能合约的开发、调试、 应用开发等环节，包含了Solidity智能合约开发工具库、 智

开发第一个区块链应用 33 5 关键概念 57 6 网络搭建 65 7 配置管理 135 8 网络维护 181 9 创建和使用账户 209 10 开发和使用智能合约 215 11 多种语言SDK 259 12 区块链功能接口列表 493 13 使用链上信使 533 14 开发期问题排查 537 15 开发部署工具(build_chain.sh) 559 16 命令行交互控制台 企业（节 点）将数据存储在远端分布式系统中，克服了本地化数据存储的诸多限制。 多引擎是一系列功能特性的总括，比如预编译合约能够突破EVM的性能瓶颈，实现高性能合约；控制台 可以让用户快速掌握区块链使用技巧等。 上述功能特性均聚焦解决技术和体验的痛点，为开发、运维、治理和监管提供更多的工具支持，让系统 处理更快、容量更高，使应用运行环境更安全、更稳定。 4 Chapter 1. FISCO BCOS 区块链多方协作治理组件解决方案：可无缝适配FISCO BCOS的区块链治理组件解决方案。首批开 源的四个组件分别从私钥丢失重置、合约权限细粒度管控、私钥和证书的全生命周期管控等方面 着手，提供了可部署的智能合约代码、易于使用的SDK和可参考的落地实践Demo等交付物。 • 区块链应用开发组件解决方案：一套开放、轻量的开发组件集，覆盖智能合约的开发、调试、 应用开发等环节，包含了Solidity智能合约开发工具库、 智

Contents 1 平 平 平台 台 台介 介 介绍 绍 绍 3 2 版 版 版本 本 本及 及 及兼 兼 兼容 容 容 7 3 安 安 安装 装 装 19 4 教 教 教程 程 程 25 5 使 使 使用 用 用手 手 手册 册 册 41 6 运 运 运维 维 维部 部 部署 署 署工 工 工具 具 具 223 7 SDK 287 8 区 区 区块 块 块链 链 链浏 浏 浏览 览 览器 器 器 国 密 等请参考 使用手册 • 控制台：交 交 交互 互 互式 式 式命 命 命令 令 令行 行 行工 工 工具 具 具，可访问区块链节点，查询区块链状态，部署并调用合约等。 • 运维部署工具(Generator)：支持建链、扩容等操作，推 推 推荐 荐 荐构 构 构建 建 建企 企 企业 业 业级 级 级区 区 区块 块 块链 链 链时 时 时使 使 使用 用 用，快速使用方 法可参考 教程 • JSON-RPC接口可参考 JSON-RPC API • 系统设计文档请参考 系统设计 关 关 关键 键 键特 特 特性 性 性 • 多群组: 教程 使用手册 设计文档 • 并行计算: 使用手册 设计文档 • 分布式存储: 使用手册 设计文档 重 重 重要 要 要: • 本技术文档只适用FISCO BCOS 2.0+，FISCO BCOS 1.3.x版本的技术文档请查看 1.3系列技术文档

版 版本 本 本新 新 新特 特 特性 性 性 7 3 版 版 版本 本 本及 及 及兼 兼 兼容 容 容 11 4 安 安 安装 装 装 19 5 教 教 教程 程 程 25 6 使 使 使用 用 用手 手 手册 册 册 41 7 企 企 企业 业 业级 级 级部 部 部署 署 署工 工 工具 具 具 191 8 SDK 231 9 区 区 区块 块 块链 链 链浏 浏 浏览 览 览器 密 等请参考 使用手册 • 控制台：交 交 交互 互 互式 式 式命 命 命令 令 令行 行 行工 工 工具 具 具，可访问区块链节点，查询区块链状态，部署并调用合约等。 • 企业级部署工具(Generator)：支持建链、扩容等操作，推 推 推荐 荐 荐构 构 构建 建 建企 企 企业 业 业级 级 级区 区 区块 块 块链 链 链时 时 时使 使 使用 用 用，快速使用 方法可参考 教程 • JSON-RPC接口可参考 JSON-RPC API • 系统设计文档请参考 系统设计 关 关 关键 键 键特 特 特性 性 性 • 多群组: 教程 使用手册 设计文档 • 并行计算: 使用手册 设计文档 • 分布式存储: 使用手册 设计文档 重 重 重要 要 要: • 本技术文档只适用FISCO BCOS 2.0+，FISCO BCOS 1.3.x版本的技术文档请查看 1.3系列技术文档

搭建第一个区块链网络 开发第一个区块链应用 开发手册 使用工具 开发部署工具：区块链网络快速部署工具 开发部署工具是提供给开发者快速搭建FISCO BCOS区块链网络的脚本工 具。 命令行交互控制台：节点查询与管理工具 命令行交互控制台是提供给开发者使用的节点查询与管理的工具。控制台 拥有丰富的命令，包括查询区块链状态、管理区块链节点、部署并调用合 区块链底层的复杂度，降低区块链使用的门槛，大幅提高区块链应用的开 发效率，包含节点前置、节点管理、交易链路，数据导出，Web管理平台 等子系统。 区块链浏览器：区块链数据浏览工具 区块链浏览器将区块链中的数据可视化，并进行实时展示。方便用户以 Web页面的方式，浏览当前区块链中的信息。本浏览器版本适配FISCO BCOS 2.0+，关于2.0+版本的特性可以参考此链接。在使用本浏览器之前需 要先理解2 nt)、权限治理组件(Governance-Auth)、 私 钥管理组件(Governance-Key)和证书管理组件（Governance-Cert）。上述组 件都提供了可部署的智能合约代码、易于使用的SDK和可参考的落地实践 Demo等交付物。 区块链应用开发组件：助力低代码开发 WeBankBlockchain-SmartDev应用开发组件包含了一套开放、轻量的开发组 件集，覆盖智能合约

为了让大家更好的了解FISCO BCOS区块链开源平台的使用方 法。本文档按照Step By Step的步骤详细介绍了FISCO BCOS区块链的构建、安 装、启动，智能合约部署、调用等初阶用法，还包括多节点组网、系统合约等 高阶内容的介绍。 本文档不介绍FISCO BCOS区块链设计理念及思路，详情请 参看白皮书。 快速指引 手工搭链 使用指南 高级合约调用（web3sdk） 企业搭链工具（物料包） FISCO BCOS 物料包 FISCO BCOS docker 手工搭链 手工搭链 国密版FISCO-BCOS 国密版FISCO BCOS 国密版web3sdk web3sdk SDK使用指南 SDK应用开发指南 手工搭链 环境要求 程序部署 基础配置 创世节点 增加节点 环境要求 配置 最低配置 推荐配置 CPU 1.5GHz 2.4GHz 内存 2GB 4GB 核心 切换到FISCO-BCOS目录下，执行FISCO-BCOS安装脚本。脚本自动下载并安 装程序。 cd FISCO-BCOS && git checkout master-1.3 bash build.sh #若需要源码编译安装 使用 bash build.sh -b 检查是否安装成功 fisco-bcos --version #成功: FISCO-BCOS version x.x.x 基础配置 配置根证书 生成链的根证书