开源进展 | WeBASE v1.5.4 发布，新增实训案例集与管理台 *** 作指引

作为一个友好的、功能丰富的区块链中间件平台，WeBASE一直致力于降低区块链开发者的研发门槛，提高区块链开发效率。

如今，WeBASE v1.5.4来了，此次更新新增区块链应用实训课程案例集，以及管理台 *** 作指引与设计说明，助力社区开发者更快捷高效地学习区块链，搭建区块链应用。一起来看看v1.5.4带来的新功能吧！

  新增实训课程案例集

如何将 WeBASE与区块链课程相结合，以更好地服务开发者？为解答这一命题， WeBASE团队和社区伙伴、社区开发者通力合作，对WeBASE功能进行有针对性的调整，在WeBASE v1.5.1中推出WeBASE实训插件，支持教学实训场景，详情见《开源进展 | WeBASE v1.5.1 发布，支持教学实训场景》。

在本次v1.5.4的更新中，WeBASE技术文档新增了“WeBASE实训课程案例”板块，收录的课程案例均为针对社区实训课程专门设计的，案例实现由实训题目、实验步骤和参考答案三个模块组成。

目前收录了从易到难的三个案例：运行第一个智能合约，积分转账合约实现，存证合约应用实现。开发者可以参考案例快速上手合约开发，社区伙伴可以参考案例，根据自身实际课程设计进行相应调整。

实训题目：描述了本次课程的具体要求。

如下图1所示，“运行第一个智能合约”的要求为：使用Solidity语言编写一个HelloWorld合约，说明该合约需包含哪些合约逻辑，实现怎样的效果，并给出了合约的基础框架。

图1:创建第一个智能合约-实训题目

实验步骤：描述了实训所需的各实验步骤，每个实验步骤会给出对应的答案“提交方式”要求，也就是在完成实验步骤后，需要提交哪些内容。

如下图2所示，“向部署的智能合约发送交易”这一步骤中，我们根据学生在该课程所需要掌握的知识点，列出了需要其提交的内容。比如，需要学生掌握通过SDK连接节点的知识点，则要求学生提交通过SDK连接节点的源码。

说明一下，此处实验步骤和提交内容可以根据自定义的课程内容进行调整。

图2:创建第一个智能合约-部分实验步骤

参考答案：WeBASE提供了一套基于FISCO BCOS和WeBASE完成的课程参考答案，包含了实现的源代码、实验步骤截图等。

未来，WeBASE 团队将持续挖掘 WeBASE 在区块链教育领域中的潜能，也欢迎各位社区开发者参与共建，创造更多元化的实训课程案例贡献到社区。

  WeBASE管理台新增 *** 作指引

本次更新中，WeBASE管理台各页面新增了【 *** 作指引】，对页面模块功能的设计与使用方法进行说明，方便用户快速熟悉、掌握WeBASE。

如下图3所示，在WeBASE “私钥管理”页面中，用户可以通过页面右侧的【 *** 作指引】，快速了解“新增用户”和“导入私钥”两个按钮的功能是什么，掌握其使用方法。

图3：WeBASE管理台-私钥管理页面

又如，可能有用户会疑惑为什么自己的私钥或者合约会被WeBASE标记为“异常”， 出现“用户异常”或者“合约异常”的告警。

如下图4所示，用户“0x97e9b7a9d5e19a8a0aa7cd39f632244da69640b6”被WeBASE标记为异常用户，出现在“交易审计-异常用户”的告警列表中。在v1.5.4新增 *** 作指引后，用户可以在WeBASE管理台“交易审计-异常用户” 页面右侧 *** 作指引中，快速查看交易审计功能的设计与使用说明，了解其被标记为“异常用户”原因为：该私钥用户在链上发起过交易，但是并没有在WeBASE的私钥管理中登记。

*只要某个私钥在链上发起了交易，或者某个合约部署到链上了但是未在WeBASE中登记，那么对应的私钥地址或合约地址即会被WeBASE标记为“异常”。

图4：WeBASE管理台-交易审计-异常用户页面

实际上，我们在“私钥管理-全量”用户列表中能看到该用户，说明该用户确实在链上发起过交易（如未发起过交易的私钥无法在全量用户列表中看到）。按照“交易审计-异常用户”的 *** 作指引所描述，用户只需要在全量用户“导入”该私钥的地址到WeBASE中，或者将该用户地址对应的私钥导入到WeBASE中，即可消除“用户异常”的告警。

图5：WeBASE管理台-私钥管理页面

  其他优化和修复

优化：优化WeBASE管理台的合约IDE交易体验，丰富入参提示，如bytesN类型提示输入长度并校验参数。

优化：新增WeBASE管理台中登录页“忘记密码“与”验证码加载失败“提示。

优化：优化合约仓库加载方式，通过conf/warehouse目录中的.json文件可加载合约模板；社区用户可以直接按照json格式，提交Pull Request贡献合约。

优化：更新可视化部署的build_chain脚本为最新的v2.8.0，修复openssl版本兼容性问题。

bugfix：修复WeBASE所调用的Java-SDK的KeyFactory一定情况下重复私钥的问题。

bugfix：修复查询event页面中获取合约列表，合约重复问题。

bugfix：修复可视化部署中检测localhost的误判。

  即刻使用

上述优化及功能所涉及的最新代码和技术文档已同步更新，欢迎体验和star支持。

如需咨询技术问题，欢迎本公众号对话框回复【小助手】进技术交流群。

WeBASE 代码仓库：

https://github.com/WeBankBlockchain/WeBASE/

WeBASE 代码仓库国内镜像：

https://gitee.com/WeBank/WeBASE/

WeBASE 技术文档：

https://webasedoc.readthedocs.io/zh_CN/latest

WeBASE 技术文档国内镜像：

https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/doc/index.html

首次体验WeBASE，可参考一键部署文档：

https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE/install.html

如需升级已有版本，可参考：

WeBASE一键部署的一键升级：

https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE-Install/upgrade.html#auto

WeBASE-Front升级说明：

https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE-Front/upgrade.html

WeBASE-Node-Manager升级说明：

https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE-Node-Manager/upgrade.html

WeBASE-Sign升级说明：

https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE-Sign/upgrade.html

WeBASE-Web升级说明：

https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE-Web/upgrade.html

向我们报告问题，欢迎提交issue：

https://github.com/WeBankFinTech/WeBASE/issues