WEB:如何快速构建区块链应用?这款脚手架支持一键生成

在数字化、信息化的今天,区块链技术已经逐步走入各行各业。为了满足普适性的要求,区块链的应用开发理应更加简单顺手。但是我们发现目前区块链应用开发仍然存在着一定门槛,社区中不断涌现的疑问便是体现之一。

如何配置私钥和证书?

怎么访问区块链节点?

SDK的接口怎么用?

如何构建一笔交易?

怎么解析交易回执?

……

来自开发者的疑问各式各样,但如果开发者一直在处理这些问题,则会带来大量的时间开销,影响业务开发的进展。一门成熟的技术,应不断将重复的细节封装起来,让开发人员更加聚焦业务,提升业务快速上线、快速试错和快速迭代的效率。

微众银行自2015年深耕区块链,在技术攻关和应用开发上积攒了丰富的经验。为了让开发者能够在自己的业务中轻松引入区块链技术,微众银行区块链开发了区块链应用开发组件WeBankBlockchain-SmartDev。其所包含的子组件——区块链应用开发脚手架WebankBlockchain-SmartDev-Scaffold,更是通过一键生成应用项目,帮助开发者敏捷、高效地开发区块链应用。

??应用开发脚手架简介

一个典型的区块链应用项目后端,可以分为三块。业务逻辑部分由用户自行定义;代码部分包含了智能合约访问的功能,例如函数入参的封装、交易的构造和推送、链的访问等;资源部分则包含了合约、ABI、BIN。如下图所示:

Paxos发布加密寒冬如何帮助拯救数字资产经济白皮书:金色财经报道,数字资产公司Paxos发布《加密货币冬天如何帮助拯救数字资产经济》白皮书。白皮书汇集了Paxos领导团队和加密货币市场数据提供商Kaiko的内部人士的见解,《加密货币之冬如何帮助拯救数字资产经济》提供了对2022年底和2023年初历史性破坏后的加密货币行业的看法。

为了对数字资产领域在这一动荡时期的过去、现在和未来提供一个全面的看法,《加密货币之冬如何帮助拯救数字资产经济》深入探讨了2022年加密货币之冬之前的几年,FTX和Alameda Research的高调崩溃所带来的影响,以及由此造成的2.1万亿美元的市值损失。该白皮书还研究了一些关键的前瞻性话题,如监管环境、加密货币行业的运营路径、该行业如何与消费者、风险投资公司、机构投资者重新建立信任等。[2023/4/12 14:00:08]

应用开发脚手架组件允许用户在写好智能合约的基础上,将智能合约转换为一个SpringBoot项目,这个项目已经涵盖了上图中蓝色和绿色的部分,用户只需要补充自己的业务逻辑即可,不必再去关心区块链访问的细节,大大缩短了开发时间。

??关键特性一览

一键生成

用户在开发完智能合约后,可以将智能合约直接拖入脚手架,只要轻量配置,就可以生成相关项目。并且,生成的项目已经包含了智能合约访问的必要逻辑。此外,该项目是SpringBoot项目,相关的配置、服务均已纳入到spring容器当中。

高度封装

币情观察室 | 如何从小白蜕变成合格的交易者:4月2日11:00,金色盘面邀请行情大V李明成做客金色财经《币情观察室》直播间,将分享《如何从小白蜕变成合格的交易者》,敬请关注,扫描下图二维码即可观看。[2020/4/2]

脚手架在生成项目时,会对合约调用逻辑做高度的封装,用户可以像使用ORM框架操作数据库一样地操作智能合约。

在生成的项目中,每个合约都被单独封装到一个类中,每个函数对应合约的一个函数。其输入是java类型的输入,输出也是已解析的输出。此外,对于函数的输入参数,我们也已生成了相关的模型类,方便用户使用。

轻量配置

用户在将智能合约拖入脚手架后,只需做少量的涉及项目名称、组名、合约选择器等内容的配置即可。而且这些配置依据“契约优于配置”的原则设置了默认值,用户可根据自己的实际需要进行调整。

合约可选

在开发具有一定复杂度的智能合约时,出于易升级、松耦合的目的,开发者通常会采用一定的手段将合约功能解耦,拆散到不同的合约中去。所以,在一组智能合约中,真正供外部访问的合约只占少数,多数合约都仅作为功能性合约来支撑整体业务。

而且,在后续应用开发时,真正需要开发的服务类也占少数。为了让项目聚焦在所需要的合约上,开发者可配置合约选择器,即指定所需要处理的合约,继而脚手架只会为这些合约生成相应的代码,避免了冗余代码。

??如何使用

下面给一个简单的例子,以说明脚手架的使用方法。

声音 | BB:一直在研究如何为受到武汉疫情影响的人们提供帮助:2月16日,Block.one首席执行官BB发推文称,一直在研究如何以一种还尚未被使用的方式提供最好的帮助,且一直非常谨慎地保护Block.one的员工。我们的许多组织都在中国香港运营,我们的心与受影响的人息息相关。武汉加油。而此前EOS创始人BM在推文发布的有关武汉疫情的相关言论引起争议,甚至有社区成员要求中国交易所下架EOS,随后BM删除相关推文并道歉。[2020/2/16]

获取脚手架

从gihtub或gitee获取脚手架,以github为例:

git?clone?https://github.com/WeBankBlockchain/SmartDev-Scaffold.gitcd?tools

进入tools目录后,可以看到它的结构:

|--tools?|??|--contracts?|??|--|HelloWorld.sol?|??|--config.ini|??|--run.sh

其中:

contracts目录用于存放solidity合约文件,脚手架后续会读取该目录下的合约,以生成相对应的业务工程。可删除该目录下的默认合约,并将自己的业务合约拷贝到该目录下。

config.ini是启动相关配置。

run.sh是启动脚本。

配置脚手架

合约配置

金色财经独家整理 贸易战对比特币走势影响如何?贸易战避险,比特币“效果不错”:

今日凌晨,中美史上最大贸易战打响,全球股市重挫,数字资产比特币走势如何再被讨论。重温早在3月2日Brian Kelly在CNBC的关于贸易战的言论:贸易战将加强美元贬值、物价上涨的预期,由于普遍担忧通胀,人们愿意投资比特币这样的“新黄金”、 “硬资产”(避险),“在贸易战中,比特币效果不错”。

Brian Kelly的观点发表于300亿美元贸易战规模预测下,而今600万“变本加厉”。中国已于今晨展开“反击”,外媒也普遍预测美国为长期输家。股市下跌将支撑黄金,金价在昨日由于加息和贸易战担忧下收于两周最高点,而比特币为何反而下跌?据CNBC称:比特币未守住9000美元关口或因日本对加密数字货币加强监管力度的政策可能。金色财经认为,由于政策目前仍为影响比特币的主要因素,在最晚今年7月份国际监管措施出台、政策逐步趋稳后,数字货币价格将逐渐与黄金涨跌保持相似的变动。[2018/3/23]

本示例中,使用默认的HelloWorld合约。实际使用过程中,可删除contracts目录下的默认合约,并将自己的业务合约拷贝到该目录下。

项目配置

可以在config.ini中做项目配置,如下:

###?项目名称artifact=demo###?组名称group=org.example###?所支持的合约列表,通常为空即可selector=

运行脚手架

直接启动脚本:

美国商品期货交易委员会公布关于如何定义加密货币已经交易完成的解释: 美国商品期货交易委员会(CFTC)已经公布了解释说明,关于如何定义加密货币已经从买方“交付”给了卖方。确认交付已经完成的的两个因素是:1. 客户有能力 (i)拥有和控制全部数量的商品,无论是以保证金,还是使用杠杆或其他融资购买,以及(ii)在交易之日起28内,自由地商业使用商品(在任何特定平台内外);以及2. 报价人及卖方(包括各自的关联方或与报价人或卖家合作的其他人士)不保留任何利益或控制任何以保证金,杠杆或其他融资方式购买的商品,在超过自交易日期起计28日后。据CFTC称,提议的解释不是最终的,需要经过90天的公众评议期。[2017/12/16]

chmod?x?run.sh?bash?run.sh

运行成功后,会在tools目录下得到一个基于SpringBoot的项目工程,本示例是demo:

|--tools?|??|--demo?##?这是新生成的工程|??|--contracts

.├──?build.gradle├──?gradle│???└──?wrapper│???????├──?gradle-wrapper.jar│???????└──?gradle-wrapper.properties├──?settings.gradle└──?src????├──?main????│???├──?contracts????│???│???└──?HelloWorld.sol????│???├──?java????│???│???└──?org????│???│???????└──?example????│???│???????????└──?demo????│???│???????????????├──?Application.java????│???│???????????????├──?config????│???│???????????????│???├──?ContractConfig.java????│???│???????????????│???├──?SdkBeanConfig.java????│???│???????????????│???└──?SystemConfig.java????│???│???????????????├──?model????│???│???????????????│???├──?CommonResponse.java????│???│???????????????│???└──?bo????│???│???????????????│???????└──?HelloWorldSetInputBO.java????│???│???????????????├──?service????│???│???????????????│???└──?HelloWorldService.java????│???│???????????????└──?utils????│???│???????????????????└──?IOUtil.java????│???└──?resources????│???????├──?abi????│???????│???└──?HelloWorld.abi????│???????├──?application.properties????│???????├──?bin????│???????│???├──?ecc????│???????│???│???└──?HelloWorld.bin????│???????│???└──?sm????│???????│???????└──?HelloWorld.bin????│???????└──?conf????└──?test????????└──?java????????????├──?org????????????│???└──?example????????????│???????└──?demo????????????│???????????└──?DemoPkey.java????????????└──?org.example.demo

其中:

config目录包含了Bean配置类。

service目录中包含了智能合约访问类,一个类对应一个合约。

bo目录包含了合约函数输入参数的封装POJO类。

src/main/resource/conf目录用于存放证书信息。

应用开发

生成项目工程后,可以进行DAPP开发。下面以前文所提及的demo项目工程为例进行说明。

部署合约

使用控制台等方式部署HelloWorld合约,可得到它的地址。

证书拷贝

将配置文件拷贝到生成工程的conf目录或src/main/resources/conf目录下。该业务工程会自动在这些路径下搜索证书。

配置连接节点

修改application.properties时,填写如下信息:

system.peers=127.0.0.1:20200system.groupId=1system.certPath=src/main/resources/conf###?前述合约部署地址system.contract.helloWorldAddress=###?私钥明文,如为空,会自动生成一个system.hexPrivateKey=server.port=8080

补全业务处理逻辑

一个完整的DAPP应包含至少三层架构。本示例补全一个Controller。但需说明的是,它仅仅是展示交易的结果。示例如下:

@("hello")public?class?HelloController?{????????}

编译工程

进入目录后,执行编译:

cd?demogradle?build?-x?test

运行jar包

启动项目后,可在浏览器内输入:

http://127.0.0.1:8080/hello/set?n=hello

返回示例:

0x1c8b283daef12b38632e8a6b8fe4d798e053feb5128d9eaf2be77c324645763b

??即刻使用

上述相关代码和技术文档已更新,欢迎体验和star支持。如需咨询技术问题,欢迎关注本公众号,对话框回复进技术交流群。

文档地址:

https://smartdev-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Scaffold/index.html

github代码库地址:

https://github.com/WeBankBlockchain/SmartDev-Scaffold?

gitee代码库地址:

https://gitee.com/WeBankBlockchain/SmartDev-Scaffold

欢迎参与WeBankBlockchain的社区建设:

如项目对您有帮助,欢迎点亮我们的小星星(点击项目左上方Star按钮)。

欢迎提交代码(Pullrequests)。

提问和提交BUG。

如果发现代码存在安全漏洞,可通过以下地址

https://security.webank.com/上报。

郑重声明: 本文版权归原作者所有, 转载文章仅为传播更多信息之目的, 如作者信息标记有误, 请第一时间联系我们修改或删除, 多谢。

链链资讯

[0:0ms0-7:875ms