概要介绍

使用说明

WeBASE-Front是和FISCO-BCOS节点配合使用的一个子系统。此分支支持FISCO-BCOS 2.0以上版本,集成web3sdk,对接口进行了封装,可通过HTTP请求和节点进行通信。另外,具备可视化控制台,可以在控制台上开发智能合约,部署合约和发送交易,并查看交易和区块详情。还可以管理私钥,对节点健康度进行监控和统计。

../../_images/2.png

WeBASE-Front使用方式有以下三种:

1、单独部署作为独立控制台使用,请参考部署说明

2、结合WeBASE-Node-ManagerWeBASE-Web服务一起部署使用,请参考WeBASE安装部署

3、结合WeBASE-Sign服务一起部署使用,调用WeBASE-Sign进行数据签名,再发送上链。此方式在方式1的基础上再部署WeBASE-Sign服务,然后需调用合约部署(结合WeBASE-Sign)接口、交易处理(结合WeBASE-Sign)接口进行合约部署和调用。

注意: WeBASE-Front需要跟节点同机部署,一个节点对应一个WeBASE-Front服务。

国密支持

WeBASE-Front v1.2.2+已支持 国密版FISCO-BCOS,使用WeBASE v1.2.2及以上版本

WeBASE-Front具体需要适配国密版FISCO-BCOS的地方有:

  • 开启web3sdk的国密开关:修改application.yml/application.properties中的encryptType改为1
  • 合约编译支持国密版:
    • WeBASE-Front Web编译智能合约已引入sol-0.4.25-gm.js,已自动切换支持国密版智能合约的编译/部署/调用;
    • WeBASE-Front后台编译国密版智能合约,已引入solcJ:0.4.25-rc1.jar,自动切换支持国密版智能合约的编译/部署/调用;

安装详情可查看下一章节的WeBASE-Front部署说明

支持链上事件订阅和通知

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

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

../../_images/event_structure.png链上事件通知架构

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

solidity v0.5.1和v0.6.10支持

WeBASE-Front v1.4.2+已支持solidity v0.5.1v0.6.10:

其中v0.5.1可在合约IDE中直接进行切换,若需要使用solidity v0.6.10,可参考部署说明的v0.6.10配置