钱包 API说明¶
Contents
- 钱包 API说明
- 钱包连接方式
- 2.1 工具类 API
- 2.2 查询类 API
- 2.2.1 get_block
- 2.2.2 get_account
- 2.2.3 get_full_account
- 2.2.4 get_relative_account_history
- 2.2.5 list_account_balances
- 2.2.6 list_accounts_by_name
- 2.2.7 get_witness
- 2.2.8 list_witnesses
- 2.2.9 get_committee_member
- 2.2.10 list_committee_members
- 2.2.11 list_committee_proposals
- 2.2.12 get_platform_count
- 2.2.13 get_platform
- 2.2.14 list_platforms
- 2.2.15 get_asset
- 2.2.16 list_assets
- 2.2.17 compute_available_csaf
- 2.3 钱包/私钥管理类 API
- 2.4 操作/交易类 API
- 2.4.1 transfer & transfer_new
- 2.4.2 create_witness
- 2.4.3 update_witness
- 2.4.4 create_committee_member
- 2.4.5 update_committee_member
- 2.4.6 set_voting_proxy
- 2.4.7 update_witness_votes
- 2.4.8 update_committee_member_votes
- 2.4.9 collect_csaf_with_time
- 2.4.10 collect_csaf & collect_csaf_new
- 2.4.11 create_platform
- 2.4.12 update_platform
- 2.4.13 update_platform_votes
- 2.4.14 account_auth_platform
- 2.4.15 account_cancel_auth_platform
- 2.4.16 create_asset
- 2.4.17 update_asset
- 2.4.18 enable_allowed_assets
- 2.4.19 update_allowed_assets
- 2.4.20 issue_asset
- 2.4.21 reserve_asset
- 2.4.22 override_transfer
- 2.5 广告类 API
- 2.6 平台管理类 API
- 2.7 内容类 API
- 2.7.1 create_post
- 2.7.2 update_post
- 2.7.3 get_post
- 2.7.4 reward_post
- 2.7.5 get_license
- 2.7.6 list_licenses
- 2.7.7 get_posts_count
- 2.7.8 account_auth_platform
- 2.7.9 score_a_post
- 2.7.10 buyout_post
- 2.7.11 get_score
- 2.7.12 get_posts_by_platform_poster
- 2.7.13 list_scores
- 2.7.14 get_post_profits_detail
- 2.7.15 get_platform_profits_detail
- 2.7.16 get_poster_profits_detail
- 2.7.17 get_score_profit
- 2.7.17 account_manage
钱包连接方式¶
启动方式:¶
wallet的使用:
可以通过交互的命令行,也可以通过websocket和http的接口。 参考 交易指南
./yoyow_client -s ws://127.0.0.1:8090/ -r 0.0.0.0:8091 -H 127.0.0.1:8093
注意:
使用 -s 来指定,连接到的节点程序的IP与端口;
使用 -r 选项来开启一个websocket接口;
使用 -H 选项来开启一个HTTP-RPC服务,方便我们其他程序进行访问。如:单独处理充值/提现的脚本程序。
yoyow_node 只有完成同步后,才会监听RPC端口,所以请耐心等待 yoyow_node 同步完成。
您可以启动多个client 连接同一个yoyow_node。但请注意不要使用相同的-H,会因为端口被占用而监听失败。
在本文档的测试用例中,均使用本机地址。
websocket 接口地址: ws://localhost:8091
http rpc接口地址: http://localhost:8093
连接方法如下:
- 使用wscat连接 websocket 接口:
- ::
- wscat -c ws://localhost:8091
- 使用curl 连接 websocket 接口:
- ::
- curl --data '{"jsonrpc": "2.0", "method": "call", "params": [0, "get_accounts_by_uid", [["250926091"]]], "id": 1}' http://localhost:8091
- 使用curl 连接 http 接口:
- ::
- curl --data '{"method": "call", "params": [0, "get_accounts_by_uid", [["250926091"]]], "id": 1}' http://localhost:8093
备注:websocket和http接口的区别:websocket接口同样可以使用curl获取数据,会遵循jsonrpc格式,请求和返回的json数据均需携带{"jsonrpc": "2.0"}。http 的接口不需携带{"jsonrpc": "2.0"}的标签。
2.1 工具类 API¶
2.1.1 calculate_account_uid¶
给定一个数,计算出对应的账户 uid
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
n: | 数字 |
---|
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"calculate_account_uid",[12]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"calculate_account_uid",[12]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": 3106
}
2.1.2 suggest_brain_key¶
随机生成一个脑密钥,根据脑密钥得出一对公私钥
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
无
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"suggest_brain_key",[]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"suggest_brain_key",[]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"brain_priv_key": "DERIC GIANTRY ALODY TELAR TIRR BOILER BULLIT REACTOR BANISH FLOCCUS SLIPPER PELANOS WEALTHY SOLE RESCRUB RELIMIT",
"wif_priv_key": "5JXK8jhtJM8jKXcpBHeWahzkfZ9c7ske31TkMR7eMeq1uWirYVD",
"pub_key": "YYW7jcmGpu6KEUE352VtGB9PTo38Nut5qxXitfSgG6cDmAvxz2yin"
}
}
2.1.3 get_transaction_id¶
返回给定交易的 tx id (交易 ID ,或称交易哈希)
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
trx: | JSON格式的完整交易 |
---|
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"get_transaction_id",[{"operations":[[0,{"fee":{"total":{"amount":100000,"asset_id":0}},"from":250926091,"to":223331844,"amount":{"amount":100000,"asset_id":0},"extensions":{}}]]}]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"suggest_brain_key",[{"operations":[[0,{"fee":{"total":{"amount":100000,"asset_id":0}},"from":250926091,"to":223331844,"amount":{"amount":100000,"asset_id":0},"extensions":{}}]]}]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": "5ea3a6ee9f030472f83fb436836b602a3a5ed6a5"
}
2.2 查询类 API¶
2.2.1 get_block¶
根据块高获取某个块的信息
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
block_id: | 块高 |
---|
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"get_block",[846552]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"get_block",[846552]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"result": {
"previous": "000cead7924a4e84b8e6278791bec479ad8ecf29",
"timestamp": "2019-05-23T02:28:18",
"witness": 26460,
"transaction_merkle_root": "0000000000000000000000000000000000000000",
"witness_signature": "202cb55660544787bbae0dea54bce63f8aafae1766039d59022870117d58c864dc2cde9072eb91744472381d3233a9216839a8d9e4a3c7f4ed250cc619cd2daeed",
"transactions": [],
"block_id": "000cead8d55a838ed34c919fd6ff372d169edc6e",
"signing_key": "YYW5xhgecRawPgbq3ZaHdnxpo6TvySM1cLw2wBH7ZGXePkUcAVNJy",
"transaction_ids": []
}
}
2.2.2 get_account¶
获取账户基本信息。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
account_name_or_id: | |
---|---|
uid或者账户昵称name,例如:"250926091" |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"get_account",[250926091]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"get_account",[250926091]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"id": "1.2.1378",
"uid": 250926091,
"name": "yoyo250926091",
"owner": {
"weight_threshold": 1,
"account_uid_auths": [],
"key_auths": [
[
"YYW7UoNSEQAUPvnvoBRVKyPAD9845esnpiK6MgHinsn5yqr5UgT5W",
1
]
]
},
"active": {
"weight_threshold": 1,
"account_uid_auths": [],
"key_auths": [
[
"YYW6fU7Th8uESW9FZnpkhYaTUwtSvn3f2TQxFVA3ef2SSiwdZES71",
1
]
]
},
"secondary": {
"weight_threshold": 1,
"account_uid_auths": [],
"key_auths": [
[
"YYW5eDSFYeiqyFRajfPP8tTZM7mfUeyc7H65zmnHtDW4SQJdwqTBD",
1
]
]
},
"memo_key": "YYW7SpC4QLY1LRRxFQ2hbYHdAyQo88L8qnPJcDJkiRMugcnFGUGvo",
"reg_info": {
"registrar": 206336051,
"referrer": 25997,
"registrar_percent": 0,
"referrer_percent": 0,
"allowance_per_article": {
"amount": 0,
"asset_id": 0
},
"max_share_per_article": {
"amount": 0,
"asset_id": 0
},
"max_share_total": {
"amount": 0,
"asset_id": 0
},
"buyout_percent": 10000
},
"can_post": true,
"can_reply": false,
"can_rate": false,
"is_full_member": true,
"is_registrar": false,
"is_admin": false,
"create_time": "2018-04-03T08:21:00",
"last_update_time": "2018-04-03T08:21:00",
"active_data": "{}",
"secondary_data": "{}",
"statistics": "2.5.1378"
}
}
2.2.3 get_full_account¶
获取账户详细信息。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
account_name_or_id: | |
---|---|
uid或者账户昵称name,例如:"250926091" |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"get_full_account",[["250926091"]]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params": [0, "get_full_account", [["250926091"]]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"account": {
"id": "1.2.1378",
"uid": 250926091,
"name": "yoyo250926091",
"owner": {
"weight_threshold": 1,
"account_uid_auths": [],
"key_auths": [
[
"YYW7UoNSEQAUPvnvoBRVKyPAD9845esnpiK6MgHinsn5yqr5UgT5W",
1
]
]
},
"active": {
"weight_threshold": 1,
"account_uid_auths": [],
"key_auths": [
[
"YYW6fU7Th8uESW9FZnpkhYaTUwtSvn3f2TQxFVA3ef2SSiwdZES71",
1
]
]
},
"secondary": {
"weight_threshold": 1,
"account_uid_auths": [],
"key_auths": [
[
"YYW5eDSFYeiqyFRajfPP8tTZM7mfUeyc7H65zmnHtDW4SQJdwqTBD",
1
]
]
},
"memo_key": "YYW7SpC4QLY1LRRxFQ2hbYHdAyQo88L8qnPJcDJkiRMugcnFGUGvo",
"reg_info": {
"registrar": 206336051,
"referrer": 25997,
"registrar_percent": 0,
"referrer_percent": 0,
"allowance_per_article": {
"amount": 0,
"asset_id": 0
},
"max_share_per_article": {
"amount": 0,
"asset_id": 0
},
"max_share_total": {
"amount": 0,
"asset_id": 0
},
"buyout_percent": 10000
},
"can_post": true,
"can_reply": false,
"can_rate": false,
"is_full_member": true,
"is_registrar": false,
"is_admin": false,
"create_time": "2018-04-03T08:21:00",
"last_update_time": "2018-04-03T08:21:00",
"active_data": "{}",
"secondary_data": "{}",
"statistics": "2.5.1378"
},
"statistics": {
"id": "2.5.1378",
"owner": 250926091,
"total_ops": 11,
"removed_ops": 0,
"prepaid": 0,
"csaf": 4200683,
"core_balance": 1098850704,
"core_leased_in": 0,
"core_leased_out": 0,
"average_coins": 1099970604,
"average_coins_last_update": "2018-04-12T12:56:00",
"coin_seconds_earned": "136484730731520",
"coin_seconds_earned_last_update": "2018-04-12T12:56:00",
"total_witness_pledge": 0,
"releasing_witness_pledge": 0,
"witness_pledge_release_block_number": 4294967295,
"last_witness_sequence": 0,
"uncollected_witness_pay": 0,
"witness_last_confirmed_block_num": 0,
"witness_last_aslot": 0,
"witness_total_produced": 0,
"witness_total_missed": 0,
"witness_last_reported_block_num": 0,
"witness_total_reported": 0,
"total_committee_member_pledge": 0,
"releasing_committee_member_pledge": 0,
"committee_member_pledge_release_block_number": 4294967295,
"last_committee_member_sequence": 0,
"can_vote": true,
"is_voter": false,
"last_voter_sequence": 1,
"last_platform_sequence": 1,
"total_platform_pledge": 1000000000,
"releasing_platform_pledge": 0,
"platform_pledge_release_block_number": 4294967295,
"last_post_sequence": 0
},
"csaf_leases_in": [],
"csaf_leases_out": [],
"witness_votes": [],
"committee_member_votes": []
}
}
2.2.4 get_relative_account_history¶
获取账户历史。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
account: | 可以是 uid 或者账户昵称 |
---|---|
op_type: | 限制操作类型,参见操作类型。值为 null 时,则返回所有操作类型;为 0 时可获得所有transfer操作. |
start: | 查询起始编号(sequence number) |
limit: | 返回结果总数 |
end: | 值为 0 时,可得到最多的最近操作记录. |
返回结果的数量会在end - start 范围之内;如果limit值比end - start 要小,则返回满足limit条件的最新操作记录。 返回结果的排序方式为: 最新的优先
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"get_relative_account_history",["250926091",null,10,10,0]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"get_relative_account_history",["250926091",null,10,10,0]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"memo": "",
"description": "Transfer 1.20000 YOYO from 250926091 to 209414065 (Fee: 0.20000 YOYO)",
"sequence": 11,
"op": {
"id": "1.12.46722",
"op": [
0,
{
"fee": {
"total": {
"amount": 20000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 20000,
"asset_id": 0
}
}
},
"from": 250926091,
"to": 209414065,
"amount": {
"amount": 120000,
"asset_id": 0
}
}
],
"result": [
0,
{}
],
"block_timestamp": "2018-04-12T12:56:21",
"block_num": 5946192,
"trx_in_block": 0,
"op_in_trx": 0,
"virtual_op": 690
}
},
{
"memo": "",
"description": "Transfer 10 YOYO from 250926091 to 209414065 (Fee: 0.20000 YOYO)",
"sequence": 10,
"op": {
"id": "1.12.46721",
"op": [
0,
{
"fee": {
"total": {
"amount": 20000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 20000,
"asset_id": 0
}
}
},
"from": 250926091,
"to": 209414065,
"amount": {
"amount": 1000000,
"asset_id": 0
}
}
],
"result": [
0,
{}
],
"block_timestamp": "2018-04-12T12:55:57",
"block_num": 5946184,
"trx_in_block": 0,
"op_in_trx": 0,
"virtual_op": 689
}
}
]
}
2.2.5 list_account_balances¶
获取账户余额。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
account: | uid或者账户昵称name,例如:"250926091" |
---|
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"list_account_balances",["250926091"]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"list_account_balances",["250926091"]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"amount": 1098850704,
"asset_id": 0
}
]
}
2.2.6 list_accounts_by_name¶
根据名称查找账号UID。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
lowerbound: | 以此作为起始名称开始查询,设为空串则从头开始查 |
---|---|
limit: | 返回数量限制,最多不能超过 1001 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"list_accounts_by_name",["yoyo",10]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"list_accounts_by_name",["yoyo",10]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [
[
"yoyo10007071",
10007071
],
[
"yoyo100090928",
100090928
],
[
"yoyo100361976",
100361976
],
[
"yoyo100459405",
100459405
],
[
"yoyo100501159",
100501159
],
[
"yoyo100583445",
100583445
],
[
"yoyo100603302",
100603302
],
[
"yoyo100735531",
100735531
],
[
"yoyo10124233",
10124233
],
[
"yoyo101530854",
101530854
]
]
}
2.2.7 get_witness¶
获取见证人信息。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
owner_account: | 参数可以是 uid 或者账户昵称。 |
---|
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"get_witness",["132826789"]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"get_witness",["132826789"]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"id": "1.5.31",
"account": 132826789,
"name": "yoyo132826789",
"sequence": 1,
"is_valid": true,
"signing_key": "YYW1111111111111111111111111111111114T1Anm",
"pledge": "7500000000",
"pledge_last_update": "2017-09-05T11:39:03",
"average_pledge": "7500000000",
"average_pledge_last_update": "2017-09-06T12:05:36",
"average_pledge_next_update_block": 4294967295,
"total_votes": 1023267564,
"by_pledge_position": "0",
"by_pledge_position_last_update": "0",
"by_pledge_scheduled_time": "45370982250075664161773192435",
"by_vote_position": "0",
"by_vote_position_last_update": "0",
"by_vote_scheduled_time": "332544857826054970738151567847",
"last_confirmed_block_num": 8168,
"last_aslot": 8599,
"total_produced": 25,
"total_missed": 0,
"url": ""
}
}
2.2.8 list_witnesses¶
查询指定借出人的币龄租借(借出)清单。
结果按借入人 uid 从小到大排序
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
lower_bound: | 以此作为起始 uid 开始查询,设为 0 则从头开始查 |
---|---|
limit: | 返回数量限制,最多不能超过 101 |
order_by: | 排序类型。取值范围[0,1,2]。 0:按uid由大到小排序;1:按得票数从多到少排序;2:按抵押从多到少排序 |
注意事项¶
接口采用分页设计,若要获取全部的见证人,可以循环调用,直至返回见证人数小于limit为止。
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"list_witnesses",["132"]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"list_witnesses",["132"]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"id": "1.5.1",
"account": 25997,
"name": "init1",
"sequence": 1,
"is_valid": true,
"signing_key": "YYW71suPihtG7jJAGiVBCkd63ECHYebQaPa894oy3r54zk3eM1itt",
"pledge": 1000000000,
"pledge_last_update": "2017-09-12T21:02:45",
"average_pledge": 1000000000,
"average_pledge_last_update": "2017-09-13T21:20:30",
"average_pledge_next_update_block": 4294967295,
"total_votes": 0,
"by_pledge_position": "0",
"by_pledge_position_last_update": "0",
"by_pledge_scheduled_time": "340282366580656096882718510549",
"by_vote_position": "0",
"by_vote_position_last_update": "0",
"by_vote_scheduled_time": "340282366920938463463374607431768211455",
"last_confirmed_block_num": 5994633,
"last_aslot": 6366418,
"total_produced": 518458,
"total_missed": 32186,
"url": ""
},
{
"id": "1.5.2",
"account": 26264,
"name": "init2",
"sequence": 1,
"is_valid": true,
"signing_key": "YYW71suPihtG7jJAGiVBCkd63ECHYebQaPa894oy3r54zk3eM1itt",
"pledge": 1000000000,
"pledge_last_update": "2017-09-12T21:02:51",
"average_pledge": 1000000000,
"average_pledge_last_update": "2017-09-13T21:20:36",
"average_pledge_next_update_block": 4294967295,
"total_votes": 0,
"by_pledge_position": "0",
"by_pledge_position_last_update": "0",
"by_pledge_scheduled_time": "340282366580656096882718510549",
"by_vote_position": "0",
"by_vote_position_last_update": "0",
"by_vote_scheduled_time": "340282366920938463463374607431768211455",
"last_confirmed_block_num": 5994632,
"last_aslot": 6366417,
"total_produced": 518439,
"total_missed": 32198,
"url": ""
},
{
"id": "1.5.3",
"account": 26460,
"name": "init3",
"sequence": 1,
"is_valid": true,
"signing_key": "YYW71suPihtG7jJAGiVBCkd63ECHYebQaPa894oy3r54zk3eM1itt",
"pledge": 1000000000,
"pledge_last_update": "2017-09-12T21:02:54",
"average_pledge": 1000000000,
"average_pledge_last_update": "2017-09-13T21:20:39",
"average_pledge_next_update_block": 4294967295,
"total_votes": 0,
"by_pledge_position": "0",
"by_pledge_position_last_update": "0",
"by_pledge_scheduled_time": "340282366580656096882718510549",
"by_vote_position": "0",
"by_vote_position_last_update": "0",
"by_vote_scheduled_time": "340282366920938463463374607431768211455",
"last_confirmed_block_num": 5994636,
"last_aslot": 6366421,
"total_produced": 518427,
"total_missed": 32161,
"url": ""
},
{
"id": "1.5.4",
"account": 26861,
"name": "init4",
"sequence": 1,
"is_valid": true,
"signing_key": "YYW71suPihtG7jJAGiVBCkd63ECHYebQaPa894oy3r54zk3eM1itt",
"pledge": 1000000000,
"pledge_last_update": "2017-09-12T21:03:00",
"average_pledge": 1000000000,
"average_pledge_last_update": "2017-09-13T21:20:45",
"average_pledge_next_update_block": 4294967295,
"total_votes": 0,
"by_pledge_position": "0",
"by_pledge_position_last_update": "0",
"by_pledge_scheduled_time": "340282366580656096882718510549",
"by_vote_position": "0",
"by_vote_position_last_update": "0",
"by_vote_scheduled_time": "340282366920938463463374607431768211455",
"last_confirmed_block_num": 5994640,
"last_aslot": 6366425,
"total_produced": 518441,
"total_missed": 32137,
"url": ""
},
{
"id": "1.5.5",
"account": 27027,
"name": "init5",
"sequence": 1,
"is_valid": true,
"signing_key": "YYW71suPihtG7jJAGiVBCkd63ECHYebQaPa894oy3r54zk3eM1itt",
"pledge": 1000000000,
"pledge_last_update": "2017-09-12T21:05:15",
"average_pledge": 1000000000,
"average_pledge_last_update": "2017-09-13T21:23:00",
"average_pledge_next_update_block": 4294967295,
"total_votes": 0,
"by_pledge_position": "0",
"by_pledge_position_last_update": "0",
"by_pledge_scheduled_time": "340282366580656096882718510549",
"by_vote_position": "0",
"by_vote_position_last_update": "0",
"by_vote_scheduled_time": "340282366920938463463374607431768211455",
"last_confirmed_block_num": 5994639,
"last_aslot": 6366424,
"total_produced": 518387,
"total_missed": 32190,
"url": ""
}
]
}
2.2.9 get_committee_member¶
获取理事成员信息。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
owner_account: | uid 或者账户昵称。 例如:"25997" |
---|
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"get_committee_member",["25997"]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"get_committee_member",["25997"]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"id": "1.4.0",
"account": 25997,
"name": "init1",
"sequence": 1,
"is_valid": true,
"pledge": 0,
"total_votes": 567814657,
"url": ""
}
}
2.2.10 list_committee_members¶
列出当前有效的候选理事清单。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
lower_bound: | 以此作为起始 uid 开始查询,设为 0 则从头开始查 |
---|---|
limit: | 返回数量限制,最多不能超过 101 |
order_by: | 排序类型。取值范围[0,1,2]。 0:按uid由大到小排序;1:按得票数从多到少排序;2:按抵押从多到少排序 |
注意事项¶
接口采用分页设计,若要获取全部的理事会,可以循环调用,直至返回理事会人数小于limit为止。
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0,"list_committee_members",[0,5,1]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"list_committee_members",[0,5,1]], "id": 1}' http://localhost:8091
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"id": "1.4.0",
"account": 25997,
"name": "init1",
"sequence": 1,
"is_valid": true,
"pledge": 0,
"total_votes": 567814657,
"url": ""
},
{
"id": "1.4.1",
"account": 26264,
"name": "init2",
"sequence": 1,
"is_valid": true,
"pledge": 0,
"total_votes": 0,
"url": ""
},
{
"id": "1.4.2",
"account": 26460,
"name": "init3",
"sequence": 1,
"is_valid": true,
"pledge": 0,
"total_votes": 0,
"url": ""
},
{
"id": "1.4.3",
"account": 26861,
"name": "init4",
"sequence": 1,
"is_valid": true,
"pledge": 0,
"total_votes": 0,
"url": ""
},
{
"id": "1.4.4",
"account": 27027,
"name": "init5",
"sequence": 1,
"is_valid": true,
"pledge": 0,
"total_votes": 0,
"url": ""
}
]
}
2.2.11 list_committee_proposals¶
列出所有尚未成功执行的理事会提案,包含正在投票表决的、已表决通过但还没到执行时间的。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
无
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "list_committee_proposals", []]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "list_committee_proposals", []], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": []
}
2.2.12 get_platform_count¶
获取网络上平台的总数量
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
无
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "get_platform_count", []]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "get_platform_count", []], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": 6
}
2.2.13 get_platform¶
根据平台所有人(owner)账号,获取平台对象信息
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
owner_account: | 平台所有人账号 |
---|
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "get_platform", ["250926091"]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "update_committee_account", [0, "get_platform", ["250926091"]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"id": "1.6.3",
"owner": 250926091,
"name": "NoPlatform",
"sequence": 1,
"is_valid": true,
"total_votes": 0,
"url": "www.example2.com",
"pledge": 1000000000,
"pledge_last_update": "2018-04-03T09:30:48",
"average_pledge": 396825,
"average_pledge_last_update": "2018-04-03T09:34:48",
"average_pledge_next_update_block": 5684416,
"extra_data": "{}",
"create_time": "2018-04-03T09:30:48",
"last_update_time": "2018-04-03T09:34:48"
}
}
2.2.14 list_platforms¶
按平台拥有者进行查询,列出当前有效的平台清单。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
lower_bound: | 以此作为起始 uid 开始查询,设为 0 则从头开始查 |
---|---|
limit: | 返回数量限制,最多不能超过 100 |
order_by: | 排序类型。取值范围[0,1,2]。 0:按uid由大到小排序;1:按得票数从多到少排序;2:按抵押从多到少排序 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "list_platforms", [0,5,1]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "list_platforms", [0, "list_platforms", [0,5,1]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"id": "1.6.0",
"owner": 217895094,
"name": "test-yoyow",
"sequence": 1,
"is_valid": true,
"total_votes": 0,
"url": "http://demo.yoyow.org/",
"pledge": 1000000000,
"pledge_last_update": "2018-02-10T01:03:57",
"average_pledge": 176601774,
"average_pledge_last_update": "2018-02-11T06:49:12",
"average_pledge_next_update_block": 4562164,
"extra_data": "{\"login\":\"http://demo.yoyow.org:3000/authLogin\"}",
"create_time": "2018-02-10T01:03:57",
"last_update_time": "2018-02-11T06:49:12"
},
{
"id": "1.6.5",
"owner": 223331844,
"name": "baidu",
"sequence": 1,
"is_valid": true,
"total_votes": 0,
"url": "",
"pledge": 1000000000,
"pledge_last_update": "2018-04-16T02:52:36",
"average_pledge": 0,
"average_pledge_last_update": "2018-04-16T02:52:36",
"average_pledge_next_update_block": 6050467,
"extra_data": "",
"create_time": "2018-04-16T02:52:36",
"last_update_time": "1970-01-01T00:00:00"
},
{
"id": "1.6.4",
"owner": 224006453,
"name": "dwgMarket",
"sequence": 1,
"is_valid": true,
"total_votes": 0,
"url": "www.cad1688.com",
"pledge": 1000000000,
"pledge_last_update": "2018-04-04T08:38:24",
"average_pledge": 0,
"average_pledge_last_update": "2018-04-04T08:38:24",
"average_pledge_next_update_block": 5712088,
"extra_data": "{}",
"create_time": "2018-04-04T08:38:24",
"last_update_time": "1970-01-01T00:00:00"
}
]
}
2.2.15 get_asset¶
根据给定的资产代码或者 id ,返回资产详细信息。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
asset_name_or_id: | |
---|---|
资产符号或者资产id |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "get_asset", [ 3]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "get_asset", [ 3]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": "1.3.3",
"asset_id": 3,
"symbol": "WOWO",
"precision": 4,
"issuer": 223331844,
"options": {
"max_supply": "1000000000000000",
"market_fee_percent": 0,
"max_market_fee": "1000000000000000",
"issuer_permissions": 79,
"flags": 0,
"whitelist_authorities": [],
"blacklist_authorities": [],
"whitelist_markets": [],
"blacklist_markets": [],
"description": ""
},
"dynamic_asset_data_id": "2.3.3"
}
2.2.16 list_assets¶
分页查询资产详细信息。
返回结果按资产代码的 ASCII 码顺序排序
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
lower_bound_symbol: | |
---|---|
以此作为起始代码开始查询,顺序按资产代码的 ASCII 码排序 | |
limit: | 返回数量限制,最多不能超过 101 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "list_assets", ["YOY", 4]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "list_assets", ["YOY", 4]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"id": "1.3.91",
"asset_id": 91,
"symbol": "YOYES",
"precision": 2,
"issuer": 215074501,
"options": {
"max_supply": 1200,
"market_fee_percent": 0,
"max_market_fee": 1200,
"issuer_permissions": 79,
"flags": 0,
"whitelist_authorities": [],
"blacklist_authorities": [],
"whitelist_markets": [],
"blacklist_markets": [],
"description": "卢俊义"
},
"dynamic_asset_data_id": "2.2.91",
"dynamic_asset_data": {
"id": "2.2.91",
"asset_id": 91,
"current_supply": 0,
"accumulated_fees": 0
}
},
{
"id": "1.3.130",
"asset_id": 130,
"symbol": "YOYIO",
"precision": 2,
"issuer": 254208024,
"options": {
"max_supply": 1258000000,
"market_fee_percent": 0,
"max_market_fee": 1258000000,
"issuer_permissions": 79,
"flags": 0,
"whitelist_authorities": [],
"blacklist_authorities": [],
"whitelist_markets": [],
"blacklist_markets": [],
"description": "环保节能"
},
"dynamic_asset_data_id": "2.2.130",
"dynamic_asset_data": {
"id": "2.2.130",
"asset_id": 130,
"current_supply": 1258000000,
"accumulated_fees": 0
}
},
{
"id": "1.3.0",
"asset_id": 0,
"symbol": "YOYO",
"precision": 5,
"issuer": 1264,
"options": {
"max_supply": "200000000000000",
"market_fee_percent": 0,
"max_market_fee": "1000000000000000",
"issuer_permissions": 0,
"flags": 0,
"whitelist_authorities": [],
"blacklist_authorities": [],
"whitelist_markets": [],
"blacklist_markets": [],
"description": ""
},
"dynamic_asset_data_id": "2.2.0",
"dynamic_asset_data": {
"id": "2.2.0",
"asset_id": 0,
"current_supply": "106901076031525",
"accumulated_fees": 0
}
},
{
"id": "1.3.2",
"asset_id": 2,
"symbol": "YOYOW",
"precision": 5,
"issuer": 25638,
"options": {
"max_supply": "1000000000000",
"market_fee_percent": 0,
"max_market_fee": "1000000000000",
"issuer_permissions": 79,
"flags": 0,
"whitelist_authorities": [],
"blacklist_authorities": [],
"whitelist_markets": [],
"blacklist_markets": [],
"description": ""
},
"dynamic_asset_data_id": "2.2.2",
"dynamic_asset_data": {
"id": "2.2.2",
"asset_id": 2,
"current_supply": 0,
"accumulated_fees": 0
}
}
]
}
2.2.17 compute_available_csaf¶
计算某个账户待领取的 积分值。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
account_name_or_id: | |
---|---|
uid或者账户昵称name,例如:"250926091" |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "compute_available_csaf", [310299086]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "compute_available_csaf", [310299086]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"result": "608.85747"
}
2.3 钱包/私钥管理类 API¶
2.3.1 save_wallet_file¶
保存钱包文件,会保存到yoyo_client的执行文件夹下
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlock状态
访问授权限制¶
请求参数¶
wallet_filename: | |
---|---|
字符串,为备份的文件名。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "save_wallet_file", ["t3.json"]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "save_wallet_file", ["t3.json"]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result":null
}
2.3.2 set_password¶
设置钱包密码
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
访问授权限制¶
请求参数¶
password: | 密码字符串 例如:"1234" |
---|
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "set_password", ["1234"]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "set_password", ["1234"]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": null
}
2.3.3 unlock¶
解锁钱包
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet处于locked状态
访问授权限制¶
请求参数¶
password: | 密码字符串 例如:"1234" |
---|
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "unlock", ["1234"]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "unlock", ["1234"]], "id": 1}'
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": null
}
2.3.4 lock¶
锁定钱包
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
无
访问授权限制¶
请求参数¶
无
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "lock", []]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params": [0, "lock", []], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": null
}
2.3.5 import_key¶
将一个私钥导入钱包,并指定一个相关账号。私钥和账号并不一定要有关联。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
account_name_or_id: | |
---|---|
账号 uid 或者昵称 | |
wif_key: | 私钥字符串 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "lock", []]}{"id":1, "method":"call", "params":[0, "import_key", ["250926091","5JLaW7u3EC4vVLbTmLo1XeSBGiTeRtqER1UsoLtYbFNnBafgPKG"]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "lock", []]}{"id":1, "method":"call", "params":[0, "import_key", ["250926091","5JLaW7u3EC4vVLbTmLo1XeSBGiTeRtqER1UsoLtYbFNnBafgPKG"]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": true
}
2.3.6 dump_private_keys¶
列出钱包内所有私钥及对应公钥。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
无
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "dump_private_keys",[]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params": [0, "dump_private_keys",[]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [
[
"YYW5eDSFYeiqyFRajfPP8tTZM7mfUeyc7H65zmnHtDW4SQJdwqTBD",
"5HvABsnYU1U7misWHq9mc6mE8QovBiy8H5rVZc3zKztgZsPfFMB"
],
[
"YYW6fU7Th8uESW9FZnpkhYaTUwtSvn3f2TQxFVA3ef2SSiwdZES71",
"5JLaW7u3EC4vVLbTmLo1XeSBGiTeRtqER1UsoLtYbFNnBafgPKG"
]
]
}
2.3.7 list_my_accounts_cached¶
列出钱包文件中所有缓存的账户(导入私钥时指定的账户)的信息。
注:该缓存信息不一定与链上数据同步。要想进行同步,请重新打开钱包文件。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
无
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "list_my_accounts_cached",[]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params": [0, "list_my_accounts_cached",[]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"id": "1.2.1378",
"uid": 250926091,
"name": "yoyo250926091",
"owner": {
"weight_threshold": 1,
"account_uid_auths": [],
"key_auths": [
[
"YYW7UoNSEQAUPvnvoBRVKyPAD9845esnpiK6MgHinsn5yqr5UgT5W",
1
]
]
},
"active": {
"weight_threshold": 1,
"account_uid_auths": [],
"key_auths": [
[
"YYW6fU7Th8uESW9FZnpkhYaTUwtSvn3f2TQxFVA3ef2SSiwdZES71",
1
]
]
},
"secondary": {
"weight_threshold": 1,
"account_uid_auths": [],
"key_auths": [
[
"YYW5eDSFYeiqyFRajfPP8tTZM7mfUeyc7H65zmnHtDW4SQJdwqTBD",
1
]
]
},
"memo_key": "YYW7SpC4QLY1LRRxFQ2hbYHdAyQo88L8qnPJcDJkiRMugcnFGUGvo",
"reg_info": {
"registrar": 206336051,
"referrer": 25997,
"registrar_percent": 0,
"referrer_percent": 0,
"allowance_per_article": {
"amount": 0,
"asset_id": 0
},
"max_share_per_article": {
"amount": 0,
"asset_id": 0
},
"max_share_total": {
"amount": 0,
"asset_id": 0
},
"buyout_percent": 10000
},
"can_post": true,
"can_reply": false,
"can_rate": false,
"is_full_member": true,
"is_registrar": false,
"is_admin": false,
"create_time": "2018-04-03T08:21:00",
"last_update_time": "2018-04-03T08:21:00",
"active_data": "{}",
"secondary_data": "{}",
"statistics": "2.5.1378"
}
]
}
2.4 操作/交易类 API¶
以下操作涉及密钥权限的,需要导入相关的私钥,同时,保证wallet需处于解锁(unlocked)状态
交易类的操作一般情况下最后两个参数分别是 csaf_fee 和 broadcast, 分别代表 手续费的支付方式 和 是否广播
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
---|---|
broadcast: | 是否广播,true or false |
注:transfer 和 collect_csaf 由于历史原因,会没有csaf_fee参数,默认使用积分抵扣手续费,如果需要使用零钱支付手续费,可以使用transfer_new 和 collect_csaf_new 两个接口。
2.4.1 transfer & transfer_new¶
根据uid列表 查询平台
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要转出人active key
访问授权限制¶
请求参数¶
from: | 转出人(UID或昵称) |
---|---|
to: | 转入人(UID或昵称) |
amount: | 金额,如果金额为小数建议使用字符串传参 |
asset_symbol: | 币种, 资产类型,当前只有"YOYO" |
memo: | 备注(不带备注的话用空串"") |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费(transfer 没有该参数,默认使用积分抵扣手续费) |
broadcast: | 是否广播,true or false |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "transfer_new",[250926091, 209414065, "10", "YOYO", "feho", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "transfer_new",[250926091, 209414065, "10", "YOYO", "feho", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 57170,
"ref_block_prefix": 852086171,
"expiration": "2018-04-15T03:18:33",
"operations": [
[
0,
{
"fee": {
"total": {
"amount": 20898,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 20898,
"asset_id": 0
}
}
},
"from": 250926091,
"to": 209414065,
"amount": {
"amount": 1000000,
"asset_id": 0
},
"memo": {
"from": "YYW7SpC4QLY1LRRxFQ2hbYHdAyQo88L8qnPJcDJkiRMugcnFGUGvo",
"to": "YYW8PK8NtXW6JjtxqPV8QTgw4ejPEg4FgVeNV1maZDGzzNoEbgmr2",
"nonce": "7783743918290282490",
"message": "4468a7f3a5ac7fbf8125856381673030"
}
}
]
],
"signatures": [
"1f0a075215760089cf879b67ee6ba0aaaffa9408cd48c9040eee562909a8d67f5f7bbbb6401aabc69c00cd5d212f65b41204651f33442dc5b5b0056ce38f06c10e"
]
}
}
2.4.2 create_witness¶
创建见证人。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要见证人所有者的active key
访问授权限制¶
请求参数¶
owner_account: | 账号(UID或昵称) |
---|---|
block_signing_key: | |
出块签名公钥, | |
pledge_amount: | 抵押金额 |
pledge_asset_symbol: | |
抵押币种(YOYO) | |
url: | 介绍链接 |
can_pledge: | 是否允许抵押, true / false 不需修改则输入 null |
bonus_rate: | 抵押挖矿分红比例,出块工资中的该比例部分分给抵押账户 不需修改则输入 null |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
其中:签名公钥为 YYW1111111111111111111111111111111114T1Anm 表示暂时离线
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "create_witness", ["223331844", "YYW1111111111111111111111111111111114T1Anm","1000000", "YOYO", "http://www.yoyow.org", false, 0, true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "create_witness", ["223331844", "YYW1111111111111111111111111111111114T1Anm","100", "YOYO", "http://www.yoyow.org", false, 0, true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"ref_block_num": 58457,
"ref_block_prefix": 2372452101,
"expiration": "2018-05-03T11:28:36",
"operations": [[
13,{
"fee": {
"total": {
"amount": 100000000,
"asset_id": 0
}
},
"account": 223331844,
"block_signing_key": "YYW1111111111111111111111111111111114T1Anm",
"pledge": {
"amount": "100000000000",
"asset_id": 0
},
"url": "http://www.yoyow.org"
}
]
],
"signatures": [
"202857a37e91889a1c6124a2e3405eff00647b315aa55db7989334e187a5a92c1f0cb4bb00531fa525e53f26403e8bd323a9e46f8289b0039ed2caeb951f70eb28"
]
}
2.4.3 update_witness¶
修改见证人信息。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要见证人所有者的active key
访问授权限制¶
请求参数¶
witness_account: | |
---|---|
账号(UID或昵称) | |
block_signing_key: | |
新的出块签名公钥,不需修改则输入 null | |
pledge_amount: | 新的抵押金额,不需修改则输入 null |
pledge_asset_symbol: | |
新的抵押币种(YOYO),不需修改则输入 null | |
url: | 新的介绍链接,不需修改则输入 null |
can_pledge: | 是否允许抵押, true / false 不需修改则输入 null |
bonus_rate: | 抵押挖矿分红比例,出块工资中的该比例部分分给抵押账户 不需修改则输入 null |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
其中,抵押金额和币种必须同时出现或者同时不出现,目前币种只能是 YOYO
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "update_witness", ["223331844", null,"100345", "YOYO", null, null, null, true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "update_witness", ["223331844", null,"100345", "YOYO", null, null, null, true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 13103,
"ref_block_prefix": 3050749194,
"expiration": "2018-05-04T04:17:42",
"operations": [
[
14,
{
"fee": {
"total": {
"amount": 1000000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 1000000,
"asset_id": 0
}
}
},
"account": 223331844,
"new_pledge": {
"amount": "10034500000",
"asset_id": 0
}
}
]
],
"signatures": [
"1f6503a1e7dd15d1d9d5fe9cdaddddea39acf40071bd5621458b9abf3e0c8709f63fedfac89adc571fcc8af20fe6beb9f94d93d47256d3170b314e87153492357e"
]
}
}
2.4.4 create_committee_member¶
创建候选理事身份。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
否
访问授权限制¶
请求参数¶
owner_account: | 账号(UID或昵称) |
---|---|
pledge_amount: | 抵押金额 |
pledge_asset_symbol: | |
抵押币种(YOYO) | |
url: | 介绍链接 |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
查询到的资产实际只有YOYO可用。
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "create_committee_member", ["223331844","1000", "YOYO", "http://www.yoyow.org", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "create_committee_member", ["223331844","1000", "YOYO", "http://www.yoyow.org", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 13153,
"ref_block_prefix": 1417310192,
"expiration": "2018-05-04T04:20:12",
"operations": [
[
8,
{
"fee": {
"total": {
"amount": 10000000,
"asset_id": 0
}
},
"account": 223331844,
"pledge": {
"amount": 100000000,
"asset_id": 0
},
"url": "http://www.yoyow.org"
}
]
],
"signatures": [
"1f2b34fe5e2437be46d83ec2f0f4482e1b5df509131131c41eeb16e484df5e4ea96df19f82be294433bc751e84d6dcc28073e758ad7de1ca48c4b36fb2d41b2def"
]
}
}
2.4.5 update_committee_member¶
修改候选理事信息。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
否
访问授权限制¶
请求参数¶
committee_member_account: | |
---|---|
账号(UID或昵称) | |
pledge_amount: | 新的抵押金额,不需修改则输入 null |
pledge_asset_symbol: | |
新的抵押币种(YOYO),不需修改则输入 null | |
url: | 新的介绍链接,不需修改则输入 null |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "update_committee_member", ["223331844", "10234", "YOYO", null, true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "update_committee_account", ["250926091","10000", "YOYO", null, true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 13189,
"ref_block_prefix": 2763581564,
"expiration": "2018-05-04T04:22:00",
"operations": [
[
9,
{
"fee": {
"total": {
"amount": 1000000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 1000000,
"asset_id": 0
}
}
},
"account": 223331844,
"new_pledge": {
"amount": 1023400000,
"asset_id": 0
}
}
]
],
"signatures": [
"20506ea2aadb44a57ae4bb60c71b0c2002f89410d4941ed83d3323c4bed2f883ee4d045c9a326e331b49770db32799c63b854a67dd4ff998b74f6b457cb7d9157e"
]
}
}
2.4.6 set_voting_proxy¶
设置投票代理。
账户A设置账户B为投票代理,则B的投票对象得到的票数为A的有效票数+B的有效票数。 A 称之为委托人,B 称之为代理人
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要委托人账号的active key
访问授权限制¶
请求参数¶
account_to_modify: | |
---|---|
委托人账号(UID或昵称) | |
voting_account: | 代理人账号(用UID或昵称设置代理,null为取消代理) |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "set_voting_proxy", ["250926091", "abit", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "set_voting_proxy", ["250926091", "abit", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 18995,
"ref_block_prefix": 2835940919,
"expiration": "2018-04-16T02:06:36",
"operations": [
[
5,
{
"fee": {
"total": {
"amount": 100000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 100000,
"asset_id": 0
}
}
},
"voter": 223331844,
"proxy": 250926091
}
]
],
"signatures": [
"1f793459c8c7e06e80b2b34d2d13a0fb46e5d4f839953f6fae96af16acf389b51c534c35d2f85fe5d9f8e7316b1bb66941c2591e31afe7e5bbfee8802877ad7af0"
]
}
}
2.4.7 update_witness_votes¶
见证人投票。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要投票人的active key
访问授权限制¶
请求参数¶
voting_account: | 账号(UID或昵称) |
---|---|
witnesses_to_add: | |
增加支持的见证人清单(UID或昵称) | |
witnesses_to_remove: | |
移除支持的见证人清单(UID或昵称) | |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
witnesses_to_add和witnesses_to_remove两个清单可以都为空"[]",表示刷新投票意向。
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "update_witness_votes", ["250926091", ["abit"], [], true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "update_witness_votes", ["250926091", ["abit"], [], true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 18961,
"ref_block_prefix": 1229162670,
"expiration": "2018-04-16T02:04:54",
"operations": [
[
15,
{
"fee": {
"total": {
"amount": 200000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 200000,
"asset_id": 0
}
}
},
"voter": 250926091,
"witnesses_to_add": [
209414065
],
"witnesses_to_remove": []
}
]
],
"signatures": [
"206badbed989fcf01c93a2eda807976bae29f2e95ca2dcaa83f645be6c3bffcbc178199f4e4816801643cc9ee158fc4e8f450c2082763ac163e1b875bfb82f3a25"
]
}
}
2.4.8 update_committee_member_votes¶
理事会选举投票。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要投票人的active key
访问授权限制¶
请求参数¶
voting_account: | 投票人账号(UID或昵称) |
---|---|
committee_members_to_add: | |
数组,增加支持的候选理事清单(UID或昵称) | |
committee_members_to_remove: | |
数组,移除支持的候选理事清单(UID或昵称) | |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
committee_members_to_add,committee_members_to_remove两个清单可以都为空"[]",表示刷新投票意向。
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "update_committee_member_votes", ["250926091", ["init1"], [], true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "update_committee_member_votes", ["250926091", ["init1"], [], true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 19152,
"ref_block_prefix": 1139468448,
"expiration": "2018-04-16T02:14:27",
"operations": [
[
10,
{
"fee": {
"total": {
"amount": 100000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 100000,
"asset_id": 0
}
}
},
"voter": 250926091,
"committee_members_to_add": [
25997
],
"committee_members_to_remove": []
}
]
],
"signatures": [
"1f35562e4301c20f293977ffe27399ccf961fc3d5c0c9d928730ed5af03af24637599e30d070032bae887d9db3201c891b1c362dd0324e8bd9b02064d679a65be3"
]
}
}
2.4.9 collect_csaf_with_time¶
领取积分,需指定时间参数,领取积累到指定时间的积分。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
访问授权限制¶
请求参数¶
from: | 领取账号(UID或昵称) |
---|---|
to: | 接收账号(UID或昵称) |
amount: | 领取金额 |
asset_symbol: | 领取币种( 币种只能是 YOYO ) |
time: | 指定时间,例如:"2018-04-16T02:44:00" ,该时间为UTC时间,且不得早于当前链上新出块的时间5分钟。 |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "collect_csaf_with_time", ["223331844", "223331844", "0.5", "YOYO", "2018-04-16T02:44:00" true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "collect_csaf_with_time", ["223331844", "223331844", "0.5", "YOYO", "2018-04-16T02:44:00" true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 19813,
"ref_block_prefix": 1809327617,
"expiration": "2018-04-16T02:47:30",
"operations": [
[
6,
{
"fee": {
"total": {
"amount": 100000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 100000,
"asset_id": 0
}
}
},
"from": 223331844,
"to": 223331844,
"amount": {
"amount": 50000,
"asset_id": 0
},
"time": "2018-04-16T02:44:00"
}
]
],
"signatures": [
"1f250855fcc4e4ef093c14990411b1cfd41f97de43447e1b6a21cbe26eb95f6c9671b7c0d5ba4365d76018d277086c34c1d73a1f90c817f4d073852c6f041daf72",
"2061c58d04a7ad9f60af1f145c837f57475d3d1785754527753b1144c1bef445240faa079b5927956be10693711b392b7a52fb55439addacbcee94a40e61f13f84"
]
}
}
2.4.10 collect_csaf & collect_csaf_new¶
领取积分,领取积累到当前时间(分钟)的积分。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
访问授权限制¶
请求参数¶
from: | 领取账号(UID或昵称) |
---|---|
to: | 接收账号(UID或昵称) |
amount: | 领取金额 |
asset_symbol: | 领取币种( 币种只能是 YOYO ) |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 (collect_csaf 没有该参数,默认使用积分抵扣手续费) |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "collect_csaf", ["250926091", "250926091", 1, "YOYO", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "collect_csaf", ["250926091", "250926091", 1, "YOYO", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 19646,
"ref_block_prefix": 555752677,
"expiration": "2018-04-16T02:39:09",
"operations": [
[
6,
{
"fee": {
"total": {
"amount": 100000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 100000,
"asset_id": 0
}
}
},
"from": 250926091,
"to": 250926091,
"amount": {
"amount": 100000,
"asset_id": 0
},
"time": "2018-04-16T02:37:00"
}
]
],
"signatures": [
"203a417b25f10110d8143d7476976abbcbb3490f13432630366e5b0d1d8d7580573c8595e93109af4a55282756b8b4916ae055147cceae1bc7b85f2b0a7f2fa042",
"2054d3b25618ddaeae499297a483d5490bac77f35bac7dd850645400d7f8001a2265cd997ff62db54740e9fcda52b0bbbaf5aa6d12d3fbcd65a71e2ccf6baa1e1a"
]
}
}
2.4.11 create_platform¶
创建平台
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要申请者的Active key
访问授权限制¶
请求参数¶
owner_account: | 创建者账号 |
---|---|
name: | 平台名称 |
pledge_amount: | 抵押数量,当前不得少于10000 YOYO |
pledge_asset_symbol: | |
抵押币种(YOYO) | |
url: | 平台链接 |
extra_data: | 平台额外数据 |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "create_platform", ["223331844", "yoyo.club", "10000", "YOYO", "", "", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "create_platform", ["223331844", "yoyow.club", "10000", "YOYO", "", "", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 19954,
"ref_block_prefix": 1357577324,
"expiration": "2018-04-16T02:54:33",
"operations": [
[
20,
{
"fee": {
"total": {
"amount": 100007811,
"asset_id": 0
}
},
"account": 223331844,
"pledge": {
"amount": 1000000000,
"asset_id": 0
},
"name": "baidu",
"url": "",
"extra_data": ""
}
]
],
"signatures": [
"20534af4af03c6d4001c797dde6ac438a6b3d31c77b94cb8e4b6519e681a289c69370057de58412bb5e3ba8320ab975d33012bb92b20509e3daee6582affce8e80"
]
}
}
2.4.12 update_platform¶
修改平台信息。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
否
访问授权限制¶
请求参数¶
platform_account: | |
---|---|
账号(UID或昵称) | |
name: | 新的平台名称,不需修改则输入 null |
pledge_amount: | 新的抵押金额,不需修改则输入 null |
pledge_asset_symbol: | |
新的抵押币种(YOYO),不需修改则输入 null | |
url: | 新的介绍链接,不需修改则输入 null |
extra_data: | 新的平台额外数据 |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注: 抵押金额和币种必须同时出现或者同时不出现,目前币种只能是 YOYO。 抵押金额为 0 则为关闭平台
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "update_platform", ["223331844", "NUUUU", null, null, "http://www.example.com", "http://www.example.com", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "update_platform", ["223331844", "NUUUU", null, null, "http://www.example.com", "http://www.example.com", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 20262,
"ref_block_prefix": 1534083365,
"expiration": "2018-04-16T03:09:57",
"operations": [
[
21,
{
"fee": {
"total": {
"amount": 1053709,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 1053709,
"asset_id": 0
}
}
},
"account": 223331844,
"new_name": "NUUUU",
"new_url": "http://www.example.com",
"new_extra_data": "http://www.example.com"
}
]
],
"signatures": [
"202e8e53a7e58d4b60c7bf7b0d3f8076a6c9b8f7c472c48e61463cff68228e2cf643404bf954f1c7596deb05630942c95057ff397f31753bff069e5754894efcad"
]
}
}
2.4.13 update_platform_votes¶
为平台投票
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要投票者的Active key
访问授权限制¶
请求参数¶
voting_account: | 投票人账号(UID或昵称) |
---|---|
platforms_to_add: | |
增加支持的平台清单(UID或昵称) | |
platforms_to_remove: | |
移除支持的平台清单(UID或昵称) | |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
latforms_to_add,platforms_to_remove 两个清单可以都为空,表示刷新投票意向。
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "update_platform_votes", ["250926091", ["223331844"], [], true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "update_platform_votes", ["250926091", ["223331844"], [], true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 20494,
"ref_block_prefix": 3288350547,
"expiration": "2018-04-16T03:21:33",
"operations": [
[
22,
{
"fee": {
"total": {
"amount": 200000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 200000,
"asset_id": 0
}
}
},
"voter": 250926091,
"platform_to_add": [
223331844
],
"platform_to_remove": []
}
]
],
"signatures": [
"20274d50cf4905fe072e3257632335546c386721f2d608cf3939316f7167ddbea55a28616cc790b00aea5bc89b6649e56c04c8121f50a97c2ca4b3f587ac5e922e"
]
}
}
2.4.14 account_auth_platform¶
账户对平台授权。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
主控密钥
访问授权限制¶
请求参数¶
account: | 授权账号(UID或昵称) |
---|---|
platform_owner: | 平台所有者账号(UID或昵称) |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "account_auth_platform", ["250926091", "223331844", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "account_auth_platform", ["250926091", "223331844", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 26612,
"ref_block_prefix": 1858930703,
"expiration": "2018-07-05T02:34:57",
"operations": [
[
23,
{
"fee": {
"total": {
"amount": 10000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 10000,
"asset_id": 0
}
}
},
"uid": 223331844,
"platform": 250926091
}
]
],
"signatures": [
"200ee643c33b074ad002bc6f4b477ff48dbee76bd3aa1c3c5b3a4c064b1f39581e61f93e957128c1c20737eafa2e09c56f6d0f97468676cfa2a15d04f50da0774c"
]
}
}
2.4.15 account_cancel_auth_platform¶
账户取消对平台授权。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
主控密钥
访问授权限制¶
请求参数¶
account: | 授权账号(UID或昵称) |
---|---|
platform_owner: | 平台所有者账号(UID或昵称) |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "account_cancel_auth_platform", ["250926091", "223331844", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "account_cancel_auth_platform", ["250926091", "223331844", true, true], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 26736,
"ref_block_prefix": 2510951750,
"expiration": "2018-07-05T02:41:09",
"operations": [
[
24,
{
"fee": {
"total": {
"amount": 10000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 10000,
"asset_id": 0
}
}
},
"uid": 223331844,
"platform": 250926091
}
]
],
"signatures": [
"2021240ab7c321fad009693c8a598363aa840fcde0f07cc54d72b8c3b7d6e116d4357127328faea805aff7d632fb0a09e2ce6ac203d4a97b2dd30c139548939d38"
]
}
}
2.4.16 create_asset¶
创建资产
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要申请者的Active key
访问授权限制¶
请求参数¶
issuer: | 创建人UID |
---|---|
symbol: | 要创建资产的符号 |
precision: | 精度(保留几位小数) |
common: | 选项,详见下文选项参数结构 |
initial_supply: | 初始流通量为整型表示,即:实际金额 = initial_supply / ( 10 ^ precision ) |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
其中选项参数结构
asset_options {
// 该资产在任何给定时间可能存在的最大供应量。 这可以和 GRAPHENE_MAX_SHARE_SUPPLY 一样大
// 特别说明:该最大供应量为最小单位Token的数量,比如发行的最大供应量为30000,精度设为2,则实际的供应量为30000/(10^2)=300个Token,最小的交易单位为0.01。
max_supply = GRAPHENE_MAX_SHARE_SUPPLY;
// (预留字段,暂未使用,必须为 0 )
market_fee_percent = 0;
// (预留字段,暂未使用,必须为 0 )
max_market_fee = GRAPHENE_MAX_SHARE_SUPPLY;
// 发行人有权更新的标志
issuer_permissions = UIA_ASSET_ISSUER_PERMISSION_MASK;
// 此权限上的当前活动标志
flags = 0;
// 一组白名单的账户可以使用此资产。 如果whitelist_authorities不为空,则只有whitelist_authorities中的帐户才可以持有,使用或转让资产。
whitelist_authorities;
// 一组黑名单的帐户,不可以持有,使用此资产。
blacklist_authorities;
// 定义该资产可能在市场上交易的资产(预留字段,暂未使用)
whitelist_markets;
// 定义该资产不得在市场上交易的资产,不得重叠白名单 (预留字段,暂未使用)
blacklist_markets;
// 描述该资产的含义/目的的数据,费用将按照描述的大小进行收费。
string description;
};
其中, issuer_permisisons 和 flags 两个字段,是以整数方式表示,该整数转换为二进制后,每一位代表一个权限或者标志。目前定义如下:
enum asset_issuer_permission_flags
{
white_list = 0x02, // 白名单,如果启用,则该资产发行人可以控制他人是否可以使用该资产(这里的“使用”包含转账等操作)
override_authority = 0x04, // 强制转账,如果启用,则该资产发行人可以强制转走或者收回其他人账户里的该类资产
transfer_restricted = 0x08, // 限制转账,如果启用,则转账的发起者或者接收者必须是该资产发行人
issue_asset = 0x200, // 发行资产,如果启用,则该资产发行人可以增加一定数量的该类资产到某账户,同时增加该资产的当前流通总量
change_max_supply = 0x400, // 修改流通量上限,如果启用,则该资产发行人可以修改该资产的流通量上限
};
目前尚未使用的位,在 issuer_permissions 和 flags 两个字段中必须为 0 。 在flags 字段里,某一位如果为 1 ,则表示该资产启用了这一位对应的参数;如果为 0 ,则表示没有启用。 在issuer_permissions 字段里,如果某一位如果为 0 ,则表示资产发行人可以修改 flags 字段里对应的参数位;如果为 1 ,则表示不可修改。
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "create_asset", ["250926091","TOTOTO", 4, {"max_supply":300000,"market_fee_percent":0,"max_market_fee":0,"issuer_permissions":4}, 200000, true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "create_asset", ["250926091","TOTOTO", 4, {"max_supply":300000,"market_fee_percent":0,"max_market_fee":0,"issuer_permissions":4}, 200000, true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"ref_block_num": 57735,
"ref_block_prefix": 998946957,
"expiration": "2018-07-06T04:31:06",
"operations": [[
25,{
"fee": {
"total": {
"amount": 50000000,
"asset_id": 0
}
},
"issuer": 250926091,
"symbol": "TOTOTO",
"precision": 4,
"common_options": {
"max_supply": 300000,
"market_fee_percent": 0,
"max_market_fee": 0,
"issuer_permissions": 4,
"flags": 0,
"whitelist_authorities": [],
"blacklist_authorities": [],
"whitelist_markets": [],
"blacklist_markets": [],
"description": ""
},
"extensions": {
"initial_supply": 200000
}
}
]
],
"signatures": [
"1f32dc80319019ff0c5eff27c9d1e15c7371fcc2825969b8e42a6429fb44c2ac3a75344b382e00c9f7f4af06600b0aff93aa380bf81b94f62b1abe0bfc807fcb6f"
]
}
2.4.17 update_asset¶
更新资产信息。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要资产所有者的Active key
访问授权限制¶
请求参数¶
symbol: | 资产符号 |
---|---|
new_issuer: | 新的资产所有人,不需修改则置为null |
new_options: | 新的资产选项(见create_asset 中的 common参数结构),不需修改则输入 null |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "update_asset", ["WOWO", null, {"max_supply":"2000000000"}, true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "update_asset", ["WOWO", null, {"max_supply":"2000000000"}, true, true]]}, "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 12862,
"ref_block_prefix": 653302827,
"expiration": "2018-05-04T04:05:39",
"operations": [
[
26,
{
"fee": {
"total": {
"amount": 50000000,
"asset_id": 0
}
},
"issuer": 223331844,
"asset_to_update": 3,
"new_options": {
"max_supply": 2000000000,
"market_fee_percent": 0,
"max_market_fee": "1000000000000000",
"issuer_permissions": 79,
"flags": 0,
"whitelist_authorities": [],
"blacklist_authorities": [],
"whitelist_markets": [],
"blacklist_markets": [],
"description": ""
}
}
]
],
"signatures": [
"2030b2b084ab8e47bc2da5c863475776eac2cde1feba4cb3575eb7a7e86f96c9594a9778280c740098a5eec26f84b57993d925d2630c1a3dc31395c9938a676089"
]
}
}
2.4.18 enable_allowed_assets¶
账户主动启用或停用账户端资产白名单。
该白名单默认为停用状态,停用白名单即 账户可以发送和接收任何资产。
白名单处于启用状态时,该账户只能发送和接收名单内的资产,同时可使用 update_allowed_assets 命令更新白名单。
从停用状态变更为启用状态时,白名单中默认只有“核心资产”,即 YOYO 。
从启用状态停用白名单后,数据清除。重新启用时需重新添加需要的资产。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要资产所有者的Active key
访问授权限制¶
请求参数¶
account: | 账号(UID或昵称) |
---|---|
enable: | 是否启用( true 为启用, false 为停用 ) |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "enable_allowed_assets", ["250926091", false, true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "issue_asset", "250926091", false, true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"ref_block_num": 56000,
"ref_block_prefix": 3273656390,
"expiration": "2018-07-06T03:04:21",
"operations": [[
34,{
"fee": {
"total": {
"amount": 100000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 100000,
"asset_id": 0
}
}
},
"account": 250926091,
"enable": false
}
]
],
"signatures": [
"1f7e06ed28f6017e9a25ee1d165ec1aae330fb87abc9486c264c30f7de2e8d2369077509d61d96df016fbeec55bbd541532b90f35bf2e18278c87369fa87d7158b"
]
}
2.4.19 update_allowed_assets¶
更新账户端资产白名单。
只有白名单处于开启状态时,才能更新。 不能移除 YOYO 。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要资产所有者的Active key
访问授权限制¶
请求参数¶
account: | 账号(UID或昵称) |
---|---|
assets_to_add: | 添加到白名单的资产清单(资产代码或 id ) |
assets_to_remove: | |
从白名单移除的资产清单(资产代码或 id ) | |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "issue_asset", ["250926091", "100000", "WOWO", "memo", ture, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "issue_asset", ["250926091", "100000", "WOWO", "memo", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"ref_block_num": 56441,
"ref_block_prefix": 3725987382,
"expiration": "2018-07-06T03:26:24",
"operations": [[
35,{
"fee": {
"total": {
"amount": 200000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 200000,
"asset_id": 0
}
}
},
"account": 250926091,
"assets_to_add": [
3
],
"assets_to_remove": []
}
]
],
"signatures": [
"200f4362763eef9a5f0de6c461d2dcde77e665ae5ac2d462c89dd1f4ba22b35b7b21662e306d1e52c530815983f284d79b3191ebd4d3fea43f135aff4e21fe39a3",
"1f199078220bf0d6c2fcf28e0bd4fbf9afc1eb7db241997173a469d88d538d36c03c3299136cf42a030810c5adf250be990029391c0ad7ae8268e5bee4850f07bd"
]
}
2.4.20 issue_asset¶
分配发行的资产给某个账号
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要资产所有者的Active key
访问授权限制¶
请求参数¶
to_account: | 发行到的目标账号 |
---|---|
amount: | 数量 |
symbol: | 资产符号 |
memo: | 备注 |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "issue_asset", ["250926091", "100000", "WOWO", "memo", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "issue_asset", ["250926091", "100000", "WOWO", "memo", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"ref_block_num": 55598,
"ref_block_prefix": 1065296620,
"expiration": "2018-05-03T09:05:39",
"operations": [[
27,{
"fee": {
"total": {
"amount": 2008984,
"asset_id": 0
}
},
"issuer": 223331844,
"asset_to_issue": {
"amount": 1000000000,
"asset_id": 3
},
"issue_to_account": 250926091,
"memo": {
"from": "YYW8EeMDaSmDg8zLXL272kcm4W7vUF4c4tBkfQpV7N79PBjgGjkDN",
"to": "YYW7SpC4QLY1LRRxFQ2hbYHdAyQo88L8qnPJcDJkiRMugcnFGUGvo",
"nonce": "3388232258004121975",
"message": "fc712e427e57aae3d6819e3427b7f90a"
}
}
]
],
"signatures": [
"205e29664c74590e1af73aa645374dc25f2900758e5213a3120fdf285d7940d5e66339311a97513cf78bd794916619f5813c940a9e7bc4b942fbd9fed49a2a7d27"
]
}
2.4.21 reserve_asset¶
销毁自己账户中指定数量的指定资产。 操作完成后,该资产类型的流通总量相应减少。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要资产所有者的Active key
访问授权限制¶
请求参数¶
from: | 账号(UID或昵称) |
---|---|
amount: | 金额 |
symbol: | 币种(资产代码) |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "reserve_asset", ["250926091", "1000", "WOWO", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "reserve_asset", ["250926091", "1000", "WOWO", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"ref_block_num": 56703,
"ref_block_prefix": 1905534427,
"expiration": "2018-07-06T03:39:30",
"operations": [[
28,{
"fee": {
"total": {
"amount": 10000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 10000,
"asset_id": 0
}
}
},
"payer": 250926091,
"amount_to_reserve": {
"amount": 10000000,
"asset_id": 3
}
}
]
],
"signatures": [
"1f6a2f416a525ae4754a98388cb4464f60f1b77659c5a742d8b76a80d581484ce5681c24aa51c7379acaa8247df49d962cb28b5910e179a7de9c8a48e49fe7cc5a"
]
}
2.4.22 override_transfer¶
强制转账。资产发行人强制某账户将一定数量资产转到另一账户。
只有资产发行人才能使用这个功能。
备注用发行人备注私钥加密,转入人可解密备注,转出人不可解密。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
需要资产发行人的Active key和memo key
访问授权限制¶
请求参数¶
from: | 转出人(UID或昵称) |
---|---|
to: | 转入人(UID或昵称) |
amount: | 金额 |
symbol: | 币种(资产代码) |
memo: | 备注(不带备注的话用空串"") |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费 |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{"id":1, "method":"call", "params":[0, "override_transfer", ["216494599", "250926091", 2, "SOSO", "memo", true, true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0, "override_transfer", ["216494599", "250926091", 2, "SOSO", "memo", true, true]], "id": 1}' http://localhost:8091/rpc
返回结果¶
{
"ref_block_num": 61983,
"ref_block_prefix": 2781522721,
"expiration": "2018-07-06T08:03:30",
"operations": [[
30,{
"fee": {
"total": {
"amount": 2008984,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 2008984,
"asset_id": 0
}
}
},
"issuer": 223331844,
"from": 216494599,
"to": 250926091,
"amount": {
"amount": 20000,
"asset_id": 283
},
"memo": {
"from": "YYW5jiVsASqAyUibUb8awgDapFqfjQJo3SfvTEPJHxir8r3ggVtZU",
"to": "YYW8Z8rtp7oEZFJi7Ar9HC4r4d15jXCVTQ2CAosjSnkSFdbc74GJ3",
"nonce": "9585190871224727019",
"message": "b0e7b1997c2142125c0369c4304a33c1"
}
}
]
],
"signatures": [
"20008db33ea71863fc7f4b97763a34e96e8b9d87714b1445d33c34a6b7bb3015c14d0a130c1ee74946c19b5e992c02249872e1bf601ca24380ebef22e5119a2894"
]
}
2.5 广告类 API¶
2.5.1 creat_advertising¶
平台账户创建一个新的广告位。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform_account: | |
---|---|
账号 uid 或者昵称; | |
ad_desc: | 广告描述; |
unit_price: | 单位时间的价格; |
unit_time: | 单位时间; |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费. |
broadcast: | 是否广播 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"create_advertising",["309037055","test_content",10,100,true,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"create_advertising",["309037055","test_content",10,100,true,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 19218,
"ref_block_prefix": 1481040854,
"expiration": "2020-08-20T03:07:57",
"operations": [[
42,{
"fee": {
"total": {
"amount": 11269,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 11269,
"asset_id": 0
}
}
},
"advertising_aid": 4,
"platform": 309037055,
"unit_time": 100,
"unit_price": 1000000,
"description": "test_content"
}
]
],
"signatures": [
"200ae5264dc2a7f5ee834eb03b5d96110caa3cd010f8463bb8035553734bbceadc794a4f2c8be36bf27c3324e967e7af95bb2f85b5312db98e276209866a09b57d"
]
}
}
2.5.2 update_advertising¶
平台账户编辑广告位信息,上架、下架广告位。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform_account: | |
---|---|
账号 uid 或者昵称; | |
advertising_aid: | |
广告的ID; | |
ad_desc: | 广告的描述; |
unit_price: | 单位时间的价格; |
unit_time: | 单位时间; |
on_sale: | 是否在售; |
csaf_fee: | 是否使用积分抵扣手续费,true: 积分抵扣手续费,false: 零钱支付手续费; |
broadcast: | 是否广播。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"update_advertising",["309037055","1","ad_update",100,100,"",true,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"update_advertising",["309037055","1","ad_update",100,100,"",true,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 20149,
"ref_block_prefix": 1435609923,
"expiration": "2020-08-20T03:54:30",
"operations": [[
43,{
"fee": {
"total": {
"amount": 10976,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 10976,
"asset_id": 0
}
}
},
"platform": 309037055,
"advertising_aid": 1,
"description": "ad_update",
"unit_price": 10000000,
"unit_time": 100
}
]
],
"signatures": [
"205d6deef94b961d74051e872b470b42200013eec055c913dd3949a0a803c8e07247a795fe685c9a54a83e9c834d51907e09026c6bf9971ae6f0b3437aac2a172e"
]
}
}
2.5.3 list_advertisings¶
列出平台账户所有的广告位。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform_account: | |
---|---|
平台账号的id; | |
advertising_aid: | |
起始广告的ID; | |
limit: | 要展示的数量上限; |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"list_advertisings",["309037055",0,10]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"list_advertisings",["309037055",0,10]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [{
"id": "2.18.0",
"advertising_aid": 1,
"platform": 309037055,
"on_sell": true,
"unit_time": 100,
"unit_price": 10000000,
"description": "ad_update",
"last_order_sequence": 0,
"publish_time": "2020-08-20T02:49:27",
"last_update_time": "2020-08-20T03:52:48"
},{
"id": "2.18.1",
"advertising_aid": 2,
"platform": 309037055,
"on_sell": true,
"unit_time": 100,
"unit_price": 1000000,
"description": "test_content1",
"last_order_sequence": 0,
"publish_time": "2020-08-20T02:52:18",
"last_update_time": "2020-08-20T02:52:18"
}
]
}
2.5.4 list_advertising_orders_by_purchaser¶
列出特定账户发起的购买广告位的列表。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
purchaser: | 广告购买者账号的id; |
---|---|
advertising_order_id: | |
起始广告订单的ID; | |
limit: | 要展示的数量上限; |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"list_advertising_orders_by_purchaser",["309037055",0,10]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"list_advertising_orders_by_purchaser",["309037055",0,10]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result":
}
2.5.5 list_advertising_orders_by_ads_aid¶
列出特定广告位收到的购买订单列表。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 广告所在平台账号的id; |
---|---|
ads_id: | 广告位的ID; |
ads_id: | 起始广告订单的ID; |
limit: | 要展示的数量上限; |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"list_advertising_orders_by_ads_aid",["309037055",0,0,10]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"list_advertising_orders_by_ads_aid",["309037055",0,0,10]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result":
}
2.5.6 buy_advertising¶
购买广告位。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
acount: | 账户id; |
---|---|
platform: | 平台账户的id; |
ads_id: | 广告的id; |
start_time: | 广告开始时间; |
buy_number: | 购买数目; |
extra_data: | 额外信息; |
memo_data: | memo信息; |
csaf_fee: | 是否用积分付手续费:true,用积分付;否,用余额支付; |
broadcast: | 是否广播。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"buy_advertising",["309037055","309037055",1,155197400,30,extramessage,null,true,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"buy_advertising",["309037055","309037055",1,155197400,30,extramessage,null,true,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result":
}
2.5.7 confirm_advertising¶
平台确认是否同意购买订单,或者拒绝购买订单。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 平台账户的id; |
---|---|
ads_id: | 广告的id; |
ads_order_oid: | 广告订单id; |
confirm: | 是否确认; |
csaf_fee: | 是否用积分付手续费:true,用积分付;否,用余额支付; |
broadcast: | 是否广播。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"confirm_advertising",["309037055",1,1,true,true,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"confirm_advertising",["309037055",1,1,true,true,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result":
}
2.5.8 ransom_advertising¶
在广告订单提交七天内未得到回复后,用户可以赎回所在订单里面的金额。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 平台账户的id; |
---|---|
account: | 发起订单用户的id |
ads_id: | 广告的id; |
ads_order_oid: | 广告订单id; |
csaf_fee: | 是否用积分付手续费:true,用积分付;否,用余额支付; |
broadcast: | 是否广播。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"ransom_advertising",["309037055","309037055",1,1,true,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"ransom_advertising",["309037055","309037055",1,1,true,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result":
}
2.6 平台管理类 API¶
2.6.1 create_liscense¶
平台账户创建一个新的许可。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
license_type: | 许可类型 |
---|---|
hash_value: | 许可的Hash值 |
title: | 许可的标题 |
body: | 许可的内容 |
extra_data: | 额外内容 |
csaf_fee: | 是否使用积分支付手续费。true,积分付手续费;false,余额付手续费。 |
broadcast: | 是否广播。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"create_license",["309037055",1,123456789,"license_one","licensebody","licenseextra",false,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"create_license",["309037055",1,123456789,"license_one","licensebody","licenseextra",false,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 48964,
"ref_block_prefix": 953879366,
"expiration": "2020-08-21T03:55:15",
"operations": [[
41,{
"fee": {
"total": {
"amount": 14587,
"asset_id": 0
}
},
"license_lid": 1,
"platform": 309037055,
"type": 1,
"hash_value": "123456789",
"extra_data": "licenseextra",
"title": "license_one",
"body": "licensebody"
}
]
],
"signatures": [
"20502916d94e25403f2faca0c93b5040853d9cea4eeb58b12a6bb954bdc3f2e50d4580b818cdcc1b89c6e91382f62af4335dd268ac9b1a6bdc78f2ac03139039c6"
]
}
}
2.7 内容类 API¶
2.7.1 create_post¶
平台账户创建一个新的广告位。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 平台账户的id; |
---|---|
poster: | 文章作者账户的id |
hash_value: | 文章的Hash值; |
title: | 文章标题; |
body: | 文章内容; |
extra_data: | 额外内容 |
original_platform: | |
文章原平台 | |
original_poster: | |
文章原作者 | |
original_id: | 文章原id |
post_create_ext: | |
文章创建的扩展结构,详见下文文章创建扩展结构。 | |
broadcast: | 是否广播。 |
其中文章创建扩展结构
post_create_ext{
uint8_t post_type = post_operation::Post_Type_Post; //文章类型
optional<std::string> forward_price; //转发价格
optional< map<account_uid_type, receiptor_ext> > receiptors; //受益人列表
optional<license_lid_type> license_lid; //文章许可id
uint32_t permission_flags = //文章开放的权限
post_object::Post_Permission_Forward | //文章允许转发
post_object::Post_Permission_Liked | //文章允许点赞
post_object::Post_Permission_Buyout | //文章允许买断
post_object::Post_Permission_Comment | //文章允许评论
post_object::Post_Permission_Reward; //文章允许打赏
optional<string> sign_platform; //扩展:由平台账户代签
};
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"create_post",["309037055","309037055",987456321,"postname","postbody","postextry","","","",{post_type:0,forward_price:null,receiptors:null,license_lid :1,permission_flags:255,sign_platform:null},false,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"create_post",["309037055","309037055",987456321,"postname","postbody","postextry","","","",{post_type:0,forward_price:null,receiptors:null,license_lid :1,permission_flags:255,sign_platform:null},false,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 49241,
"ref_block_prefix": 4121157896,
"expiration": "2020-08-21T04:09:06",
"operations": [[
18,{
"fee": {
"total": {
"amount": 10446,
"asset_id": 0
}
},
"post_pid": 1,
"platform": 309037055,
"poster": 309037055,
"hash_value": "987456321",
"extra_data": "postextry",
"title": "postname",
"body": "postbody",
"extensions": {
"post_type": 0,
"license_lid": 1,
"permission_flags": 255
}
}
]
],
"signatures": [
"207c8cf46c205005b117a6f0df2ed5624985997db50c0654cd964a423af032b74f0a45ab65fd923d1fb3cb837eaa4dbedbe4fde773dd9b33f1a9a0bee53de83c58",
"2028adf0a8d80a2767e6d82322a772a2a8bfffcfb9fdc7b2193a675dbed8533d7674ad25f0890daea77b3e0496299e732fc3a65dd9fa964f03dfb02b7a5b7ef2af"
]
}
}
2.7.2 update_post¶
用于更新文章内容,开发权限,许可id,转发价以及受益人出售收益的挂单.
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 文章所在平台的账户id; |
---|---|
poster: | 文章作者账户的id |
post_pid: | 文章的id |
hash_value: | 文章的Hash值; |
title: | 文章标题; |
body: | 文章内容; |
extra_data: | 额外内容; |
post_update_ext: | |
文章更新的扩展结构,详见下文文章更新扩展结构; | |
csaf_fee: | 是否使用积分支付手续费。true,积分付手续费;false,余额付手续费。 |
broadcast: | 是否广播。 |
文章更新的扩展结构
post_update_ext{
optional<std::string> forward_price; //更新转发价,需要作者签名
optional<std::string> receiptor; //更新的目标受益人,收益人相关内容更新,需要该收益人签名
optional<bool> to_buyout; //更新是否出售收益,需要目标收益人签名
optional<uint16_t> buyout_ratio; //更新出售收益比率,需要目标收益人签名
optional<std::string> buyout_price; //更新出售收益价格,需要目标收益人签名
optional<time_point_sec> buyout_expiration; //更新出售收益过期时间,需要目标收益人签名
optional<license_lid_type> license_lid; //更新文章许可id ,需要作者签名
optional<uint32_t> permission_flags; //更新文章开放权限 ,需要作者签名
optional<string> content_sign_platform; //由平台代签内容更新
optional<string> receiptor_sign_platform;//由平台代签收益人参数更新
};
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"update_post",["309037055","309037055",2,,"","","","",{forward_price : 500, receiptor : 309037055, to_buyout : true, buyout_ratio : 30, buyout_price : 300, buyout_expiration : 1546272000, license_lid : 1, permission_flags : null, content_sign_platform :null, receiptor_sign_platform :null},true,ture]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"update_post",["309037055","309037055",2,,"","","","",{forward_price : 500, receiptor : 309037055, to_buyout : true, buyout_ratio : 30, buyout_price : 300, buyout_expiration : 1546272000, license_lid : 1, permission_flags : null, content_sign_platform :null, receiptor_sign_platform :null},true,ture], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 52512,
"ref_block_prefix": 2867670362,
"expiration": "2020-08-21T06:52:39",
"operations": [[
19,{
"fee": {
"total": {
"amount": 146875,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 146875,
"asset_id": 0
}
}
},
"platform": 309037055,
"poster": 309037055,
"post_pid": 2,
"extensions": {
"forward_price": 50000000,
"receiptor": 309037055,
"to_buyout": true,
"buyout_ratio": 3000,
"buyout_price": 30000000,
"buyout_expiration": "2018-12-31T16:00:00",
"license_lid": 1
}
}
]
],
"signatures": [
"1f172368eb582b7fcf80ab201bf6d104071bb66d6be61a3b38d72ef25592c890af6e4e41029e9a1f3d383367bfa650d797739baa90b553a3aac0507117e189f1bf",
"20642a2065e398d90a54c890e9884962f0db70bfe176e8cef15d5381fd5ad61f924b29b013578b7432738c8577b135737cde194e18dd6fb9459a4ee065f2d98c6d"
]
}
}
2.7.3 get_post¶
用于对文章项目的查询。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 文章所在平台的账户id; |
---|---|
poster: | 文章作者账户的id |
post_pid: | 文章的id |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"get_post",["309037055","309037055",1]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"get_post",["309037055","309037055",1]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"id": "1.7.137",
"platform": 309037055,
"poster": 309037055,
"post_pid": 1,
"post_type": "Post_Type_Post",
"hash_value": "987456321",
"extra_data": "postextry",
"title": "postname",
"body": "postbody",
"create_time": "2020-08-21T04:07:09",
"last_update_time": "2020-08-21T04:07:09",
"receiptors": [[
309037055,{
"cur_ratio": 10000,
"to_buyout": false,
"buyout_ratio": 0,
"buyout_price": 0,
"buyout_expiration": "1969-12-31T23:59:59"
}
]
],
"license_lid": 1,
"permission_flags": 255,
"score_settlement": false
}
}
2.7.4 reward_post¶
用于个人账户对文章的打赏,打赏可以是链上任意资产。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
account: | 打赏人的账户id; |
---|---|
platform: | 文章所在平台的账户id; |
poster: | 文章作者账户的id; |
post_pid: | 文章的id; |
amount: | 打赏的数额; |
asset_symbol: | 打赏的资产名字; |
sign_platform: | 可选项,平台代签点赞文章内容; |
csaf_fee: | 是否使用积分支付手续费。true,积分付手续费;false,余额付手续费。 |
broadcast: | 是否广播。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"reward_post",["309037055","309037055","309037055",2,1000,"YOYO",NULL,true,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"reward_post",["309037055","309037055","309037055",2,1000,"YOYO",NULL,true,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 55286,
"ref_block_prefix": 3782910134,
"expiration": "2020-08-21T09:11:21",
"operations": [[
38,{
"fee": {
"total": {
"amount": 10000,
"asset_id": 0
}
},
"from_account_uid": 309037055,
"platform": 309037055,
"poster": 309037055,
"post_pid": 2,
"amount": {
"amount": 100000000,
"asset_id": 0
}
}
]
],
"signatures": [
"1f599bcdc9a2fd6b19badecd369948c114b295800e60897fdc6f6caf5aea417ff84b37d363636087602852af01b4e550b52c4ca45c53a51ef9b29d4ebe35e62900"
]
}
}
2.7.5 get_license¶
用于查询平台特定license项目。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 文章平台的账户id; |
---|---|
license_lid: | 许可的id; |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"get_license",["309037055","1"]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"get_license",["309037055","1"]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"id": "2.17.6",
"license_lid": 1,
"platform": 309037055,
"license_type": 1,
"hash_value": "123456789",
"extra_data": "licenseextra",
"title": "license_one",
"body": "licensebody",
"create_time": "2020-08-21T03:53:18"
}
}
2.7.6 list_licenses¶
用于查询平台license项目。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 文章平台的账户id; |
---|---|
license_lid: | 起始许可的id; |
limit: | 展示的数目 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"list_licenses",["309037055",2.17.6,1]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"list_licenses",["309037055",2.17.6,1]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [{
"id": "2.17.6",
"license_lid": 1,
"platform": 309037055,
"license_type": 1,
"hash_value": "123456789",
"extra_data": "licenseextra",
"title": "license_one",
"body": "licensebody",
"create_time": "2020-08-21T03:53:18"
}
]
}
2.7.7 get_posts_count¶
用于查询平台特定账户的文章数量。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 文章平台的账户id; |
---|---|
poster: | 用户的id; |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"get_posts_count",["309037055","309037055"]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"get_posts_count",["309037055","309037055"]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": 2
}
2.7.8 account_auth_platform¶
账户授予平台的零钱使用限额,以及授予平台的各类操作权限。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
account: | 文章平台的账户id; |
---|---|
platform_pid: | 用户的id; |
memo: | memo信息; |
limit_for_platform: | |
授予平台的零钱限额; | |
permission_flags: | |
授予平台的权限,详情见下; | |
csaf_fee: | 使用积分付手续费。true,积分付手续费;false,余额付手续费; |
broadcast: | 是否广播。 |
permission_flags权限详情:
account_auth_platform_object::Platform_Permission_Forward | //转帖权
account_auth_platform_object::Platform_Permission_Liked | //点赞权
account_auth_platform_object::Platform_Permission_Buyout | //买断权
account_auth_platform_object::Platform_Permission_Comment | //评论权
account_auth_platform_object::Platform_Permission_Reward | //打赏权
account_auth_platform_object::Platform_Permission_Post, //发贴权
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"account_auth_platform",["309037055","309037055","MEMO",10000,255,true,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"account_auth_platform",["309037055","309037055","MEMO",10000,255,true,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 3179,
"ref_block_prefix": 4066884465,
"expiration": "2020-08-24T02:59:36",
"operations": [[
23,{
"fee": {
"total": {
"amount": 100000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 100000,
"asset_id": 0
}
}
},
"uid": 309037055,
"platform": 309037055,
"extensions": {
"limit_for_platform": 1000000000,
"permission_flags": 255,
"memo": {
"from": "YYW85x3LxSJafzbEMVjtkVy7ZdTTSi7QuY4KseM9PKWTVZK7fJwpa",
"to": "YYW85x3LxSJafzbEMVjtkVy7ZdTTSi7QuY4KseM9PKWTVZK7fJwpa",
"nonce": "17727766371187465601",
"message": "8f6523b9dc991bd7fc842740d68609d6"
}
}
}
]
],
"signatures": [
"1f5cdc640e66b1fc9a6c4869935b1fddb47d320e36737fd44f37b126cb7e04e2be4b69c29b9d037fa25865742e8217f6559d2be8b92dfba0dc5e5f28907b94b875"
]
}
}
2.7.9 score_a_post¶
用于账户对文章帖子点赞打分,打分范围为-5~5,需要花费账户积分。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
from_account: | 点赞发起人的id; |
---|---|
platform: | 文章平台的账户id; |
poster: | 用户的id; |
post_pid: | 文章的id |
score: | 打的分数,范围从-5到5 |
csaf: | 支付的积分; |
sign_by_platform: | |
可选项,由平台代签。默认为null; | |
csaf_fee: | 使用积分付手续费。true,积分付手续费;false,余额付手续费; |
broadcast: | 是否广播。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"score_a_post",["309037055","309037055","500545326",1,5,10,null,true,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"score_a_post",["309037055","309037055","500545326",1,5,10,null,true,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 13248,
"ref_block_prefix": 3577965138,
"expiration": "2020-08-24T11:23:03",
"operations": [[
37,{
"fee": {
"total": {
"amount": 10000,
"asset_id": 0
},
"options": {
"from_csaf": {
"amount": 10000,
"asset_id": 0
}
}
},
"from_account_uid": 309037055,
"platform": 309037055,
"poster": 500545326,
"post_pid": 1,
"score": 5,
"csaf": 1000000
}
]
],
"signatures": [
"1f541290c8a297938ba7258f585d5cff065e738607f854106fdfcc18c49922ddb14e847b69f0740fcbe8590a7ed61aa37095c32577902e4c2ddefddd0ef05c45d4",
"20017f65f962612d1207d113290a87abe3c33fadf13bdbd2debfd2ed1a0c35d27a36ffd99958ab07a5bccca8453dcc1a8b5a521bba4de5267f9fbeaf35d6fd4959"
]
}
}
2.7.10 buyout_post¶
用于买断特定文章受益人的收益比。其中买断的受益人receiptor_account,必须先完成出售文章受益的有效挂单,参见update_post操作。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
from_account: | 买断发起人的id; |
---|---|
platform: | 文章所发布的平台账户; |
poster: | 用户的id; |
post_pid: | 文章id; |
receiptor_account: | |
要被买断的文章原有收益人的id | |
sign_platform: | 可选项,平台代签,默认填null; |
csaf_fee: | 使用积分付手续费。true,积分付手续费;false,余额付手续费; |
broadcast: | 是否广播。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"buyout_post",["500545326","309037055","309037055",1,"309037055",null,false,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"buyout_post",["500545326","309037055","309037055",1,"309037055",null,false,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 36148,
"ref_block_prefix": 2436977284,
"expiration": "2020-08-25T06:28:03",
"operations": [[
40,{
"fee": {
"total": {
"amount": 10000,
"asset_id": 0
}
},
"from_account_uid": 500545326,
"platform": 309037055,
"poster": 309037055,
"post_pid": 1,
"receiptor_account_uid": 309037055
}
]
],
"signatures": [
"202f1263f5c3ed62aaeea5ddd59380ec301c88a7350c06df1c1fe67a06779333f32c138ae343cf8260c438caadb04e577a600e9dda818ee7c2c3cf0705859fce32",
"202d144a7d068c98fc45dbe28fd87e296d2b4c32f36e01cef46932b48847ae867d4b01cc3c0418d31d8cb63aad62867e8e16fed0e9c754c5b76d79a8769179de2f"
]
}
}
2.7.11 get_score¶
用于查询平台特定账户给特定文章的评分。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 文章平台的账户id; |
---|---|
poster: | 文章作者的id; |
post_pid: | 文章的id; |
from_account: | 打分账户的id。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"get_score",["309037055","500545326",1,309037055]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"get_score",["309037055","500545326",1,309037055]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"id": "2.16.153",
"from_account_uid": 309037055,
"platform": 309037055,
"poster": 500545326,
"post_pid": 1,
"score": 5,
"csaf": 1000000,
"period_sequence": 0,
"profits": 0,
"create_time": "2020-08-24T11:21:06"
}
}
2.7.12 get_posts_by_platform_poster¶
用于查询平台特定账户所发布的全部文章信息。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 文章平台的账户id; |
---|---|
poster: | 文章作者的id; |
lower_bound_post: | |
限定要查询的编号最大的文章的id; | |
limit: | 要展示的数目。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"get_posts_by_platform_poster",["309037055","500545326",1.7.155,10]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"get_posts_by_platform_poster",["309037055","500545326",1.7.155,10]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [{
"id": "1.7.141",
"platform": 309037055,
"poster": 500545326,
"post_pid": 1,
"post_type": "Post_Type_Post",
"hash_value": "987456321",
"extra_data": "postextry",
"title": "postname",
"body": "postbody",
"create_time": "2020-08-24T04:36:21",
"last_update_time": "2020-08-24T04:36:21",
"receiptors": [[
309037055,{
"cur_ratio": 2500,
"to_buyout": false,
"buyout_ratio": 0,
"buyout_price": 0,
"buyout_expiration": "1969-12-31T23:59:59"
}
],[
500545326,{
"cur_ratio": 7500,
"to_buyout": false,
"buyout_ratio": 0,
"buyout_price": 0,
"buyout_expiration": "1969-12-31T23:59:59"
}
]
],
"license_lid": 1,
"permission_flags": 255,
"score_settlement": false
}
]
}
2.7.13 list_scores¶
用于查询平台特定文章的限定数量的评分。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
platform: | 文章平台的账户id; |
---|---|
poster: | 文章作者的id; |
post_pid: | 文章的id; |
lower_bound_score: | |
起始打分行为的id; | |
limit: | 展示数目限制; |
list_cur_period: | |
是否仅展示当前收益分配周期的点赞。true:只展示当前周期点赞;false:展示所有点赞。 |
注意事项¶
无
调用样例及调试工具¶
WebSocket:
wscat -c ws://localhost:8091
{{"id":1, "method":"call", "params":[0,"list_scores",["309037055","500545326",1,1.7.0,10,true]]}
JSON-RPC:
curl --data '{"jsonrpc": "2.0", "method": "call", "params":[0,"list_scores",["309037055","500545326",1,1.7.0,10,true]], "id": 1}' http://localhost:8093
返回结果¶
{
"id": 1,
"jsonrpc": "2.0",
"result": [{
"id": "2.16.153",
"from_account_uid": 309037055,
"platform": 309037055,
"poster": 500545326,
"post_pid": 1,
"score": 5,
"csaf": 1000000,
"period_sequence": 0,
"profits": 0,
"create_time": "2020-08-24T11:21:06"
}
]
}
2.7.14 get_post_profits_detail¶
用于查询平台特定文章在特定周期内的收益。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
begin_period: | 开始周期号; |
---|---|
end_period: | 截止周期号; |
platform: | 平台ID或名字; |
poster: | 作者的账户ID或名字; |
post_pid: | 文章的ID; |
注意事项¶
无
2.7.15 get_platform_profits_detail¶
查询从起始周期到截至周期的平台的所有收益详情。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
begin_period: | 开始周期号; |
---|---|
end_period: | 截止周期号; |
platform: | 平台ID或名字; |
lower_bound_index: | |
起始活动序号; | |
limits: | 显示的文章数目; |
注意事项¶
无
2.7.16 get_poster_profits_detail¶
查询从起始周期到截至周期的作者的所有收益详情。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
begin_period: | 开始周期号; |
---|---|
end_period: | 截止周期号; |
poster: | 作者ID或名字; |
lower_bound_index: | |
起始活动序号; | |
limits: | 显示的文章数目; |
注意事项¶
无
2.7.17 get_score_profit¶
查询某账户在某收益周期的点赞总收入。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
account: | 账户的名称或ID; |
---|---|
period: | 收益分配的周期号。 |
注意事项¶
无
2.7.17 account_manage¶
用于对平台账户的管理。
支持格式¶
JSON
请求方式¶
WebSocket; JSON-RPC
所需密钥权限¶
wallet需要处于unlocked状态
访问授权限制¶
请求参数¶
executor: | 管理员账户的id或名字; |
---|---|
account: | 所管理的账户; |
opt: | 权限选项,详见下; |
csaf_fee: | 使用积分付手续费。true,积分付手续费;false,余额付手续费; |
broadcast: | 是否广播。 |
其中权限选项:
struct opt
{
optional< bool > can_post; //允许发帖
optional< bool > can_reply; //允许回复
optional< bool > can_rate; //允许点赞
};