From 2810d4a55e67ec9a66ff54fbc2c11eb671b2bb9d Mon Sep 17 00:00:00 2001 From: wenlinli <1574249665@qq.com> Date: Tue, 5 Sep 2023 12:38:11 +0800 Subject: [PATCH 1/7] update pro expand group guide --- 3.x/zh_CN/docs/tutorial/pro/expand_group.md | 99 ++++----------------- 1 file changed, 15 insertions(+), 84 deletions(-) diff --git a/3.x/zh_CN/docs/tutorial/pro/expand_group.md b/3.x/zh_CN/docs/tutorial/pro/expand_group.md index 59346909b..e00b71744 100644 --- a/3.x/zh_CN/docs/tutorial/pro/expand_group.md +++ b/3.x/zh_CN/docs/tutorial/pro/expand_group.md @@ -4,7 +4,9 @@ -------------- -Pro版本FISCO BCOS区块链系统支持动态多群组区块链网络，可在系统运行时扩容产生新群组、下线群组。`BcosBuilder`提供了新群组上线和下线功能，本章在[搭建Pro版区块链网络](./installation.md)的基础上扩容、下线`wasm`群组`group2`，帮助用户掌握Pro版本FISCO BCOS区块链系统群组扩容、下线步骤。 +Pro版本FISCO BCOS区块链系统支持动态多群组区块链网络，可在系统运行时扩容产生新群组、下线群组。`BcosBuilder` +提供了新群组上线和下线功能，本章在[搭建Pro版区块链网络](./installation.md)的基础上扩容、下线群组`group2`，帮助用户掌握Pro版本FISCO +BCOS区块链系统群组扩容、下线步骤。 ```eval_rst @@ -43,13 +45,6 @@ $ sed -i .bkp 's/group0/group2/g' config.toml # 确认群组ID修改成功: 输出group2 $ cat config.toml | grep -i group_id group_id="group2" - -# 配置虚拟机类型为wasm -$ sed -i .bkp 's/vm_type="evm"/vm_type="wasm"/g' config.toml - -# 确认虚拟机类型修改成功： -$ cat config.toml|grep vm_type -vm_type="wasm" ``` **linux系统:** @@ -70,13 +65,6 @@ $ sed -i 's/group0/group2/g' config.toml # 确认群组ID修改成功: 输出group2 $ cat config.toml | grep -i group_id group_id="group2" - -# 配置虚拟机类型为wasm -$ sed -i 's/vm_type="evm"/vm_type="wasm"/g' config.toml - -# 确认虚拟机类型修改成功： -$ cat config.toml|grep vm_type -vm_type="wasm" ``` @@ -91,7 +79,7 @@ group_id="group2" # the genesis configuration path of the group, will generate new genesis configuration if not configurated # genesis_config_path = "" # VM type, now only support evm/wasm -vm_type="wasm" +vm_type = "evm" # use sm-crypto or not sm_crypto=false # enable auth-check or not @@ -243,61 +231,7 @@ generated/chain0/group2 ## 2. 向新群组发送交易 -新群组部署成功后，可使用控制台直接连接新群组`group2`，向新群组发送交易。控制台`contract/liquid`目录下提供了已经编译好的`hello_world`合约，这里直接使用即可。关于`webankblockchain-liquid（以下简称WBC-Liquid）`合约编写和编译，可参考[这里](https://liquid-doc.readthedocs.io/zh_CN/latest/)。 - -WBC-Liquid hello_world合约如下： - -```rust -#![cfg_attr(not(feature = "std"), no_std)] - -use liquid::storage; -use liquid_lang as liquid; - -#[liquid::contract] -mod hello_world { - use super::*; - - #[liquid(storage)] - struct HelloWorld { - name: storage::Value, - } - - #[liquid(methods)] - impl HelloWorld { - pub fn new(&mut self) { - self.name.initialize(String::from("Alice")); - } - - pub fn get(&self) -> String { - self.name.clone() - } - - pub fn set(&mut self, name: String) { - self.name.set(name) - } - } - - #[cfg(test)] - mod tests { - use super::*; - - #[test] - fn get_works() { - let contract = HelloWorld::new(); - assert_eq!(contract.get(), "Alice"); - } - - #[test] - fn set_works() { - let mut contract = HelloWorld::new(); - - let new_name = String::from("Bob"); - contract.set(new_name.clone()); - assert_eq!(contract.get(), "Bob"); - } - } -} -``` +新群组部署成功后，可使用控制台直接连接新群组`group2`，向新群组发送交易。 ```shell $ bash start group2 @@ -325,22 +259,19 @@ Type 'help' or 'h' for help. Type 'quit' or 'q' to quit console. peer0: 93d51a1a3af71dda7015d7be88818ef4f3e674cd0681e8184690ac0f504aee1148023eda30e3075958accda62e35161f42312ed4b56f44e23ae2e81c07734c60 peer1: a6448fd526eb90438621d653e59cd2c850cf60953cdf702471e62731b4363412f05319f92aa141c38031d9bf1d3d2067e5430585cfe8f38d74ebc20e6dacf9b3 -# 创建文件目录tmp -[group2]: /> mkdir tmp -Success -# 部署hello_world WBC-Liquid合约 -[group2]: /> deploy contracts/liquid/hello_world/hello_world.wasm contracts/liquid/hello_world/hello_world.abi tmp -transaction hash: 0x39bdce5954e39bfe0e2291a0373a5107fc7f29522f9dfddc69dcf1dd33e21bd4 -contract address: /tmp -currentAccount: 0x537149148696c7e6c3449331d77ddfaabc3c7a75 +# 部署hello_world合约 +[group2]: /> deploy HelloWorld +transaction hash: 0x796b573aece250bba891b9251b8fb464d22f41cb36e7cae407b2bd0a870f5b72 +contract address: 0x6849F21D1E455e9f0712b1e99Fa4FCD23758E8F1 +currentAccount: 0x7b047472a4516e9697446576f8c7fcc064f967fa # 获取当前块高 [group2]: /> getBlockNumber 2 # 调用tmp2目录下hello_world合约的get方法是，输出Alice -[group2]: /> call tmp get +[group2]: /> call HelloWorld 0x6849F21D1E455e9f0712b1e99Fa4FCD23758E8F1 get --------------------------------------------------------------------------------------------- Return code: 0 description: transaction executed successfully @@ -348,12 +279,12 @@ Return message: Success --------------------------------------------------------------------------------------------- Return value size:1 Return types: (string) -Return values:(Alice) +Return values:(Hello, World!) --------------------------------------------------------------------------------------------- # 设置hello_world的name为"Hello, Fisco" -[group2]: /> call tmp set "Hello, Fisco" -transaction hash: 0x87ee80ed586b185cbc17d33ade0b97b8436cc4c568538f68ae16cb6d9cfffcf0 +[group2]: /> call HelloWorld set "Hello, Fisco" +transaction hash: 0x2f7c85c2c59a76ccaad85d95b09497ad05ca7983c5ec79c8f9d102d1c8dddc30 --------------------------------------------------------------------------------------------- transaction status: 0 description: transaction executed successfully @@ -368,7 +299,7 @@ Event logs Event: {} # 获取更新后的name -[group2]: /> call tmp get +[group2]: /> call HelloWorld get --------------------------------------------------------------------------------------------- Return code: 0 description: transaction executed successfully From 058ab9408d2cef9ee7de03abb119fd4f8bb6e26f Mon Sep 17 00:00:00 2001 From: wenlinli <1574249665@qq.com> Date: Tue, 17 Oct 2023 14:17:17 +0800 Subject: [PATCH 2/7] add release v3.5.0 relate doc --- 2.x/docs/compatibility.md | 79 ++++++++++----- 3.x/zh_CN/docs/design/contract_directory.md | 2 +- .../docs/introduction/change_log/3_5_0.md | 96 +++++++++++++++++++ .../docs/introduction/change_log/index.rst | 17 ++++ 4 files changed, 168 insertions(+), 26 deletions(-) create mode 100644 3.x/zh_CN/docs/introduction/change_log/3_5_0.md diff --git a/2.x/docs/compatibility.md b/2.x/docs/compatibility.md index a048da347..be04ca8f9 100644 --- a/2.x/docs/compatibility.md +++ b/2.x/docs/compatibility.md @@ -81,6 +81,7 @@ FISCO-BCOS 3.0.0 及之后的版本之间相互兼容。FISCO-BCOS 3.0.0-rc的 - [v3.2.0](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html#fisco-bcos-v3-2-x) - [v3.3.0](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html#fisco-bcos-v3-3-x) - [v3.4.0](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html#fisco-bcos-v3-4-x) +- [v3.5.0](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html#fisco-bcos-v3-5-x) #### 3.2.1. FISCO-BCOS v3.0.0-rc1 @@ -336,28 +337,56 @@ FISCO-BCOS 3.0.0 及之后的版本之间相互兼容。FISCO-BCOS 3.0.0-rc的 #### 3.2.9. FISCO-BCOS v3.4.x -| 项目 | 功能简介 | 版本 | 文档 | github | gitee | 备注 | -| ------------------------------------- | -------------------------- | ----------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ---------------------------- | -| FISCO-BCOS | 区块链底层平台 | v3.4.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/) | [github](https://github.com/FISCO-BCOS/FISCO-BCOS/tree/v3.4.0) | [gitee](https://gitee.com/FISCO-BCOS/FISCO-BCOS/tree/v3.4.0) | | -| Solidity | solidity智能合约 | v0.8.11 | [文档](https://docs.soliditylang.org/en/v0.8.11) | | | **最高支持solidity v0.8.11** | -| JavaSDK | Java语言SDK | v3.4.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/sdk/java_sdk/index.html) | [github](https://github.com/FISCO-BCOS/java-sdk/tree/v3.4.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk/tree/v3.4.0) | | -| GoSDK | Go语言SDK | 开发中 | | [github](https://github.com/FISCO-BCOS/go-sdk) | | | -| PythonSDK | Python语言SDK | 暂不支持 | | | | | -| 控制台(console) | 交互式命令行工具 | v3.4.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/index.html) | [github](https://github.com/FISCO-BCOS/console/tree/v3.4.0) | [gitee](https://gitee.com/FISCO-BCOS/console/tree/v3.4.0) | | -| java-sdk-demo | Java压测工具 | v3.4.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/stress_testing.html) | [github](https://github.com/FISCO-BCOS/java-sdk-demo/tree/3.4.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk-demo/tree/3.4.0) | | -| spring-boot-starter | Gradle SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0-rc4#spring-boot-starter) | [github](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | | -| spring-boot-crud | Maven SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0-rc4#spring-boot-crud) | [github](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | | -| generator | 企业区块链部署工具 | 不支持 | | | | | -| WeBASE | 区块链中间件平台 | v3.0.2 | [文档](https://webasedoc.readthedocs.io/zh_CN/lab/) | [github](https://github.com/WeBankBlockchain/WeBASE/tree/master-3.0) | [gitee](https://gitee.com/WeBank/WeBASE/tree/master-3.0) | | -| WeCross | 跨链协作平台 | v1.3.0 | | | | | -| WeIdentity | 分布式身份解决方案 | v3.0.0-rc.1 | [文档](https://weidentity.readthedocs.io/zh_CN/latest/) | [github](https://github.com/WeBankBlockchain/WeIdentity) | [gitee](https://gitee.com/WeBank/WeIdentity) | | -| WeBankBlockchain-Data-Export | 数据导出组件 | V3 | [文档](https://data-doc.readthedocs.io/zh_CN/data_export_3.0/docs/WeBankBlockchain-Data-Export/index.html) | [github](https://github.com/WeBankBlockchain/Data-Export/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Data-Export/tree/V3/) | | -| WeBankBlockchain-Data-Stash | 数据仓库组件 | 不支持 | | | | | -| WeBankBlockchain-Data-Reconcile | 数据对账组件 | v1.0.0 | [文档](https://data-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Data-Reconcile/index.html) | [github](https://github.com/WeBankBlockchain/Data-Reconcile) | [gitee](https://gitee.com/WeBankBlockchain/Data-Reconcile) | | -| WeBankBlockchain-SmartDev-Scaffold | 应用开发脚手架 | V3 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Scaffold/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3/) | | -| WeBankBlockchain-SmartDev-SCGP | 智能合约编译插件 | v1.0.1 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-SCGP/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-SCGP) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-SCGP) | | -| WeBankBlockchain-SmartDev-Contract | 智能合约库 | v1.0.0 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Contract/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Contract) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Contract) | | -| WeBankBlockchain-Governance-Cert | 证书管理组件 | v1.0.1 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Cert/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Cert) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Cert) | | -| WeBankBlockchain-Governance-Key | 私钥管理组件 | v1.0.2 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Key/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Key) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Key) | | -| WeBankBlockchain-Governance-Authority | 权限治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Acct/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Account/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Account/tree/V3/) | | -| WeBankBlockchain-Governance-Account | 账户治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Auth/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Authority/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Authority/tree/V3/) | | +| 项目 | 功能简介 | 版本 | 文档 | github | gitee | 备注 | +|---------------------------------------|------------------------|-------------|-----------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|---------------------------------------------------------------------------|--------------------------| +| FISCO-BCOS | 区块链底层平台 | v3.4.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/) | [github](https://github.com/FISCO-BCOS/FISCO-BCOS/tree/v3.4.0) | [gitee](https://gitee.com/FISCO-BCOS/FISCO-BCOS/tree/v3.4.0) | | +| Solidity | solidity智能合约 | v0.8.11 | [文档](https://docs.soliditylang.org/en/v0.8.11) | | | **最高支持solidity v0.8.11** | +| JavaSDK | Java语言SDK | v3.4.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/sdk/java_sdk/index.html) | [github](https://github.com/FISCO-BCOS/java-sdk/tree/v3.4.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk/tree/v3.4.0) | | +| GoSDK | Go语言SDK | 开发中 | | [github](https://github.com/FISCO-BCOS/go-sdk) | | | +| PythonSDK | Python语言SDK | 暂不支持 | | | | | +| 控制台(console) | 交互式命令行工具 | v3.4.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/index.html) | [github](https://github.com/FISCO-BCOS/console/tree/v3.4.0) | [gitee](https://gitee.com/FISCO-BCOS/console/tree/v3.4.0) | | +| java-sdk-demo | Java压测工具 | v3.4.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/stress_testing.html) | [github](https://github.com/FISCO-BCOS/java-sdk-demo/tree/3.4.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk-demo/tree/3.4.0) | | +| spring-boot-starter | Gradle SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0-rc4#spring-boot-starter) | [github](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | | +| spring-boot-crud | Maven SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0-rc4#spring-boot-crud) | [github](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | | +| generator | 企业区块链部署工具 | 不支持 | | | | | +| WeBASE | 区块链中间件平台 | v3.0.2 | [文档](https://webasedoc.readthedocs.io/zh_CN/lab/) | [github](https://github.com/WeBankBlockchain/WeBASE/tree/master-3.0) | [gitee](https://gitee.com/WeBank/WeBASE/tree/master-3.0) | | +| WeCross | 跨链协作平台 | v1.3.0 | | | | | +| WeIdentity | 分布式身份解决方案 | v3.0.0-rc.1 | [文档](https://weidentity.readthedocs.io/zh_CN/latest/) | [github](https://github.com/WeBankBlockchain/WeIdentity) | [gitee](https://gitee.com/WeBank/WeIdentity) | | +| WeBankBlockchain-Data-Export | 数据导出组件 | V3 | [文档](https://data-doc.readthedocs.io/zh_CN/data_export_3.0/docs/WeBankBlockchain-Data-Export/index.html) | [github](https://github.com/WeBankBlockchain/Data-Export/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Data-Export/tree/V3/) | | +| WeBankBlockchain-Data-Stash | 数据仓库组件 | 不支持 | | | | | +| WeBankBlockchain-Data-Reconcile | 数据对账组件 | v1.0.0 | [文档](https://data-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Data-Reconcile/index.html) | [github](https://github.com/WeBankBlockchain/Data-Reconcile) | [gitee](https://gitee.com/WeBankBlockchain/Data-Reconcile) | | +| WeBankBlockchain-SmartDev-Scaffold | 应用开发脚手架 | V3 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Scaffold/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3/) | | +| WeBankBlockchain-SmartDev-SCGP | 智能合约编译插件 | v1.0.1 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-SCGP/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-SCGP) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-SCGP) | | +| WeBankBlockchain-SmartDev-Contract | 智能合约库 | v1.0.0 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Contract/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Contract) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Contract) | | +| WeBankBlockchain-Governance-Cert | 证书管理组件 | v1.0.1 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Cert/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Cert) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Cert) | | +| WeBankBlockchain-Governance-Key | 私钥管理组件 | v1.0.2 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Key/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Key) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Key) | | +| WeBankBlockchain-Governance-Authority | 权限治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Acct/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Account/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Account/tree/V3/) | | +| WeBankBlockchain-Governance-Account | 账户治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Auth/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Authority/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Authority/tree/V3/) | | + +#### 3.2.10. FISCO-BCOS v3.5.x + +| 项目 | 功能简介 | 版本 | 文档 | github | gitee | 备注 | +|---------------------------------------|------------------------|-------------|-----------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|---------------------------------------------------------------------------|--------------------------| +| FISCO-BCOS | 区块链底层平台 | v3.5.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/) | [github](https://github.com/FISCO-BCOS/FISCO-BCOS/tree/v3.5.0) | [gitee](https://gitee.com/FISCO-BCOS/FISCO-BCOS/tree/v3.5.0) | | +| Solidity | solidity智能合约 | v0.8.11 | [文档](https://docs.soliditylang.org/en/v0.8.11) | | | **最高支持solidity v0.8.11** | +| JavaSDK | Java语言SDK | v3.5.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/sdk/java_sdk/index.html) | [github](https://github.com/FISCO-BCOS/java-sdk/tree/v3.5.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk/tree/v3.5.0) | | +| GoSDK | Go语言SDK | 开发中 | | [github](https://github.com/FISCO-BCOS/go-sdk) | | | +| PythonSDK | Python语言SDK | 暂不支持 | | | | | +| 控制台(console) | 交互式命令行工具 | v3.5.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/index.html) | [github](https://github.com/FISCO-BCOS/console/tree/v3.5.0) | [gitee](https://gitee.com/FISCO-BCOS/console/tree/v3.5.0) | | +| java-sdk-demo | Java压测工具 | v3.5.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/stress_testing.html) | [github](https://github.com/FISCO-BCOS/java-sdk-demo/tree/3.5.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk-demo/tree/3.5.0) | | +| spring-boot-starter | Gradle SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0-rc4#spring-boot-starter) | [github](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | | +| spring-boot-crud | Maven SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0-rc4#spring-boot-crud) | [github](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | | +| generator | 企业区块链部署工具 | 不支持 | | | | | +| WeBASE | 区块链中间件平台 | v3.0.2 | [文档](https://webasedoc.readthedocs.io/zh_CN/lab/) | [github](https://github.com/WeBankBlockchain/WeBASE/tree/master-3.0) | [gitee](https://gitee.com/WeBank/WeBASE/tree/master-3.0) | | +| WeCross | 跨链协作平台 | v1.3.0 | | | | | +| WeIdentity | 分布式身份解决方案 | v3.0.0-rc.1 | [文档](https://weidentity.readthedocs.io/zh_CN/latest/) | [github](https://github.com/WeBankBlockchain/WeIdentity) | [gitee](https://gitee.com/WeBank/WeIdentity) | | +| WeBankBlockchain-Data-Export | 数据导出组件 | V3 | [文档](https://data-doc.readthedocs.io/zh_CN/data_export_3.0/docs/WeBankBlockchain-Data-Export/index.html) | [github](https://github.com/WeBankBlockchain/Data-Export/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Data-Export/tree/V3/) | | +| WeBankBlockchain-Data-Stash | 数据仓库组件 | 不支持 | | | | | +| WeBankBlockchain-Data-Reconcile | 数据对账组件 | v1.0.0 | [文档](https://data-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Data-Reconcile/index.html) | [github](https://github.com/WeBankBlockchain/Data-Reconcile) | [gitee](https://gitee.com/WeBankBlockchain/Data-Reconcile) | | +| WeBankBlockchain-SmartDev-Scaffold | 应用开发脚手架 | V3 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Scaffold/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3/) | | +| WeBankBlockchain-SmartDev-SCGP | 智能合约编译插件 | v1.0.1 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-SCGP/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-SCGP) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-SCGP) | | +| WeBankBlockchain-SmartDev-Contract | 智能合约库 | v1.0.0 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Contract/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Contract) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Contract) | | +| WeBankBlockchain-Governance-Cert | 证书管理组件 | v1.0.1 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Cert/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Cert) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Cert) | | +| WeBankBlockchain-Governance-Key | 私钥管理组件 | v1.0.2 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Key/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Key) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Key) | | +| WeBankBlockchain-Governance-Authority | 权限治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Acct/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Account/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Account/tree/V3/) | | +| WeBankBlockchain-Governance-Account | 账户治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Auth/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Authority/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Authority/tree/V3/) | | diff --git a/3.x/zh_CN/docs/design/contract_directory.md b/3.x/zh_CN/docs/design/contract_directory.md index 90f1408d1..a857fe799 100644 --- a/3.x/zh_CN/docs/design/contract_directory.md +++ b/3.x/zh_CN/docs/design/contract_directory.md @@ -205,7 +205,7 @@ BFS存储表生命周期主要包括创建、修改、读取，暂时不支持 - **值得注意的是：** Solidity的地址由于其不可读的性质与BFS易读可见的原则相悖，因此Solidity部署后的合约地址只生成合约存储表，其BFS元数据不会写入 `/apps` 表内。例如：用户部署合约后地址为 0x123456，链上将会为合约创建合约存储表`/apps/123456`，但并不会将元数据写入到 `/apps` 内，即用户调用`list(/apps)`，不会显示子目录有`123456`这个资源。用户后续可以通过link操作，将solidity合约地址与BFS进行绑定。 - 在用户发起创建Table合约请求时，将会在 `/tables` 目录下创建对应的合约资源表，例如：创建Table合约 t_test合约时，将会创建 `/tables/t_test` 的存储表。 - 在执行合约时，将会读取合约资源对应的存储表中的状态数据。 -- 在部署普通合约是，将会创建合约的权限数据表，详情请参考：[权限底层节点设计](./committee_design.html#id15) +- 在部署普通合约时，将会创建合约的权限数据表，详情请参考：[权限底层节点设计](./committee_design.html#id15) #### 2.5.3 合约软链接资源生命周期 diff --git a/3.x/zh_CN/docs/introduction/change_log/3_5_0.md b/3.x/zh_CN/docs/introduction/change_log/3_5_0.md new file mode 100644 index 000000000..cab33c509 --- /dev/null +++ b/3.x/zh_CN/docs/introduction/change_log/3_5_0.md @@ -0,0 +1,96 @@ +# v3.5.0 + +#### 新增 + +* [新增rPBFT共识算法](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3602) +* [支持交易同步、区块同步的树状广播](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3630,) +* [交易池按时间顺序打包交易](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3889) +* [新增Paillier预编译合约](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3757) +* [支持用tars rpc协议发交易](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3718) + +#### 修改 + +* [日志打印优化](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3845) + +#### 修复 + +* [修复交易池通知打包模块错误交易量的bug](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3715) +* [修复共识模块Proposal验证漏洞以及CheckPoint的Timer计时问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3759) +* [修复共识模块Proposal验证失败未正确处理交易导致交易池积压交易的问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3809) +* [修复call with sign接口在Pro架构的国密节点中验证失败的问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3797) +* [修复代码覆盖率统计异常的问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3777) +* [修复DAG执行时自锁的问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3831) +* [同步3.2.x修复的bug](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3899) +* [修复evm缓存失效的问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3854) +* [修复gateway发送损坏消息包的问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3825) +* [修复归档工具重导入时对abi字段的处理](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3820) +* [修复归档工具重导入时对nonce字段的处理](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3811) +* [build_chain.sh 建链脚本-l参数支持解析域名](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3931) +* [修复节点接收到USR1/USR2信号后导致boost log死锁问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3947) +* [修复取默克尔证明时阻塞rpc请求的问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3955) + + +* 历史版本升级 + + 需要升级的链的“数据兼容版本号（[compatibility_version](#id5)）”为如下版本时： + + * 3.4.x、3.5.x：数据完全兼容当前版本，直接替换二进制即可完成升级 + * + 3.3.x、3.2.x、3.1.x、3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](#id5) + * 3.0-rc x：数据不兼容，无法升级，可考虑逐步将业务迁移至3.x正式版 + * 2.x：数据不兼容，2.x版本仍持续维护，可考虑升级为2.x的最新版本 + +**组件兼容性** + +| | 推荐版本 | 最低版本 | 说明 | +|------------|-------------|---------------------|-------------------| +| WeBASE | 3.0.2 | 3.0.2 | | +| WeIdentity | v3.0.0-rc.1 | v3.0.0-rc.1 | | +| Console | 3.5.0 | 3.0.0 | | +| Java SDK | 3.5.0 | 3.0.0 | | +| CPP SDK | 3.5.0 | 3.0.0 | | +| Solidity | 0.8.11 | 最低 0.4.25，最高 0.8.11 | 需根据合约版本下载编译器（控制台） | +| WBC-Liquid | 1.0.0-rc3 | 1.0.0-rc3 | | + +#### 升级方法 + +该操作仅支持将3.x版本升级为本版本，不支持3.0-rc或2.x的升级。 + +##### 查询数据兼容版本号（compatibility_version） + +用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#getsystemconfigbykey) +进行查询，如当前返回的版本为3.0.0 + +``` +[group0]: /apps> getSystemConfigByKey compatibility_version +3.0.0 +``` + +##### 替换节点二进制 + +需将**所有节点** +的二进制逐步替换为当前版本。为了不影响业务，替换过程能够以灰度方式进行，逐个替换并重启节点。替换过程中，当前的链仍然会以旧的数据兼容版本号的逻辑继续执行。当所有节点二进制替换完成并重启后，需用控制台修改数据兼容版本号为当前版本。 + +##### 设置数据兼容版本号（compatibility_version） + +用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#setsystemconfigbykey) +设置数据兼容版本号，如当前版本为3.4.0。 + +``` +[group0]: /apps> setSystemConfigByKey compatibility_version 3.5.0 +{ + "code":0, + "msg":"success" +} + +注：若开启权限治理功能，需要使用 setSysConfigProposal 命令 +``` + +设置成功，再次查询，得到当前版本已升级为3.5.0 + +``` +[group0]: /apps> getSystemConfigByKey compatibility_version +3.5.0 +``` + +当前链已经完成升级，至此，**链开始以新的逻辑继续运行**，并支持了新的特性。 diff --git a/3.x/zh_CN/docs/introduction/change_log/index.rst b/3.x/zh_CN/docs/introduction/change_log/index.rst index 0cc3b7a78..d40f92c78 100644 --- a/3.x/zh_CN/docs/introduction/change_log/index.rst +++ b/3.x/zh_CN/docs/introduction/change_log/index.rst @@ -20,6 +20,23 @@ FISCO BCOS 版本迭代，支持版本之间的兼容升级，支持可灰度升 upgrade.md +v3.5.x +------------------ + +.. admonition:: FISCO BCOS 3.x Releases + + - `FISCO BCOS v3.5.0 <./3_5_0.html>`_ [`release `_] + + +.. admonition:: 查看节点和数据版本 + + - 查看Air版本FISCO BCOS节点二进制版本：``./fisco-bcos --version`` + - 查看Pro版本FISCO BCOS节点二进制版本：``./BcosNodeService --version``, ``./BcosRpcService --version``, ``./BcosGatewayService --version`` + - 查看Max版本FISCO BCOS节点二进制版本：``./BcosMaxNodeService --version``, ``./BcosRpcService --version``, ``./BcosGatewayService --version``, ``./BcosExecutorService --version`` + - 查看轻节点二进制版本：``../fisco-bcos-lightnode --version`` + - 查看轻节点相关文档，请参考 [`轻节点搭建工具 `_] + + v3.4.x ------------------ From 7f7d6acb770fdac6d0a9aa1135c2a2054ee8a177 Mon Sep 17 00:00:00 2001 From: wenlinli <1574249665@qq.com> Date: Tue, 17 Oct 2023 14:34:33 +0800 Subject: [PATCH 3/7] update --- 3.x/zh_CN/docs/introduction/change_log/index.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/3.x/zh_CN/docs/introduction/change_log/index.rst b/3.x/zh_CN/docs/introduction/change_log/index.rst index d40f92c78..91c5bc534 100644 --- a/3.x/zh_CN/docs/introduction/change_log/index.rst +++ b/3.x/zh_CN/docs/introduction/change_log/index.rst @@ -36,6 +36,11 @@ v3.5.x - 查看轻节点二进制版本：``../fisco-bcos-lightnode --version`` - 查看轻节点相关文档，请参考 [`轻节点搭建工具 `_] +.. toctree:: + :hidden: + :maxdepth: 0 + + 3_5_0.md v3.4.x ------------------ @@ -53,7 +58,11 @@ v3.4.x - 查看轻节点二进制版本：``../fisco-bcos-lightnode --version`` - 查看轻节点相关文档，请参考 [`轻节点搭建工具 `_] +.. toctree:: + :hidden: + :maxdepth: 0 + 3_4_0.md v3.3.x ------------------ From cd8746c4e32ae4ad39cc1c0b30c3bffe4e14d5ea Mon Sep 17 00:00:00 2001 From: wenlinli <1574249665@qq.com> Date: Tue, 17 Oct 2023 14:42:12 +0800 Subject: [PATCH 4/7] 1 --- 3.x/zh_CN/docs/introduction/change_log/3_5_0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/3.x/zh_CN/docs/introduction/change_log/3_5_0.md b/3.x/zh_CN/docs/introduction/change_log/3_5_0.md index cab33c509..53ebb56d4 100644 --- a/3.x/zh_CN/docs/introduction/change_log/3_5_0.md +++ b/3.x/zh_CN/docs/introduction/change_log/3_5_0.md @@ -74,7 +74,7 @@ ##### 设置数据兼容版本号（compatibility_version） 用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#setsystemconfigbykey) -设置数据兼容版本号，如当前版本为3.4.0。 +设置数据兼容版本号，如当前版本为3.5.0。 ``` [group0]: /apps> setSystemConfigByKey compatibility_version 3.5.0 From 2c592b8fa2ee36ce83dcebaa0cf13048a4fe6899 Mon Sep 17 00:00:00 2001 From: wenlinli <1574249665@qq.com> Date: Tue, 17 Oct 2023 16:59:00 +0800 Subject: [PATCH 5/7] fix error --- 3.x/zh_CN/docs/introduction/change_log/3_5_0.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/3.x/zh_CN/docs/introduction/change_log/3_5_0.md b/3.x/zh_CN/docs/introduction/change_log/3_5_0.md index 53ebb56d4..88d94a5c4 100644 --- a/3.x/zh_CN/docs/introduction/change_log/3_5_0.md +++ b/3.x/zh_CN/docs/introduction/change_log/3_5_0.md @@ -35,8 +35,7 @@ 需要升级的链的“数据兼容版本号（[compatibility_version](#id5)）”为如下版本时： * 3.4.x、3.5.x：数据完全兼容当前版本，直接替换二进制即可完成升级 - * - 3.3.x、3.2.x、3.1.x、3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](#id5) + * 3.3.x、3.2.x、3.1.x、3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](#id5) * 3.0-rc x：数据不兼容，无法升级，可考虑逐步将业务迁移至3.x正式版 * 2.x：数据不兼容，2.x版本仍持续维护，可考虑升级为2.x的最新版本 From 2bf5b9c0ea84b69a78d3f902b4c38086fc48b9a3 Mon Sep 17 00:00:00 2001 From: wenlinli <1574249665@qq.com> Date: Tue, 17 Oct 2023 17:22:40 +0800 Subject: [PATCH 6/7] add start feature example --- .../docs/introduction/change_log/3_5_0.md | 40 ++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/3.x/zh_CN/docs/introduction/change_log/3_5_0.md b/3.x/zh_CN/docs/introduction/change_log/3_5_0.md index 88d94a5c4..5760ae27d 100644 --- a/3.x/zh_CN/docs/introduction/change_log/3_5_0.md +++ b/3.x/zh_CN/docs/introduction/change_log/3_5_0.md @@ -35,10 +35,29 @@ 需要升级的链的“数据兼容版本号（[compatibility_version](#id5)）”为如下版本时： * 3.4.x、3.5.x：数据完全兼容当前版本，直接替换二进制即可完成升级 - * 3.3.x、3.2.x、3.1.x、3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](#id5) + * + 3.3.x、3.2.x、3.1.x、3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](#id5) * 3.0-rc x：数据不兼容，无法升级，可考虑逐步将业务迁移至3.x正式版 * 2.x：数据不兼容，2.x版本仍持续维护，可考虑升级为2.x的最新版本 + +* 开启实验功能 + + 效果：通过feature开关控制实验功能的开启 + + 操作：升级节点可执行程序后，通过控制台命令`setSystemConfigByKey 1` 开启对应实验功能，具体操作见文档升级方法部分 + + 注意事项： + * feature操作不可逆，打开后不可关闭 + * 需确认所有可执行程序版本相同后，再进行feature开启操作 + +| | Feature 名 | 默认状态 | 说明 | +|---------|---------------------|------|--------------------------------------------| +| 块内分片 | feature_sharding | 关：0 | 默认关闭，仅在从3.3、3.4升级至当前版本时，feature_sharding打开 | +| 同态加密 | feature_paillier | 关：0 | 默认关闭 | +| rpbft共识 | feature_rpbft | 关：0 | 默认关闭 | +| bug修复 | bugfix_\ | 开：1 | 从低版本升级默认关闭 | + **组件兼容性** | | 推荐版本 | 最低版本 | 说明 | @@ -93,3 +112,22 @@ ``` 当前链已经完成升级，至此，**链开始以新的逻辑继续运行**，并支持了新的特性。 + +##### 通过feature开关开启rpbft共识 + +通过控制台getSystemConfigByKey命令，查看当前rpbft的feature是否开启 + +``` +[group0]: /apps> getSystemConfigByKey feature_rpbft +0 +``` + +通过setSystemConfigByKey 命令，开启rpbft的feature，启用rpbft共识 + +``` +[group0]: /apps> setSystemConfigByKey feature_rpbft 1 +{ + "code":0, + "msg":"success" +} +``` \ No newline at end of file From 3b5676219f98445df7b128a9b51d733b1624c3b2 Mon Sep 17 00:00:00 2001 From: wenlinli <1574249665@qq.com> Date: Tue, 17 Oct 2023 17:26:13 +0800 Subject: [PATCH 7/7] add some --- 3.x/zh_CN/docs/introduction/change_log/3_5_0.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/3.x/zh_CN/docs/introduction/change_log/3_5_0.md b/3.x/zh_CN/docs/introduction/change_log/3_5_0.md index 5760ae27d..29868a00d 100644 --- a/3.x/zh_CN/docs/introduction/change_log/3_5_0.md +++ b/3.x/zh_CN/docs/introduction/change_log/3_5_0.md @@ -115,7 +115,7 @@ ##### 通过feature开关开启rpbft共识 -通过控制台getSystemConfigByKey命令，查看当前rpbft的feature是否开启 +通过控制台getSystemConfigByKey命令，查看当前rpbft的feature的状态 ``` [group0]: /apps> getSystemConfigByKey feature_rpbft @@ -130,4 +130,11 @@ "code":0, "msg":"success" } +``` + +通过控制台getSystemConfigByKey命令，查看当前rpbft的feature是否已开启，feature的值为1表示已开启 + +``` +[group0]: /apps> getSystemConfigByKey feature_rpbft +0 ``` \ No newline at end of file