教程 | 使用WeBASE进行“两阶段交易”

作为一个友好的、功能丰富的区块链中间件平台， WeBASE致力于提高区块链开发者的运维与管理效率。在新近发布的 WeBASE v1.5.2 中，一大优化是提供了获取交易编码的接口，更方便用户使用"两阶段交易"。

“两阶段交易”是什么？“两阶段交易”是指分成两个步骤发送交易，即对交易编码并签名、将交易提交到链上这两个阶段：

• 第一阶段：构造并获取交易编码值，并通过私钥对交易编码值签名;

• 第二阶段：发送交易，也就是将已签名的编码值发送到链上。

在WeBASE v1.5.2中，我们在WeBASE-Front节点前置服务中增加了获取交易编码值的功能。该接口可以返回未签名的交易编码值，也可以返回通过WeBASE-Front本地私钥或WeBASE-Sign私钥签名后的交易编码值。获得已签名的编码值后，用户直接调用前置服务的提交交易接口即可完成“两阶段交易”。

以下演示，我们通过WeBASE-Front节点前置服务接口获取交易编码值，并通过FISCO-BCOS Java-SDK对编码值进行签名，最后通过接口提交交易来加深对“两阶段交易”的了解。

  前期准备

部署HelloWorld合约

在发起交易之前，首先要确保在链上部署一个可调用的合约。这里以WeBASE-Front “合约仓库-工具合约”中的 “HelloWorld” 合约为例，部署一份 HelloWorld 合约。

我们在 WeBASE-Front 的合约IDE中编译一份 HelloWorld 合约并完成部署操作，如下图所示：

获得合约地址、合约ABI等信息后，我们根据 WeBASE-Front 的接口文档指引，调用获取交易编码接口。

查看接口文档

两阶段交易中，第一步交易编码并签名可以通过 WeBASE-Front 的 /trans/convertRawTxStr/withSign 接口构造一个已签名的交易体，接口文档简介如下：

值得一提的是，调用 /trans/convertRawTxStr/withSign 接口时：

• 如果传入了 signUserId 非空，则返回的交易体编码值是通过 signUserId 对应私钥签名后的交易体编码值。

• 如果传入的 signUserId 为空，则返回的是未签名的交易体编码值，开发者也可以通过JAVA-SDK用私钥对该值签名。
  

获取已签名的交易编码值后，就可以进行第二步的提交交易操作了。

在 WeBASE-Front 中，我们可以通过 /trans/signed-transaction 接口，将已签名的交易体编码值，完成交易上链并获得交易回执。

上述各个接口的调用方法都可以在 WeBASE-