如何使用webase-front交易处理接口(本地签名)调用合约

最新推荐文章于 2023-08-27 10:29:26 发布
最新推荐文章于 2023-08-27 10:29:26 发布
阅读量598 收藏 2
点赞数 1
分类专栏： FISOC-BCOS笔记 区块链技术应用与开发 笔记 文章标签： 区块链 java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_63706760/article/details/132045041
版权

如何使用webase-front交易处理接口(本地签名)调用合约

前提条件

  • 部署好fisco-bcos区块链网络，此处是通过webase依赖包一键部署区块链网络
  • 在虚拟机或者云服务器部署区块链网络并开放相应的端口，使用windows端导入java项目时，请使用内网IP或公网IP导出项目

注意这里是为了方便，通过webase平台用户导出项目，而webase平台和webase-frong前置两个数据库互相独立，用户公私钥不会共享，所以也要把webase平台的用户导入到webase-front前置。若使用webase-front部署合约，并导出，则不用操作

这里也可以自己在idea新建一个项目，导入相应的配置好相关配置就可以了，不过会相对麻烦一些

1.接口说明

接口描述

此接口为WeBASE-Front使用本地私钥（页面中的测试用户）进行签名

通过合约信息进行调用，前置根据调用的合约方法是否是“constant”方法区分返回信息，“constant”方法为查询，返回要查询的信息。非“constant”方法为发送数据上链，返回块hash、块高、交易hash等信息。

接口URL

http://localhost:5002/WeBASE-Front/trans/handle

调用方法

HTTP POST

请求参数

1）参数列表

序号中文参数名类型最大长度必填说明
1用户地址userString是用户地址，可通过/privateKey接口创建
2合约名称contractNameString是
3合约地址contractAddressString是
4方法名funcNameString是
5合约编译后生成的abi文件内容contractAbiList是合约中单个函数的ABI，若不存在同名函数可以传入整个合约ABI，格式：JSONArray
6方法参数funcParamList否String数组，每个参数都使用String字符串表示，数组也需要放在双引号内，多个参数以逗号分隔（参数为数组时同理），如：set(string s, string[] l) -> [“str1”,“[“arr1”,“arr2”]”]，根据所调用的合约方法判断是否必填
7群组IDgroupIdint是默认为1
8合约路径contractPathint否
9是否使用cns调用useCnsbool是
10cns名称cnsNameString否CNS名称，useCns为true时不能为空
11cns版本versionString否CNS版本，useCns为true时不能为空

2）数据格式

示例：

{
	"groupId": "1",
	"user": "0x7bfa3539c8761978f0a2a1f7f240bde97819fb03",
	"contractName": "HelloWorld",
	"contractPath": "/",
	"version": "",
	"funcName": "set",
	"funcParam": ["333"],
	"contractAddress": "0xe10441d9179cf0424aae808b51bc85dcbbfe1447",
	"contractAbi": [{
		"inputs": [{
			"internalType": "string",
			"name": "n",
			"type": "string"
		}],
		"name": "set",
		"outputs": [],
		"stateMutability": "nonpayable",
		"type": "function",
		"funcId": 2
	}],
	"useAes": false,
	"useCns": false,
	"cnsName": ""
}
响应参数

a、正确查询交易返回值信息

{"Hi,Welcome!"}

b、正确发送数据上链返回值信息（交易收据）

{
  "transactionHash": "0x69ced0162a0c3892e4eaa3091b831ac3aaeb772c062746b20891ceaf8a4fb429",
  "transactionIndex": "0x0",
  "root": "0x8cbc3f2c0e35a71738909e3b388efa6697084b05badd3a3bd3c64f0575c78c15",
  "blockNumber": "2",
  "blockHash": "0xf58f4f43b3761f4863ad366c4a7e2a812ed68df9f7bcad6b502fd544665e7625",
  "from": "0x9d75e0ee66cfef16897b601624b60413d988ae7d",
  "to": "0x0000000000000000000000000000000000000000",
  "gasUsed": "316449",
  "contractAddress": "0xa8af0ee580d8af674a60341030ddbc45431bc235",
  "logs": [],
  "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
  "status": "0x0",
  "statusMsg": "None",
  "input": "0x608060405234801561001057600080fd5b506103e3806100206000396000f300608060405260043610610057576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063299f7f9d1461005c5780633590b49f146100ec57806362e8d6ce14610155575b600080fd5b34801561006857600080fd5b5061007161016c565b6040518080602001828103825283818151815260200191508051906020019080838360005b838110156100b1578082015181840152602081019050610096565b50505050905090810190601f1680156100de5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b3480156100f857600080fd5b50610153600480360381019080803590602001908201803590602001908080601f016020809104026020016040519081016040528093929190818152602001838380828437820191505050505050919291929050505061020e565b005b34801561016157600080fd5b5061016a6102c4565b005b606060008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156102045780601f106101d957610100808354040283529160200191610204565b820191906000526020600020905b8154815290600101906020018083116101e757829003601f168201915b5050505050905090565b7f5715c9562eaf8d524d564edb392acddefc81d8133e2fc3b8125a260b1b413fda816040518080602001828103825283818151815260200191508051906020019080838360005b83811015610270578082015181840152602081019050610255565b50505050905090810190601f16801561029d5780820380516001836020036101000a031916815260200191505b509250505060405180910390a180600090805190602001906102c0929190610312565b5050565b6040805190810160405280600d81526020017f48656c6c6f2c20576f726c6421000000000000000000000000000000000000008152506000908051906020019061030f929190610312565b50565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061035357805160ff1916838001178555610381565b82800160010185558215610381579182015b82811115610380578251825591602001919060010190610365565b5b50905061038e9190610392565b5090565b6103b491905b808211156103b0576000816000905550600101610398565b5090565b905600a165627a7a72305820f3088deb3d14c6893440e4769f2389e9335e04faa10e6de5b4c93af15d1a34e80029",
  "output": "0x",
  "txProof": null,
  "receiptProof": null,
  "message": null,
  "statusOK": true
}
注：访问 WeBASE-Front Swagger-ui
  • 浏览器访问: http://localhost:5002/WeBASE-Front/swagger-ui.html
  • 找到**/trans/handle**的 API 接口
  • 有相关的测试用例对其进行测试操作
    在这里插入图片描述
    在这里插入图片描述

2.编写合约HelloWorld.sol

pragma solidity ^0.4.25;

contract HelloWorld{
    string str;
    
    constructor(){
        str = "Hello World";
    }
    
    function setStr(string memory _str)public {
        str = _str;
    }
    
    function getStr()public view returns(string memory){
        return str;
    }
}

3.编译部署合约

在这里插入图片描述

4.导出java项目

第一步点击到处java项目
在这里插入图片描述

第二步，选择节点，选择用户，选择已编译HelloWorld合约

在这里插入图片描述
在这里插入图片描述

第三步，把下载好的Java项目导入IDEA

打开IDEA,点击左上角文件，点击打开，然后找到下载好的项目导入，构建项目需要一定的时间下载gradel包管理器和依赖

导入后成功构建，如下所示：

在这里插入图片描述

5.通过测试类调用接口

HelloWorldTestByWeBASE_Front 是一个测试类。它主要用于测试与合约进行交互的功能。

类中的注解解释如下：

  • @RunWith(SpringRunner.class)：指定使用 SpringRunner 来运行测试，这是一个JUnit运行器，用于运行 Spring Boot 的集成测试。
  • @SpringBootTest(classes = Application.class)：表示这是一个Spring Boot的集成测试类，并指定了 Application 类作为启动类来加载Spring Boot上下文。
  • @WebAppConfiguration：标记这是一个Web应用程序的配置类，并为测试类提供Web上下文。
  • @PropertySource(value = {"classpath:application.properties"})：指定了引入的外部属性文件 application.properties。

该类中包含了两个测试方法：

  1. testSet() 方法用于测试调用合约的 setStr() 方法
  2. testGet() 方法用于测试调用合约的 getStr() 方法

这个测试类主要用于验证与合约进行交互的功能是否正常，包括调用合约的方法并获取其返回结果。

代码如下所示:

package org.example.HelloWorld;

import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.context.annotation.PropertySource;
import org.springframework.http.*;
import org.springframework.test.context.junit4.SpringRunner;
import org.springframework.test.context.web.WebAppConfiguration;
import org.springframework.web.client.RestTemplate;

@RunWith(SpringRunner.class)
@SpringBootTest(classes = Application.class)
@WebAppConfiguration
@PropertySource(value = {"classpath:application.properties"})
public class HelloWorldTestByWeBASE_Front {
    @Value("${URL}")
    private String URL;
    @Value("${system.contract.helloWorldAddress}")
    private String CONTRACT_ADDRESS;
    private final String CONTRACT_NAME = "HelloWorld";
    public static final String ABI = "[{\"constant\":false,\"inputs\":[{\"name\":\"_str\",\"type\":\"string\"}],\"name\":\"setStr\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"getStr\",\"outputs\":[{\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"}]";
    public static final String FUNC_SETSTR = "setStr";

    public static final String FUNC_GETSTR = "getStr";

    public static final String TEST_USER_ADDRESS = "0xf6d9791f45c124ad528793aaa559b7bb2c93e190";


    @Test
    public void testSet(){
        // 创建一个RestTemplate实例
        RestTemplate restTemplate = new RestTemplate();
        // 创建请求头，并设置为JSON格式
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        // 构造请求体
        JSONObject requestBody = new JSONObject();
        //设置接口参数
        JSONArray params = JSONArray.parseArray("[\"Hello FISCO-BCOS\"]");
        requestBody.put("contractName",CONTRACT_NAME);
        requestBody.put("contractAddress",CONTRACT_ADDRESS);
        requestBody.put("funcParam",params);
        //此处ABI原为json格式，因为JSONObject对象要序列化为json格式，避免重复序列化所以先将ABI转为java对象
        requestBody.put("contractAbi", JSONArray.parseArray(ABI));
        requestBody.put("user",TEST_USER_ADDRESS);
        requestBody.put("funcName",FUNC_SETSTR);
        // 创建HttpEntity对象，将请求体和请求头封装为一个请求实体
        HttpEntity<JSONObject> requestEntity = new HttpEntity<>(requestBody, headers);
        // 发送POST请求，并获取响应结果
        ResponseEntity<String> responseEntity = restTemplate.exchange(URL,HttpMethod.POST, requestEntity, String.class);
        System.out.println("responseEntity = " + responseEntity);
        System.out.println("responseEntity.getStatusCodeValue() = " + responseEntity.getStatusCodeValue());
        if(responseEntity.getStatusCodeValue()==200){
            System.out.println("调用合约setStr()成功，结果为：" + responseEntity.getBody());
        }
    }

    @Test
    public void testGet(){
        // 创建一个RestTemplate实例
        RestTemplate restTemplate = new RestTemplate();
        // 创建请求头，并设置为JSON格式
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        // 构造请求体
        JSONObject requestBody = new JSONObject();
        requestBody.put("contractName",CONTRACT_NAME);
        requestBody.put("contractAddress",CONTRACT_ADDRESS);
        //此处ABI原为json格式，因为JSONObject对象要序列化为json格式，避免重复序列化所以先将ABI转为java对象
        requestBody.put("contractAbi", JSONArray.parseArray(ABI));
        requestBody.put("user",TEST_USER_ADDRESS);
        requestBody.put("funcName",FUNC_GETSTR);
        // 创建HttpEntity对象，将请求体和请求头封装为一个请求实体
        HttpEntity<JSONObject> requestEntity = new HttpEntity<>(requestBody, headers);
        // 发送POST请求，并获取响应结果
        ResponseEntity<String> responseEntity = restTemplate.exchange(URL,HttpMethod.POST, requestEntity, String.class);
        System.out.println("responseEntity = " + responseEntity);
        System.out.println("responseEntity.getStatusCodeValue() = " + responseEntity.getStatusCodeValue());
        if(responseEntity.getStatusCodeValue()==200){
            System.out.println("调用合约getStr()成功，结果为：" + responseEntity.getBody());
        }
        // 发送Get请求，并获取响应结果
        String response = restTemplate.getForObject("http://47.122.19.138:5002/WeBASE-Front/version", String.class);
        System.out.println("version = " + response);
    }


}

测试运行结果：
在这里插入图片描述

已经调用成功！！！

阿杰在摸鱼
关注
  • 1
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
FISCO-BCOS及WeBase-Front中间件安装包.zip
10-24
FISCO-BCOS及WeBase-Front中间件安装包
区块链网络管理平台WeBASE双节点可视化部署
冰之杍的博客
06-05 6437
区块链网络管理平台WeBASE双节点可视化部署
区块链入门教程(8)--WeBASE-Front节点前置服务
程序员大阳
10-22 4989
开发一个最基本的HelloWorld智能合约。
WeBASE管理平台快速入门搭建(单群主4节点联盟链+WeBASE-Front)
weixin_61275790的博客
06-20 2515
WeBASE是区块链应用和FISCO BCOS节点之间搭建的中间件平台可以帮助开发者快速构建、测试和部署基于FISCO BCOS的区块链应用，支持智能合约开发模板、合约API管理、账户管理、链上操作记录查询等功能。同时，WeBASE还提供了多样化的安全保障措施，如合约审计、用户权限控制、节点监控等功能，支持多租户部署及多集群管理等特性。这些功能能够帮助开发者降低区块链应用的开发和维护成本，提高应用的安全性和可靠性。
Fisco Bcos区块链三（webase中间件平台一键部署）
qq_54353206的博客
01-25 3260
搭建webase平台，方便节点管理和智能合约部署
开源进展 | WeBASE v3.1.0发布，新增多个实用特性
微众区块链的博客
08-04 1489
WeBASE是一个友好、功能丰富的区块链中间件平台，通过一系列通用功能组件和实用工具，助力社区开发者更快捷地与区块链进行交互。目前WeBASE已更新迭代至v3.1.0版本，本次更新中，WeBASE带来了最新的合约Java脚手架导出功能，完成达梦数据库适配，新增WeBASE CRUD预编译接口代码，并在技术文档中归类呈现了数十篇由社区开发者贡献的区块链教程，以便用户可以按需查阅。一起来看看WeBAS...
WeBase快速入门搭建，http://localhost:5002/WeBASE-Front页面打不开，启动后5002端口自动断开
qq_50330658的博客
09-07 4056
WeBASE-Front 解决方法：先切到fisco节点下，启动相关节点，案例中用到了node0和node1，所以操作如下： cd~ cd fisco/nodes/127.0.0.1 ./start_all.sh#或者单独启动node0和node1，cd node0 && ./start.sh cd node1 && ./start.sh 未启动节点时： http://localhost:5002/WeBASE-Front 控制台输出： 启动节点后： 控制台输
区块链入门教程(9)--使用WeBASE-Front部署及调用合约
程序员大阳
10-29 1601
智能合约转译Go文件
WeBASE-Front安装及使用
xingxincsdn的博客
07-07 2894
WeBASE-Front是和FISCO-BCOS节点配合使用的一个子系统，可视化控制台。支持FISCO-BCOS 2.0以上版本，集成web3sdk，对接口进行了封装，可通过HTTP请求和节点进行通信。具备可视化控制台，可以在控制台上开发智能合约，部署合约和发送交易，并查看交易和区块详情。还可以管理私钥，对节点健康度进行监控和统计。注意： WeBASE-Front需要跟节点同机部署，一个节点对应一个WeBASE-Front服务。...
WeBASE-Front前置节点服务搭建
qq_51562644的博客
08-27 510
这里需要将nodes/${ip}/sdk拷贝到conf目录，共SDK与节点建立连接时使用。如果未安装git命令的需要先安装git命令，安装git命令代码如下，如已安装请忽略。现在WeBASE-Front服务就搭建完毕了，我们现在来完成合约的调用。这个表示没有配置JAVA_HOME的环境变量，需要配置一下环境变量。但是我们不使用它，我们自己来写一个HelloWorld合约进行调用。到这里我们的节点前置服务的配置及基本使用就已经学会了。：部署时需要选择用户，我们选择刚刚创建的用户。
webase-front.zip
11-11
节点前置服务 WeBASE-Front仓库 集成web3sdk，提供RESTful风格的接口，客户端可以使用http的形式和节点进行交互，内置内存数据库，采集节点健康度数据。内置web控制台，实现节点的可视化操作。
WeBASE-Front-master.zip
03-26
WeBASE-Front是和FISCO BCOS节点配合使用的一个子系统,需要和节点统计部署，目前支持FISCO BCOS 2.0/3.0以上版本，可通过HTTP请求和节点进行通信，集成了web3sdk/java-sdk，对接口进行了封装和抽象，具备可视化...
WeBASE-Front:WeBASE-Front是和FISCO BCOS节点配合使用的一个子系统，需要和节点统计部署，目前支持FISCO BCOS 2.0以上版本，可通过HTTP请求和节点进行通信，集成了web3jsdk，对接口进行了封装和抽象，具备可视化控制台，可以在控制台上查看交易和区块详情，开发智能合约，管理私钥，并对节点健康度进行监控和统计
05-13
WeBASE-Front是和FISCO BCOS节点配合使用的一个子系统，需要和节点统计部署，目前支持FISCO BCOS 2.0以上版本，可通过HTTP请求和节点进行通信，集成了web3jsdk，对接口进行了封装和抽象，具备可视化控制台，可以在...
console-webase-front 源
06-10
console-webase-front 源
WeBASE应用管理案例：亦笔科技贡献司法存证应用
微众区块链的博客
08-20 809
WeBASE v1.5.0开放了应用管理功能，支持区块链应用以开源应用管理案例的形式接入到WeBASE中， 为社区提供完整的应用开源实现参考。我们公司（杭州亦笔科技有限公司）作为一家专注于...
手动搭建webase（1）——节点前置服务
qq_50330658的博客
09-11 2145
1.前提条件 2.拉取代码 git clone https://github.com/WeBankFinTech/WeBASE-Front.git #若因网络问题导致长时间下载失败，可尝试以下命令 git clone https://gitee.com/WeBank/WeBASE-Front.git 进入目录 cd WeBASE-Front 如下图： mkdir WEBASE创建空文件夹用于存放相关组件 3.编译代码 方式一：如果服务器已安装Gradle，且版本为Gradle-4.10或以上 gr
可视化部署
m0_70877441的博客
04-08 679
可视化部署是指通过 WeBASE 管理平台（WeBASE-Web+WeBASE-Node-Manager），在多台主机上快速部署 FISCO-BCOS 底层节点和 WeBASE-Front 前置 以及对底层节点的扩容操作。然后通过 WeBASE 管理平台（WeBASE-Web）的界面在填入的主机中部署节点（FISCO-BCOS 2.5.0+，暂未支持FISCO-BCOS 3.0系列）和节点前置子系统（WeBASE-Front 1.4.0+）。注：若后续需要添加新的主机，需要将新主机的IP添加到此处。
【教程】如何配置简单的webase-front中间件
这里面的代码全是错的
08-21 1218
日志中若出现报错信息，可根据信息提示判断服务是否异常，也可以参考并根据错误提示或根据。如，检查webase-front日志，其他webase服务可进行类似操作。拷贝sdk证书文件（build_chain的时候生成的）检查方法如下，若无输出，则代表进程端口监听异常，需要到。检查节点前置webase-front的进程。中查看日志的错误信息，并根据错误提示或根据。命令，检查节点与节点前置的进程是否存在。命令，检查节点与节点前置的端口监听情况。目录，供SDK与节点建立连接时使用。成功部署后，可以根据以下步骤。
【微众区块链】centos7一键部署快速搭建WeBASE管理台环境
Demon_666的博客
04-25 722
centos7一键部署WeBASE管理平台
webase-front的搭建监听失败
最新发布
01-27
webase-front的搭建监听失败可能是由于多种原因造成的。首先，可以检查是否正确安装了所需的组件和软件，包括Node.js、npm等。其次，可能是由于端口被占用或者防火墙阻止了监听请求。此外，也有可能是配置文件中的...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值