fibos-tokens 模块

介绍

fibos-tokens 模块，依赖于 fibos-tracker 模块，模块内默认依赖 fibos-accounts 模块。使用该模块，可以轻松搞定 FIBOS、EOS 链上的 token 合约相关记录的存储和查询。

安装

npm install fibos-tokens

使用

...
const Tracker = require("fibos-tracker");

Tracker.Config.DBconnString = "sqlite:./chain.db";

const tracker = new Tracker();
tracker.use(require("fibos-tokens"));
...

示例代码

默认表结构定义

fibos_tokens 表

| 字段 | 类型 | 说明 | | --- | --- | --- | | id | int | 自增id | | token_name | text | 通证名 FO@eosio| | token_type | text | 通证类型(tradition:传统通证，tradition:智能通证) | | token_status | text | 通证状态(on:在线，off:销毁) | | created| Date | 通证创建时间 | | createdAt | Date | 记录创建时间 | | updatedAt | Date | 记录更新时间 | | creator_id | String | 通证创建者关联账号 |

fibos_tokens_action 表

| 字段 | 类型 | 说明 | | --- | --- | --- | | id | int | 自增id | | account_from_id | String | 交易发起账户 | | account_to_id | String | 交易目标账户 | | contract_action | String | 交易名称 | | token_from_id | int | 交易发起通证关联id | | token_to_id | int | 交易目标通证关联id| | transaction_id | int | 交易关联事务id| | global_sequence | int | 交易唯一标识 | | createdAt | Date | 记录创建时间 | | updatedAt | Date | 记录更新时间 |

查询示例

示例 server

const http = require('http');
const Tracker = require("fibos-tracker");

let port = 8080;

let DBconnString = process.env.DBconnString || 'mysql://root:[email protected]/fibos_chain';
Tracker.Config.DBconnString = DBconnString;

const tracker = new Tracker();
tracker.use(require("fibos-tokens"));

var svr = new http.Server(port, [
    (req) => { req.session = {} },
    {
        "/1.0/app": tracker.app
    }]);

svr.start();

以下所有查询都通过 graphql

业务场景-:

查询账号 「fibos」 的所有操作

const http = require('http');
http.post(`http://127.0.0.1:8081/1.1`, {
	headers: {
		'Content-Type': 'application/graphql'
	},
	body: `
		{
			find_fibos_tokens_action(
				order:"-id"
				where:{
					or:[{
						account_from_id: "fibos"
					},{
						account_to_id: "fibos"
					}]
				}
			){
				account_from{
					id
				}
				account_to{
					id
				}
				action{
					rawData
					transaction{
                          block{
                              status
                    }}
				}
			}
		}`
}).json();

解释：这条查询的含义为查询和账号 「fibos」相关的所有操作。 返回结果说明：

account_from->id：操作发起人
account_to->id：操作接受人
action->rawData：链上具体数据
action->transaction->block->status：当前交易状态(noirreversible:该笔交易不会被分叉,irreversible:该笔交易可能被分叉)

业务场景二:

查询账号 「fibos」的所有转账操作

const http = require("http");
http.post(`http://127.0.0.1:8081/1.1`, {
	headers: {
		'Content-Type': 'application/graphql'
	},
	body: `
		{
			find_fibos_tokens_action(
				order:"-id"
				where:{	
					or:[{
						account_from_id: "fibos"
					},{
						account_to_id: "fibos"
					}],
					contract_action:{
						in:["eosio.token/transfer","eosio.token/extransfer"]
					}
				}
			){
				account_from{
					id
				}
				account_to{
					id
				}
				action{
					rawData
					transaction{
                          block{
                              status
                    }}
				}
			}
		}`
}).json();

解释：索引条件说明：

contract_action -> in(["eosio.token/transfer","eosio.token/extransfer"]) FIBOS 中支持转账的方法为 eosio.token/transfer 和 eosio.token/extransfer
返回结果说明：
account_from->id：操作发起人
account_to->id：操作接受人
action->rawData：链上具体数据
action->transaction->block->status：当前交易状态(noirreversible:该笔交易不会被分叉,irreversible:该笔交易可能被分叉)