自动分账是许多平台都邑用到的付出功用。许多互联网内容售卖平台都邑跟内容供应者分账。比方:Apple 的 App Store 跟 App 开辟者三七分红。许多平台都运用了付出宝、微信付出作为付出手腕,然则要同时完成给内容供应者分账,倒是一件不太轻易的事。运用 FIBOS 智能合约能够很轻易完成这个需求。
文中代码已在 GitHub 上开源。https://github.com/fengluo/fi…
设想思绪
在 FIBOS 转账是经由过程 token 合约的extransfer
要领来完成的。extransfer
要领在实行的时刻会给转账方账户和入账方账户发送关照。所以用户给平台方账户转账的时刻,平台账户就会收到关照。所以团体营业逻辑以下:
quantity: 10 FO
memo: 内容供应者账户 quantity: 8 FO
用户账户 -------------------> 平台账户 ----------------> 内容供应者账户
extransfer 2/8 分红 extransfer
- 用户给平台方账户转账,
memo
中填写内容供应者的账户名。 - 平台方的账户合约监听
extransfer
要领的关照,然后做出分账盘算,给对应内容供应者的账户转账对应金额。
团体逻辑很简朴,全部合约代码逻辑差不多用20行就能够写完。
编写合约
FIBOS 的智能合约分为 ABI 文件和 JS 合约两部份。ABI 相当于合约接口,JS 合约则是功用完成。本案例现在没有接口设想需求,不过 ABI 文件照样合约不可缺乏的部份。所以我们简朴建立一下就好。
我们先建立一个 contracts
文件夹,合约文件都邑放在这里。然后在此文件夹下,建立 subaccount.abi
文件,内容为:
{
"version": "eosio::abi/1.0"
}
JS 合约部份也没有太庞杂。在 contracts
文件夹下建立 subaccount.js
文件,代码为:
exports.on_extransfer = (from, to, quantity, memo) => {
// 须要在开首做一些推断
if (to === action.receiver && action.is_account(memo)) {
const num = parseInt(quantity.quantity.split(' ')[0])
// 假定我们商定平台方跟内容供应者是2/8分红。
const subnum = (num * 0.8).toFixed(4);
trans.send_inline('eosio.token', 'extransfer', {
from: to,
to: memo,
quantity: {
quantity: `${subnum} ${quantity.quantity.split(' ')[1]}`,
contract: quantity.contract
},
memo: 'sub account'
},
[
{
// 须要供应合约账户的 active 权限
actor: action.receiver,
permission: 'active'
}
]);
}
}
合约代码开首我们须要做一些考证。
- 收款方的账户为合约账户,不然由于下面代码实行给内容供应者转账时,由于转帐方也是合约账号会再次收到关照,形成无穷递归,超越最大 send_inline 层数而报错。
- 我们用
memo
参数来放内容供应者的账户,所以我们须要对此参数校验一下该账户是不是存在防备打错。
合约代码中我们运用 send_inline
挪用 eosio.token
合约来实行转帐操纵。转帐操纵须要对应账户的 active
权限才实行。为了处理权限滥用题目,FIBOS 定义了一个特别权限 eosio.code
。我们须要在平台合约账户中设置权限,在 active
权限下增加该合约账户的 eosio.code
受权。详细的设置操纵会在下面申明。
在 FIBOS TestNet 上注册账号
为轻易测试,我们在测试网 http://testnet.fibos.fo 上注册三个账户。
- 用户账号
helloworld11
- 内容供应者账号
helloworld22
- 平台合约账号
helloworld33
我们须要纪录这三个账号的账户名以及公私钥。以便下面的开辟运用。建立一个一致的设置文件来纪录这些数据:
const config = {
// 平台合约账户的客户端设置
client: {
chainId: '68cee14f598d88d340b50940b6ddfba28c444b46cd5f33201ace82c78896793a',
httpEndpoint: 'http://testnet.fibos.fo',
keyProvider: 'PRIVATE_KEY_OF_helloworld33'
},
// 用户账户的客户端设置
callClient:{
chainId: '68cee14f598d88d340b50940b6ddfba28c444b46cd5f33201ace82c78896793a',
httpEndpoint: 'http://testnet.fibos.fo',
keyProvider: 'PRIVATE_KEY_OF_helloworld11'
},
// 平台合约账户信息
contractAccount: {
name: 'helloworld33',
publicKey: 'PUBLIC_KEY_OF_helloworld33',
privateKey: 'PRIVATE_KEY_OF_helloworld33'
},
// 用户账户信息
account1: {
name: 'helloworld11',
publicKey: 'PUBLIC_KEY_OF_helloworld11',
privateKey: 'PRIVATE_KEY_OF_helloworld11'
},
// 内容供应者账户信息
account2: {
name: 'helloworld22',
publicKey: 'PUBLIC_KEY_OF_helloworld22',
privateKey: 'PRIVATE_KEY_OF_helloworld22'
}
}
module.exports = config
设置权限
在合约代码中,我们挪用了 trans.send_inline
函数挪用合约 eosio.token
来完成转帐操纵,然则转帐操纵是须要账户的 active
权限。所以我们须要更新一下合约账户的权限,须要增加挪用者的 eosio.code
受权到它的 active
权限。这个挪用者天然也是这个合约账户。
const FIBOS = require('fibos.js');
const config = require('./config');
const fibosClient = FIBOS(config.client);
let ctx = fibosClient.contractSync('eosio');
var r = ctx.updateauthSync({
account: config.contractAccount.name,
permission: 'active',
parent: 'owner',
auth: {
threshold: 1,
keys: [{
key: config.contractAccount.publicKey,
weight: 1
}],
accounts: [{
permission: {
// 将挪用者账号的 eosio.code 受权增加到它的 active 权限下。
actor: config.contractAccount.name,
permission: 'eosio.code'
},
weight: 1
}]
}
},{
authorization: `${config.contractAccount.name}@owner` //变动账户权限须要运用 owner 权限
});
console.log(r);
布置合约
const FIBOS = require('fibos.js');
const config = require('./config');
const fibosClient = FIBOS(config.client);
const fs = require('fs');
// setcode
const jsCode = fs.readTextFile(`${__dirname}/contracts/subaccount.js`);
fibosClient.setcodeSync(config.contractAccount.name, 0, 0, fibosClient.compileCode(jsCode));
// getcode
const code = fibosClient.getCodeSync(config.contractAccount.name, true);
console.log('code:', code);
// setabi
const abi = JSON.parse(fs.readTextFile(`${__dirname}/contracts/subaccount.abi`));
fibosClient.setabiSync(config.contractAccount.name, abi);
转账测试
我们先来写一个剧本 account.js
来检察三个账户的余额。
const FIBOS = require('fibos.js');
const config = require('./config');
const fibosClient = FIBOS(config.callClient);
const account1 = fibosClient.getTableRowsSync(true, 'eosio.token', config.account1.name, 'accounts');
console.log(config.account1.name);
console.log(account1);
const account2 = fibosClient.getTableRowsSync(true, 'eosio.token', config.account2.name, 'accounts');
console.log(config.account2.name);
console.log(account2);
const contractAccount = fibosClient.getTableRowsSync(true, 'eosio.token', config.contractAccount.name, 'accounts');
console.log(config.contractAccount.name);
console.log(contractAccount);
实行 fibos account.js
来检察三个账户信息。 现在我们的账户还没有 FO,所以大抵状况是如许的:
- 用户账户:
helloworld11
金额:0.0000 FO
- 内容供应者账户:
helloworld22
金额:0.0000 FO
- 平台合约账户:
helloworld33
金额:0.0000 FO
测试网会自动给每一个账户发放10 EOS 的通证用以测试运用。账户中还并没有 FO 通证。所以我们再来写一个兑换剧本,用1 EOS 换一点 FO 通证。
const FIBOS = require('fibos.js');
const config = require('./config');
const fibosClient = FIBOS(config.callClient);
let ctx = fibosClient.contractSync('eosio.token');
const r = ctx.exchangeSync(
config.account1.name,
'1.0000 EOS@eosio',
'0.0000 FO@eosio',
'exchange FO to EOS',
{
authorization: config.account1.name
}
);
console.log(r)
再次实行 fibos account.js
来检察账户信息。现在我们的账户金额大抵是如许的:
- 用户账户:
helloworld11
金额:146.4245 FO
- 内容供应者账户:
helloworld22
金额:0.0000 FO
- 平台合约账户:
helloworld33
金额:0.0000 FO
下面写个剧本 transfer.js
来实行转帐操纵。
const FIBOS = require('fibos.js');
const config = require('./config');
const fibosClient = FIBOS(config.callClient);
let ctx = fibosClient.contractSync('eosio.token');
const r = ctx.extransferSync(
config.account1.name, // 用户账户
config.contractAccount.name, // 平台合约账户
'10.0000 FO@eosio', // 转帐金额
config.account2.name, // 附言填写内容供应者的账户名,平台合约会给它分账
{
authorization: config.account1.name //供应用户账户的受权
}
)
console.log(r)
我们要从用户账户 account1
给平台合约账户 account3
转帐 10 FO。memo
参数为要分红的内容供应者账户 account2
。依据合约中定的2/8分红,平台合约账户 account3
将会分得2 FO,而内容供应者账户 account2
将会取得8 FO。
运用敕令 fibos transfer.js
实行该剧本完成转帐操纵。
下面我们再来看一下现在三个账户状况。实行敕令 fibos account.js
。三个账户金额大抵以下。
- 用户账户:
helloworld11
金额:136.4245 FO
- 内容供应者账户:
helloworld22
金额:8.0000 FO
- 平台合约账户:
helloworld33
金额:2.0000 FO
效果显现,分账账户和平台合约账户如预期那样取得8 FO 和2 FO。
综上,我们胜利运用了智能合约完成了自动分账。平台方还能够继承依据本身营业须要定制本身的合约。
文中的代码请参考:https://github.com/fengluo/fi…