高级合约调用（web3sdk） 企业搭链工具（物料包） • 国密版FISCO BCOS • 特性详解 应用实践 • Wiki • 社区 ## 快速指引 重要 快速搭链工具 FISCO BCOS 物料包 • FISCO BCOS docker 手工搭链 · 手工搭链 国密版FISCO-BCOS • 国密版FISCO BCOS • 国密版web3sdk web3sdk • SDK使用指南 -n 机构名 bash generate_agency_cert.sh -c /mydata -o /mydata -n test_agency ## 配置SDK证书 区块链环境搭建完成之后Web3SDK需要连接节点时需要SDK证书文件，SDK证书需要在机构证书生成之后才能生成，我们为上面生成的机构test_agency生成SDK证书 cd /mydata/FISCO-BCOS/tools/scripts/ keystore.p12 sdk.crt sdk.csr — sdk.key — sdk.param — sdk.private — sdk.pubkey 使用Web3SDK时将ca.crt client.keystore文件拷贝到conf目录下即可。 ## 创世节点 ## 生成创世节点 生成节点的目录、配置文件、启动脚本、身份文件、证书文件。并自动部署系统合约。

不兼容v1.x|可运行于v2.0.0-rc1节点 v2.0.0-rc1节点无法使用v2.0.0-rc2新特性，但可提升稳定性 若需要用此版本的新特性，需重新搭链| |控制台|v1.0.2+|| |Web3SDK|v2.0.0-rc2+|| |企业级部署工具|v1.0.0-rc2|仅可使用v1.0.0-rc2| |浏览器|v2.0.0-rc2+|| |Solidity|最高支持 solidity 0.5 |节点|不兼容v1.x节点|v2.0.0-rc1与v1.x完全不兼容v2.0.0-rc1不能直接运行于v1.x节点v2.0.0-rc1节点不能与v1.x节点相互通信| |控制台|v1.0.0+|| |Web3SDK|v2.0.0-rc1+|| |企业级部署工具|v1.0.0-rc1|仅可使用v1.0.0-rc1| |浏览器|v2.0.0-rc1+|| |Solidity|最高支持 solidity 0.5 + + + + + + + Generating seal on, blkNum=1, tx=0, myIdx=2, hash=49d0e830... ## 配置及使用控制台 在控制台通过Web3SDK链接FISCO BCOS节点，实现查询区块链状态、部署调用合约等功能，能够快速获取到所需要的信息。控制台指令详细介绍参考这里。 ## 准备依赖 • Java环境配置 参考Java环境要求。

控制台：交互式命令行工具，可访问区块链节点，查询区块链状态，部署并调用合约等。 企业级部署工具(Generator)：支持建链、扩容等操作，推荐构建企业级区块链时使用，快速使用方法可参考教程 - Web3SDK：提供访问节点状态、修改区块链系统配置以及节点发送交易等接口。 - 浏览器详细介绍请参考浏览器 • JSON-RPC接口可参考 JSON-RPC API - 系统设计文档请参考 系统设计 ## 不兼容v1.x|可运行于v2.0.0-rc1节点 v2.0.0-rc1节点无法使用v2.0.0-rc2新特性，但可提升稳定性 若需要用此版本的新特性，需重新搭链| |控制台|v1.0.2+|| |Web3SDK|v2.0.0-rc2+|| |企业级部署工具|v1.0.0-rc2|仅可使用v1.0.0-rc2| |浏览器|v2.0.0-rc2+|| |Solidity|最高支持 solidity 0.5 |节点|不兼容v1.x节点|v2.0.0-rc1与v1.x完全不兼容v2.0.0-rc1不能直接运行于v1.x节点v2.0.0-rc1节点不能与v1.x节点相互通信| |控制台|v1.0.0+|| |Web3SDK|v2.0.0-rc1+|| |企业级部署工具|v1.0.0-rc1|仅可使用v1.0.0-rc1| |浏览器|v2.0.0-rc1+|| |Solidity|最高支持 solidity 0.5

不兼容v1.x|可运行于v2.0.0-rc1节点 v2.0.0-rc1节点无法使用v2.0.0-rc2新特性，但可提升稳定性 若需要用此版本的新特性，需重新搭链| |控制台|v1.0.2+|| |Web3SDK|v2.0.0-rc2+|| |运维部署工具|v1.0.0-rc2|仅可使用v1.0.0-rc2| |浏览器|v2.0.0-rc2+|| |Solidity|最高支持 solidity 0.5.2|| |节点|不兼容v1.x节点|v2.0.0-rc1与v1.x完全不兼容v2.0.0-rc1不能直接运行于v1.x节点v2.0.0-rc1节点不能与v1.x节点相互通信| |控制台|v1.0.0+|| |Web3SDK|v2.0.0-rc1+|| |运维部署工具|v1.0.0-rc1|仅可使用v1.0.0-rc1| |浏览器|v2.0.0-rc1+|| |Solidity|最高支持 solidity 0.5.2|| + + + + + + + Generating seal on, blkNum=1, tx=0, myIdx=2, hash=49d0e830... ## 配置及使用控制台 在控制台通过Web3SDK链接FISCO BCOS节点，实现查询区块链状态、部署调用合约等功能，能够快速获取到所需要的信息。控制台指令详细介绍参考这里。 ## 准备依赖 • Java环境配置 参考Java环境要求。

EALER]++++++Generating seal on,blkNum=1,tx=0, →myIdx=2,hash=49d0e830.. ### 4.2 配置及使用控制台 在控制台通过Web3SDK链接FISCO BCOS节点，实现查询区块链状态、部署调用合约等功能，能够快速获取到所需要的信息。控制台指令详细介绍参考这里。 #### 4.2.1 准备依赖 • Java环境配置 参考Java环境要求。 提供的Web3SDK实现对区块链上合约的调用访问。 本教程要求用户熟悉Linux操作环境，具备Java开发的基本技能，能够使用Gradle工具，熟悉Solidity语法。 通过学习教程，你将会了解到以下内容： 1. 如何将一个业务场景的逻辑用合约的形式表达 2. 如何将Solidity合约转化成Java类 3. 如何配置Web3SDK 4. 如何构建一个应用，并集成Web3SDK到应用工程 工程 5. 如何通过Web3SDK调用合约接口，了解Web3SDK调用合约接口的原理 教程中会提供示例的完整项目源码，用户可以在此基础上快速开发自己的应用。 重要：请参考安装文档完成FISCO BCOS区块链的搭建和控制台的下载工作，本教程中的操作假设在该文档搭建的环境下进行。 #### 5.2.1 示例应用需求 区块链天然具有防篡改，可追溯等特性，这些特性决定其更容易受金融领域的青睐，

基于WeCross支持同构、异构跨链 开发支持 合约开发工具 WeBASE-IDE，ChainIDE 开发建链工具 提供一键搭链脚本工具 合约部署与测试 工具 基于Java SDK的console, 交互式控制台基于Web3SDK的 console SDK语言 Java、nodejs、go、python 快速开发组件 提供Spring-boot-starter 压测工具 SDK内嵌压测工具，支持Caliper 运维支持 运维建链工具 链上提供合约生命周期管理功能，便于链管理员对链 上合约进行管理。 易用性 FISCO BCOS引入开发部署工具、交互式控制台、区块链浏览器等工具来提 升系统的易用性，大幅缩短建链、部署应用的时间。 开发部署工具 基于Web3SDK的交互式的命令行工具console Interactive command line tool console based on Java SDK 区块链浏览器 为了便于不同语言开发者快速开发应用，FISCO 开发、运维区 块链带来了巨大的便利，降低了操作繁琐性和使用门槛。 相比于传统的nodejs等脚本工具，控制台安装简单、使用体验更好。详细请查 看 基于Java SDK的控制台使用手册 和 基于Web3SDK的控制台使用手册。 虚拟机 2.0版本引入了最新的以太坊虚拟机版本，支持Solidity 0.5版本。同时，引入 了EVMC扩展框架，支持扩展不同虚拟机引擎。 底层内部集成支持interpreter

不兼容v1.x|可运行于v2.0.0-rc1节点 v2.0.0-rc1节点无法使用v2.0.0-rc2新特性，但可提升稳定性 若需要用此版本的新特性，需重新搭链| |控制台|v1.0.2+|| |Web3SDK|v2.0.0-rc2+|| |运维部署工具|v1.0.0-rc2|仅可使用v1.0.0-rc2| |浏览器|v2.0.0-rc2+|| |Solidity|最高支持 solidity 0.5.2|| |节点|不兼容v1.x节点|v2.0.0-rc1与v1.x完全不兼容v2.0.0-rc1不能直接运行于v1.x节点v2.0.0-rc1节点不能与v1.x节点相互通信| |控制台|v1.0.0+|| |Web3SDK|v2.0.0-rc1+|| |运维部署工具|v1.0.0-rc1|仅可使用v1.0.0-rc1| |浏览器|v2.0.0-rc1+|| |Solidity|最高支持 solidity 0.5.2|| + + + + + + + Generating seal on, blkNum=1, tx=0, myIdx=2, hash=49d0e830... ## 配置及使用控制台 在控制台通过Web3SDK链接FISCO BCOS节点，实现查询区块链状态、部署调用合约等功能，能够快速获取到所需要的信息。控制台指令详细介绍参考这里。 ## 准备依赖 • Java环境配置 参考Java环境要求。

ChainIDE开发建链工具提供一键搭链脚本工具合约部署与测试工具基于Java SDK的console, 交互式控制台基于Web3SDK的consoleSDK语言Java、nodejs、go、python快速开发组件提供S 链上提供合约生命周期管理功能，便于链管理员对链上合约进行管理。 ## 易用性 FISCO BCOS引入开发部署工具、交互式控制台、区块链浏览器等工具来提升系统的易用性，大幅缩短建链、部署应用的时间。 开发部署工具 - 基于Web3SDK的交互式的命令行工具console • Interactive command line tool console based on Java SDK 区块链浏览器 为了便于不同语言开发者快速开发应用，FISCO 户管理、开发、运维区块链带来了巨大的便利，降低了操作繁琐性和使用门槛。 相比于传统的nodejs等脚本工具，控制台安装简单、使用体验更好。详细请查看基于Java SDK的控制台使用手册和基于Web3SDK的控制台使用手册。 ## 虚拟机 2.0版本引入了最新的以太坊虚拟机版本，支持Solidity 0.5版本。同时，引入了EVMC扩展框架，支持扩展不同虚拟机引擎。底层内部集成支持interpreter

ALER]++++++Generating seal on,blkNum=1,tx=0, →myIdx=2,hash=49d0e830... ### 3.2 配置及使用控制台 在控制台通过Web3SDK链接FISCO BCOS节点，实现查询区块链状态、部署调用合约等功能，能够快 速获取到所需要的信息。控制台指令详细介绍参考这里。 #### 3.2.1 准备依赖 • Java环境配置 参考Java环境要求。 提供的Web3SDK实现对区块链上合约的调用访问。 本教程要求用户熟悉Linux操作环境，具备Java开发的基本技能，能够使用Gradle工具，熟悉Solidity语法。 通过学习教程，你将会了解到以下内容： 1. 如何将一个业务场景的逻辑用合约的形式表达 2. 如何将Solidity合约转化成Java类 3. 如何配置Web3SDK 4. 如何构建一个应用，并集成Web3SDK到应用工程 工程 5. 如何通过Web3SDK调用合约接口，了解Web3SDK调用合约接口的原理 教程中会提供示例的完整项目源码，用户可以在此基础上快速开发自己的应用。 重要：请参考安装文档完成FISCO BCOS区块链的搭建和控制台的下载工作，本教程中的操作假设在该文档搭建的环境下进行。 #### 4.2.1 示例应用需求 区块链天然具有防篡改，可追溯等特性，这些特性决定其更容易受金融领域的青睐，

提供的Web3SDK实现对区块链上合约的调用访问。 本教程要求用户熟悉Linux操作环境，具备Java开发的基本技能，能够使用Gradle工具，熟悉Solidity语法。 通过学习教程，你将会了解到以下内容： 1. 如何将一个业务场景的逻辑用合约的形式表达 2. 如何将Solidity合约转化成Java类 3. 如何配置Web3SDK 4. 如何构建一个应用，并集成Web3SDK到应用工程 工程 5. 如何通过Web3SDK调用合约接口，了解Web3SDK调用合约接口的原理 教程中会提供示例的完整项目源码，用户可以在此基础上快速开发自己的应用。 重要：请参考安装文档完成FISCO BCOS区块链的搭建和控制台的下载工作，本教程中的操作假设在该文档搭建的环境下进行。 #### 5.2.1 示例应用需求 区块链天然具有防篡改，可追溯等特性，这些特性决定其更容易受金融领域的青睐， | |-- Table.sol | |-- tool |-- asset_run.sh // 项目运行脚本 (续上页) ## 项目引入Web3SDK 项目的build.gradle文件已引入Web3SDK，不需修改。其引入方法介绍如下： - Web3SDK引入了以太坊的solidity编译器相关jar包，因此在build.gradle文件需要添加以太坊的远程仓库： repositories