WeBASE (WeBank Blockchain Application Software Extension) is a set of common components built between blockchain applications and the bottom layer of FISCO BCOS. Each module is designed around transactions, contracts, key management, data, and visual management, shielding the blockchain The complexity of the underlying layer greatly reduces the R&D threshold and speeds up the efficiency of blockchain application development.
For the latest v3.0 released by FISCO BCOS ( for those who don’t know about FISCO BCOS v3.0, click here for details ), the WeBASE team collaborated with the FISCO BCOS open source community to carry out the adaptation work intensively and develop the WeBASE lab version so that developers can efficiently Deploy and manage FISCO BCOS v3.0. At present, WeBASE lab has made staged progress, and it is now officially released to the community. Welcome to star and actively experience it.
In a word, WeBASE lab provides on-chain data overview, contract IDE, transaction management, private key management and other operation and maintenance management functions that match FISCO BCOS v3.0, and provides the latest rapid deployment tools. We expect that through WeBASE lab, users can deploy FISCO BCOS v3.0 with one click, manage smart contracts in the visual web management console, initiate transactions and interact with the chain.
It should be noted that the main function of WeBASE lab is to facilitate the operation and maintenance management of FISCO BCOS v3.0 for users. The existing 1.x version of WeBASE (applicable to FISCO BCOS 2.x version) will continue to be updated and iterated. permanent maintenance. When using WeBASE, you can view the current version information in any of the following ways to better complete the deployment work:
-
View the version information output when deploying WeBASE
-
View the release_note in the WeBASE source code
-
View the release_note in the installation package
Next, let's take a look at the function introduction of WeBASE lab!
Adapt to the new features of FISCO BCOS v3.0
Around the new features in FISCO BCOS v3.0, the function points that WeBASE lab has completed adaptation are listed as follows:
-
The node list no longer displays PBFT View, and judges whether the node is normal by the Timeout status of the node and whether the block generation has timed out;
-
When setting consensus nodes in the node list, increase the node weight value setting;
-
Update the CRUD Table contract in the WeBASE contract warehouse to the KVTable contract;
-
The WeBASE-Front node pre-service can connect multiple nodes in the organization. In FISCO BCOS v3.0 "Professional Pro Edition", it adapts to the mode of multiple RPC nodes, and no longer restricts deployment on the same machine or only connects to a single node;
-
The contract IDE supports struct input parameters; struct will be converted to Tuple[] when the contract is compiled, which is the Tuple array type. When entering struct as parameters, we need to enclose the parameters in square brackets []. For example, in the following HelloWorld contract, the input parameter of the set method is a custom struct type Item . When the input parameter data of Item is a=1, b="test" , the parameter value entered in the WeBASE contract IDE Should be [1,"test"] with an additional square bracket around the argument.
Note: struct input parameters need to use 0.6.10 solidity in the contract IDE. When obtaining struct type data, the return value should return the content in the struct instead of directly returning the struct itself, as shown in the get method below.
pragma solidity ^0.6.10;pragma experimental ABIEncoderV2;struct Item {uint256 a; // 整型string b; // 字符串}contract HelloWorld {Item item;function set(Item memory i) public {item = i;}function get() public view returns (uint256 a, string memory b) {return (item.a, item.b);}}
Chain that supports one-click deployment of FISCO BCOS v3.0 "Light Air Edition"
In the WeBASE lab one-click deployment configuration file common.properties, after filling out the configuration of WeBASE and FISCO BCOS, enter a line of python commands to complete the chain of FISCO BCOS v3.0 "light Air version" and the deployment of WeBASE lab with one click .
Note: This update belongs to WeBASE lab-rc1 version in WeBASE lab, which is compatible with FISCO BCOS v3.0.0-rc1 version, so the version number filled in the one-click deployment is as follows:
# WeBASE子系统的最新版本（lab或以上版本）webase.web.version=lab-rc1webase.mgr.version=lab-rc1webase.sign.version=lab-rc1webase.front.version=lab-rc1...# Fisco-bcos version(v3.0.0 or above)fisco.version=v3.0.0-rc1After the deployment is complete, the detailed version number of WeBASE will be output. For service status check and usage after deployment, please refer to the WeBASE online documentation provided at the end of this article.
Currently, one-click deployment can only deploy chain nodes of FISCO BCOS v3.0 "Lightweight Air Edition". In this version, a chain has only a single group. If you need to use a multi-group chain, you need to use FISCO BCOS v3.0 "Professional Pro Edition".
Support multi-group chain management
In FISCO BCOS v3.0 "Professional Edition", a single chain node contains multiple microservices, such as RPC service, Gateway service and node service. On this basis, the chain of the "Professional Pro Edition" can contain multiple groups, and multiple groups can be national secrets or non-national secrets, and there is no longer a restriction that multiple groups of a single chain must be of the same encryption type.
Therefore, under the "Professional Pro Edition" chain, when WeBASE lab switches groups, it can automatically switch to a national secret or non-national secret encryption type according to the chain type to support corresponding functions such as contract compilation and contract analysis.
In addition, when we need to manage the "Professional Pro Edition" chain in WeBASE lab, we can use the WeBASE enterprise-level deployment method to install WeBASE sub-services one by one to achieve, and connect the chain node in front of the WeBASE-Front node. Add the node front to the WeBASE management console, and then manage the chain of the "Professional Pro Edition".
WeBASE lab accesses the RPC service in the chain node microservice through the node front service. The node pre-service no longer restricts deployment on the same machine, and no longer requires only a single node to be connected. Instead, it is recommended to connect multiple RPC nodes of the same organization, which can conveniently and accurately obtain the data of chain nodes.
In subsequent updates, WeBASE lab will continue to support more functions of FISCO BCOS v3.0. Users in the community are welcome to put forward requirements or feedback suggestions to WeBASE, and optimize the functional experience of WeBASE lab together.
use immediately
The latest code and technical documents involved in the above optimization and functions have been updated synchronously, and are located in the [lab] branch of the WeBASE code warehouse .
This update belongs to WeBASE lab-rc1 version in WeBASE lab, which is compatible with FISCO BCOS v3.0.0-rc1 version. Welcome to experience and star support.
If you need to consult technical questions, welcome to reply [ Little Assistant ] in the dialog box of this official account to enter the technical exchange group.
WeBASE code repository:
https://github.com/WeBankBlockchain/WeBASE/tree/lab
Domestic image of WeBASE code warehouse:
https://gitee.com/WeBank/WeBASE/tree/lab
WeBASE technical documentation:
https://webasedoc.readthedocs.io/zh_CN/lab
Domestic mirror of WeBASE technical documentation:
https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/doc/lab-rc1/index.html
For the first experience of WeBASE, please refer to the one-click deployment document:
https://webasedoc.readthedocs.io/zh_CN/latest/docs/WeBASE/install.html
Report problems to us, welcome to file an issue:
https://github.com/WeBankFinTech/WeBASE/issues
To learn more about dry goods, please pay attention to the FISCO BCOS open source community public account, visit the FISCO BCOS code warehouse to download all the source code of the project: https://github.com/FISCO-BCOS/FISCO-BCOS , welcome to click the star collection in the upper right corner of the page , to get the latest version.