Release v3.1.1 (#1599)

* update version to 3.1.1

* update storage security

2.x/docs/articles/3_features/30_architecture/group_architecture_practice.md

@@ -143,4 +143,4 @@ Switched to group 2
 
 ## 总结
 
-本文介绍了搭建仲裁链的关键过程，FISCO BCOS 2.0的操作文档step by step介绍了如何部署多群组区块链，详细流程可以参考[https://fisco-bcos-documentation.readthedocs.io/zh_CN/release-2.0/docs/tutorial/group_use_cases.html](https://fisco-bcos-documentation.readthedocs.io/zh_CN/release-2.0/docs/tutorial/group_use_cases.html)
+本文介绍了搭建仲裁链的关键过程，FISCO BCOS 2.0的操作文档step by step介绍了如何部署多群组区块链，详细流程可以参考[多群组部署](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/group_use_cases.html)

2.x/docs/compatibility.md

@@ -11,8 +11,8 @@
 `FISCO-BCOS`目前主要存在`2.x`[[文档链接](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/)]和`3.x`[[文档链接](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/)]两个大版本，用户可以根据不同的场景选择:
 
 - v2.x和v3.x版本之间不兼容，后续会同时保持维护、迭代、更新。<br>
-- v2.x是目前的稳定版本，最新为v2.9.1，已经经过多个机构、多个应用，长时间在生产环境中的实践检验，具备金融级的高性能、高可用性及高安全性。**用户当前有生产级的使用需求，可以直接使用v2.x即可**。<br>
-- v3.x当前处于rc阶段，最新为v3.0.0-rc4，将会在八月份前后发布正式版本，届时生产环境可以使用3.0正式版本。也**欢迎用户预先体验3.0的新特性**。
+- v2.x是目前的稳定版本，已经经过多个机构、多个应用，长时间在生产环境中的实践检验，具备金融级的高性能、高可用性及高安全性。该版本会持续进行维护。**用户当前有生产级的使用需求，可以直接使用v2.x即可**。<br>
+- v3.x为当前FISCO-BCOS最新的版本，采用微服务的架构，已发布正式版，欢迎体验。
 
 ## 2. JDK版本说明
 
@@ -77,6 +77,7 @@ FISCO-BCOS 3.0.0 及之后的版本之间相互兼容。FISCO-BCOS 3.0.0-rc的
 - [v3.0.0-rc3](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html#fisco-bcos-v3-0-0-rc3)
 - [v3.0.0-rc4](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html#fisco-bcos-v3-0-0-rc4)
 - [v3.0.0](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html#fisco-bcos-v3-0-0)
+- [v3.1.0](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html#fisco-bcos-v3-1-0)
 
 #### 3.2.1. FISCO-BCOS v3.0.0-rc1
 
@@ -218,3 +219,31 @@ FISCO-BCOS 3.0.0 及之后的版本之间相互兼容。FISCO-BCOS 3.0.0-rc的
 | 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.6. FISCO-BCOS v3.1.x
+
+| 项目                                  | 功能简介                   | 版本                      | 文档                                                         | github                                                       | gitee                                                        | 备注                         |
+| ------------------------------------- | -------------------------- | ------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ---------------------------- |
+| FISCO-BCOS                            | 区块链底层平台             | v3.1.x                    | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/)  | [github](https://github.com/FISCO-BCOS/FISCO-BCOS/tree/v3.1.0) | [gitee](https://gitee.com/FISCO-BCOS/FISCO-BCOS/tree/v3.1.0) |                              |
+| Solidity                              | solidity智能合约           | v0.8.11                   | [文档](https://docs.soliditylang.org/en/v0.8.11)             |                                                              |                                                              | **最高支持solidity v0.8.11** |
+| JavaSDK                               | Java语言SDK                | v3.1.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.1.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk/tree/v3.1.0)   |                              |
+| GoSDK                                 | Go语言SDK                  | 暂不支持</br>后续版本规划 |                                                              |                                                              |                                                              |                              |
+| PythonSDK                             | Python语言SDK              | 暂不支持</br>后续版本规划 |                                                              |                                                              |                                                              |                              |
+| 控制台(console)                       | 交互式命令行工具           | v3.1.x                    | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/index.html) | [github](https://github.com/FISCO-BCOS/console/tree/v3.1.0)  | [gitee](https://gitee.com/FISCO-BCOS/console/tree/v3.1.0)    |                              |
+| java-sdk-demo                         | Java压测工具               | v3.1.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.1.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk-demo/tree/3.1.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.0                    | [文档](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                            | 分布式身份解决方案         | v1.8.5-rc1                | [文档](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.x/release_note.txt

@@ -1 +1 @@
-v3.1.0
+v3.1.1

3.x/zh_CN/conf.py

@@ -87,7 +87,7 @@
 # The short X.Y version.
 version = '3.0'
 # The full version, including alpha/beta/rc tags.
-release = 'v3.1.0'
+release = 'v3.1.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

3.x/zh_CN/docs/change_log/3_1_1.md

@@ -0,0 +1,71 @@
+# v3.1.1
+
+#### 新增
+
+* 支持在MacOS上通过建链脚本（[`build_chain.sh`](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/tutorial/air/build_chain.html)）直接下载二进制建链，无需手动编译节点二进制（[#3179](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3179)）
+
+#### 修复
+
+* 共识模块快速视图切换的问题（[#3168](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3168)）
+* 测试合约初始化逻辑修复（[#3182](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3182)）
+* gateway回包问题修复（[#3197](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3197)）
+* DMC执行时消息包类型错误修复（[#3198](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3198)）
+
+#### 兼容性
+
+* 历史版本升级
+
+  需要升级的链的“数据兼容版本号（[compatibility_version](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/change_log/3_1_1.html#id5)）”为如下版本时：
+
+  * 3.1.0：本版本的数据兼容版本号依然为3.1.0，直接替换二进制即可完成升级
+  * 3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/change_log/3_1_1.html#id5)
+  * 3.0-rc x：数据不兼容，无法升级，可考虑逐步将业务迁移至3.x正式版
+  * 2.x：数据不兼容，2.x版本仍持续维护，可考虑升级为2.x的最新版本
+
+* 组件兼容性
+
+|            | 推荐版本  | 最低版本                 | 说明                               |
+| ---------- | --------- | ------------------------ | ---------------------------------- |
+| Console    | 3.1.0     | 3.0.0                    |                                    |
+| Java SDK   | 3.1.0     | 3.0.0                    |                                    |
+| CPP SDK    | 3.0.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/develop/console/console_commands.html#getsystemconfigbykey)进行查询，如当前返回的版本为3.0.1
+
+``` 
+[group0]: /apps>  getSystemConfigByKey compatibility_version
+3.0.1
+```
+
+##### 替换节点二进制
+
+需将**所有节点**的二进制逐步替换为当前版本。为了不影响业务，替换过程能够以灰度方式进行，逐个替换并重启节点。替换过程中，当前的链仍然会以旧的数据兼容版本号的逻辑继续执行。当所有节点二进制替换完成并重启后，需用控制台修改数据兼容版本号为当前版本。
+
+##### 设置数据兼容版本号（compatibility_version）
+
+用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/console_commands.html#setsystemconfigbykey)设置数据兼容版本号，如当前版本为3.1.0
+
+```
+[group0]: /apps>  setSystemConfigByKey compatibility_version 3.1.0
+{
+    "code":0,
+    "msg":"success"
+}
+```
+
+设置成功，再次查询，得到当前版本已升级为3.1.0
+
+``` 
+[group0]: /apps>  getSystemConfigByKey compatibility_version
+3.1.0
+```
+
+当前链已经完成升级，至此，**链开始以新的逻辑继续运行**，并支持了新的特性。

3.x/zh_CN/docs/design/tx_procedure.md

@@ -4,7 +4,7 @@
 
 交易的一生，贯穿下图所示的各个阶段。本文将梳理交易的整个流转过程，一窥FISCO BCOS交易完整生命周期。
 
-<img src="../../../../2.x/images/articles/transaction_lifetime/IMG_5188.PNG" style="zoom:90%;" />
+<img src="https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/_images/IMG_51881.PNG" style="zoom:90%;" />
 
 ## 交易生成
 
@@ -17,13 +17,13 @@
 
 之后，区块链客户端会再向交易填充一些必要的字段，如用于防交易重放的交易ID及blockLimit。交易的具体结构和字段含义可以参考[编码协议文档](./protocol_description.md)，交易构造完成后，客户端随后便通过RPC信道将交易发送给节点。
 
-<img src="../../../../2.x/images/articles/transaction_lifetime/IMG_5189.PNG" style="zoom:60%;" />
+<img src="https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/_images/IMG_51891.PNG" style="zoom:60%;" />
 
 ## 交易池
 
 区块链交易被发送到节点后，节点会通过验证交易签名的方式来验证一笔交易是否合法。若一笔交易合法，则节点会进一步检查该交易是否重复出现过，若从未出现过，则将交易加入交易池缓存起来。若交易不合法或交易重复出现，则将直接丢弃交易。
 
-<img src="../../../../2.x/images/articles/transaction_lifetime/IMG_5190.PNG" style="zoom:60%;" />
+<img src="https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/_images/IMG_51901.PNG" style="zoom:60%;" />
 
 ## 交易广播
 
@@ -35,15 +35,15 @@
 
 为了提高交易处理效率，同时也为了确定交易之后的执行顺序保证事务性，当交易池中有交易时，Sealer线程负责从交易池中按照先进先出的顺序取出一定数量的交易，组装成待共识区块，随后待共识区块会被发往各个节点进行处理。
 
-<img src="../../../../2.x/images/articles/transaction_lifetime/IMG_5191.JPG" style="zoom:60%;" />
+<img src="https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/_images/IMG_51911.JPG" style="zoom:60%;" />
 
 ## 交易执行
 
 节点在收到区块后，会调用区块验证器把交易从区块中逐一拿出来执行。如果是预编译合约代码，验证器中的执行引擎会直接调用相应的C++功能，否则执行引擎就会把交易交给EVM（以太坊虚拟机）执行。
 
 交易可能会执行成功，也可能因为逻辑错误或Gas不足等原因执行失败。交易执行的结果和状态会封装在交易回执中返回。
 
-<img src="../../../../2.x/images/articles/transaction_lifetime/IMG_5192.JPG" style="zoom:60%;" />
+<img src="https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/_images/IMG_51921.JPG" style="zoom:60%;" />
 
 ## 交易共识
 

3.x/zh_CN/docs/manual/faq/index.md

@@ -10,4 +10,4 @@ A:
 Q:
   Whether the node supports binary operation with version numbers inconsistent with the genesis block? <br>
 A: 
-  The minimum version currently supported by FISCO BCOS is 3.0.0-rc4, and the highest supported version is v3.1.0. Binaries not within this range will not be able to start.
+  The minimum version currently supported by FISCO BCOS is 3.0.0-rc4, and the highest supported version is v3.1.1. Binaries not within this range will not be able to start.