SEER区块浏览器开发指南


(アキラ) #1

SEER区块浏览器开发指南

原文在 https://github.com/akirasen/seerdocs/blob/master/zh-Hans/explorer.md https://docs.seerchain.org/#/zh-Hans/explorer 欢迎指正。

区块浏览器基本功能

区块链浏览器是浏览区块链信息的主要窗口,每一个区块所记载的内容都可以从区块链浏览器上进行查阅。用户可以使用区块链浏览器查询记录在区块中的交易信息,包括转账、预测、账户管理和社区治理操作等。

DAPP内的信息展示部分,和区块浏览器的作用相似。

SEER基于石墨烯底层开发,区块链上记录的最小信息是操作(operations)。每个区块(block)里可能有多个交易(transactions),每个交易里可能包含多个操作

区块浏览器需要预先考虑到多语言版本的需求。

时间显示:区块链时间为GMT/UTC,即英国格林尼治时间/世界标准时,考虑到SEER的用户遍及世界各地,以年月日时分秒显示时间时需考虑到用户所在时区的问题,使用N分钟前、N小时前、N天前的表达形式也是一个不错的选择。

在提法上,有的地方称1.15.N为预测市场,有的地方又称为房间,其实是一样的。同时,1.14.N有时称为预测市场设立者,有的时候又称为平台或是房主资质,二者也是一样的,可根据场景来介绍。

区块浏览器的页面

首页

1、滚动区域显示最新区块链上的操作信息:包括类型 发起ID(链接) 内容 被操作ID(链接,如果有并便于排版) 时间 交易ID(链接)
例如:

类型 说明 时间 交易链接
[派发奖励] shehuilongge2018 对 预测市场446 “刘强东在明尼苏达所涉…”派奖 10天前 160d9a381a21
[转账] okok 转账 1000SEER 给 else 11天前 70dd572e03f7

160d9a381a21为缩写,实际的交易ID是160d9a381a2152d55719b0e7e4aea4aaecce06e3,链接格式为:https://seerscan.com/tx/160d9a381a2152d55719b0e7e4aea4aaecce06e3 。之所以建议使用交易ID而不使用区块高度,是因为最新区块的信息不同于不可逆块,理论上来说在区块浏览器显示的操作信息所属区块可能在入块后会改变。而交易id是通过本地算法求得的,具有唯一性,更适合作为即时出现的链接地址。

滚动区域需显示的最新操作信息,可以首先通过info获得当前块高,再通过get_block获得当前块信息,若当前块包含交易信息,则将交易内的最新操作按一定格式显示。每3秒以后,可以用在块号上+1的方法再get_block获取下一个块的信息。

若要显示历史交易信息,则需要不断存储最新块内的信息,并保存全部或一定时间范围内的非空块信息。

2、显示区块链状态:包括最新块生产时间当前块高链号``出块时间间隔下次数据维护时间区块生产参与度,这些信息都可以通过infoget_global_properties获得;

例如:

网络状态
最新块生产时间 0秒前
当前块高 42421333
链号 cea4fdf4f5c2278f139b22e782b308928f04008b0fc2c79970a58974a2a28f91
出块时间间隔 3秒
下次数据维护时间 8小时后
区块生产参与度 100%

3、提供搜索功能:可以输入区块号帐号交易id资产名预测市场id等信息搜索相应的信息,进入相应的页面;

先检测填入的数据类型,若为纯数字,则检测相应的区块和房间是否存在,若存在则下拉提示[预测市场]321416和[区块]321416(只提示存在的);

分别通过get_blocklist_accountslist_assetsget_seer_room,以及查询本地存储交易信息中交易id获得。

若输入的是字符串,则检测相应的帐号、交易id、资产名是否存在,若存在则下拉提示[帐号]opc、[帐号]opc002和[资产]opc,或[交易id]160d9a381a2152d55719b0e7e4aea4aaecce06e3(只提示存在的)。

his
HIS(UIA) 1.3.1
IOU.HIS(UIA) 1.3.21
hiseer(账号员) 1.2.59
hise01(账号) 1.2.8872
hello-his(账号) 1.2.10231
shis1(账号) 1.2.56782
160d9a381a2152d55719b0e7e4aea4aaecce06e3(交易) 856782块高

用户点击后跳转到相应的页面。

4、链接到其他页面;

5、显示本轮活跃见证人:列表可以通过info获得,列表中的用户名(链接)点击跳转到账户相关页面;

6、显示本轮活跃理事会:列表可以通过info获得,列表中的用户名(链接)点击跳转到账户相关页面;

区块信息页面

1、显示该区块块号,时间,出块见证人。

2、该区块所包含的所有操作信息列表:包括类型 发起ID(链接) 内容 被操作ID(链接,如果有并便于排版) 时间 交易ID(链接)

3、格式化后的该区块json信息。

通过get_block获得相应信息。

链接格式为:https://seerscan.com/block/723091

账户相关页面

1、和该用户相关的操作列表(最近100个),可以通过get_relative_account_history获得:包括类型 发起ID(链接) 内容 被操作ID(链接,如果有并便于排版) 时间 交易ID(链接)

类型 说明 时间 交易链接
[派发奖励] shehuilongge2018 对 预测市场446 “刘强东在明尼苏达所涉…”派奖,else 获得10000SEER 10天前 160d9a381a21
[转账] okok 转账 1000SEER 给 else 11天前 70dd572e03f7
[参与预测] else 参与 预测市场446 “刘强东在明尼苏达所涉…”,预测选项“不起诉”,支出1000SEER 15天前 19b0e7e4aea4

例如该账号参与过的房间房主派奖时,除显示房主派奖外,还应该显示该帐号余额的变动情况。通过op.result.deltas获取;

例如该账号参与预测时,除显示参与预测,该帐号余额的变动情况
(通过op.result.deltas获取)、输入结果(通过op.op.inputN获取),同时显示房间号(通过op.op.room 获取,链接)

交易id通过get_block op.block_num 获取该转账操作所在块的信息,再通过op.trx_in_block的数值来获取到块信息中transaction_ids数组里该转账操作对应的txid,同一个txid可能对应多个操作。

2、该账户属性:包含资产余额Object_ID帐户名推荐人注册人是否终身会员权限中显示该用户的资金账户MEMO公钥,若此用户具有预测市场设立者预言机见证人理事会等角色,或是投票给某个理事会成员/设置了投票代理,也将其属性值列出。以侧边栏的形式出现
例如:

资产余额
SEER 1000000
OPC 120000
PFC 8700

通过list_account_balances获取

账户属性
帐户名 okok
Object_ID 1.2.30
是否终身会员
推荐人 seer
注册人 seer
权限
OwnerKey SEER7SQVh85z8N38jvcmYTtE7JifoRsGH5DEea6HixVdxVHTezDfHv
ActiveKey SEER7WyPH3aCQkGfWZkQnXuYPQNZ4ppC2n3tfA87hpAVtoqzXFh5gx
MemoKey SEER7WyPH3aCQkGfWZkQnXuYPQNZ4ppC2n3tfA87hpAVtoqzXFh5gx

通过get_account获取

3、预测市场设立者属性包括:Object_ID、描述、脚本、保证金、信誉度、参与量,以及当前正在进行的房间和历史房间前N位(信息格式见预测市场列表);
例如:

预测市场设立者信息
Object_ID 1.14.6
描述 请叫我社会哥
脚本 -
保证金 300000
信誉度 2
参与量 2

通过get_house_by_account获取以上信息,同时可以用roomsfinished_rooms作为get_seer_room的参数获得以下数据:

正在进行的房间

类型 设立者 市场编号 描述 总参与量 开启时间 结束时间 创建者权重 标签
[PVP] okok 446 “BTC 2018年10月21日…” 367万 SEER 5天前 5分钟后 70% 币比 币圈 经济 BTC
[高级] okok 486 “曼城 VS 恒大 胜负” 188万 OPC 3天前 3小时后 80% 章鱼宝 体育 赛事 足球 欧亚杯 2018

已结束的房间

| 类型 | 设立者 | 市场编号 | 描述 | 总参与量 | 开启时间 | 结束时间 | 创建者权重 | 标签 |
| [PVD] | okok | 526 | “刘强东在明尼苏达所涉…” | 42万 ABC | 13天前 | 2天前 | 30% | 热门 社会 大佬 |

4、预言机属性包括:Object_ID、描述、脚本、保证金、信誉度、参与量。
例如:

预言机信息
Object_ID 1.13.1
描述 最帅预言机
脚本 -
保证金 16000
信誉度 3
参与量 3

通过get_oracle_by_account获取

5、见证人属性包括:Object_ID、抵押数、待领取抵押收益、抵押清单(抵押ID+数额)、待领取出块收益、最近出块号、链接、丢块数、见证人签名公钥。

分别通过get_witnessget_vesting_balances获取,其中get_vesting_balances返回信息中,object_id为1.11.N的即出块收益,出块收益id通过get_witnesspay_vb获取。

例如:

见证人信息
Object_ID 1.5.11
抵押数 14000000
待领取抵押收益 187865
待领取出块收益 318642
最近出块号 3216572
链接 https://baidu.com
丢块数 23
见证人签名 SEER7QatX8TjD44ZHayfqBFYENUQQtvRU9b8ykgCBxBdaFRzqagKxc
抵押清单 2.16.0、2.16.1、2.16.3

6、理事会信息属性包括:Object_ID、总得票数、链接。
例如:

理事会信息
Object_ID 1.4.7
总得票数 189765425
链接 https://baidu.com

通过get_committee_member获取

链接格式为:https://seerscan.com/account/okok

热门预测市场列表页面

1、列出当前活跃的预测市场(房间)列表:[市场类型(PVD/高级/PVP)] 创建者 房间号(Object_ID,链接) 描述(链接) 总参与量 开启时间 结束时间 创建者权重 标签(链接),默认按参与量排序,用户可按一定方式排序(排序方式包括总参与量、结束时间、创建者权重);

例如:

类型 设立者 市场编号 描述 总参与量 开启时间 结束时间 创建者权重 标签
[PVP] shehuige18 446 “BTC 2018年10月21日…” 367万 SEER 5天前 5分钟后 70% 币比 币圈 经济 BTC
[高级] octopaul 486 “曼城 VS 恒大 胜负” 188万 OPC 3天前 3小时后 80% 章鱼宝 体育 赛事 足球 欧亚杯 2018
[PVD] akira 526 “刘强东在明尼苏达所涉…” 42万 ABC 13天前 20天后 30% 热门 社会 大佬

标签一栏中,根据页面显示区域显示1个至全部个数标签。

2、根据用户标签历史纪录在侧边栏生成标签云,每个标签链接到相应的预测市场标签列表页面。

3、列出活跃的预测市场设立者(按参与量排名列出前N位)。

可通过lookup_house_accounts获得房主列表,再通过get_houses获得所有活跃房间和历史房间,再通过get_seer_room获得房间详细信息。

标签云通过本地存储数据中的标签,列出使用次数最多的标签。

排名 设立者 描述 保证金 信誉度 参与量
1 okok 请叫我社会哥 300000 3 3
2 else 输钱福利社,输了又来的就是我。 500000 15 15

链接格式为:https://seerscan.com/hotmarkets

预测市场标签列表页面

1、列出当前活跃的预测市场(房间)列表:[市场类型(PVD/高级/PVP)] 创建者 房间号(Object_ID,链接) 描述(链接) 总参与量 开启时间 结束时间 创建者权重 标签(链接),默认按参与量排序,用户可按一定方式排序(排序方式包括总参与量、结束时间、创建者权重);

2、显示已结束/输入中预测市场列表,格式同上。

3、显示标签云。

通过get_rooms_by_label获取相应标签的房间id,再通过get_seer_room获取这些房间的详细信息。

标签云通过本地存储数据中的标签,列出使用次数最多的标签。

链接格式为:https://seerscan.com/label/社会

预测市场详情页面

1、显示房间属性:

通过get_seer_room获得房间详细信息,属性包括:市场Object_ID、设立者ID(链接)、标签(链接)、描述、市场类型(PVD/高级/PVP)、市场状态(进行中/未开始/已结束/结果输入)。

描述 新加坡时间2019年1月2日0时整,比特币价格高于7000美元吗?以coinmarketcap.com显示价格为准。
类型 PVD(LMSR)
Object_ID 1.15.1236
设立者 okok
标签 币比 币圈 经济 BTC 币价 USD 美元 牛市

2、显示房间设置:接受资产、单次最小参与数额、单次最大参与数额;

接受资产 SEER
单次最小参与数额 100
单次最大参与数额 10000

3、显示市场状态:开始时间、结束时间、结果输入时限、资金池(仅高级模式和PVD模式显示,PVD模式的资金池通过房主设定的L值和选项数,根据公式资金池F = L x ln(选项数量)计算出)、总参与量;

市场状态 进行中
开始时间 2018-12-22T02:36:29
结束时间 2019-01-01T16:00:00
结果输入时限 12小时
资金池 12412984 SEER
总参与量 98372123 SEER

4、显示预言机设置和门槛:市场设立者权重、预言机奖励、条件达到此门槛的预言机才能参与结果输入:(名誉、保证金、参与量)

市场设立者权重 30%
每个预言机奖励 100 SEER
- -
条件达到此门槛的预言机才能参与结果输入
名誉 3
保证金 10000 SEER
参与量 3

5、房间选项:包括选项描述、参与人数和参与数量(资产或份数),非LMSR显示奖金倍数。

选项 内容 参数人数 参数量 该选项发生概率
0 归零 0次 0份 0%
1 小于7000美元 8723次 1234140份 28.21%
2 等于7000美元 1次 100000份 0.1%
3 大于7000美元 7131次 3453253份 71.78%

6、最新参与滚动信息:

类型 说明 时间 交易链接
[派发奖励] okok 对 预测市场1236 派奖 2天前 ZHayfqBF8QtvR
[输入结果] okok 对 预测市场1236 输入结果:选项1“小于7000美元” 2天前 fqBFYENUx9a3
[输入结果] else 对 预测市场1236 输入结果:选项1“小于7000美元” 2天前 d55719b0e7e4
[市场结算] okok 对 预测市场1236 结算 3天前 d9a381a2152d
[停止参与] okok 停止 预测市场1236 3天前 4aecceds06e3
[参与预测] shehuilongge2018 参与 预测市场1236 ,预测选项1“小于7000美元” 4天前 a381a021520d
[参与预测] else 参与 预测市场1236 ,预测选项1“小于7000美元” 5天前 160d9a381a21

滚动信息包含房间参与数据,get_seer_room的参数包括房间object_id参与记录的开始索引start参与记录返回的最大数量limit。例如get_seer_room 1.15.236 0 100即表示返回236房间的前100个参与记录。若要显示更多记录,需要修改start,在当前start的基础上增加limit,例如若一个房间共200条记录,要全部显示需要get_seer_room 1.15.236 0 100,再get_seer_room 1.15.236 100 100

7、参与预测图表:参数包括时间、参与人次、参与数额、预测选项、选项赔率(PVD为单份成本);

链接格式为:https://seerscan.com/pm/3427 (PM = prediction market)

交易详细信息页面

1、显示该交易时间、所属区块。

2、显示该交易id下所有操作列表;

类型 说明
[转账] okok 转账 1000ABC 给 else
[转账] okok 转账 1000ABC 给 alice
[转账] okok 转账 1000ABC 给 bob

3、显示格式化后的该交易json信息。

通过交易id和本地存储数据中的交易id匹配,显示该交易id对应的交易信息。

交易id有多重获取方式:

A 通过get_block获取区块信息中该交易所在transactions中的顺序位置,对应该区块信息中"transaction_ids"字符串中该交易对应的transaction_id

B 用户在转账操作时可以用transfer2替代transfer,这样在交易广播后,会在返回信息中直接给出该交易对应的transaction_id

C 用户可以使用get_transaction_id在参数中传入该交易的json格式内容,即可生成对应的transaction_id

D 用户在使用RPC方式调用get_relative_account_history时,返回信息中op.block_num即该操作的入块高度,op.trx_in_block 该操作所属交易的transaction_id在该区块transaction_ids字符串中的位置。

链接格式为:https://seerscan.com/tx/160d9a381a2152d55719b0e7e4aea4aaecce06e3

资产介绍页面

1、该资产持有人列表(链接),持有占比;
2、持有分布统计饼图;
3、该资产的属性:资产代号、资产类型(CORE/UIA)、当前供应量、发行人(链接)、Object_ID、小数位数、最大供应量等(侧边栏)。
4、SEER的资产介绍页面可以作为SEER持仓分布页面在首页提供链接;

排名 账户 数额
1 init0 8000000000.00000
2 okok 100000000.00000
3 else 300000.00000
4 alice 5400000.00000

属性:

资产代号 ABC
Object_ID 1.3.10
资产类型 UIA
当前供应量 8046234175
最大供应量 10000000000
发行人 okok
小数位数 5

| 手续费汇率 | 0.56 SEER/ABC |
| 资金池余额 | 88838 |
| 发行人未申领收入 | 171419 |

该资产持有人列表可使用余额快照功能,每隔一段时间对指定资产的所有用户持仓进行快照,获取持有人列表数据。
资产属性可通过get_asset获得。

链接格式为:https://seerscan.com/assets/SEER

预测市场排行榜页面

1、显示预测市场设立者排行榜;

排名 账户名 声誉 保证金 参与量 未领手续费分成奖励 链接
1 okok 135 1000000 135 345156 http://baidu.com
2 alice 98 700000 98 142343 http://google.com
3 bob 76 600000 76 267780 http://facebook.com

默认通过声誉排序,通过lookup_house_accounts获得所有平台id,get_houses可获得平台的详细信息列表。

2、显示预言机排行榜。

排名 账户名 声誉 保证金 参与量 链接
1 else 95 100000 95 http://baidu.com
2 tomato 65 80000 65 http://google.com
3 tom 62 50000 62 http://facebook.com

默认通过声誉排序,通过lookup_oracle_accounts获得所有预言机id,get_oracles可获得预言机的详细信息列表。

链接格式为:https://seerscan.com/ranking

见证人信息页面

1、显示本轮活跃见证人列表:包括排名、账户名、上一个区块、上次生成块、缺失块数、抵押金、利息收入;

排名 账户名 上一个区块 上次生成块 缺失块数 抵押金 利息收入
1 okok 1分钟前 456123 2 1205616145 1353345
2 else 1分钟前 456121 1 21456283 64562
3 alice 20秒前 456126 1 5981236 345343
4 bob 现在 456129 0 8123012 4081236

通过list_witnesses获得所有见证人id,get_witness可获得每个见证人的详细信息。

按抵押金额排名前101位的为获息见证人,通过get_global_properties.result.active_collateral_witnesses可以获得获息见证人列表。

通过info获得本轮出块的21位活跃见证人和参与率等信息,每块奖励通过get_global_properties获得,本期剩余见证人奖励通过get_dynamic_global_properties中的witness_budget本期见证人预算总额 - 本期已出块数 * 每块奖励得出。

2、区块生产状态:包括当前见证人、活跃见证人、参与率、每块奖励、剩余预算、计票更新时间(侧边栏显示);

当前见证人 bob
活跃见证人 21
参与率 100%
每块奖励 3SEER
本期剩余预算 23127SEER
计票更新时间 8小时后

3、可切换主力见证人、主力及候选见证人(获息见证人)、所有见证人(所有注册见证人资格的用户,包括未入选获息见证人的用户)。

理事会信息页面

1、显示排名、账户名、得票数、竞选网页。

2、可以切换活跃理事会成员和所有(含竞选中)理事会成员页面

排名 账户名 得票数 竞选网页
1 okok 65115531 http://baidu.com
2 else 54234798 http://baidu.com
3 alice 68633872 http://baidu.com

所有理事会成员列表通过list_committee_members获得,活跃理事会成员列表通过get_global_properties.result.active_committee_members 或 info 获得,详细信息通过get_committee_member获得。


(アキラ) #2

调用区块链上的信息

以下指南以Ubuntu 16.04.4 x64 系统为例。

配置一个SEER全节点

1、在服务器新建一个名叫seer的窗口;

screen -S seer

2、在root目录下新建一个名叫seer的目录,下载v0.0.5版本的程序包到此目录,并更名为seer.tar.gz。(请到SEER软件发布页https://github.com/seer-project/seer-core-package/releases 复制最新的ubuntu版本程序包链接替换掉此下载链接。)

mkdir seer
curl -Lo seer/seer.tar.gz https://github.com/seer-project/seer-core-package/releases/download/v0.05/seer-ubuntu-0.0.5.tar.gz 

3、进入seer目录,解压此软件包。

cd seer
tar xzvf seer.tar.gz

4、带websocket参数启动witness_node:

witness_node --rpc-endpoint=127.0.0.1:9090 max-ops-per-account=1000 

其中的--rpc-endpoint参数为节点监听的websocket RPC IP地址和端口号,需要您替换,此处127.0.0.1为本机,9090是为节点指定的WS端口。

--max-ops-per-account参数设定内存中保留账户的多少条操作记录,此处1000表示保留追踪账户的1000条操作记录,需要您按需求填写。

5、观察节点运行正常后,ctrl+A d隐藏screen,断开服务器。之后要再打开运行有节点的Sreeen,则使用 screen -R ,或 screen -r seer

节点正常启动后,会显示像下面一样的3秒一个的出块信息。

节点正常启动的状态

如果要关闭节点,则使用control + C

配置一个SEER命令行钱包

1、在服务器新建一个名叫cli的窗口,运行seer目录中的命令行钱包程序;

screen -S cli
cd~
seer/cli_wallet -s ws://127.0.0.1:9090 -r 127.0.0.1:9191 -H 127.0.0.1:9192

-s参数可以设置要连接的节点api地址及端口,此处ws://127.0.0.1:9090为上一步中运行的本地节点的websocket RPC地址和端口,您也可以在此处使用局域网或公网中的其他公共api地址,不过有因外部api无法提供服务而导致命令行钱包异常退出的风险;

-r参数可以设置命令行钱包要监听的websocket RPC地址和端口,此处设为127.0.0.1:9191,负责充提业务的程序可以使用此端口调用命令行钱包进行操作;

-H参数可以设置命令行钱包要监听的Http-RPC地址和端口,此处设为127.0.0.1:9192,负责充提业务的程序也可以使用此端口调用命令行钱包进行操作。

2、钱包启动成功后,会显示:

Please use the set_password method to initialize a new wallet before continuing
3564395ms th_a       main.cpp:227                  main                 ] Listening for incoming RPC requests on 127.0.0.1:9191
3564396ms th_a       main.cpp:252                  main                 ] Listening for incoming HTTP RPC requests on 127.0.0.1:9192
new >>> 

接入命令行钱包

可以使用Http-RPC或websocket RPC方式接入命令行钱包。使用JSON-RPC远程调用协议传入相应的指令,即可让命令行钱包进行相关操作或返回需要的信息。

格式如下(实际使用时不换行无注释):

{ 
    "jsonrpc" : 2.0,//定义JSON-RPC版本
    "method" : "get_block",//调用的方法名,例如转账 transfer ,列出账户余额 list_account_balances 等,此处get_block为返回指令块号的区块信息
    "params" : [1], //方法传入的参数,若无参数则为null,此处1表示块号
    "id" : 1//调用标识符
} 

Http-RPC接入示例

可以使用curl命令来测试Http-RPC连接命令行钱包实现获取指定账户的各资产余额:

 curl http://127.0.0.1:9192 -d '{"jsonrpc": "2.0", "method": "list_account_balances", "params": ["seerdex-withdraw"], "id": 1}'

 {"id":1,"result":[{"amount":"7861151753754","asset_id":"1.3.0"},{"amount":97099800,"asset_id":"1.3.8"}]}

websocket RPC接入示例

首先在服务器上安装使用wscat测试ws:

 apt install node-ws

测试通过websocket RPC连接命令行钱包实现获取指定账户的各资产余额:

wscat -c ws://127.0.0.1:9191
> {"jsonrpc": "2.0", "method": "list_account_balances", "params": ["seerdex-withdraw"], "id": 1}
< {"id":1,"result":[{"amount":"7861151753754","asset_id":"1.3.0"},{"amount":97099800,"asset_id":"1.3.8"}]}                                      

常用指令

按上一部分的首次出现顺序排列:

get_block

格式: get_block num

参数: 块号

作用: 显示第num个块的概况

示例: {"jsonrpc": "2.0", "method": "get_block", "params": [2090482], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": {
		"previous": "003b1b3f312331a5caca5d84251561532d1a37bf",//上一个块的块号
		"timestamp": "2018-10-20T10:22:51",//时间戳
		"witness": "1.5.3",//见证人
		"transaction_merkle_root": "10d083ae2e6fee5822094d7d4622e4b616989e66",
		"extensions": [],
		"witness_signature": "203......f1",//见证人签名
		"transactions": [//交易列表
			"ref_block_num": 6974,//引用的区块号
			"ref_block_prefix": 478549604,//引用的区块头
			"expiration": "2018-10-20T10:24:47",//交易过期时间
			"operations": [//操作列表
				[0, {
					"fee": {//手续费
						"amount": 2105468,
						"asset_id": "1.3.0"
					},
					"from": "1.2.105",//发起用户ID
					"to": "1.2.109",//接收用户ID
					"amount": {
						"amount": 10000000,//金额
						"asset_id": "1.3.0"//资产类型 
					},
					"memo": {
						"from": "SEER8UAbnsAnXY1qr3CD6uzKaRuewsyPF9ynYJJGrdvSfDANxsGNxH",
						"to": "SEER6sJwPuSSayEzHXLbVgw9HJsDnGBk5Dup5bq3ns1YziZEDMKMgU",
						"nonce": "394247926841715",
						"message": "129a23c2e02759b952322eb2f3ab71f91a5943a0d200daa9aa39561a66fda3f3"
					},
					"extensions": []
				}]
			],
			"extensions": [],
			"signatures": ["2054eb......e7c7"],//交易签名集合
			"operation_results": [
				[0, {}]
			]
		}],
		"block_id": "003b1b40e745144407b6a59ec18388dfc29a4866",//块id
		"signing_key": "SEER4xBLWwa8Q42ZRnY2sFz5rywr16TG6WgbNSPDR5DodvNEQyVgnQ",//见证人签名公钥
		"transaction_ids": ["e7ac878e5771a8c5f7e20699639cad7084067960"],//交易id集
		"txs_count": 1
	}
}

info

作用:显示当前Seer区块链的状态

示例:{"jsonrpc": "2.0", "method": "info", "params": [], "id": 1}

返回信息示例:

 {"id":1,
 	"result":
 	{
 		"head_block_num":3678258,//当前块高
 		"head_block_id":"00382032d0bfee243b0c5f6b37e3fd6f29682e6e",//当前块号
 		"head_block_age":"0 second old",//上一个区块生成时间
 		"next_maintenance_time":"7 hours in the future",//维护更新时间
 		"chain_id":"da68a9c5f2fd9ed48e626ea301db1c77505523884ba0dd409e779246c6ea26cf",//链号
 		"participation":"88.28125000000000000",//区块生产参与率
 		"active_witnesses"://活跃见证人ID
 		["1.5.1","1.5.2","1.5.3","1.5.4","1.5.5","1.5.6","1.5.7","1.5.8"],
 		"active_committee_members"://活跃理事会成员ID
 		["1.4.0","1.4.1","1.4.2","1.4.3","1.4.4","1.4.5","1.4.6","1.4.7"]
 	}
 }

get_global_properties

作用:列出链的当前全局参数

示例:{"jsonrpc": "2.0", "method": "get_global_properties", "params": [], "id": 1}

提示:`"fee"`、`"price_per_kbyte"`等费率相关参数值的单位均为 `1/100000` ,代表着SEER支持的最大小数点后数据精度。

返回信息示例:

{
	"id": 1,
	"result": {
		"id": "2.0.0",
		"parameters": {
			"current_fees": {
				"parameters": [
					/*...费率表介绍可以在命令行指南中查看...*/]
			},
			"block_interval": 3,//块间隔时间,3秒
			"maintenance_interval": 86400,//维护更新时间 86400秒,一天
			"maintenance_skip_slots": 3,//维护时跳过的块间隔数
			"committee_proposal_review_period": 1209600,//理事会提案审查期 1209600秒 14天
			"maximum_transaction_size": 2048,//最大交易大小 2048K 即2M
			"maximum_block_size": 2000000,//最大单个块数据大小 2000000K 即约1.9G
			"maximum_time_until_expiration": 86400,//在到期之前,交易有效的最长生命周期(以秒为单位)
			"maximum_proposal_lifetime": 2419200,//在到期之前,提议的交易的最长生命周期(以秒为单位)
			"maximum_asset_whitelist_authorities": 50,//资产可列为白名单或黑名单权限的最大帐户数
			"maximum_authenticator_count": 101,//最多认证者的数量
			"maximum_committee_count": 1001,//参与理事会最大人数
			"maximum_authority_membership": 10,//权限(多签)可以设置的最大数量的密钥/帐户
			"network_percent_of_fee": 6000,//支付给网络的手续费比例 此处为60%
			"lifetime_referrer_percent_of_fee": 0,//终身会员推荐人手续费分成比例
			"cashback_vesting_period_seconds": 31536000,//待解冻余额解冻周期,31536000秒,一年
			"cashback_vesting_threshold": 10000000,//待解冻余额领取门槛,100SEER
			"count_non_member_votes": true,//非会员账户是否投票
			"allow_non_member_whitelists": false,//非会员帐户能否设置白名单和黑名单
			"witness_pay_per_block": 300000,//主力见证人出块的每个块奖励,3 SEER
			"max_predicate_opcode": 1,
			"fee_liquidation_threshold": 10000000,
			"accounts_per_fee_scale": 1000,
			"account_fee_scale_bitshifts": 4,
			"max_authority_depth": 2,//权限(多签)可以设置的最大深度(级别)
			"min_guaranty_per_room": "10000000000",//每个房间最少抵押金:10万SEER
			"max_oracle_reward": 100000000,//每个预言机最高奖励:1000SEER
			"fixed_witness_count": 21,//主力见证人数量
			"maximum_profit_witness_count": 101,//获息见证人总数
			"maximun_seer_settles_per_block": 1000,
			"supported_authenticate_types": 7,
			"extensions": []
		},
		"next_available_vote_id": 9,
		"active_committee_members": ["1.4.0", "1.4.1", "1.4.2", "1.4.3", "1.4.4", "1.4.5", "1.4.6", "1.4.7", "1.4.8"],//活跃理事会成员
		"active_witnesses": ["1.5.1", "1.5.2", "1.5.3", "1.5.4", "1.5.5", "1.5.6", "1.5.7", "1.5.8", "1.5.9"],//活跃(主力)见证人
		"active_collateral_witnesses": ["1.5.1", "1.5.2", "1.5.3", "1.5.4", "1.5.5", "1.5.6", "1.5.7", "1.5.8", "1.5.9"],//活跃获息见证人(主力+候选)
		"active_supervisors": [],
		"active_authenticators": [],
		"seer_exploded": false
	}
}

list_accounts

格式:list_accounts lowerbound limit

参数:lowerbound:账户名下标, limit:返回结果的数量上限

作用:列出账号名大于lowerbound的账户

示例1:{"jsonrpc": "2.0", "method": "list_accounts", "params": ["",10], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": [
		["abc111", "1.2.115"],
		["abccba", "1.2.108"],
		["abcde-12345", "1.2.20"],
		["abcde-123455", "1.2.23"],
		["acc-3", "1.2.101"],
		["akira123", "1.2.133"],
		["akira6", "1.2.131"],
		["alice", "1.2.109"],
		["asd123", "1.2.149"],
		["asdddd22", "1.2.27"]
	]
}

此例未指定账号名,所以从a开始,若设置账号名大于seer,则会列出从seer开始的seer01、seer03等账户。

示例2:{"jsonrpc": "2.0", "method": "list_accounts", "params": ["seer",9], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": [
		["seer", "1.2.13"],
		["seer-123", "1.2.137"],
		["seer-bind-1", "1.2.55"],
		["seer-faucet", "1.2.15"],
		["seer-go", "1.2.42"],
		["seer-king", "1.2.46"],
		["seer-opc", "1.2.75"],
		["seer123", "1.2.117"],
		["seeropc123", "1.2.74"]
	]
}

list_assets

格式:list_assets lowerbound limit

参数:lowerbound资产名下标, limit 返回结果的数量上限

作用:列出资产名大于lowerbound的资产

示例:{"jsonrpc": "2.0", "method": "list_assets", "params": ["SEE",2], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": [{
		"id": "1.3.11",//SEER的资产ID
		"symbol": "SEED",//SEER的资产ID
		"precision": 5,//小数点后精度
		"issuer": "1.2.151",//创建者
		"options": {
			"max_supply": "10000000000",//最大供给量
			"market_fee_percent": 0,//交易手续费收取比例
			"max_market_fee": 0,//最大市场手续费
			"issuer_permissions": 31,
			"flags": 0,
			"core_exchange_rate": {//发生手续费会按以下比例 从费用池自动将此资产换为核心资产(SEER)用于支付费用
				"base": {
					"amount": 100000,//对标市场基准资产的比例
					"asset_id": "1.3.0"
				},
				"quote": {
					"amount": 100000,
					"asset_id": "1.3.11"
				}
			},
			"whitelist_authorities": [],//一组帐户,此资产的白名单。如果白名单非空,则只允许白名单中的帐户保留、使用或转移资产。
			"blacklist_authorities": [],//一组帐户,此资产的黑名单。如果设置了白名单,则只有这些帐户能进行此资产的发送、接收、交易等,但如果该帐户被列入黑名单,即使该帐户也列入白名单,它也不能操作此资产。
			"whitelist_markets": ["1.3.0"],//定义此资产可在市场上组成交易对的资产
			"blacklist_markets": [],//定义此资产在市场上不可进行交易的资产,不得与白名单重叠
			"description": "{\"main\":\"\",\"market\":\"\"}",//资产描述
			"extensions": []
		},
		"dynamic_asset_data_id": "2.3.11"
	}, {
		"id": "1.3.0",
		"symbol": "SEER",
		"precision": 5,
		"issuer": "1.2.3",
		"options": {
			"max_supply": "1000000000000000",
			"market_fee_percent": 0,
			"max_market_fee": "1000000000000000",
			"issuer_permissions": 0,
			"flags": 0,
			"core_exchange_rate": {
				"base": {
					"amount": 1,
					"asset_id": "1.3.0"
				},
				"quote": {
					"amount": 1,
					"asset_id": "1.3.0"
				}
			},
			"whitelist_authorities": [],
			"blacklist_authorities": [],
			"whitelist_markets": [],
			"blacklist_markets": [],
			"description": "",
			"extensions": []
		},
		"dynamic_asset_data_id": "2.3.0"
	}]
}

get_seer_room

格式:get_seer_room room_id start limit

参数:room_id为房间id,start 为投注记录的开始索引,limit为返回结果中投注记录的最大数量

作用:根据房间id查询房间详情(不是完整的房间,因投注太多的情况下房间空间会非常大)

示例:{"jsonrpc": "2.0", "method": "get_seer_room", "params": ["1.15.21",0,2], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": {
		"id": "1.15.21",//预测市场房间id
		"house_id": "1.14.9",//创建者身份(平台)id
		"owner": "1.2.105",//创建者账号id
		"label": [
			"BTC", 
			"币圈",
			"比特币",
			"行情"
		],//标签
		"description": "比特币2018-10-30中午能高于6810美元吗?(以新加坡时间2018-10-30中午12点整feixiaohao.com的价格为准)",//描述
		"script": "",//网址
		"room_type": 0,//房间类型 0为LMSR
		"status": "opening",//状态
		"option": {
			"result_owner_percent": 9000,//创建者输入权重
			"reward_per_oracle": 1000000,//每个预言机奖励
			"accept_asset": "1.3.0",//接受资产类型
			"minimum": 100000,//最小参与数量
			"maximum": "10000000000",//最大参与数量
			"start": "2018-07-01T13:22:45",//开始时间
			"stop": "2018-07-01T13:33:45",//结束时间
			"input_duration_secs": 360,//结果输入时间(秒)
			"filter": {//预言机门槛
				"reputation": 0,//声誉
				"guaranty": 0,//保证金
				"volume": 0//参与量
			},
			"allowed_oracles": [],
			"allowed_countries": [],
			"allowed_authentications": []
		},
		"running_option": {
			"room_type": 0,//房间类型
			"selection_description": [
				"高于6810美元",//选项0
				"不高于6810美元"//选项1
			],
			"range": 2,
			"lmsr": {
				"L": "100000000000"//L值
			},
			"participators": [//参与记录
				[{
					"player": "1.2.106",//参与者id
					"when": "2018-07-01T13:56:42",//参与时间
					"amount": "100000000000",//参与数量
					"paid": "62011450696",//参与金额
					"sequence": 0
				}, {
					"player": "1.2.106",
					"when": "2018-07-01T13:56:48",
					"amount": "100000000000",
					"paid": "81366632353",
					"sequence": 1
				}],
				[]
			],
			"total_shares": "69314718055",//总参与量
			"settled_balance": 0,
			"settled_row": -1,
			"settled_column": -1,
			"player_count": [13, 4],//各选项参与人数
			"total_player_count": 17,//总参与人数
			"lmsr_running": {
				"items": ["120000000000", "110000000000"],//各选项参与份数
				"accelerator": []
			},
			"guaranty_alone": 0
		},
		"owner_result": [],
		"final_result": [],
		"committee_result": [],
		"oracle_sets": [],
		"final_finished": false,
		"settle_finished": false,
		"last_deal_time": "1970-01-01T00:00:00"
	}
}

get_relative_account_history

格式:get_relative_account_history name start limit end

参数:name可以是账户名或id,start为返回结果的最小编号,limit 为返回结果的数量上限,end为返回结果的最大编号;

返回数据排序方式为按时间顺序,越新的越靠前;

编号从1开始,若end = 0,则返回最新的limit条操作信息;

若end - start > limit,则返回满足条件的最新的limit条操作信息。

作用:列出账户name的操作历史记录

请避免一次性返回超过100条数据,以免节点或钱包报错。同时,在命令行钱包中使用此命令时只会返回 "description"中的数据,用RPC调用方能返回完整数据。

示例:{"jsonrpc": "2.0", "method": "get_relative_account_history", "params": ["seerdex-withdraw",15,1,30], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": [
		{
		"memo": "give you 980 SEER",//解锁并有相应私钥的钱包方能显示MEMO
		"description": "Transfer 980 SEER from alice to okok -- Memo: give	ou 980 SEER   (Fee: 21.05468 SEER)",//钱包一般只显示此内容
		"op": {
			"id": "1.9.703568",//该操作的对象id,可通过get_object	.9.703568查看此操作
			"op": [
				0, //操作类型,0表示转账
				{
				"fee": {//手续费
					"amount": 2105468,//数额
					"asset_id": "1.3.0"//资产类型
				},
				"from": "1.2.109",//转出id
				"to": "1.2.105",//接收id
				"amount": {
					"amount": 98000000,//转账数额
					"asset_id": "1.3.0"//资产类型
				},
				"memo": {//MEMO权限相关
					"from": "SEER6sJwPuSSayEzHXLbVgw9HJsDnGBk5Dup5bq3ns1Yzi	DMKMgU",
					"to": "SEER8UAbnsAnXY1qr3CD6uzKaRuewsyPF9ynYJJGrdvSfDAN	GNxH",
					"nonce": "394073041834538",
					"message": "485e630438b9a38c94c12afd9b15007845484d7f0c8	c29c135f4f9a155a1ee"
				},
				"extensions": []
			}],
			"result": [//操作返回结果
				0, 
				{				}
			],
			"block_num": 3674099,//入块高度
			"trx_in_block": 0,//操作所属交易在区块内的位置
			"op_in_trx": 0,//操作在交易内的位置
			"virtual_op": 52924//虚拟操作编号
		}
	}]
}

get_relative_account_history会列出和此账户有关的所有操作,例如自己转账给别人(包括提现)、别人转账给自己(包括充值)、账号注册、参与预测等。

list_account_balances

格式:list_account_balances name

参数:name可以是账户名,也可以是账户的id

作用:列出账号为id的账户的各资产余额

示例:{"jsonrpc": "2.0", "method": "list_account_balances", "params": ["abc"], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": [{
		"amount": "7861177753754", //余额,精度5,amount没有小数点,其数值被乘以了10000 此处即78611777.53754
		"asset_id": "1.3.0" //资产类型 此处为SEER
	}, {
		"amount": 97099800, //余额,精度5,amount没有小数点,其数值被乘以了10000 
		"asset_id": "1.3.8" //资产类型 此处为测试链上的ABC资产
	}]
}

get_account

格式:get_account account_name_or_id

参数:account_name_or_id是账户名或id

作用:列出账户account_name_or_id的详细情况

示例:{"jsonrpc": "2.0", "method": "get_account", "params": ["bob"], "id": 1}

{"jsonrpc": "2.0", "method": "get_account", "params": ["1.2.151"], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": {
		"id": "1.2.151",//此帐户id
		"membership_expiration_date": "1969-12-31T23:59:59",//此帐户的会员资格到期的时间。
		"registrar": "1.2.151",//注册人
		"referrer": "1.2.151",//推荐人
		"lifetime_referrer": "1.2.151",//终身会员推荐人
		"network_fee_percentage": 6000,//手续费分配给网络的百分比
		"lifetime_referrer_fee_percentage": 4000,//手续费分配给终身会员推荐人的百分比
		"referrer_rewards_percentage": 0,//推荐人获得的比例
		"name": "bob",//名称
		"owner": {//账户权限 多签管理
			"weight_threshold": 1,//阈值
			"account_auths": [],
			"key_auths": [
				["SEER4v4wcrtnCCoo5S2THnLnLLKZDZ8ovRC5V2TnHKbHhjrh8oyz6L", 1]//账户权限公钥 权重
			],
			"address_auths": []
		},
		"active": {//资金权限 多签管理
			"weight_threshold": 1,//阈值
			"account_auths": [],
			"key_auths": [
				["SEER7js4ot7oPXrNEZaejvyagNG4mJtCtUxhX8t3Qi7H6ABjcBXqx3", 1]//资金权限公钥 权重
			],
			"address_auths": []
		},
		"options": {
			"memo_key": "SEER7js4ot7oPXrNEZaejvyagNG4mJtCtUxhX8t3Qi7H6ABjcBXqx3",//MEMO(备注)权限公钥
			"voting_account": "1.2.5",
			"num_committee": 0,
			"num_authenticator": 0,
			"num_supervisor": 0,
			"votes": [],
			"extensions": []
		},
		"statistics": "2.5.151",
		"whitelisting_accounts": [],
		"blacklisting_accounts": [],
		"whitelisted_accounts": [],
		"blacklisted_accounts": [],
		"owner_special_authority": [0, {}],
		"active_special_authority": [0, {}],
		"top_n_control_flags": 0,
		"country": 0,
		"status": 0,
		"authentications": []
	}
}

get_house_by_account

格式:get_house_by_account account

参数:account为账户id

作用:根据对方账户id查询平台

示例:{"jsonrpc": "2.0", "method": "get_house_by_account", "params": ["1.2.77"], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": {
		"id": "1.14.6",//平台id
		"owner": "1.2.77",//拥有者账户id
		"description": "最帅平台",//平台描述
		"script": "https://baidu.com",//平台链接
		"reputation": 2,//名誉
		"guaranty": "10000000000",//保证金
		"volume": 2,//参与量
		"collected_fees": 1000000,//待领取手续费分成
		"rooms": ["1.15.15"],//正在进行的房间
		"finished_rooms": ["1.15.12", "1.15.13"]//已结束房间
	}
}

get_oracle_by_account

格式:get_oracle_by_account account

参数:account为账户id

作用:根据对方账户id查询预言机

示例:{"jsonrpc": "2.0", "method": "get_oracle_by_account", "params": ["1.2.63"], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": {
		"id": "1.13.0",//预言机id
		"owner": "1.2.63",//拥有者账户id
		"guaranty": "200001000000",//保证金
		"locked_guaranty": 0,//锁定中保证金
		"reputation": 1,//名誉
		"volume": 1,//参与量
		"description": "超机预言机",//预言机描述
		"script": "https://baidu.com"//预言机介绍链接
	}
}

get_witness

格式:get_witness owner_account

参数:owner_account为账户名或者id

作用:列出账户为owner_account的见证人

示例:
示例:{"jsonrpc": "2.0", "method": "get_witness", "params": ["bob"], "id": 1}
{"jsonrpc": "2.0", "method": "get_witness", "params": ["1.2.151"], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": {
		"id": "1.5.9",//见证人id
		"witness_account": "1.2.151",//拥有者账户id
		"last_aslot": 4662280,
		"signing_key": "SEER7GQxZj2DecxkN3jMfJaHap3U5yYzW21AQ94StwG5rmMsdnGs97",//见证人签名公钥
		"pay_vb": "1.11.60",//出块收益id
		"collaterals": ["2.16.1"],//抵押项列表
		"collateral_profit": 189632156,//待领取抵押收益
		"total_collateral": 5234000000000,//总抵押金额
		"cancelling_collateral": 1000000000,//解锁中抵押项
		"url": "",//见证人链接
		"total_missed": 1049,//总丢块数
		"last_confirmed_block_num": 4660381,//最后确认出块
		"recent_maintenance_missed_blocks": [1049, 0]//本维护期内丢的块数
	}
}

get_vesting_balances

格式:get_vesting_balances account_name

参数:account_name为账户名或id

作用:列出用户的锁定余额详情

示例:{"jsonrpc": "2.0", "method": "get_vesting_balances", "params": ["bob"], "id": 1}{"jsonrpc": "2.0", "method": "get_vesting_balances", "params": ["1.2.151"], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": [{
		"id": "1.11.30",//待解冻余额id
		"owner": "1.2.151",//所有人id
		"balance": {
			"amount": 77850000000,//待解冻余额金额
			"asset_id": "1.3.0"//资产代号
		},
		"policy": [1, {
			"vesting_seconds": 31536000,//解锁总时长 约365天,此项为终身会员返利
			"start_claim": "1970-01-01T00:00:00",//
			"coin_seconds_earned": "7466889574164855",
			"coin_seconds_earned_last_update": "2018-10-18T00:00:00"
		}],
		"allowed_withdraw": {
			"amount": 189847249,//可领取数量
			"asset_id": "1.3.0"
		},
		"allowed_withdraw_time": "2018-10-27T08:36:15"
	}, {
		"id": "1.11.60",//待解冻余额id
		"owner": "1.2.151",//所有人id
		"balance": {
			"amount": 7022400000,//待解冻余额金额
			"asset_id": "1.3.0"//资产代号
		},
		"policy": [1, {
			"vesting_seconds": 86400,//解锁总时长 约1天,此项为出块收益
			"start_claim": "1970-01-01T00:00:00",
			"coin_seconds_earned": "697509440000000",
			"coin_seconds_earned_last_update": "2018-10-27T08:36:00"
		}],
		"allowed_withdraw": {
			"amount": 6987100000,//可领取数量
			"asset_id": "1.3.0"
		},
		"allowed_withdraw_time": "2018-10-27T08:36:15"
	}]
}

get_committee_member

格式:get_committee_member(string owner_account);

参数:owner_account为账户名或者id

作用:列出账户为owner_account的理事会成员

示例:{"jsonrpc": "2.0", "method": "get_committee_member", "params": ["bob"], "id": 1}{"jsonrpc": "2.0", "method": "get_committee_member", "params": ["1.2.151"], "id": 1}
返回信息示例:

{
	"id": 1,
	"result": {
		"id": "1.4.8",//理事id
		"committee_member_account": "1.2.151",//拥有者账户id
		"vote_id": "0:8",//投票id
		"total_votes": 13293995215,//得票数
		"url": "https://baidu.com"//竞选链接
	}
}

lookup_house_accounts

格式:lookup_house_accounts lower_bound_name limit

参数:lowerbound为账户名的下标,limit为返回结果的数量上限

作用:列出SEER平台列表

示例:{"jsonrpc": "2.0", "method": "lookup_house_accounts", "params": ["", 100], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": [
		["alice", "1.14.14"],//平台拥有者账号名和平台id
		["asd123", "1.14.15"],
		["cn-itata", "1.14.3"],
		["da-keai", "1.14.11"],
		["danilo3", "1.14.2"],
		["das", "1.14.16"],
		["else", "1.14.10"],
		["null-account", "1.14.4294967295"],
		["okok", "1.14.9"],
		["q123456789", "1.14.1"],
		["qwe111", "1.14.12"],
		["seer", "1.14.0"],
		["seer-go", "1.14.7"],
		["seer-king", "1.14.8"],
		["seer123", "1.14.13"],
		["tnt123456", "1.14.5"],
		["tnt23456", "1.14.6"],
		["xianzhixianjue", "1.14.4"]
	]
}

get_houses

格式:get_houses house_ids

参数:house_ids为平台的id集

作用:根据给定的id集列出平台列表

示例:{"jsonrpc": "2.0", "method": "get_houses", "params": [1.14.3,1.14.2,1.14.6], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": [{
		"id": "1.14.3",//平台id
		"owner": "1.2.30",//平台拥有者账号名
		"description": "test",//平台描述
		"script": "",//平台链接
		"reputation": 0,//声望值
		"guaranty": "300000000000",//保证金
		"volume": 0,//参与次数
		"rooms": ["1.15.11"],//进行中的房间
		"finished_rooms": []//已完成的房间
	}, {
		"id": "1.14.2",
		"owner": "1.2.29",
		"description": "test",
		"script": "1",
		"reputation": 0,
		"guaranty": "10000000000",
		"volume": 0,
		"rooms": ["1.15.3"],
		"finished_rooms": []
	}, {
		"id": "1.14.6",//平台id
		"owner": "1.2.77",//平台拥有者账号名
		"description": "",//平台描述
		"script": "",//平台链接
		"reputation": 2,//声望值
		"guaranty": "10000000000",//保证金
		"volume": 2,//参与次数
		"rooms": ["1.15.15"],//进行中的房间
		"finished_rooms": ["1.15.12", "1.15.13"]//已完成的房间
	}]

get_rooms_by_label

格式:get_rooms_by_label(const string& label, uint32_t limit)const;

参数:label为需要查找的索引, limit为返回结果的最大数量

作用:查询标签为label的房间

示例:{"jsonrpc": "2.0", "method": "get_rooms_by_label", "params": ["football",100], "id": 1}

返回信息示例:

{
	"id": 1,
	"jsonrpc": "2.0",
	"result": ["1.15.20", "1.15.22"]//含有指定标签的房间列表,包含已结束房间
}

get_transaction_id

格式:get_transaction_id signed_transaction(JSON)

参数:signed_transaction为JSON格式的已签名的交易内容。

作用:将压缩过的JSON格式的交易内容转换为其交易ID。

示例:{"jsonrpc": "2.0", "method": "get_transaction_id", "params": [{"ref_block_num":64292,"ref_block_prefix":1517346144,"expiration":"2018-10-12T07:33:12","operations":[[0,{"fee":{"amount":2136718,"asset_id":"1.3.0"},"from":"1.2.105","to":"1.2.138","amount":{"amount":"50000000000","asset_id":"1.3.0"},"memo":{"from":"SEER8UAbnsAnXY1qr3CD6uzKaRuewsyPF9ynYJJGrdvSfDANxsGNxH","to":"SEER6QbqUZF6xzjdceVoLHS7K1KwvLyszVTZS8bbsQQQXcAm8L3aZp","nonce":"4469110159915322318","message":"482a7d070d298fe2a79d5f528f55778c62584d242274a7d697dae1ec63d7038b5a0b80dc9ba524e3f5f528bc717c60a635f89ff8af1cccbd1b4189f8ddc92e39"},"extensions":[]}]],"extensions":[],"signatures":["204e8746aac14a05fb3c66ac653429dead34bddac58911c53346feb365f0c7b5767ea870c1e5da6a104d8364e42f504fc1bdcfc442652f5c2e9bb9b26a858b0ccd"]}], "id": 1}

{
	"id": 1,
	"result": "2b6eca1996c4456c1e235c68c0b3c3005e076630"
}

transfer2

格式:transfer2 from to amount asset_symbol memo broadcast(true/false)

参数:from为转出账户,to为接收账户,amount为转账数量, asset_symbol为资产名,memo为备注。from/to 可以是用户名或者id,broadcast设置是否广播。

作用:转账,并返回交易id。

示例:{"jsonrpc": "2.0", "method": "transfer2", "params": ["seerdex-withdraw","ffffff","500000","SEER","Welcome to SEERTALK. https://forum.seerchain.org",true], "id": 1}

返回信息示例:

{
	"id": 1,
	"jsonrpc": "2.0",
	"result":[
		"2b6eca1996c4456c1e235c68c0b3c3005e076630",//交易id
		{
		"ref_block_num": 64292,//引用的区块号
		"ref_block_prefix": 1517346144,//引用的区块头
		"expiration": "2018-10-12T07:33:12",//交易过期时间
		"operations": [
			[0, {//0表示转账
				"fee": {//手续费
					"amount": 2136718,//金额 ,amount没有小数点,其数值被乘以了10000 
					"asset_id": "1.3.0"//资产 此处表示SEER
				},
				"from": "1.2.105",//转出账户id
				"to": "1.2.138",//转入账户id
				"amount": {
					"amount": "50000000000",//金额 amount没有小数点,其数值被乘以了10000 
					"asset_id": "1.3.0"//资产 此处表示SEER
				},
				"memo": {//memo权限相关
					"from": "SEER8UAbnsAnXY1qr3CD6uzKaRuewsyPF9ynYJJGrdvSfDANxsGNxH",
					"to": "SEER6QbqUZF6xzjdceVoLHS7K1KwvLyszVTZS8bbsQQQXcAm8L3aZp",
					"nonce": "4469110159915322318",
					"message": "482a7d070d298fe2a79d5f528f55778c62584d242274a7d697dae1ec63d7038b5a0b80dc9ba524e3f5f528bc717c60a635f89ff8af1cccbd1b4189f8ddc92e39"
				},
				"extensions": []
			}]
		],
		"extensions": [],
		"signatures": ["204e8746aac14a05fb3c66ac653429dead34bddac58911c53346feb365f0c7b5767ea870c1e5da6a104d8364e42f504fc1bdcfc442652f5c2e9bb9b26a858b0ccd"]
		}
	]
}

get_asset

格式:get_asset asset_name_or_id

参数:asset_name_or_id是资产名或资产id

作用:列出资产asset_name_or_id的详细情况

示例:{"jsonrpc": "2.0", "method": "get_asset", "params": ["SEER"], "id": 1}

{"jsonrpc": "2.0", "method": "get_asset", "params": ["1.3.0"], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": {
		"id": "1.3.0",//资产ID
		"symbol": "SEER",//资产名
		"precision": 5,//精度
		"issuer": "1.2.3",//发行人
		"options": {
			"max_supply": "1000000000000000",//最大供给
			"market_fee_percent": 0,
			"max_market_fee": "1000000000000000",//最大市场手续费
			"issuer_permissions": 0,
			"flags": 0,
			"core_exchange_rate": {
				"base": {
					"amount": 1,
					"asset_id": "1.3.0"
				},
				"quote": {
					"amount": 1,
					"asset_id": "1.3.0"
				}
			},
			"whitelist_authorities": [],
			"blacklist_authorities": [],
			"whitelist_markets": [],
			"blacklist_markets": [],
			"description": "",
			"extensions": []
		},
		"dynamic_asset_data_id": "2.3.0"
	}
}

list_witnesses

格式:list_witnesses lowerbound limit

参数:lowerbound为账户名的下标,limit为返回结果的数量上限

作用:列出见证人列表

示例:{"jsonrpc": "2.0", "method": "list_witnesses", "params": ["" ,100], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": [
		["bob"/*竞选见证人的用户账号*/, "1.5.9"/*竞选见证人的竞选者ID*/],
		["init0", "1.5.1"],
		["init1", "1.5.2"],
		["init2", "1.5.3"],
		["init3", "1.5.4"],
		["init4", "1.5.5"],
		["init5", "1.5.6"],
		["init6", "1.5.7"],
		["seer-go", "1.5.8"]
	]
}

get_dynamic_global_properties

作用:列出链的当前全局动态参数

示例:{"jsonrpc": "2.0", "method": "get_dynamic_global_properties", "params": [], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": {
		"id": "2.1.0",
		"head_block_number": 3678309,//当前区块高度
		"head_block_id": "00382065d1057b13415518f913ce26e46fe45cac",//当前块号
		"time": "2018-10-12T16:37:30",//链上时间(格林尼治时间)
		"current_witness": "1.5.4",//当前出块的见证人
		"next_maintenance_time": "2018-10-13T00:00:00",//下次维护更新时间
		"last_budget_time": "2018-10-12T00:00:00",//上次维护时间
		"witness_budget": 3398400000,//本期见证人预算总额
		"accounts_registered_this_interval": 1,//账户注册间隔
		"recently_missed_count": 0,//最近缺失区块数
		"current_aslot": 4762199,//当前总块(丢掉的块加实际块高)
		"recent_slots_filled": "340240787892099949526793007880921399231",//用于计算见证人参与度的参数
		"dynamic_flags": 0,
		"last_irreversible_block_num": 3678305//最近一个不可逆块块号
	}
}

list_committee_members

格式:list_committee_members lowerbound limit

参数:lowerbound为账户名的下标,limit为返回结果的数量上限

作用:列出理事会成员列表

示例:{"jsonrpc": "2.0", "method": "list_committee_members", "params": ["" ,100], "id": 1}

返回信息示例:

{
	"id": 1,
	"result": [
		["bob",/*竞选理事会的用户账号*/ "1.4.8"/*竞选理事会的理事竞选者ID*/],
		["init0", "1.4.0"],
		["init1", "1.4.1"],
		["init2", "1.4.2"],
		["init3", "1.4.3"],
		["init4", "1.4.4"],
		["init5", "1.4.5"],
		["init6", "1.4.6"],
		["seer-go", "1.4.7"]
	]
}

(アキラ) #3

操作信息翻译

操作信息翻译是指将区块链数据中的各种代码、Object_ID、数据转化为普通用户易读的格式,方便用户一目了然的查看区块链信息。

SEER链上的操作类型

通过RPC调用返回的数据,在get_relative_account_historyop.op.Nget_blocktransactions.operations.N定义了该操作的类型。

以下是SEER常见的操作类型:

N operations 类型
0 Transfer 转账
1 limit_order_create_operation 委单
2 limit_order_cancel_operation 取消委单
3 fill_order_operation 委单撮合
4 Create Account 创建账户
5 Update Account 更新账户
7 account_upgrade_operation 升级账户
9 Create User-Issue Asset 创建资产
10 asset_update_operation 更新资产
11 asset_issue_operation 发行资产
12 asset_reserve_operation 销毁资产
13 asset_fund_fee_pool_operation 为资产手续费池注入资金
14 witness_create_operation 创建见证人
15 witness_update_operation 更新见证人
16 witness_create_collateral_operation 见证人创建抵押项
17 witness_cancel_collateral_operation 见证人取消抵押项
18 witness_claim_collateral_operation 见证人领取抵押项余额/抵押收益
19 proposal_create_operation 创建交易提议
20 proposal_update_operation 更新交易提议
26 committee_member_create_operation 创建理事会成员
30 vesting_balance_withdraw_operation 提取解冻金额/出块收益
40 seer_oracle_create_operation 创建预言机
41 seer_oracle_update_operation 更新预言机
42 seer_oracle_input_operation 预言机输入结果
43 seer_room_create_operation 创建房间
44 seer_room_update_operation 更新房间
45 seer_room_input_operation 创建者输入结果
46 seer_room_open_operation 开启房间
47 seer_room_stop_participating_operation 停止房间
48 seer_room_final_operation 预测结算
49 seer_room_settle_operation 派发奖励
50 seer_room_participate_operation 参与预测
53 seer_house_create_operation 创建平台
54 seer_house_update_operation 更新平台

转账操作

操作信息:

0,{//操作类型:转账
	"fee": 
	{
	  "amount": 200000,//手续费 2
	  "asset_id": "1.3.0"//手续费类型 1.3.0指SEER
	},
	"from": "1.2.1250",//发起用户ID
	"to": "1.2.1292",//接收用户ID
	"amount":
	 {
	  "amount": 1000000000,//金额10000
	  "asset_id": "1.3.1"//金额类型 1.3.1即OPC
	},
	"extensions": []
}

显示效果:

类型 说明
[转账] okok 转账 10000.00000 ABC 给 else

取数据格式:
get_account[result.transactions.operations.from].result.name + “转账” + result.transactions.operations.amount.amount/100000 + get_asset[result.transactions.operations.amount.asset_id].result.symbol + “给” + get_account[result.transactions.operations.to].result.name

委单操作

操作信息:

1,{//操作类型:委单
	"fee": {
	  "amount": 500000,//手续费 5
	  "asset_id": "1.3.0"//手续费类型 1.3.0指SEER
	},
	"seller": "1.2.150",//发起用户ID
	"amount_to_sell": {
	  "amount": 95500000,//出售金额995
	  "asset_id": "1.3.7"//出售资产类型
	},
	"min_to_receive": {
	  "amount": 95500000,//购买金额995
	  "asset_id": "1.3.0"//出售资产类型
	},
	"expiration": "2023-10-26T05:09:08",
	"fill_or_kill": false,
	"extensions": []
}

显示效果:

类型 说明
[委单] tomato 提交委单,以 1.00000 ABC/SEER 的价格求购 955.00000 SEER

取数据格式:

get_account[result.transactions.operations.seller].result.name + “提交委单,以” + result.transactions.operations.amount_to_sell.amount / result.transactions.operations.min_to_receive.amount + get_asset[result.transactions.operations.amount_to_sell.amount.asset_id].result.symbol + “/” + get_asset[result.transactions.operations.min_to_receive.amount.asset_id].result.symbol + “的价格买入” + result.transactions.operations.min_to_receive.amount/100000 + get_asset[result.transactions.operations.min_to_receive.amount.asset_id].result.symbol

取消委单操作

操作信息:

2,{//操作类型:取消委单
	"fee": {
	  "amount": 0,
	  "asset_id": "1.3.0"
	},
	"fee_paying_account": "1.2.105",//发起用户ID
	"order": "1.6.11",//要取消的委单id
	"extensions": []
}

显示效果:

类型 说明
[取消委单] tomato 取消了委单 #11

取数据格式:

get_account[result.transactions.operations.fee_paying_account].result.name + “取消了委单 #” + result.transactions.operations.order

委单撮合提示

此提示仅显示在get_relative_account_historyRPC方式返回的用户相关历史信息中。

显示用户提交的委单实际成交情况,例如:

A、用户挂单,未即时成交的,当有用户以高于此委单下单,使此委单成交时,显示实际成交量和成交价格(小明挂单以10 SEER/ABC 求购 1000 ABC,当有用户挂单9 SEER/ABC 求购 100 SEER时,小明的订单部分撮合成交,显示小明以9 SEER/ABC的价格购买了11.11111 ABC);

B、用户挂单时,市场内有低于用户挂单价格的委单,将优先以低价委单的委单价成交低价单,显示实际成交金额和成交价格,小明挂单以10 SEER/ABC 求购 100 ABC,此时市场内有用户挂单9 SEER/ABC 求购 100 SEER时,还有用户8SEER/ABC 求购 100SEER,小明的订单部分撮合成交,显示小明以9 SEER/ABC的价格购买了11.11111 ABC;以8 SEER/ABC的价格购买了12.5 ABC);

操作信息:

3, {//操作类型:委单撮合
	"fee": {
		"amount": 0,
		"asset_id": "1.3.7"
	},
	"order_id": "1.6.34",//委单ID
	"account_id": "1.2.106",//发起用户ID
	"pays": {
		"amount": 10000000,//卖出数量
		"asset_id": "1.3.0"//卖出资产类型
	},
	"receives": {
		"amount": 1000000,//收到数量
		"asset_id": "1.3.7"//收到资产类型
	},
	"fill_price": {
		"base": {
			"amount": 10000000,
			"asset_id": "1.3.0"
		},
		"quote": {
			"amount": 1000000,
			"asset_id": "1.3.7"
		}
	},
	"is_maker": true
}

显示效果:

类型 说明
[委单撮合] tomato 以 0.10000 ABC/SEER 的价格卖出了 100.00000 SEER

取数据格式:

get_account[result.op.account_id].result.name + “以” + result.op.receives.amount / result.op.pays.amount + get_asset[result.op.receives.asset_id].result.symbol + “/” + get_asset[result.op.pays.asset_id].result.symbol + “的价格卖出了” + result.op.pays.amount / 100000 + get_asset[result.op.pays.asset_id].result.symbol

创建账户操作

操作信息:

4,{//操作类型:创建账户
	"fee": {
	  "amount": 514160,
	  "asset_id": "1.3.0"
	},
	"registrar": "1.2.105",//发起用户ID
	"referrer": "1.2.105",
	"referrer_percent": 0,
	"name": "tomato",//新注册用户账号名
	"owner": {//账户权限
	  "weight_threshold": 1,
	  "account_auths": [],
	  "key_auths": [[
	      "SEER8NbcJc5vHz7Pq8WnCWP2TRJi487QV8RdSkNKVh9TAxsMwNY6zD",
	      1
	    ]
	  ],
	  "address_auths": []
	},
	"active": {//资金权限
	  "weight_threshold": 1,
	  "account_auths": [],
	  "key_auths": [[
	      "SEER584id6xbk9mGeKhMK6o2ouz3mptP1u4uHR748S4c29qpb94aBQ",
	      1
	    ]
	  ],
	  "address_auths": []
	},
	"options": {
	  "memo_key": "SEER584id6xbk9mGeKhMK6o2ouz3mptP1u4uHR748S4c29qpb94aBQ",//MEMO权限
	  "voting_account": "1.2.5",
	  "num_committee": 0,
	  "num_authenticator": 0,
	  "num_supervisor": 0,
	  "votes": [],
	  "extensions": []
	},
	"extensions": {}
}

显示效果:

类型 说明
[创建账户] okok 注册了账户 tomato

取数据格式:

get_account[result.transactions.operations.registrar].result.name + “注册了账户” + result.transactions.operations.name

更新账户操作

操作信息:

5, {//操作类型:更新账户
	"fee": {
		"amount": 2000000,
		"asset_id": "1.3.0"
	},
	"account": "1.2.140",//发起用户ID
	"active": {
		"weight_threshold": 1,
		"account_auths": [
			[
				"1.2.105",
				1
			]
		],
		"key_auths": [
			[
				"SEER8UAbnsAnXY1qr3CD6uzKaRuewsyPF9ynYJJGrdvSfDANxsGNxH",
				1
			],
			[
				"SEER584id6xbk9mGeKhMK6o2ouz3mptP1u4uHR748S4c29qpb94aBQ",
				1
			]
		],
		"address_auths": []
	},
	"extensions": {}
}

显示效果:

类型 说明
[更新账户] tomato 更新了账户信息

取数据格式:

get_account[result.transactions.operations.account].result.name + “更新了账户信息”

升级账户操作

操作信息:

7,{//操作类型:升级账户
	"fee": {
	"amount": 1000000000,
	"asset_id": "1.3.0"
	},
	"account_to_upgrade": "1.2.140",//发起用户ID
	"upgrade_to_lifetime_member": true,
	"extensions": []
}

显示效果:

类型 说明
[升级账户] tomato 升级到终身会员

取数据格式:

get_account[result.transactions.operations.account_to_upgrade].result.name + “升级到终身会员”

创建资产操作

操作信息:

9, {//操作类型:创建资产
	"fee": {
		"amount": "30000000000",
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.140",//发起用户ID
	"symbol": "ABC",//新资产代号
	"precision": 4,
	"common_options": {
		"max_supply": 1000000000,
		"market_fee_percent": 0,
		"max_market_fee": 0,
		"issuer_permissions": 31,
		"flags": 0,
		"core_exchange_rate": {
			"base": {
				"amount": 100000,
				"asset_id": "1.3.0"
			},
			"quote": {
				"amount": 10000,
				"asset_id": "1.3.1"
			}
		},
		"whitelist_authorities": [],
		"blacklist_authorities": [],
		"whitelist_markets": [],
		"blacklist_markets": [],
		"description": "{\"main\":\"\",\"market\":\"\"}",
		"extensions": []
	},
	"extensions": []
}

显示效果:

类型 说明
[创建资产] tomato 创建了资产 ABC

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “创建了资产” + result.transactions.operations.symbol

更新资产操作

操作信息:

10, {//操作类型:更新资产
	"fee": {
		"amount": 50000000,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.140",//发起用户ID
	"asset_to_update": "1.3.10",//更新的资产ID
	"new_options": {
		"max_supply": "10000000000",
		"market_fee_percent": 0,
		"max_market_fee": 0,
		"issuer_permissions": 31,
		"flags": 0,
		"core_exchange_rate": {
			"base": {
				"amount": 100000,
				"asset_id": "1.3.0"
			},
			"quote": {
				"amount": 10000,
				"asset_id": "1.3.10"
			}
		},
		"whitelist_authorities": [],
		"blacklist_authorities": [],
		"whitelist_markets": [
			"1.3.0"
		],
		"blacklist_markets": [],
		"description": "{\"main\":\"\",\"market\":\"\"}",
		"extensions": []
	}

显示效果:

类型 说明
[更新资产] tomato 更新了资产 ABC

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “更新了资产” + get_asset[result.transactions.operations.asset_to_update].result.symbol

资产发行操作

操作信息:

11, {//操作类型:资产发行
	"fee": {
		"amount": 2000097,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.140",//发起用户ID
	"asset_to_issue": {
		"amount": 11110000,//发行资产数额
		"asset_id": "1.3.10"//发行资产ID
	},
	"issue_to_account": "1.2.140",//接收用户ID
	"extensions": []
}

显示效果:

类型 说明
[资产发行] tomato 将 1,111.0000 ABC 发行给 alice

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “将” + result.transactions.operations.asset_to_issue.amount/100000 get_asset[result.transactions.operations.asset_to_issue.asset_id].result.symbol+ “发行给” + get_account[result.transactions.operations.issue_to_account].result.name

销毁资产操作

操作信息:

12, {//操作类型:销毁资产
	"fee": {
		"amount": 2000000,
		"asset_id": "1.3.0"
	},
	"payer": "1.2.140",//发起用户ID
	"amount_to_reserve": {
		"amount": 1110000,//销毁资产数额
		"asset_id": "1.3.10"//销毁资产ID
	},
	"extensions": []
}

显示效果:

类型 说明
[销毁资产] tomato 销毁了 111.0000 ABC

取数据格式:

get_account[result.transactions.operations.payer].result.name + “销毁了” + result.transactions.operations.amount_to_reserve.amount/100000 + get_asset[result.transactions.operations.amount_to_reserve.asset_id].result.symbol

注资资产手续费池操作

操作信息:

13, {//操作类型:注资资产手续费池
	"fee": {
		"amount": 100000,
		"asset_id": "1.3.0"
	},
	"from_account": "1.2.140",//发起用户ID
	"asset_id": "1.3.10",//注资的资产ID
	"amount": 100000000,//注资金额
	"extensions": []
}

显示效果:

类型 说明
[注资资产手续费池] tomato 向 ABC 的手续费池注资了 1,000.00000 SEER

取数据格式:

get_account[result.transactions.operations.from_account].result.name + “向” + get_asset[result.transactions.operations.asset_id].result.symbol + “的手续费池注资了” + result.transactions.operations.amount/100000 + get_asset[result.transactions.operations.asset_id].result.symbol

创建见证人操作

操作信息:

14, {//操作类型:创建见证人
	"fee": {
		"amount": 2000000000,
		"asset_id": "1.3.0"
	},
	"witness_account": "1.2.151",//发起用户ID
	"url": "",
	"block_signing_key": "SEER7GQxZj2DecxkN3jMfJaHap3U5yYzW21AQ94StwG5rmMsdnGs97"
}

显示效果:

类型 说明
[创建见证人] bob 升级到见证人

取数据格式:

get_account[result.transactions.operations.witness_account].result.name + “升级到见证人”

更新见证人操作

操作信息:

15, {//操作类型:更新见证人
	"fee": {
		"amount": 10000000,
		"asset_id": "1.3.0"
	},
	"witness": "1.5.9",
	"witness_account": "1.2.151",//发起用户ID
	"new_signing_key": "SEER7GQxZj2DecxkN3jMfJaHap3U5yYzW21AQ94StwG5rmMsdnGs97"
}

显示效果:

类型 说明
[更新见证人] bob 更新了见证人信息

取数据格式:

get_account[result.transactions.operations.witness_account].result.name + “更新了见证人信息”

见证人创建抵押项操作

操作信息:

16, {//操作类型:创建抵押项
	"fee": {
		"amount": 1000000,
		"asset_id": "1.3.0"
	},
	"witness": "1.5.9",
	"witness_account": "1.2.151",//发起用户ID
	"amount": 100000000//抵押项金额
}

显示效果:

类型 说明
[创建抵押项] bob 创建了新抵押项,金额 1000 SEER

取数据格式:

get_account[result.transactions.operations.witness_account].result.name + “创建了新抵押项,金额” + result.transactions.operations.amount / 100000 + “SEER”

见证人解锁抵押项操作

操作信息:

17, {//操作类型:解锁抵押
	"fee": {
		"amount": 10000000,
		"asset_id": "1.3.0"
	},
	"witness": "1.5.9",
	"witness_account": "1.2.151",//发起用户ID
	"collateral_id": "2.16.1"//抵押项ID
}

显示效果:

类型 说明
[解锁抵押] bob 解锁抵押项 2.16.1,15天后可领取。

取数据格式:

get_account[result.transactions.operations.witness_account].result.name + “解锁抵押项” + result.transactions.operations.collateral_id + “,15天后可领取。”

见证人领取抵押项余额/抵押收益操作

操作信息:

"operations": [
	[
		18, {//操作类型:领取抵押余额
			"fee": {
				"amount": 10000000,
				"asset_id": "1.3.0"
			},
			"witness": "1.5.9",
			"witness_account": "1.2.151"//发起用户ID
		}
	]
],
"extensions": [],
"signatures": [
	"1f248b....097baa0"
],
"operation_results": [
	[
		2, {
			"amount": "26928724460",//领取的余额/抵押收益数额
			"asset_id": "1.3.0"
		}
	]
]

显示效果:

类型 说明
领取抵押余额 bob 领取抵押项余额/抵押收益 269,287.24460 SEER

取数据格式:

get_account[result.transactions.operations.witness_account].result.name + “领取抵押项余额/抵押收益” + result.transactions.operation_results.amount / 100000 + “SEER”

创建交易提议操作

操作信息:

19, {//操作类型:创建提议
	"fee": {
		"amount": 2000000,
		"asset_id": "1.3.0"
	},
	"fee_paying_account": "1.2.140",//提议发起用户ID
	"expiration_time": "2018-10-27T14:20:15",
	"proposed_ops": [{//交易提议内容
		"op": [
			5, {//操作类型:更新账户
				"fee": {
					"amount": 2000000,
					"asset_id": "1.3.0"
				},
				"account": "1.2.151",//被操作账户ID
				"active": {
					"weight_threshold": 1,
					"account_auths": [
						[
							"1.2.105",
							1
						]
					],
					"key_auths": [
						[
							"SEER7js4ot7oPXrNEZaejvyagNG4mJtCtUxhX8t3Qi7H6ABjcBXqx3",
							1
						]
					],
					"address_auths": []
				},
				"extensions": {}
			}
		]
	}],
	"extensions": []
}

显示效果:

类型 说明
[创建提议] tomato 创建了交易提议:更新账户 bob 的信息

取数据格式:

get_account[result.transactions.operations.fee_paying_account].result.name + “创建了交易提议:” + “更新账户” + get_account[result.transactions.operations.proposed_ops.op.account].result.name + “的信息”

此例的提议内容为更新账户操作,若提议为其他操作,则替换proposed_ops部分。

更新交易提议操作

操作信息:

20, {//操作类型:更新提议
	"fee": {
		"amount": 2000000,
		"asset_id": "1.3.0"
	},
	"fee_paying_account": "1.2.106",//发起用户ID
	"proposal": "1.8.7",//要更新的提议ID
	"active_approvals_to_add": [],
	"active_approvals_to_remove": [],
	"owner_approvals_to_add": [],
	"owner_approvals_to_remove": [],
	"key_approvals_to_add": [
		"SEER5vhLky3Yg7YLAnvrFa2twftUCxZ8zz8PHtyCVTKSWw4JzAM7DY"
	],
	"key_approvals_to_remove": [],
	"extensions": []
}

显示效果:

类型 说明
[更新提议] tomato 更新了交易提议: 1.8.7

取数据格式:

get_account[result.transactions.operations.fee_paying_account].result.name + “更新了交易提议:” + result.transactions.operations.proposal

创建理事会成员操作

操作信息:

26, {//操作类型:竞选理事
	"fee": {
		"amount": 500000000,
		"asset_id": "1.3.0"
	},
	"committee_member_account": "1.2.151",//发起用户ID
	"url": "https://baidu.com"//宣言地址
}

显示效果:

类型 说明
[竞选理事] bob 参加理事会成员竞选,竞选宣言地址:https://baidu.com

取数据格式:

get_account[result.transactions.operations.committee_member_account].result.name + “参加理事会成员竞选,竞选宣言地址:” + result.transactions.operations.url

提取解冻金额/出块收益操作

操作信息:

30, {//操作类型:提取解冻余额
	"fee": {
		"amount": 1000000,
		"asset_id": "1.3.0"
	},
	"vesting_balance": "1.11.11",//解冻余额ID
	"owner": "1.2.151",//发起用户ID
	"amount": {
		"amount": "20202300000",//收益金额
		"asset_id": "1.3.0"
	}
}

显示效果:

类型 说明
[提取解冻余额] bob 提取了账户解冻金额/出块收益 202,023.00000 SEER

取数据格式:

get_account[result.transactions.operations.owner].result.name + “提取了账户解冻金额/出块收益” + result.transactions.operations.amount.amount / 100000 + “SEER”

创建预言机操作

操作信息:

40, {//操作类型:创建预言机
	"fee": {
		"amount": 1000002246,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.140",//发起用户ID
	"guaranty": 1000000000,//保证金
	"description": "xxxx",//描述
	"script": "xxxx"//网址
}

显示效果:

类型 说明
[创建预言机] tomato 以 10,000.00000 SEER保证金创建预言机

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “以” + result.transactions.operations.guaranty / 100000 + “SEER保证金创建预言机”

更新预言机操作

操作信息:

41, {//操作类型:更新预言机
	"fee": {
		"amount": 100002539,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.140",//发起用户ID
	"oracle": "1.13.5",//预言机ID
	"guaranty": 1000000,//保证金
	"description": "xxxx",//描述
	"script": "xxxx"//网址
}

显示效果:

类型 说明
[更新预言机] tomato 更新预言机

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “更新预言机”

预言机输入结果操作

操作信息:

42, {//操作类型:预言机输入结果
	"fee": {
		"amount": 1000000,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.140",//发起用户ID
	"oracle": "1.13.5",//预言机ID
	"room": "1.15.70",//房间ID
	"input": [//输入的结果
		0
	]
}

显示效果:

类型 说明
[预言机输入结果] bob 为预测市场1.15.70 “比特币价格高于6810美元吗?以…” 输入预测结果0:高于6810美元

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “为预测市场” + result.transactions.operations.room + “”" + get_seer_room[result.transactions.operations.room].result.description + " “输入预测结果” + result.transactions.operations.input + “:” + get_seer_room[result.transactions.operations.room].result.running_option.selection_description.[result.transactions.operations.input]

创建房间操作

操作信息:

43, {//操作类型:创建预测市场
	"fee": {
		"amount": 1000010449,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.151",//发起用户ID
	"label": [//标签
		"BTC", 
		"币圈",
		"比特币",
		"行情"
	],
	"description": "比特币价格高于6810美元吗?以新加坡时间2018年10月29日0时整,coinmarketcap.com显示价格为准。",//房间描述
	"script": "https://forum.seerchain.org/t/topic/345",
	"room_type": 1,
	"option": {
		"result_owner_percent": 1000,
		"reward_per_oracle": 0,
		"accept_asset": "1.3.0",
		"minimum": 1000000,
		"maximum": 10000000,
		"start": "2018-10-26T15:35:04",
		"stop": "2018-10-26T15:35:04",
		"input_duration_secs": 60,
		"filter": {
			"reputation": 0,
			"guaranty": 0,
			"volume": 0
		},
		"allowed_oracles": [],
		"allowed_countries": [],
		"allowed_authentications": []
	},
	"initial_option": {
		"room_type": 1,
		"selection_description": [
			"高于6810美元",
			"不高于6810美元"
		],
		"range": 2
	},
	"extensions": []
}

显示效果:

类型 说明
[创建预测市场] tomato 创建预测市场“比特币价格高于6810美元吗?以…”

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “创建预测市场“” + result.transactions.operations.description + " “”

更新房间操作

操作信息:

44, {//操作类型:更新预测市场
	"fee": {
		"amount": 10009960,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.151",//发起用户ID
	"room": "1.15.71",
	"description": "比特币价格高于6810美元吗?以新加坡时间2018年10月29日0时整,coinmarketcap.com显示价格为准。",//房间描述
	"script": "https://forum.seerchain.org/t/topic/345",
	"option": {
		"result_owner_percent": 1000,
		"reward_per_oracle": 0,
		"accept_asset": "1.3.0",
		"minimum": 1000000,
		"maximum": 10000000,
		"start": "2018-10-26T16:01:57",
		"stop": "2018-10-26T16:01:57",
		"input_duration_secs": 60,
		"filter": {
			"reputation": 0,
			"guaranty": 0,
			"volume": 0
		},
		"allowed_oracles": [],
		"allowed_countries": [],
		"allowed_authentications": []
	},
	"initial_option": {
		"room_type": 1,
		"selection_description": [
			"高于6810美元",
			"不高于6810美元"
		],
		"range": 2
	},
	"extensions": []
}

显示效果:

类型 说明
[更新预测市场] tomato 更新预测市场1.15.71“比特币价格高于6810美元吗?以…”

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “更新预测市场” + result.transactions.operations.room + " “” +result.transactions.operations.description + " “”

创建者输入结果操作

操作信息:

45, {//操作类型:创建者输入结果
	"fee": {
		"amount": 500000,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.151",//发起用户ID
	"room": "1.15.70",//房间ID
	"input": [//输入的结果
		1
	]
}

显示效果:

类型 说明
[创建者输入结果] tomato 为预测市场1.15.70 “比特币价格高于6810美元吗?以…” 输入预测结果1:不高于6810美元

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “为预测市场” + result.transactions.operations.room + “”" + get_seer_room[result.transactions.operations.room].result.description + " “输入预测结果” + result.transactions.operations.input + “:” + get_seer_room[result.transactions.operations.room].result.running_option.selection_description.[result.transactions.operations.input]

开启房间操作

操作信息:

46, {//操作类型:
	"fee": {
		"amount": 10000000,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.151",//发起用户ID
	"room": "1.15.70",//房间ID
	"start": "2018-10-26T15:36:12",
	"stop": "2018-10-26T15:37:12",
	"input_duration_secs": 360
}

显示效果:

类型 说明
[开启预测] tomato 开启预测市场1.15.70 “比特币价格高于6810美元吗?以…”

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “开启预测市场” + result.transactions.operations.room + " “” +result.transactions.operations.description + " “”

停止房间操作

操作信息:

47, {//操作类型:提前终止预测
	"fee": {
		"amount": 500000,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.151",//发起用户ID
	"room": "1.15.71",//房间ID
	"input_duration_secs": 360
}

显示效果:

类型 说明
[提前终止预测] tomato 提前终止预测市场1.15.71 “比特币价格高于6810美元吗?以…”

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “提前终止预测市场” + result.transactions.operations.room + " “” +result.transactions.operations.description + " “”

预测结算操作

操作信息:

48, {//操作类型:预测结算
	"fee": {
		"amount": 1000000,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.151",//发起用户ID
	"room": "1.15.70"//房间ID
}

显示效果:

类型 说明
[预测结算] tomato 为预测市场1.15.70 "比特币价格高于6810美元吗?以…"结算
[预测结算] tomato 为预测市场1.15.70 "比特币价格高于6810美元吗?以…"结算,tomato 余额变动 -3000 SEER

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “为预测市场” + result.transactions.operations.room + " “” +result.transactions.operations.description + " “结算”

在账号详情页通过get_relative_account_history获取指定账号参与过的房间房主结算时,除显示房主结算外,还应该显示该帐号余额的变动情况(例如房主的保证金预言机支出)。通过op.result.deltas获取;

派发奖励操作

操作信息:

49, {//操作类型:派发奖励
	"fee": {
		"amount": 2000000,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.151",//发起用户ID
	"room": "1.15.70"//房间ID
}

显示效果:

类型 说明
[派发奖励] tomato 为预测市场1.15.70 "比特币价格高于6810美元吗?以…"派奖
[派发奖励] tomato 为预测市场1.15.70 "比特币价格高于6810美元吗?以…"派奖,bob 余额变动 3000 SEER

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “为预测市场” + result.transactions.operations.room + " “” + result.transactions.operations.description + " “派奖”

在账号详情页通过get_relative_account_history获取指定账号参与过的房间房主派奖时,除显示房主派奖外,还应该显示该帐号余额的变动情况。通过op.result.deltas获取;

参与预测操作

操作信息:

"operations": [
	[
		50, {//操作类型:参与预测
			"fee": {
				"amount": 500000,
				"asset_id": "1.3.0"
			},
			"issuer": "1.2.151",//发起用户ID
			"room": "1.15.70",//房间ID
			"type": 0,
			"input": [
				1//预测的选项
			],
			"input1": [],
			"input2": [],
			"amount": 1000000000//参与数额(金额或份数)
		}
	]
],
"extensions": [],
"signatures": [
	"20250.....e2931"
],
"operation_results": [
	[
		3, {
			"asset_id": "1.3.0",
			"deltas": [
				[
					"1.2.151", -1000000000//资产变动金额
				]
			]
		}
	]
]

显示效果:

类型 说明
[参与预测] bob 参与预测市场1.15.70"比特币价格高于6810美元吗?以…"预测,预测结果1:不高于6810美元 参与数额:10000,余额变动:-10,000.00000 SEER

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “参与预测市场” + result.transactions.operations.room + " “” + get_seer_room[result.transactions.operations.room].result.description + " “预测,预测结果” + result.transactions.operations.input + “:” + get_seer_room[result.transactions.operations.room].result.running_option.selection_description.[result.transactions.operations.input] + “参与数额:” + result.transactions.operations.amount + “,余额变动:” + result.transactions.operation_results.deltas[1] / 100000 + get_asset[result.transactions.operation_results.asset_id].result.symbol

A result.transactions.operations.amount 在PVP和高级模式的房间中为资产金额,在PVD(LMSR)房间中为份数。

B 在账号详情页通过get_relative_account_history获取指定账号参与预测时,除显示参与预测,该帐号余额的变动情况
(通过op.result.deltas获取)、输入结果(通过op.op.inputN获取),同时显示房间号(通过op.op.room 获取,链接)

创建平台操作

操作信息:

53, {//操作类型:升级市场设立者
	"fee": {
		"amount": 3000002050,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.151",//发起用户ID
	"guaranty": "10000000000",//保证金
	"description": "",
	"script": ""
}

显示效果:

类型 说明
[升级市场设立者] tomato 取得高级预测市场设立者身份 保证金1000000.00000 SEER

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “取得高级预测市场设立者身份 保证金” + result.transactions.operations.guaranty / 100000 + “SEER”

更新平台操作

操作信息:

54, {//操作类型:更新市场设立者
	"fee": {
		"amount": 100003125,
		"asset_id": "1.3.0"
	},
	"issuer": "1.2.151",//发起用户ID
	"house": "1.14.15",
	"guaranty": 1000000,
	"claim_fees": 0,
	"description": "",
	"script": ""
}

显示效果:

类型 说明
[更新市场设立者] tomato 更新预测市场设立者信息

取数据格式:

get_account[result.transactions.operations.issuer].result.name + “更新预测市场设立者信息”