Skip to content

Commit

Permalink
add changeLog for 2.7.0 (#1055)
Browse files Browse the repository at this point in the history
* add changeLog for 2.7.0

* modify version of fisco and console to 2.7.0
  • Loading branch information
cyjseagull committed Nov 20, 2020
1 parent 86b7528 commit 77e4eb6
Show file tree
Hide file tree
Showing 22 changed files with 182 additions and 32 deletions.
4 changes: 2 additions & 2 deletions conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -107,9 +107,9 @@ def _patched_fetch_urls(lfs_url, oid_list):
# built documents.
#
# The short X.Y version.
version = '2.6'
version = '2.7'
# The full version, including alpha/beta/rc tags.
release = 'v2.6.0'
release = 'v2.7.0'

# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
Expand Down
2 changes: 1 addition & 1 deletion docs/articles/4_tools/five_step_to_develop_application.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ $ bash nodes/127.0.0.1/start_all.sh
控制台是一个可以交互式访问区块链,进行区块链数据读写请求的工具。无需太多解释,**四步完成控制台安装:**

```
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh -c 1.2.0
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh -c 1.2.0
$ cp -n console/conf/applicationContext-sample.xml console/conf/applicationContext.xml
$ cp nodes/127.0.0.1/sdk/* console/conf/
$ cd console && ./start.sh
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -267,7 +267,7 @@ info|2020-09-04 17:34:22.459794|[g:1][CONSENSUS][SEALER]++++++++++++++++ Generat

```bash
# 下载控制台
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh
$ cd console

# 拷贝证书
Expand Down
56 changes: 56 additions & 0 deletions docs/change_log/2_7_0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# [v2.7.0](https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.7.0)

```eval_rst
.. admonition:: v2.6.x升级到v2.7.0
- **兼容升级** :直接替换v2.6.x节点的二进制为 `v2.7.0二进制 <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.7.0/fisco-bcos.tar.gz>`_ ,升级后的版本修复v2.6.x中的bug,并支持取消事件订阅、查询节点订阅的topics信息、批量返回交易回执等功能,且节点交易和区块相关的RPC接口返回了交易和区块的所有字段内容、节点返回的回执信息中带有交易执行的错误信息
- **全面升级** :参考 `安装 <../installation.html>`_ 搭建新链,重新向新节点提交所有历史交易,升级后节点包含v2.7.0所有新特性
- `v2.7.0 Release Note <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.7.0>`_
```

## 变更描述

**新增**

- 合约生命周期管理提供revokeManager功能,可通过`v2.7.0`控制台的[revokeContractStatusManager命令](../manual/console_of_java_sdk.html#revokecontractstatusmanager)使用
- 新增委员权限投票的查询接口,可通过`v2.7.0`控制台的[queryVotesOfThreshold](../manual/console_of_java_sdk.html#queryvotesofthreshold)[queryVotesOfMember](../manual/console_of_java_sdk.html#queryvotesofmember)使用
- 支持取消事件订阅
- 添加批量返回回执的方法[getBatchReceiptsByBlockNumberAndRange](../api.html#getbatchreceiptsbyblocknumberandrange)[getBatchReceiptsByBlockHashAndRange](../api.html#getbatchreceiptsbyblockhashandrange)
- 添加[getNodeInfo](../api.html#getnodeinfo)接口,返回节点订阅的topics信息
- Table合约增加address类型的EQ condition查询

**更改**

- MySQL存储模式支持MySQL 8.0
- 重构交易和区块相关的RPC接口,返回交易和区块的所有字段内容
- 交易推送的回执中带有交易执行结果的报错信息
- P2P模块添加读写idle检查的逻辑

**修复**

- 解决gcc9和clang12编译报错的问题
- Precompiled合约报错信息写入到回执中,给出更明确的报错提示
- 优化落盘加密,解决落盘加密模式下,存储空间占用大的问题
- 修复MacOS系统下CachedStorage清理缓存导致节点宕机的问题
- 修复MySQL存储模式下,CNS合约名过长导致区块提交异常的问题

**兼容性**

**向前兼容**,旧版本可以直接替换程序升级

| | 推荐版本 | 最低版本 | 说明 |
| ---------- | ----------------------- | --------- | ---------------------- |
| 控制台 | 2.7.0 | 1.0.4 | |
| Java SDK | 2.7.0 | 2.6.1 | |
| Web3SDK | 2.6.0 | 2.0.4 | |
| generator | 1.7.0 | 1.1.0 | 搭建新链需要使用该版本 |
| 浏览器 | 2.0.2 | 2.0.0-rc2 | |
| Solidity | 最高支持 solidity 0.6.10 | 0.4.11 | |
| amdb-proxy | 2.3.0 | 2.0.2 | |

**兼容模式回滚至v2.6.x方法**

当节点采用兼容模式从v2.6.x升级至v2.7.0后,可直接通过将节点二进制替换回v2.6.x完成回滚。

6 changes: 6 additions & 0 deletions docs/change_log/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,11 @@
版本及兼容
##############################################################

.. admonition:: `FISCO BCOS 2.7.0 <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.7.0>`_

**变更描述、兼容及升级说明**
- `FISCO BCOS v2.7.0 <./2_7_0.html>`_

.. admonition:: `FISCO BCOS 2.6.0 <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.6.0>`_

**变更描述、兼容及升级说明**
Expand Down Expand Up @@ -107,6 +112,7 @@
.. toctree::
:hidden:

2_7_0.md
2_6_0.md
2_5_0.md
2_4_0.md
Expand Down
4 changes: 2 additions & 2 deletions docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ sudo yum install -y openssl openssl-devel
cd ~ && mkdir -p fisco && cd fisco

## 下载脚本
curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.6.0/build_chain.sh && chmod u+x build_chain.sh
curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.7.0/build_chain.sh && chmod u+x build_chain.sh
```

```eval_rst
Expand Down Expand Up @@ -213,7 +213,7 @@ sudo yum install -y java java-devel
- 获取控制台并回到fisco目录

```bash
cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh
cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh
```

```eval_rst
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/build_chain.md
Original file line number Diff line number Diff line change
Expand Up @@ -280,7 +280,7 @@ Usage:
-m Download mini binary, only works with -b option
-h Help
e.g
./download_bin.sh -v 2.6.0
./download_bin.sh -v 2.7.0
```
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/console.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@
```bash
cd ~ && mkdir -p fisco && cd fisco
# 获取控制台
curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh -c 1.2.0
curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh -c 1.2.0
```

```eval_rst
Expand Down
21 changes: 18 additions & 3 deletions docs/manual/console_of_java_sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@
```bash
cd ~ && mkdir -p fisco && cd fisco
# 获取控制台
curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh
curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh
```

```eval_rst
Expand Down Expand Up @@ -92,9 +92,9 @@ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/downloa
**注意:默认下载的控制台内置`0.4.25`版本的`solidity`编译器,用户需要编译`0.5`或者`0.6`版本的合约时,可以通过下列命令获取内置对应编译器版本的控制台**
```bash
# 0.5
curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh -v 0.5
curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh -v 0.5
# 0.6
curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh -v 0.6
curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh -v 0.6
```

### 配置控制台
Expand Down Expand Up @@ -1712,6 +1712,21 @@ Remove OK, 1 row affected.
}
```

### **revokeContractStatusManager**

运行revokeContractStatusManager,用于撤销指定权限账号对指定合约的合约管理权限。参数:

- 合约地址:部署合约可以获得合约地址,其中0x前缀非必须。
- 账号地址:tx.origin,其中0x前缀非必须。

```text
[group:1]> revokeContractStatusManager 0x30d2a17b6819f0d77f26dd3a9711ae75c291f7f1 0x965ebffc38b309fa706b809017f360d4f6de909a
{
"code":1,
"msg":"success"
}
```

### **getContractStatus**
运行getContractStatus,查询指定合约的状态。参数:

Expand Down
8 changes: 4 additions & 4 deletions docs/manual/group_use_cases.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ mkdir -p ~/fisco && cd ~/fisco

- 获取build_chain.sh脚本
```bash
curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.6.0/build_chain.sh && chmod u+x build_chain.sh
curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.7.0/build_chain.sh && chmod u+x build_chain.sh
```

**生成星形区块链系统配置文件**
Expand Down Expand Up @@ -224,7 +224,7 @@ info|2019-02-11 15:39:42.922510| [g:2][p:520][CONSENSUS][SEALER]++++++++Generati
$ cd ~/fisco

# 获取控制台
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh

# 进入控制台操作目录
$ cd console
Expand Down Expand Up @@ -486,7 +486,7 @@ $ cd ~/fisco/nodes/127.0.0.1 && bash stop_all.sh
```bash
$ mkdir -p ~/fisco && cd ~/fisco
# 获取build_chain.sh脚本
$ curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.6.0/build_chain.sh && chmod u+x build_chain.sh
$ curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.7.0/build_chain.sh && chmod u+x build_chain.sh
# 构建本机单群组四节点区块链(生产环境中,建议每个节点部署在不同物理机上)
$ bash build_chain.sh -l 127.0.0.1:4 -o multi_nodes -p 20000,20100,7545
Generating CA key...
Expand Down Expand Up @@ -607,7 +607,7 @@ info|2019-02-11 21:14:01.657428| [g:2][p:520][CONSENSUS][SEALER]++++++++Generati
# 若从未下载控制台,请进行下面操作下载控制台,否则将控制台拷贝到~/fisco目录:
$ cd ~/fisco
# 获取控制台
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh
```

**配置控制台**
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/guomi_crypto.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ sudo apt install -y openssl curl
# 准备环境
cd ~ && mkdir -p fisco && cd fisco
# 下载build_chain.sh脚本
curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.6.0/build_chain.sh && chmod u+x build_chain.sh
curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.7.0/build_chain.sh && chmod u+x build_chain.sh
```

- 搭建4节点FISCO BCOS链
Expand Down
6 changes: 3 additions & 3 deletions docs/sdk/java_sdk/quick_start.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@
在build.gradle中引入Java SDK

```
compile ('org.fisco-bcos.java-sdk:java-sdk:2.6.1')
compile ('org.fisco-bcos.java-sdk:java-sdk:2.7.0')
```

如果您使用maven 通过以下方法引入Java SDK
Expand All @@ -44,7 +44,7 @@ compile ('org.fisco-bcos.java-sdk:java-sdk:2.6.1')
<dependency>
<groupId>org.fisco-bcos.java-sdk</groupId>
<artifactId>java-sdk</artifactId>
<version>2.6.1</version>
<version>2.7.0</version>
</dependency>
```

Expand Down Expand Up @@ -80,7 +80,7 @@ mkdir -p conf && cp -r ~/fisco/nodes/127.0.0.1/sdk/* conf
```bash
$ mkdir -p ~/fisco && cd ~/fisco
# 获取控制台
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh
$ cd ~/fisco/console
```

Expand Down
2 changes: 1 addition & 1 deletion docs/tutorial/download_console.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
`download_console.sh`脚本提供获取所有版本的控制台的功能,默认获取[2.6+版本的控制台](../manual/console_of_java_sdk.md),可通过如下命令获取最新的`download_console.sh`脚本:

```bash
mkdir -p ~/fisco && cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh
mkdir -p ~/fisco && cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh
```

```eval_rst
Expand Down
55 changes: 55 additions & 0 deletions en/docs/change_log/2_7_0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# [v2.7.0](https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.7.0)

```eval_rst
.. admonition:: v2.6.x upgraded to v2.7.0
- **Compatible upgrade** : Directly replace the binary of v2.6.x node with `v2.7.0 binary< https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.7.0/fisco-bcos.tar.gz>`_ . The upgraded version fixes bugs in v2.6.x, and supports functions such as canceling event subscriptions, querying the topic information subscribed by nodes, and returning transaction receipts in batches, and the RPC interfaces related to node transactions and blocks return transactions and blocks The content of all fields and the receipt information returned by the node contain error information about transaction execution
- **Comprehensive upgrade** :Refer to `Install <../installation.html>`_ to build a new chain and resubmit all historical transactions to the new node. After the upgrade, the node contains all the new features of v2.7.0
- `v2.7.0 Release Note <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.7.0>`_
```

## Change description

**Added**

- The contract life cycle management provides the revokeManager function, which can be used through the [revokeContractStatusManager command](../manual/console_of_java_sdk.html#revokecontractstatusmanager) in the `v2.7.0` console
- Added a query interface for voting by committee members, which can be accessed through [queryVotesOfThreshold](../manual/console_of_java_sdk.html#queryvotesofthreshold) and [queryVotesOfMember](../manual/console_of_java_sdk.html#queryvotesofmember) in the `v2.7.0` console use
- Support cancel event subscription
- Add methods to return receipts in batches [getBatchReceiptsByBlockNumberAndRange](../api.html#getbatchreceiptsbyblocknumberandrange) and [getBatchReceiptsByBlockHashAndRange](../api.html#getbatchreceiptsbyblockhashandrange)
- Added [getNodeInfo](../api.html#getnodeinfo) interface to return topic information subscribed by the node
- Table contract adds EQ condition query of address type

**Changed**

- MySQL storage mode supports MySQL 8.0
- Refactor the RPC interface related to transactions and blocks, and return all field contents of transactions and blocks
- The transaction push receipt contains the error message of the transaction execution result
- P2P module adds logic to read and write idle check

**Fixed**

- Solve the problem of compiling errors in gcc9 and clang12
- Precompiled contract error information is written into the receipt, giving a clearer error message
- Optimized disk encryption to solve the problem of large storage space occupation in disk encryption mode
- Fix the problem of node downtime caused by CachedStorage cleaning cache under MacOS system
- Fix the problem that the CNS contract name is too long in MySQL storage mode, which causes abnormal block submission

**Compatibility**

The old version can directly replace the program upgrade


| | Recommended version | Minimum version | Description |
| ------------------ | ------------------- | --------------- | ------------------------------------------------------------ |
| console | 2.7.0 | 1.0.4 | |
| Java SDK | 2.7.0 | 2.6.1 | |
| Web3SDK | 2.6.0 | 2.0.4 | |
| generator | 1.6.0 | 1.2.0 | To use latest generator, please clone from master branch of generator repo. |
| FISCO BCOS browser | 2.0.2 | 2.0.0-rc2 | |
| Solidity | up to 0.6.10 | 0.4.11 | |

**Compatibility mode rollback to v2.6.x method**

After a node is upgraded from v2.6.x to v2.7.0 in compatibility mode, the rollback can be completed directly by replacing the node binary back to v2.6.x.
6 changes: 5 additions & 1 deletion en/docs/change_log/index.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
##############################################################
Compatibility
##############################################################
.. admonition:: `FISCO BCOS 2.7.0 <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.7.0>`_

**Change description, compatibility and upgrade instructions**
- `FISCO BCOS v2.6.0 <./2_7_0.html>`_

.. admonition:: `FISCO BCOS 2.6.0 <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.6.0>`_

Expand Down Expand Up @@ -105,7 +109,7 @@ Compatibility

.. toctree::
:hidden:

2_7_0.md
2_6_0.md
2_5_0.md
2_4_0.md
Expand Down
4 changes: 2 additions & 2 deletions en/docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ cd ~ && mkdir -p fisco && cd fisco
- Download `build_chain.sh` script

```bash
curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.6.0/build_chain.sh && chmod u+x build_chain.sh
curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.7.0/build_chain.sh && chmod u+x build_chain.sh
```

```eval_rst
Expand Down Expand Up @@ -190,7 +190,7 @@ sudo yum install -y java java-devel
- Get console

```bash
cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh
cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh
```

```eval_rst
Expand Down
2 changes: 1 addition & 1 deletion en/docs/manual/build_chain.md
Original file line number Diff line number Diff line change
Expand Up @@ -261,7 +261,7 @@ Usage:
-m Download mini binary, only works with -b option
-h Help
e.g
./download_bin.sh -v 2.6.0
./download_bin.sh -v 2.7.0
```
Expand Down
2 changes: 1 addition & 1 deletion en/docs/manual/console.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ When a console command is launched, the console will obtain the result of the co
```bash
$ cd ~ && mkdir fisco && cd fisco
# get console
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.6.1/download_console.sh && bash download_console.sh -c 1.2.0
$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.0/download_console.sh && bash download_console.sh -c 1.2.0
```

```eval_rst
Expand Down

0 comments on commit 77e4eb6

Please sign in to comment.