百度超级链提供了 xuper-sdk-js 工具可以使用 js 调用超级链,Xuper SDK (JS/TS) 是一个在可以让开发者快速使用 XuperChain 的软件开发工具包。
该 SDK 提供包含账号、交易、合约与各类查询功能的服务接口,可以在浏览器与 Nodejs 环境下使用。
官方地址:https://github.com/xuperchain/xuper-sdk-js
使用方式
首先需要搭建一个 XuperChain 的测试环境,然后再通过 js 来调用 xuperchain 的服务接口
1、搭建测试环境
通过Docker搭建一个搭建单节点服务
拉取镜像 (XuperChian v3.7 – Repository)
注意这里是 3.7 版本
# 拉取镜像
docker pull smilingxinyi/xuperchain
# 启动容器
docker run -d -p 8098:8098 -p 37101:37101 -p 47101:47101 --name xc smilingxinyi/xuperchain
这里用到了 8098,37101,47101 三个端口
2、搭建 js 前端应用
使用 js 可以使用 vue 等框架
安装依赖
npm install --save @xuperchain/xuper-sdk
使用方法
# 快速开始
import XuperSDK from '@xuperchain/xuper-sdk';
const node = 'http:127.0.0.1:8098'; // 节点 注意这里连接的是 8098 端口
const chain = 'xuper'; // 链名称
const xsdk = XuperSDK.getInstance({
node,
chain
});
const start = async () => {
const result = await xsdk.getBlockChains();
console.log(result);
};
start();
在Nodejs环境中支持并默认使用 gRPC,可以选择关闭,依然使用Http方式请求
XuperSDK.getInstance({
node,
chain,
env: {
node: {
disableGRPC: true // 禁用gRPC
}
}
})
API参考文档
3、测试结果
测试环境搭建好之后,使用 js 访问可以获得如下结果:
4、插件的使用
背书服务插件
公开网络
必须使用该插件
EndorsementPlugin
Example:
const params = {
server: process.env.ENDORSE_SERVER, // 服务
fee: process.env.FEE, // 服务费
endorseServiceCheckAddr: process.env.SERVICE_SIGN_ADDRESS, // 背书签名地址
endorseServiceFeeAddr: process.env.SERVICE_FEE_ADDRESS // 背书服务费地址
}
const xsdk = new XuperSDK({
node,
chain,
plugins: [
EndorsementPlugin({
transfer: params,
makeTransaction: params // 两个一样
})
]
});
连接百度超级链开放网络请查看:vue 使用 Xuper SDK JS 连接百度超级链开放网络