账户相关操作查询插件使用教程

1. 插件概述

一个轻便operation记录查询插件，可查询所有用户的所有操作，包括虚拟操作。采用levedb数据库存储，无需启动额外进程，且witness_node程序提供API接口查询。

插件名：account_history_leveldb

数据库：leveldb

所需最低配置：

网络	内存	磁盘
主网	32G	500G
测试网	16G	200G

2. 插件的编译与启动

默认发布的release程序，并未包含该插件。如需使用该插件，请按照如下步骤编译带插件的witness_node程序，或者直接下载包含插件的release包。

2.1 编译插件

1. 下载leveldb和snappy依赖和并安装

# 安装leveldb依赖
wget https://github.com/google/leveldb/archive/v1.20.tar.gz
tar xvf v1.20.tar.gz
rm -f v1.20.tar.gz
cd leveldb-1.20
make
sudo cp -r out-static/lib* out-shared/lib* "/usr/local/lib"
cd include
sudo cp -r leveldb /usr/local/include
sudo ldconfig

# 安装snappy依赖
git clone https://github.com/google/snappy.git
cd snappy
mkdir build
cd build && cmake ../ 
sudo make install

2. 开启编译选项，支持leveldb插件

按如下方式修改gxb-core/CMakeLists.txt文件，开启编译选项

set( LOAD_ACCOUNT_HISTORY_LEVELDB_PLUGIN 1)

3. 编译带插件的witness_node程序

在Ubuntu环境下编译：Build Ubuntu (opens new window)

在MacOS环境下编译：Build OSX (opens new window)

2.2 启动插件

1. 启动带插件的witness_node程序

启动witness_node程序时，添加plugins参数，测试网节点启动参数例子如下：

nohup ./witness_node/witness_node --data-dir=testnet_node --rpc-endpoint="0.0.0.0:28090" --p2p-endpoint="0.0.0.0:6789" --seed-nodes='["testnet.gxchain.org:6789"]' --plugins "witness account_history_leveldb data_transaction " --genesis-json genesis.json --fast-replay  1>nohup.out 2>&1  &

2. 验证插件是否正常工作

查看你的data-dir目录下是否生成op_entry.db文件。

3. 插件的使用说明

get_account_relative_ops

根据账户ID返回与账户相关的指定位置和数量的operation

参数说明

请求参数	请求参数说明
API Id	0
API Name	get_account_relative_ops
API Parameters
	API参数	API参数说明
	account_id	账户ID
	start	起始位置，大与等于1
	limit	返回相关operation数量，最多100个

示例

request:

curl --data '{
    "jsonrpc": "2.0",
        "method": "call",
        "params": [0, "get_account_relative_ops", ["1.2.4629","2","2"]],
        "id": 1
}' 127.0.0.1:28090 | json_pp

response:

{
   "result" : {
      "ops" : [
         {
            "is_virtual" : true,//是否为虚拟操作
            "op_index" : "1.2.4629_2",//operation的索引
            "op" : [//operation的具体信息
               79,
               {
                  "sender_contract" : "1.2.4629",
                  "data" : "07090000000000000568656c6c6f",
                  "fee" : {
                     "amount" : 0,
                     "asset_id" : "1.3.1"
                  },
                  "contract_id" : "1.2.4628",
                  "method_name" : "inlinecall",
                  "extensions" : []
               }
            ]
         },
         {
            "op_index" : "1.2.4629_3",
            "op" : [
               75,
               {
                  "account" : "1.2.3297",
                  "method_name" : "inlinecall",
                  "extensions" : [],
                  "data" : "14120000000000000a696e6c696e65626a6e32",
                  "fee" : {
                     "asset_id" : "1.3.1",
                     "amount" : 100
                  },
                  "contract_id" : "1.2.4629"
               }
            ],
            "is_virtual" : false
         }
      ],
      "total_relative_ops_number" : 4 //与该账户相关的所有operation的个数
   },
   "id" : 1,
   "jsonrpc" : "2.0"
}