Skip to content

Commit

Permalink
Merge pull request #528 from WeBankBlockchain/dev
Browse files Browse the repository at this point in the history 
1.5.5 dev=>master
  • Loading branch information
@CodingCattwo
CodingCattwo committed Apr 23, 2023
2 parents 8aa8804 + 1a8b04c commit ef05ea6
Show file tree
Hide file tree
Showing 11 changed files with 189 additions and 76 deletions.
2 changes: 1 addition & 1 deletion conf.py
View file
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@
# The short X.Y version.
version = '1.5'
# The full version, including alpha/beta/rc tags.
release = 'v1.5.4'
release = 'v1.5.5'

# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
Expand Down
1 change: 1 addition & 0 deletions docs/WeBASE-Console-Suit/articles/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,5 @@
:maxdepth: 1
./two_phase_tx.md
```
92 changes: 63 additions & 29 deletions docs/WeBASE-Front/interface.md
View file

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion docs/WeBASE-Install/developer.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@

1. 下载安装包
```shell
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.4/webase-front.zip
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.5/webase-front.zip
```


Expand Down
12 changes: 6 additions & 6 deletions docs/WeBASE-Install/docker_install.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -137,7 +137,7 @@ Python3.6及以上版本，需安装`PyMySQL`依赖包

获取部署安装包：
```shell
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.4/webase-deploy.zip
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.5/webase-deploy.zip
```
解压安装包：
```shell
Expand Down Expand Up @@ -169,10 +169,10 @@ cd webase-deploy

```shell
# WeBASE子系统的最新版本(v1.1.0或以上版本)
webase.web.version=v1.5.4
webase.mgr.version=v1.5.4
webase.sign.version=v1.5.3
webase.front.version=v1.5.4
webase.web.version=v1.5.5
webase.mgr.version=v1.5.5
webase.sign.version=v1.5.5
webase.front.version=v1.5.5

#####################################################################
## 使用Docker启用Mysql服务，则需要配置以下值
Expand Down Expand Up @@ -248,7 +248,7 @@ node.dir=node0

# 搭建新链时需配置
# FISCO-BCOS版本
fisco.version=2.8.0
fisco.version=2.9.1
# 搭建节点个数（默认两个）
node.counts=nodeCounts
```
Expand Down
14 changes: 7 additions & 7 deletions docs/WeBASE-Install/visual_deploy.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -299,10 +299,10 @@ exit

获取部署安装包：
```shell
wget https://github.com/WeBankFinTech/WeBASELargeFiles/releases/download/v1.5.4/webase-deploy.zip
wget https://github.com/WeBankFinTech/WeBASELargeFiles/releases/download/v1.5.5/webase-deploy.zip

# 若网络问题导致长时间无法下载，可尝试以下命令
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.4/webase-deploy.zip
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.5/webase-deploy.zip
```
解压安装包：
```shell
Expand All @@ -328,10 +328,10 @@ cd webase-deploy

```shell
# WeBASE子系统的最新版本(v1.1.0或以上版本)
webase.web.version=v1.5.4
webase.mgr.version=v1.5.4
webase.sign.version=v1.5.3
fisco.webase.docker.cdn.version=v1.5.4
webase.web.version=v1.5.5
webase.mgr.version=v1.5.5
webase.sign.version=v1.5.5
fisco.webase.docker.cdn.version=v1.5.5

# 节点管理子系统mysql数据库配置
mysql.ip=127.0.0.1
Expand Down Expand Up @@ -718,7 +718,7 @@ fiscoorg/fisco-webase v2.8.0 bf4a26d5d389 5 days ago 631MB
```Bash
# 从 CDN 拉取镜像 tar 文件
# 非国密
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.4/docker-fisco-webase.tar
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.5/docker-fisco-webase.tar

# 解压镜像 tar 文件
docker load -i docker-fisco-webase.tar
Expand Down
45 changes: 34 additions & 11 deletions docs/WeBASE-Node-Manager/interface.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1779,14 +1779,25 @@ http://127.0.0.1:5001/WeBASE-Node-Manager/contract/200001
### 5.3 部署合约


构造方法参数（funcParam）为JSON数组，多个参数以逗号分隔（参数为数组时同理），示例：

```
constructor(string s) -> ["aa,bb\"cc"] // 双引号要转义
constructor(uint n,bool b) -> [1,true]
constructor(bytes b,address[] a) -> ["0x1a",["0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE","0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9"]]
```

1.5.5及以后版本：
> 构造方法参数（funcParam）为String数组，每个参数都使用String字符串表示，多个参数以逗号分隔（参数为数组时同理），示例：
>
> ```
> constructor(string s) -> ["aa,bb\"cc"] // 双引号要转义
> constructor(uint n,bool b) -> ["1","true"]
> constructor(bytes b,address[] a) -> ["0x1a","[\"0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE\",\"0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9\"]"]
> ```

1.5.5以前的版本：
>
> 构造方法参数（funcParam）为JSON数组，多个参数以逗号分隔（参数为数组时同理），示例：
>
> ```
> constructor(string s) -> ["aa,bb\"cc"] // 双引号要转义
> constructor(uint n,bool b) -> [1,true]
> constructor(bytes b,address[] a) -> ["0x1a",["0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE","0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9"]]
> ```
#### 传输协议规范

Expand All @@ -1812,7 +1823,7 @@ constructor(bytes b,address[] a) -> ["0x1a",["0x7939E26070BE44E6c4Fc759Ce55C6C8b
| 8 | contractPath | String | 是 | 合约所在目录 |
| 9 | user | String | 是 | WeBASE的私钥用户的地址 |
| 10 | account | String | 是 | 关联账户 |
| 11 | constructorParams | List | 否 | 构造函数入参，根据合约构造函数决定 |
| 11 | constructorParams | List<String> | 否 | 构造函数入参，根据合约构造函数决定。String数组，每个参数都通过String字符串表示，包括数组也需要括在双引号内，多个参数以逗号分隔（参数为数组时同理），如：set(string s, string[] l) -> ["str1","[\"arr1\",\"arr2\"]"] |


***2）入参示例***
Expand Down Expand Up @@ -1908,10 +1919,22 @@ http://127.0.0.1:5001/WeBASE-Node-Manager/contract/deploy
### 5.4 发送交易


1.5.5及以后版本：

方法参数（funcParam）为String数组，每个参数都使用String字符串表示，多个参数以逗号分隔（参数为数组时同理），示例：

```
function set(string s) -> ["aa,bb\"cc"] // 双引号要转义
function set(uint n,bool b) -> ["1","true"]
function set(bytes b,address[] a) -> ["0x1a","[\"0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE\",\"0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9\"]"]
```

1.5.5以前的版本：

方法入参（funcParam）为JSON数组，多个参数以逗号分隔（参数为数组时同理），示例：

```
function set(string s) -> ["aa,bb\"cc"] // 双引号要转义
function set(string s) -> ["aa,bb\"cc"] // 双引号要转义
function set(uint n,bool b) -> [1,true]
function set(bytes b,address[] a) -> ["0x1a",["0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE","0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9"]]
```
Expand All @@ -1938,7 +1961,7 @@ function set(bytes b,address[] a) -> ["0x1a",["0x7939E26070BE44E6c4Fc759Ce55C6C8
| 4 | contractId | Int | 是 | 合约编号 |
| 5 | funcName | String | 是 | 合约方法名 |
| 6 | contractAddress | String | 否 | 合约地址 |
| 7 | funcParam | List | 否 | 合约方法入参 |
| 7 | funcParam | List<String> | 否 | 合约方法入参，String数组，每个参数都通过String字符串表示，包括数组也需要括在双引号内，多个参数以逗号分隔（参数为数组时同理），如：set(string s, string[] l) -> ["str1","[\"arr1\",\"arr2\"]"] |
| 8 | contractAbi | List | 是 | 合约abi/合约单个函数的abi |
| 9 | useCns | bool | 否 | 是否使用cns调用，默认为false |
| 10 | cnsName | String | 否 | CNS名称，useCns为true时不能为空 |
Expand Down
62 changes: 51 additions & 11 deletions docs/WeBASE-Transaction/interface.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -68,13 +68,26 @@ b.异常返回结果示例（信息详情请参看附录1）

调用此接口发送合约部署相关信息，交易服务子系统会将合约部署请求信息缓存到数据库，通过轮询服务向节点发送交易请求，确保合约成功部署。

构造方法参数（funcParam）为JSON数组，多个参数以逗号分隔（参数为数组时同理），示例：
1.5.5及以后版本：
> 构造方法参数（funcParam）为String数组，每个参数都使用String字符串表示，多个参数以逗号分隔（参数为数组时同理），示例：
>
> ```
> constructor(string s) -> ["aa,bb\"cc"] // 双引号要转义
> constructor(uint n,bool b) -> ["1","true"]
> constructor(bytes b,address[] a) -> ["0x1a","[\"0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE\",\"0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9\"]"]
> ```

1.5.5以前的版本：
>
> 构造方法参数（funcParam）为JSON数组，多个参数以逗号分隔（参数为数组时同理），示例：
>
> ```
> constructor(string s) -> ["aa,bb\"cc"] // 双引号要转义
> constructor(uint n,bool b) -> [1,true]
> constructor(bytes b,address[] a) -> ["0x1a",["0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE","0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9"]]
> ```
```
constructor(string s) -> ["aa,bb\"cc"] // 双引号要转义
constructor(uint n,bool b) -> [1,true]
constructor(bytes b,address[] a) -> ["0x1a",["0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE","0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9"]]
```

#### 接口URL

Expand All @@ -95,7 +108,7 @@ HTTP POST
| 3 | 签名类型 | signType | int | 2 | 是 | 0-本地配置私钥签名，1-本地随机私钥签名，2-调用WeBASE-Sign签名 |
| 4 | 合约Bin | contractBin | String | | 是 | |
| 5 | 合约Abi | contractAbi | List\<Object\> | | 是 | JSON数组 |
| 6 | 构造方法参数 | funcParam | List\<Object\> | | 否 | JSON数组 |
| 6 | 构造方法参数 | funcParam | List\<String\> | | 否 | String数组，每个参数都通过String字符串表示，包括数组也需要括在双引号内，多个参数以逗号分隔（参数为数组时同理），如：set(string s, string[] l) -> ["str1","[\"arr1\",\"arr2\"]"] |
| 7 | 签名用户编号 | signUserId | String | | 否 | signType为2时必填 |

**2）数据格式**
Expand Down Expand Up @@ -416,9 +429,23 @@ b.异常返回结果示例（信息详情请参看附录1）
调用此接口发送无状态交易请求，交易服务子系统会将交易请求信息缓存到数据库，通过轮询服务向节点发送交易请求，确保交易成功上链。当部署业务流水号为空时（即不是调用交易子系统部署合约），合约地址和abi不能为空。



1.5.5及以后版本：

方法参数（funcParam）为String数组，每个参数都使用String字符串表示，多个参数以逗号分隔（参数为数组时同理），示例：

```
function set(string s) -> ["aa,bb\"cc"] // 双引号要转义
function set(uint n,bool b) -> ["1","true"]
function set(bytes b,address[] a) -> ["0x1a","[\"0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE\",\"0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9\"]"]
```

1.5.5以前的版本：

方法入参（funcParam）为JSON数组，多个参数以逗号分隔（参数为数组时同理），示例：

```
function set(string s) -> ["aa,bb\"cc"] // 双引号要转义
function set(string s) -> ["aa,bb\"cc"] // 双引号要转义
function set(uint n,bool b) -> [1,true]
function set(bytes b,address[] a) -> ["0x1a",["0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE","0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9"]]
```
Expand All @@ -445,7 +472,7 @@ HTTP POST
| 5 | 合约地址 | contractAddress | String | | 是 | |
| 6 | 合约Abi | contractAbi | List\<Object\> | | 是 | JSON数组 |
| 7 | 调用方法名 | funcName | String | | 是 | |
| 8 | 方法参数 | funcParam | List\<Object\> | | 否 | JSON数组 |
| 8 | 方法参数 | funcParam | List\<String\> | | 否 | String数组，每个参数都通过String字符串表示，包括数组也需要括在双引号内，多个参数以逗号分隔（参数为数组时同理），如：set(string s, string[] l) -> ["str1","[\"arr1\",\"arr2\"]"] |
| 9 | 签名用户编号 | signUserId | String | | 否 | signType为2时必填 |

**2）数据格式**
Expand Down Expand Up @@ -498,9 +525,22 @@ b.异常返回结果示例（信息详情请参看附录1）
调用此接口同步从节点查询交易信息。当部署业务流水号为空时（即不是调用交易子系统部署合约），合约地址和abi不能为空。


1.5.5及以后版本：

方法参数（funcParam）为String数组，每个参数都使用String字符串表示，多个参数以逗号分隔（参数为数组时同理），示例：

```
function set(string s) -> ["aa,bb\"cc"] // 双引号要转义
function set(uint n,bool b) -> ["1","true"]
function set(bytes b,address[] a) -> ["0x1a","[\"0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE\",\"0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9\"]"]
```

1.5.5以前的版本：

方法入参（funcParam）为JSON数组，多个参数以逗号分隔（参数为数组时同理），示例：

```
function set(string s) -> ["aa,bb\"cc"] // 双引号要转义
function set(string s) -> ["aa,bb\"cc"] // 双引号要转义
function set(uint n,bool b) -> [1,true]
function set(bytes b,address[] a) -> ["0x1a",["0x7939E26070BE44E6c4Fc759Ce55C6C8b166d94BE","0xce867fD9afa64175bb50A4Aa0c17fC7C4A3C67D9"]]
```
Expand All @@ -524,7 +564,7 @@ HTTP POST
| 3 | 合约地址 | contractAddress | String | | 否 | |
| 4 | 合约Abi | contractAbi | List\<Object\> | | 否 | JSON数组 |
| 5 | 调用方法名 | funcName | String | | 是 | |
| 6 | 方法参数 | funcParam | List\<Object\> | | 否 | JSON数组 |
| 6 | 方法参数 | funcParam | List\<String\> | | 否 | String数组，每个参数都通过String字符串表示，包括数组也需要括在双引号内，多个参数以逗号分隔（参数为数组时同理），如：set(string s, string[] l) -> ["str1","[\"arr1\",\"arr2\"]"] |

**2）数据格式**
```
Expand Down
15 changes: 15 additions & 0 deletions docs/WeBASE/ChangeLOG.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,21 @@
.. important::
FISCO-BCOS 2.0与3.0对比、JDK版本、WeBASE及其他子系统的兼容版本说明！`请查看 <https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html>`_
```


### WeBASE v1.5.5

WeBASE v1.5.5 版本支持 FISCO-BCOS 2.5.x及以上版本。WeBASE 子系统推荐使用下表的版本搭配，FISCO-BCOS 推荐使用 [FISCO BCOS 2.9.1](https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.9.1)版本。

| WeBASE子系统名称 | 配套版本地址 | FISCO-BCOS 2.X.X |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| [节点前置服务](https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE-Front/index.html) | [WeBASE-Front Release v1.5.5](https://github.com/WeBankBlockchain/WeBASE-Front/releases/tag/v1.5.5) | [FISCO BCOS 2.9.1](https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.9.1) |
| [节点管理服务](https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE-Node-Manager/index.html) | [WeBASE-Node-Manager Release v1.5.5](https://github.com/WeBankBlockchain/WeBASE-Node-Manager/releases/tag/v1.5.5) | [FISCO BCOS 2.9.1](https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.9.1) |
| [WeBASE管理平台](https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE-Web/index.html) | [WeBASE-Web Release v1.5.5](https://github.com/WeBankBlockchain/WeBASE-Web/releases/tag/v1.5.5) | [FISCO BCOS 2.9.1](https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.9.1) |
| [签名服务](https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE-Sign/index.html) | [WeBASE-Sign Release v1.5.3](https://github.com/WeBankBlockchain/WeBASE-Sign/releases/tag/v1.5.3) | [FISCO BCOS 2.9.1](https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.9.1) |
| [交易服务](https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE-Transaction/index.html) | [WeBASE-Transaction Release v1.4.0](https://github.com/WeBankBlockchain/WeBASE-Transaction/releases/tag/v1.4.0) | [FISCO BCOS 2.9.1](https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.9.1) |


### WeBASE v1.5.4

WeBASE v1.5.4 版本支持 FISCO-BCOS 2.5.x及以上版本。WeBASE 子系统推荐使用下表的版本搭配，FISCO-BCOS 推荐使用 [FISCO BCOS 2.8.0](https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v2.8.0)版本。
Expand Down
18 changes: 9 additions & 9 deletions docs/WeBASE/install.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,7 @@ Python3.6及以上版本，需安装`PyMySQL`依赖包

获取部署安装包：
```shell
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.4/webase-deploy.zip
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.5/webase-deploy.zip
```
解压安装包：
```shell
Expand Down Expand Up @@ -138,10 +138,10 @@ cd webase-deploy

```shell
# WeBASE子系统的最新版本(v1.1.0或以上版本)
webase.web.version=v1.5.4
webase.mgr.version=v1.5.4
webase.sign.version=v1.5.3
webase.front.version=v1.5.4
webase.web.version=v1.5.5
webase.mgr.version=v1.5.5
webase.sign.version=v1.5.5
webase.front.version=v1.5.5

#####################################################################
## 使用Docker启用Mysql服务，则需要配置以下值
Expand Down Expand Up @@ -220,7 +220,7 @@ node.dir=node0

# 搭建新链时需配置
# FISCO-BCOS版本
fisco.version=2.7.2
fisco.version=2.9.1
# 搭建节点个数（默认两个）
node.counts=nodeCounts
```
Expand Down Expand Up @@ -258,10 +258,10 @@ $ python3 deploy.py installAll
============================================================
============== deploy has completed ==============
============================================================
============== webase-web version v1.5.4 ========
============== webase-node-mgr version v1.5.4 ========
============== webase-web version v1.5.5 ========
============== webase-node-mgr version v1.5.5 ========
============== webase-sign version v1.5.3 ========
============== webase-front version v1.5.4 ========
============== webase-front version v1.5.5 ========
============================================================
```

Expand Down
2 changes: 1 addition & 1 deletion release_note.txt
View file
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v1.5.4
v1.5.5

0 comments on commit ef05ea6

Please sign in to comment.