升级说明

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

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的数据库中) 使用sign生成私钥的流程

交易签名的流程 使用sign交易签名的流程

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

API字段更新

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

/trans/handleWithSign接口:

  1. {
  2. "groupId" :1,
  3. "signUserId": "458ecc77a08c486087a3dcbc7ab5a9c3",
  4. "contractAbi":[],
  5. "contractAddress":"0x14d5af9419bb5f89496678e3e74ce47583f8c166",
  6. "funcName":"set",
  7. "funcParam":["test"]
  8. }

/contract/deployWithSign接口

  1. {
  2. "groupId":1,
  3. "signUserId": "458ecc77a08c486087a3dcbc7ab5a9c3",
  4. "bytecodeBin":"xxx",
  5. "abiInfo": [],
  6. "funcParam":[]
  7. }
  • WeBASE-Front的所有接口中useAes字段将默认为true,即私钥默认采用aes加密保存,调用时可不传入useAes

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

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

具体修改可参考接口文档

v1.2.3

修复api中的合约Bin字段

修复了WeBASE-Front接口中contractBinbytecodeBin字段的bug

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

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

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

支持链上事件订阅和通知

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

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

链上事件通知架构

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

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

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

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