升级说明

升级说明

WeBASE-Front升级的兼容性说明，请结合WeBASE-Front Changelog进行阅读

v1.4.2

新增了合约EventLog查询功能

v1.4.1

新增链权限接口与web3接口

新增ChainGovernance接口
新增getBlockHeaderByHash与getBlockHeaderByNumber接口

v1.4.0

增加版本号接口

增加返回 WeBASE-Front 和 WeBASE-Sign 版本号接口

v1.3.2

移除fastjson

移除Fastjson，替换为Jackson 2.11.0。
升级web3sdk为2.4.1，并升级springboot等依赖项

v1.3.1

新增动态群组接口

新增动态群组接口，包含生成群组、启动/停止群组、删除/恢复群组、单个/批量查询群组状态等接口

注：动态群组操作指南可参考动态群组操作指南，接口详情可参考接口文档

新增导入已部署合约Abi功能、合约Abi解析功能

前置的“合约管理”Tab中，新增导入合约abi功能，可以导入已部署的合约进行管理
前置的“合约管理”Tab中，新增合约ABI编码功能，可用于构造交易input入参

新增导入.p12私钥用户

私钥管理中，支持导入控制台所导出的.p12私钥；

v1.3.0

私钥管理修改

节点前置Web页面中的私钥管理转移至合约管理Tab下，改为测试用户管理

WeBASE-Front本地私钥仅用于本地的合约调试，不建议用于生产；因此Web页面中的私钥管理转移至合约管理Tab下，改为测试用户管理；

在WeBASE-Front的Web页面部署合约、发交易时所使用的私钥均为本地私钥，与WeBASE-Node-Manager私钥区分开；

节点管理与前置私钥模块调整

WeBASE-Node-Manager的私钥将通过WeBASE-Sign托管（新建私钥、保存私钥和交易签名），不再由WeBASE-Front生成和保存（仅保存公钥与地址）；
节点管理WeBASE-Node-Manager v1.3.0前通过节点前置WeBASE-Front的/trans/handle和/contract/deploy进行合约交易与部署，v1.3.0后将通过/trans/handleWithSign接口和/contract/deployWithSign接口进行合约部署与交易

生成私钥的流程（此处为type=2的外部私钥，WeBASE-Front的私钥始终留在Front的数据库中）

交易签名的流程

因此WeBASE-Node-Manager私钥数据需要转移到WeBASE-Sign数据库中，具体操作请参考WeBASE-Node-Manager v1.3.0升级说明

API字段更新

WeBASE-Front的/trans/handleWithSign接口和/contract/deployWithSign接口传参修改如下；

/trans/handleWithSign接口：

{
    "groupId" :1,
    "signUserId": "458ecc77a08c486087a3dcbc7ab5a9c3",
    "contractAbi":[],
    "contractAddress":"0x14d5af9419bb5f89496678e3e74ce47583f8c166",
    "funcName":"set",
    "funcParam":["test"]
}

/contract/deployWithSign接口

{
    "groupId":1,
    "signUserId": "458ecc77a08c486087a3dcbc7ab5a9c3",
    "bytecodeBin":"xxx",
    "abiInfo": [],
    "funcParam":[]
}

WeBASE-Front的所有接口中useAes字段将默认为true，即私钥默认采用aes加密保存，调用时可不传入useAes；

部署合约时不再自动注册CNS

/trans/handle接口中，contractAbi修改为必填，即需要传入合约abi或合约单个函数的abi。

具体修改可参考接口文档

v1.2.3

修复api中的合约Bin字段

修复了WeBASE-Front接口中contractBin与bytecodeBin字段的bug

contractBin是指合约编译后的运行时二进制码(runtime-bin)，多用于交易解析用
bytecodeBin是指合约编译的完整二进制码(bytecode bin)，一般用于部署合约

将部分接口的contractBin字段修改为bytecodeBin字段，修改的接口包含contract/deployWithSign，共1个；

其余包含以上两个字段的接口，均在接口文档中丰富了字段说明，方便区分

支持链上事件订阅和通知

在某些业务场景中，应用层需要实时获取链上的事件，如出块事件、合约Event事件等。应用层通过WeBASE连接节点后，由于无法和节点直接建立长连接，难以实时获取链上的消息。

为了解决这个问题，应用层可通过WeBASE-Front订阅链上事件，当事件触发时，可通过RabbitMQ消息队列通知到应用层，架构如下：

启用消息队列的事件推送服务，需要以下几步操作：

安装RabbitMQ Server，启动mq服务，并确保RabbitMQ Server服务所在服务器的5672, 15672端口可访问；
启用RabbitMQ的rabbitmq_managerment功能,（在mq服务所在主机中运行rabbitmq-plugins enable rabbitmq_management）；
配置application.yml中spring-rabbitmq项，通过host, port连接mq server, 且username, password有足够权限配置管理mq服务；

注：需要在build.gradle的dependencies中添加org.springframework.boot:spring-boot-starter-amqp:1.5.9.RELEASE的依赖

WeBASE-Front默认不启用事件消息推送功能，如需启用请参考附录-链上事件订阅和通知