关于eosjs智能合约开发,分为三个步骤:
一、概念了解、学习,查找文档阶段:具体查看文档如下
https://blog.csdn.net/weixin_39842528/article/details/81098715 eosjs前端简明使用手册,包含链接私链方法和部分eosjs封装好的方法
https://eos.readthedocs.io/zh_CN/latest/API/EOSIO-RPC/ eosio-EOS官方中文文档,包含用到的接口及范例
https://developers.eos.io/eosio-nodeos/reference#get_info nodeos官方文档,包含用到的接口
二、搭建node服务,npm引入所需要使用的代码,链接私链,调试部分接口
搭建node服务:代码如右侧所示,详见:https://blog.csdn.net/zach_zhou/article/details/72779762
npm 引入 :
1. 引入eos:npm install eos
2.引入eosjs:npminstall eos-js
3.引入express(node服务搭建所需):npm install express -save
私链链接:方法详见文章https://blog.csdn.net/weixin_39842528/article/details/81098715
方法调试:此时分两种调试方法,
1. 直接进行接口的调试,搭建界面之后,直接使用jQuery提供的ajax,链接私链上的方法名(方法名链接方式详见文章:https://developers.eos.io/eosio-nodeos/reference#get_info),利用这种方法可直接进行私链上部分方法接口的联调测试,但是需要和服务端提供私链的人员进行体检沟通好,这种方法会产生跨域的问题,目前解决方案:使用nginx进行代理。
2.使用node服务,用eosjs提供的方法,直接进行接口的测试并获取数据和操作数据,唯一的问题就是需要直接依赖node服务,否则无法跑通(目前使用此种方法进行测试),方法详见:https://blog.csdn.net/weixin_39842528/article/details/81098715
三、demo搭建
根据设计图进行前端界面的搭建,同时需要使用node便捷服务端接口供前端使用,但是在搭建的过程中,需要引入用户的私钥并进行一定的签名算法才可以,具体node服务端代码如下所示:
//引入http模块
var http = require("http");
var express = require("express");
var app = express();
//app.use(bodyParser.urlencoded({
// extended: false
//}));
//设置主机名
var hostName = '192.168.1.111';
//设置端口
var port = 8989;
const {
Api,
JsonRpc,
RpcError,
JsSignatureProvider
} = require('eosjs');
const fetch = require('node-fetch'); // node only; not needed in browsers
const {
TextDecoder,
TextEncoder
} = require('text-encoding'); // node, IE11 and IE Edge Browsers
let defaultPrivateKey = "----"; // 提供的用户的私钥
let signatureProvider = new JsSignatureProvider([defaultPrivateKey]);;
const rpc = new JsonRpc('http://127.0.0.1:8888', { // 内部私链的ip访问地址和端口号
fetch
});
const api = new Api({
rpc,
signatureProvider,
textDecoder: new TextDecoder(),
textEncoder: new TextEncoder()
});
//创建服务
app.all('*', function(req, res, next) {
res.header("Access-Control-Allow-Origin", "*");
res.header("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept");
res.header("Access-Control-Allow-Methods", "PUT,POST,GET,DELETE,OPTIONS");
res.header("X-Powered-By", ' 3.2.1')
res.header("Content-Type", "application/json;charset=utf-8");
next();
});
/**
* 创建广告
*/
app.post("/myservice/post", function(req, res) {
req.on('data', function(data) {
obj = JSON.parse(data);
console.log(obj);
(async() => {
const result = await api.transact({
actions: [{
account: 'adshow', //账户
name: 'create', //私链提供的方法名称,问区块链开发者
authorization: [{
actor: 'yan2', //操作者,需要对应上面的私钥
permission: 'active', //对应的权限,需要问区块链开发者
}],
data: obj, //该接口需要的数据
}]
}, {
blocksBehind: 3,
expireSeconds: 30,
});
res.send(result);
})();
})
});
/**
* 编辑广告答案接口
*/
app.post('/myservice/edit', function(req, res) {
console.log('===============');
req.on('data', function(data) {
var obj = JSON.parse(data);
console.log(obj);
(async() => {
const result = await api.transact({
actions: [{
account: 'adshow',
name: 'edtarticanse',
authorization: [{
actor: 'yan2',
permission: 'active',
}],
data: obj
}]
}, {
blocksBehind: 3,
expireSeconds: 30,
});
res.send(result);
})();
})
})
/**
* 支付广告佣金
*/
/**报错:需要确定**/
app.post('/myservice/payMoney', function(req, res) {
console.log('===============');
req.on('data', function(data) {
var obj = JSON.parse(data);
try {
(async() => {
const result = await api.transact({
actions: [{
account: 'adshow',
name: 'payasset',
authorization: [{
actor: 'yan2',
permission: 'active',
}],
data: obj
}]
}, {
blocksBehind: 3,
expireSeconds: 30,
});
res.send(result);
})();
} catch(e) {
console.log('\nCaught exception: ' + e);
if(e instanceof RpcError)
console.log(JSON.stringify(e.json, null, 2));
}
})
})
/**
* 用户参与广告、获取广告文件时调用
*/
/**详见日志**/
app.post('/myservice/userGetG', function(req, res) {
console.log('===============');
req.on('data', function(data) {
var obj = JSON.parse(data);
(async() => {
const result = await api.transact({
actions: [{
account: 'adshow',
name: 'partake',
authorization: [{
actor: 'yan2',
permission: 'active',
}],
data: obj
}]
}, {
blocksBehind: 3,
expireSeconds: 30,
});
res.send(result);
})();
})
})
/**
* 用户提交答案
*/
app.post('/myservice/userUpAnswer', function(req, res) {
console.log('===============');
req.on('data', function(data) {
var obj = JSON.parse(data);
console.log(obj);
(async() => {
const result = await api.transact({
actions: [{
account: 'adshow',
name: 'uploadadanse',
authorization: [{
actor: 'yan2',
permission: 'active',
}],
data: obj
}]
}, {
blocksBehind: 3,
expireSeconds: 30,
});
res.send(result);
})();
})
})
app.listen(port, hostName, function() {
console.log(`服务器运行在http://${hostName}:${port}`);
});
四、前端界面
前端界面本人采用vue搭建,也可以使用单纯的js或者jQuery方法,node服务接口调用和平常调用Java接口方式一样
总结:由于对eos不了解,在学习的过程中遇到了很多坑,主要表现在一下几点:
1.在连接上内部私链之后,进行eosjs方法的调试,发现部分方法无法获取数据,无法走通。解决方法:经过排查发现内部私钥没有进行签名算法加密,同时和用于名无法对应,在经过修改之后,方法跑通。(已解决)
2. 服务端权限问题:获取数据时,采用的用户权限不同,会导致方法无法走通,此时需要让服务端修改用户权限,才能正常获取数据以及修改数据。(已解决)
3. node服务问题:在使用接口进行调试时,需要使用node搭建一个属于自己的服务端进行连接,并提供响应的接口给前端,让前端自行调用。(已解决)
4. 在接口调用的过程中,由于浏览器同源策略问题,会产生跨域的问题,目前解决方法是采用nginx进行代理转发。(已解决)
5. 用户私钥加密问题:目前demo中用户以及用户对应的私钥是配置在服务端的,在动态获取私钥并进行加密过程中,服务端报错,错误未知,目前暂时未找到问题所在。(据区块链开发同事说,需要对接第三方https://www.mytokenpocket.vip/,用户导入私钥之后,直接获取到用户的各种信息以供node服务端使用,但是暂时未接入,方法是否可用为进行验证)
6. 在调用node服务接口过程中,发现在使用post方法时,前端传递的参数服务端一直获取不到,后来经过查找发现是服务在数据未接受到就已经产生返回,此时就需要服务端进行数据的监听,如下:
app.post("/post", function(req, res) {
req.on('data', function(data) {
obj = JSON.parse(data);
var dataList = {
'message': '回传成功'
}
res.send(dataList);
})
})
前端传递过来的参数为字符串形式,需要进行一次转换成JSON格式,然后后续的操作放在on监听事件内部,包括接口返回send的数据。