php: https://github.com/tronprotocol/Documentation/blob/master/TRX_CN/index.php
solidityNode默认的http端口是8091,启动solidityNode的时候会同时启动http服务。
/walletsolidity/getaccount
作用:查询一个账号的信息
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getaccount -d '{"address": "41E552F6487585C2B58BC2C9BB4492BC1F17132CD0"}'
参数说明:address 需要转为hexString
返回值:Account对象
/walletsolidity/listwitnesses
作用:查询超级代表列表
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/listwitnesses
参数说明:
返回值:所有超级代表列表
/walletsolidity/getassetissuelist
作用:查询所有Token列表
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getassetissuelist
参数说明:
返回值:所有Token列表
/walletsolidity/getpaginatedassetissuelist
作用:分页查询Token列表
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getpaginatedassetissuelist -d '{"offset": 0, "limit":10}'
参数说明:offset是起始Token的index,limit是期望返回的Token数量
返回值:Token列表
/walletsolidity/getassetissuebyname(Odyssey-v3.2开始支持)
作用:根据名称查询token。
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getassetissuebyname -d '{"value": "44756354616E"}'
参数说明:通证名称,格式为hexString。
返回值:token。
注意:Odyssey-v3.2开始,推荐使用getassetissuebyid或者getassetissuelistbyname替换此接口,因为从3.2开始将允许通证名称相同。如果存在相同的通证名称,此接口将会报错。
/walletsolidity/getassetissuelistbyname(Odyssey-v3.2开始支持)
作用:根据名称查询token list。
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getassetissuelistbyname -d '{"value": "44756354616E"}'
参数说明:通证名称,格式为hexString。
返回值:token列表。
/walletsolidity/getassetissuebyid(Odyssey-v3.2开始支持)
作用:根据id查询token。
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getassetissuebyid -d '{"value": "1000001"}'
参数说明:通证id,格式为String。
返回值:token。
/walletsolidity/getnowblock
作用:查询最新block
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getnowblock
参数说明:
返回值:solidityNode上的最新block
/walletsolidity/getblockbynum
作用:按照高度查询block
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getblockbynum -d '{"num" : 100}'
参数说明:num是块的高度
返回值:指定高度的block
/walletsolidity/gettransactionbyid
作用:根据id查询交易
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/gettransactionbyid -d '{"value" : "309b6fa3d01353e46f57dd8a8f27611f98e392b50d035cef213f2c55225a8bd2"}'
参数说明:value是交易id,需要是hexString
返回值:指定ID的Transaction
/walletsolidity/gettransactioncountbyblocknum(Odyssey-v3.2开始支持)
作用:查询特定block上transaction的个数
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/gettransactioncountbyblocknum -d '{"num" : 100}'
参数说明:num是块的高度.
返回值e:transaction的个数.
/walletsolidity/gettransactioninfobyid
作用:根据id查询交易的fee,所在的block
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/gettransactioninfobyid -d '{"value" : "309b6fa3d01353e46f57dd8a8f27611f98e392b50d035cef213f2c55225a8bd2"}'
参数说明:value是交易id,需要是hexString
返回值:Transaction的交易fee,所在block的高度,创建时间
/walletsolidity/getdelegatedresource(Odyssey-v3.2开始支持)
作用:查看一个账户代理给另外一个账户的资源情况
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getdelegatedresource -d '
{
"fromAddress": "419844f7600e018fd0d710e2145351d607b3316ce9",
"toAddress": "41c6600433381c731f22fc2b9f864b14fe518b322f"
}'
参数说明:
fromAddress:是要查询的账户地址,hexString格式
toAddress:代理对象的账户地址,hexString格式
返回值:账户的资源代理的列表,列表的元素为DelegatedResource
/walletsolidity/getdelegatedresourceaccountindex(Odyssey-v3.2开始支持)
作用:查看一个账户的资源代理情况
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getdelegatedresourceaccountindex -d '
{
"value": "419844f7600e018fd0d710e2145351d607b3316ce9",
}'
参数说明:
value:是要查询的账户地址,hexString格式
返回值:账户的DelegatedResourceAccountIndex
/walletsolidity/getexchangebyid(Odyssey-v3.2开始支持)
作用:根据id查询交易对
demo:curl -X POST http://127.0.0.1:8091/walletsolidity/getexchangebyid -d {"id":1}
参数说明:
id:交易对id
返回值:交易对
/walletsolidity/listexchanges(Odyssey-v3.2开始支持)
作用:查询所有交易对
demo:curl -X POST http://127.0.0.1:8091/walletsolidity/listexchanges
参数说明:
返回值:所有交易对
/walletextension/gettransactionsfromthis(新版本将不再支持)
作用:查询某个账号的出账交易记录
demo: curl -X POST http://127.0.0.1:8091/walletextension/gettransactionsfromthis -d '{"account"
: {"address" : "41E552F6487585C2B58BC2C9BB4492BC1F17132CD0"}, "offset": 0, "limit": 10,"startTime": 1546099200000, "endTime": 1552028828000}'
参数说明:address是账号地址,需要是hexString格式;offset是起始交易的index,不能大于10000,否则报错;limit是期望返回的交易数量,最大为50
,这个值可能会调整。当limit>50,或offset+limit>10000时,调整后满足limit<=50且offset+limit<=10000,startTime
:起始时间,endTime:结束时间,获取[startTime,endTime]时间段的交易。如果不传递,默认获取获取最近7天内的交易
返回值:Transaction列表,按交易创建时间的降序排列,total在[startTime,endTime]时间段内允许分页的最大交易数,rangeTotal在[startTime,
endTime]时间段内的所有交易数。
备注:该接口在新版本节点中将不再提供,如需要该功能,可以使用中心节点提供的接口,47.90.247.237:8091/walletextension/gettransactionsfromthis,
使用参考getTransactionsFromThis。
/walletextension/gettransactionstothis(新版本将不再支持)
作用:查询某个账号的入账交易记录
demo: curl -X POST http://127.0.0.1:8091/walletextension/gettransactionstothis -d '{"account" :
{"address" : "41E552F6487585C2B58BC2C9BB4492BC1F17132CD0"}, "offset": 0, "limit": 10,"startTime": 1546099200000, "endTime": 1552028828000}'
参数说明:address是账号地址,需要是hexString格式;offset是起始交易的index;limit是期望返回的交易数量,最大为50,这个值可能会调整。当limit>50
,或offset+limit>10000时,调整后满足limit<=50且offset+limit<=10000,startTime:起始时间,endTime
:结束时间,获取[startTime,endTime]时间段的交易。如果不传递,默认获取获取最近7天内的交易
返回值:Transaction列表,按交易创建时间的降序排列,total在[startTime,endTime]时间段内允许分页的最大交易数,rangeTotal在[startTime,
endTime]时间段内的所有交易数。
备注:该接口在新版本节点中将不再提供,如需要该功能,可以使用中心节点提供的接口,47.90.247.237:8091/walletextension/gettransactionstothis,
使用参考getTransactionsToThis。
/wallet/getnodeinfo(Odyssey-v3.2开始支持)
作用:获取当前node的信息
demo: curl -X GET http://127.0.0.1:8091/wallet/getnodeinfo
参数说明:无
返回值:当前节点的信息NodeInfo
FullNode默认的http端口是8090,启动FullNode的时候会同时启动http服务。
wallet/createtransaction
作用: 创建一个转账的Transaction,如果转账的to地址不存在,则在区块链上创建该账号
demo: curl -X POST http://127.0.0.1:8090/wallet/createtransaction -d '{"to_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d", "owner_address": "41D1E7A6BC354106CB410E65FF8B181C600FF14292", "amount": 1000 }'
参数说明:to_address是转账转入地址,需要转为hexString;owner_address是转账转出地址,需要转为hexString;amount是转账数量
返回值:转账合约
/wallet/gettransactionsign
作用:对交易签名,该api有泄漏private key的风险,请确保在安全的环境中调用该api
demo: curl -X POST http://127.0.0.1:8090/wallet/gettransactionsign -d '{
"transaction" : {"txID":"454f156bf1256587ff6ccdbc56e64ad0c51e4f8efea5490dcbc720ee606bc7b8","raw_data":{"contract":[{"parameter":{"value":{"amount":1000,"owner_address":"41e552f6487585c2b58bc2c9bb4492bc1f17132cd0","to_address":"41d1e7a6bc354106cb410e65ff8b181c600ff14292"},"type_url":"type.googleapis.com/protocol.TransferContract"},"type":"TransferContract"}],"ref_block_bytes":"267e","ref_block_hash":"9a447d222e8de9f2","expiration":1530893064000,"timestamp":1530893006233}}, "privateKey": "your private key"
}'
参数说明:transaction是通过http api创建的合约,privateKey是用户private key
返回值:签名之后的transaction
wallet/broadcasttransaction
作用:对签名后的transaction进行广播
demo:curl -X POST http://127.0.0.1:8090/wallet/broadcasttransaction -d '{"signature":["97c825b41c77de2a8bd65b3df55cd4c0df59c307c0187e42321dcc1cc455ddba583dd9502e17cfec5945b34cad0511985a6165999092a6dec84c2bdd97e649fc01"],"txID":"454f156bf1256587ff6ccdbc56e64ad0c51e4f8efea5490dcbc720ee606bc7b8","raw_data":{"contract":[{"parameter":{"value":{"amount":1000,"owner_address":"41e552f6487585c2b58bc2c9bb4492bc1f17132cd0","to_address":"41d1e7a6bc354106cb410e65ff8b181c600ff14292"},"type_url":"type.googleapis.com/protocol.TransferContract"},"type":"TransferContract"}],"ref_block_bytes":"267e","ref_block_hash":"9a447d222e8de9f2","expiration":1530893064000,"timestamp":1530893006233}}'
参数说明:签名之后的Transaction
返回值:广播是否成功
wallet/updateaccount
作用:修改账号名称
demo:curl -X POST http://127.0.0.1:8090/wallet/updateaccount -d '{"account_name": "0x7570646174654e616d6531353330383933343635353139" ,"owner_address":"41d1e7a6bc354106cb410e65ff8b181c600ff14292"}'
参数说明:account_name是账号名称,需要是hexString格式;owner_address是要修改名称的账号地址,需要是hexString格式
返回值:修改名称的Transaction
wallet/votewitnessaccount
作用:对超级代表进行投票
demo:curl -X POST http://127.0.0.1:8090/wallet/votewitnessaccount -d '{
"owner_address":"41d1e7a6bc354106cb410e65ff8b181c600ff14292",
"votes": [{"vote_address": "41e552f6487585c2b58bc2c9bb4492bc1f17132cd0", "vote_count": 5}]
}'
参数说明:owner_address是投票人地址,需要是hexString格式;votes.vote_address是被投票的超级代表的地址,需要是hexString格式;vote_count是投票数量
wallet/createassetissue
作用:发行Token
demo:curl -X POST http://127.0.0.1:8090/wallet/createassetissue -d '{
"owner_address":"41e552f6487585c2b58bc2c9bb4492bc1f17132cd0",
"name":"0x6173736574497373756531353330383934333132313538",
"abbr": "0x6162627231353330383934333132313538",
"total_supply" :4321,
"trx_num":1,
"num":1,
"start_time" : 1530894315158,
"end_time":1533894312158,
"description":"007570646174654e616d6531353330363038383733343633",
"url":"007570646174654e616d6531353330363038383733343633",
"free_asset_net_limit":10000,
"public_free_asset_net_limit":10000,
"frozen_supply":{"frozen_amount":1, "frozen_days":2}
}'
参数说明:
owner_address发行人地址;name是token名称;abbr是token简称;total_supply是发行总量;trx_num和num是token和trx的兑换价值;start_time和end_time是token发行起止时间;description是token说明,需要是hexString格式;url是token发行方的官网,需要是hexString格式;free_asset_net_limit是Token的总的免费带宽;public_free_asset_net_limit是每个token拥护者能使用本token的免费带宽;frozen_supply是token发行者可以在发行的时候指定冻结的token
返回值:发行Token的Transaction
wallet/updatewitness
作用:修改witness的url
demo:curl -X POST http://127.0.0.1:8090/wallet/updatewitness -d '{
"owner_address":"41d1e7a6bc354106cb410e65ff8b181c600ff14292",
"update_url": "007570646174654e616d6531353330363038383733343633"
}'
参数说明:owner_address是创建人地址,需要是hexString格式;update_url是更新的官网的url,需要是hexString格式;
wallet/createaccount
作用:创建账号,一个已经激活的账号创建一个新账号,需要花费0.1trx
demo:curl -X POST http://127.0.0.1:8090/wallet/createaccount -d '{"owner_address":"41d1e7a6bc354106cb410e65ff8b181c600ff14292", "account_address": "41e552f6487585c2b58bc2c9bb4492bc1f17132cd0"}'
参数说明:owner_address是已经激活的账号,需要是hexString格式;account_address是新账号的地址,需要是hexString格式,这个地址需要事先创建好
返回值:创建账号的Transaction
wallet/createwitness
作用:申请成为超级代表
demo:curl -X POST http://127.0.0.1:8090/wallet/createwitness -d '{"owner_address":"41d1e7a6bc354106cb410e65ff8b181c600ff14292", "url": "007570646174654e616d6531353330363038383733343633"}'
参数说明:owner_address是申请成为超级代表的账号地址,需要是hexString格式;url是官网地址,需要是hexString格式
返回值:申请超级代表的Transaction
wallet/transferasset
作用:转账Token
demo:curl -X POST http://127.0.0.1:8090/wallet/transferasset -d '{"owner_address":"41d1e7a6bc354106cb410e65ff8b181c600ff14292", "to_address": "41e552f6487585c2b58bc2c9bb4492bc1f17132cd0", "asset_name": "0x6173736574497373756531353330383934333132313538", "amount": 100}'
参数说明:owner_address是token转出地址,需要是hexString格式;to_address是token转入地址,需要是hexString格式;asset_name是token名称,需要是hexString格式;amount是token转账数量
返回值:token转账的Transaction
【注意】
- 当前的asset_name为token名称。当委员会通过AllowSameTokenName提议后asset_name改为token ID的String类型。
wallet/easytransfer
作用:快捷转账,该api存在泄漏密码的风险,请确保在安全的环境中调用该api。调用该api前请先调用createAddress生成地址。
demo:curl -X POST http://127.0.0.1:8090/wallet/easytransfer -d '{
"passPhrase": "your password",
"toAddress": "41e552f6487585c2b58bc2c9bb4492bc1f17132cd0",
"amount":100
}'
参数说明:passPhrase是用户密码,需要是hexString格式;toAddress是转入地址,需要是hexString格式;amount是转账trx数量
返回值:对应的Transaction和广播是否成功的状态
wallet/easytransferasset
作用:快捷转账,该api存在泄漏密码的风险,请确保在安全的环境中调用该api。调用该api前请先调用createAddress生成地址。
demo:curl -X POST http://127.0.0.1:8090/wallet/easytransferasset -d '{
"passPhrase": "your password",
"toAddress": "41e552f6487585c2b58bc2c9bb4492bc1f17132cd0",
"assetId": "1000001",
"amount":100
}'
参数说明:passPhrase是用户密码,需要是hexString格式;toAddress是转入地址,需要是hexString格式;assetId是通证的ID;amount是转账通证数量,单位是通证的最小单位。
返回值:对应的Transaction和广播是否成功的状态
wallet/createaddress
作用:通过密码创建地址,该api存在泄漏密码的风险,请确保在安全的环境中调用该api。
demo:curl -X POST http://127.0.0.1:8090/wallet/createaddress -d '{"value": "3230313271756265696a696e67"}'
参数说明:value是用户密码,需要是hexString格式
返回值:一个地址
wallet/participateassetissue
作用:参与token发行
demo:curl -X POST http://127.0.0.1:8090/wallet/participateassetissue -d '{
"to_address": "41e552f6487585c2b58bc2c9bb4492bc1f17132cd0",
"owner_address":"41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
"amount":100,
"asset_name":"3230313271756265696a696e67"
}'
参数说明:
to_address是Token发行人的地址,需要是hexString格式
owner_address是参与token人的地址,需要是hexString格式
amount是参与token的数量
asset_name是token的名称,需要是hexString格式
返回值:参与token发行的transaction
【注意】
- 当前的asset_name为token名称。当委员会通过AllowSameTokenName提议后asset_name改为token ID的String类型。
wallet/freezebalance
作用:冻结trx,获取带宽,获取投票权
demo:curl -X POST http://127.0.0.1:8090/wallet/freezebalance -d '{
"owner_address":"41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
"frozen_balance": 10000,
"frozen_duration": 3,
"resource" : "BANDWIDTH",
"receiver_address":"414332f387585c2b58bc2c9bb4492bc1f17342cd1"
}'
参数说明:
owner_address是冻结trx账号的地址,需要是hexString格式
frozen_balance是冻结trx的数量
frozen_duration是冻结天数,最少是3天
resource: 冻结trx获取资源的类型(可以是BANDWIDTH或者ENERGY,BANDWIDTH为带宽,ENERGY为虚拟机消耗资源)
receiverAddress表示受委托账户的地址
返回值:冻结trx的transaction
【注意】资源委托功能需要委员会开启
wallet/unfreezebalance
作用:解冻已经结束冻结期的trx,会同时失去这部分trx带来的带宽和投票权
demo:curl -X POST http://127.0.0.1:8090/wallet/unfreezebalance -d '{
"owner_address":"41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
"resource": "BANDWIDTH",
"receiver_address":"414332f387585c2b58bc2c9bb4492bc1f17342cd1"
}'
参数说明:
owner_address是解冻trx账号的地址,需要是hexString格式
resource可以是BANDWIDTH或者ENERGY
ress表示受委托账户的地址
返回值:解冻trx的transaction
【注意】资源委托功能需要委员会开启
wallet/unfreezeasset
作用:解冻已经结束冻结期的Token
demo:curl -X POST http://127.0.0.1:8090/wallet/unfreezeasset -d '{
"owner_address":"41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
}'
参数说明:
owner_address是解冻token账号的地址,需要是hexString格式
返回值:解冻token的transaction
wallet/withdrawbalance
作用:超级代表提现奖励到balance,每24个小时可以提现一次
demo:curl -X POST http://127.0.0.1:8090/wallet/withdrawbalance -d '{
"owner_address":"41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
}'
参数说明:
owner_address是提现账号的地址,需要是hexString格式
返回值:提现Trx的transaction
wallet/updateasset
作用:修改token信息
demo:curl -X POST http://127.0.0.1:8090/wallet/updateasset -d '{
"owner_address":"41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
"description": "",
"url": "",
"new_limit" : 1000000,
"new_public_limit" : 100
}'
参数说明:
owner_address是token发行人的地址,需要是hexString格式
description是token的描述,需要是hexString格式
url是token发行人的官网地址,需要是hexString格式
new_limit是token每个持有人能够使用的免费带宽
new_public_limit是该token全部的免费带宽
返回值:修改Token信息的transaction
wallet/listnodes
作用:查询api所在机器连接的节点。
demo: curl -X POST http://127.0.0.1:8090/wallet/listnodes
参数说明:无
返回值:节点列表。
wallet/getassetissuebyaccount
作用:查询账户发行的token。
demo: curl -X POST http://127.0.0.1:8090/wallet/getassetissuebyaccount -d '{"address": "41F9395ED64A6E1D4ED37CD17C75A1D247223CAF2D"}'
参数说明:发行者账户地址,格式为hexString。
返回值:用户发行的token(一个用户只能发行一个token)。
wallet/getaccountnet
作用:查询带宽信息。
demo: curl -X POST http://127.0.0.1:8090/wallet/getaccountnet -d '{"address": "4112E621D5577311998708F4D7B9F71F86DAE138B5"}'
参数说明:账户地址,格式为hexString。
返回值:带宽信息。
wallet/getassetissuebyname
作用:根据名称查询token。
demo: curl -X POST http://127.0.0.1:8090/wallet/getassetissuebyname -d '{"value": "44756354616E"}'
参数说明:通证名称,格式为hexString。
返回值:token。
注意:Odyssey-v3.2开始,推荐使用getassetissuebyid或者getassetissuelistbyname替换此接口,因为从3.2开始将允许通证名称相同。如果存在相同的通证名称,此接口将会报错。
wallet/getassetissuelistbyname(Odyssey-v3.2开始支持)
作用:根据名称查询token list。
demo: curl -X POST http://127.0.0.1:8090/wallet/getassetissuelistbyname -d '{"value": "44756354616E"}'
参数说明:通证名称,格式为hexString。
返回值:token列表。
wallet/getassetissuebyid(Odyssey-v3.2开始支持)
作用:根据id查询token。
demo: curl -X POST http://127.0.0.1:8090/wallet/getassetissuebyid -d '{"value": "1000001"}'
参数说明:通证id,格式为String。
返回值:token。
wallet/getnowblock
作用:查询最新块。
demo: curl -X POST http://127.0.0.1:8090/wallet/getnowblock
参数说明:无
返回值:当前块。
wallet/getblockbynum
作用:通过高度查询块
demo: curl -X POST http://127.0.0.1:8090/wallet/getblockbynum -d '{"num": 1}'
参数说明:块高度。
返回值:块。
wallet/getblockbyid
作用:通过ID查询块
demo: curl -X POST http://127.0.0.1:8090/wallet/getblockbyid -d '{"value": "0000000000038809c59ee8409a3b6c051e369ef1096603c7ee723c16e2376c73"}'
参数说明:块ID。
返回值:块。
wallet/getblockbylimitnext
作用:按照范围查询块
demo: curl -X POST http://127.0.0.1:8090/wallet/getblockbylimitnext -d '{"startNum": 1, "endNum": 2}'
参数说明:
startNum:起始块高度,包含此块
endNum:截止块高度,不包含此此块
返回值:块的列表。
wallet/getblockbylatestnum
作用:查询最新的几个块
demo: curl -X POST http://127.0.0.1:8090/wallet/getblockbylatestnum -d '{"num": 5}'
参数说明:块的数量。
返回值:块的列表。
wallet/gettransactionbyid
作用:通过ID查询交易
demo: curl -X POST http://127.0.0.1:8090/wallet/gettransactionbyid -d '{"value": "d5ec749ecc2a615399d8a6c864ea4c74ff9f523c2be0e341ac9be5d47d7c2d62"}'
参数说明:交易ID。
返回值:交易信息。
wallet/gettransactioninfobyid(Odyssey-v3.2开始支持)
作用:根据id查询交易的fee,所在的block
demo: curl -X POST http://127.0.0.1:8090/wallet/gettransactioninfobyid -d '{"value" : "309b6fa3d01353e46f57dd8a8f27611f98e392b50d035cef213f2c55225a8bd2"}'
参数说明:value是交易id,需要是hexString
返回值:Transaction的交易fee,所在block的高度,创建时间
/wallet/gettransactioncountbyblocknum(Odyssey-v3.2开始支持)
作用:查询特定block上transaction的个数
demo: curl -X POST http://127.0.0.1:8090/wallet/gettransactioncountbyblocknum -d '{"num" : 100}'
参数说明:num是块的高度.
返回值e:transaction的个数.
wallet/getaccount
作用:查询一个账号的信息
demo: curl -X POST http://127.0.0.1:8090/wallet/getaccount -d '{"address": "41E552F6487585C2B58BC2C9BB4492BC1F17132CD0"}'
参数说明:address 需要转为hexString
返回值:Account对象
wallet/listwitnesses
作用:查询所有witness列表
demo: curl -X POST http://127.0.0.1:8090/wallet/listwitnesses
参数说明:无
返回值:witness列表。
wallet/getassetissuelist
作用:查询所有token列表
demo: curl -X POST http://127.0.0.1:8090/wallet/getassetissuelist
参数说明:无
返回值:token列表。
wallet/getpaginatedassetissuelist
作用:分页查询token列表
demo: curl -X POST http://127.0.0.1:8090/wallet/getpaginatedassetissuelist -d '{"offset": 0, "limit": 10}'
参数说明:offset是起始Token的index,limit是期望返回的Token数量
返回值:token列表。
wallet/getpaginatedproposallist(Odyssey-v3.5开始支持)
作用:分页查询proposal列表
demo: curl -X POST http://127.0.0.1:8090/wallet/getpaginatedproposallist -d '{"offset": 0, "limit": 10}'
参数说明:offset是起始Token的index,limit是期望返回的Token数量
返回值:token列表。
wallet/getpaginatedexchangelist(Odyssey-v3.2开始支持)
作用:分页查询交易对列表
demo: curl -X POST http://127.0.0.1:8090/wallet/getpaginatedexchangelist -d '{"offset": 0, "limit":10}'
参数说明:offset是起始交易对的index,limit是期望返回的交易对数量
返回值:提案列表
wallet/totaltransaction
作用:统计所有交易总数
demo: curl -X POST http://127.0.0.1:8090/wallet/totaltransaction
参数说明:无
返回值:交易总数。
wallet/getnextmaintenancetime
作用:获取下次统计投票的时间
demo: curl -X POST http://127.0.0.1:8090/wallet/getnextmaintenancetime
参数说明:无
返回值:下次统计投票时间的毫秒数。
wallet/easytransferbyprivate
作用:快捷转账
demo: curl -X POST http://127.0.0.1:8090/wallet/easytransferbyprivate -d '{"privateKey": "D95611A9AF2A2A45359106222ED1AFED48853D9A44DEFF8DC7913F5CBA727366", "toAddress":"4112E621D5577311998708F4D7B9F71F86DAE138B5","amount":10000}'
参数说明:
privateKey:私钥,hexString格式
toAddress:转入账户地址,hexString格式。
amount:转账的drop数量。
返回值:交易,含执行结果。
警告:该api有泄漏private key的风险,请确保在安全的环境中调用该api。
wallet/easytransferassetbyprivate
作用:快捷转账
demo: curl -X POST http://127.0.0.1:8090/wallet/easytransferassetbyprivate -d '{"privateKey": "D95611A9AF2A2A45359106222ED1AFED48853D9A44DEFF8DC7913F5CBA727366", "toAddress":"4112E621D5577311998708F4D7B9F71F86DAE138B5",
"assetId": "1000001",
"amount":10000}'
参数说明:
privateKey:私钥,hexString格式
toAddress:转入账户地址,hexString格式。
assetId:通证ID。
amount:转账的通证数量,单位是通证的最小单位。
返回值:交易,含执行结果。
警告:该api有泄漏private key的风险,请确保在安全的环境中调用该api。
wallet/generateaddress
作用:生成私钥和地址
demo: curl -X POST http://127.0.0.1:8090/wallet/generateaddress
参数说明:无
返回值:地址和私钥
警告:该api有泄漏private key的风险,请确保在安全的环境中调用该api。
wallet/validateaddress
作用:检查地址是否正确
demo: curl -X POST http://127.0.0.1:8090/wallet/validateaddress -d '{"address": "4189139CB1387AF85E3D24E212A008AC974967E561"}'
参数说明:地址,可以是base58checksum、hexString、base64格式
返回值:地址正确或者错误
wallet/deploycontract
作用:部署合约
demo: curl -X POST http://127.0.0.1:8090/wallet/deploycontract -d '{"abi":"[{\"constant\":false,\"inputs\":[{\"name\":\"key\",\"type\":\"uint256\"},{\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"set\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"name\":\"key\",\"type\":\"uint256\"}],\"name\":\"get\",\"outputs\":[{\"name\":\"value\",\"type\":\"uint256\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}]","bytecode":"608060405234801561001057600080fd5b5060de8061001f6000396000f30060806040526004361060485763ffffffff7c01000000000000000000000000000000000000000000000000000000006000350416631ab06ee58114604d5780639507d39a146067575b600080fd5b348015605857600080fd5b506065600435602435608e565b005b348015607257600080fd5b50607c60043560a0565b60408051918252519081900360200190f35b60009182526020829052604090912055565b600090815260208190526040902054905600a165627a7a72305820fdfe832221d60dd582b4526afa20518b98c2e1cb0054653053a844cf265b25040029","parameter":"","call_value":100,"name":"SomeContract","consume_user_resource_percent":30,"fee_limit":10,"origin_energy_limit": 10,"owner_address":"41D1E7A6BC354106CB410E65FF8B181C600FF14292"}'
参数说明:
abi:abi
bytecode:bytecode,需要是hexString格式
parameter:构造函数的参数列表,需要按照ABI encoder编码后转话为hexString格式。如果构造函数没有参数,该参数可以不用设置。
consume_user_resource_percent:指定的使用该合约用户的资源占比,是[0, 100]之间的整数。如果是0,则表示用户不会消耗资源。如果开发者资源消耗完了,才会完全使用用户的资源。
fee_limit:最大消耗的SUN(1TRX = 1,000,000SUN)
call_value:本次调用往合约转账的SUN(1TRX = 1,000,000SUN)
owner_address:发起deploycontract的账户地址
name:合约名
origin_energy_limit: 创建者设置的,在一次合约执行或创建过程中创建者自己消耗的最大的energy,是大于0的整数
返回值:TransactionExtention, TransactionExtention中包含未签名的交易Transaction
wallet/triggersmartcontract
作用:调用合约
demo: curl -X POST http://127.0.0.1:8090/wallet/triggersmartcontract -d '{"contract_address":"4189139CB1387AF85E3D24E212A008AC974967E561","function_selector":"set(uint256,uint256)","parameter":"00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002","fee_limit":10,"call_value":100,"owner_address":"41D1E7A6BC354106CB410E65FF8B181C600FF14292"}'
参数说明:
contract_address,hexString格式
function_selector,函数签名,不能有空格
parameter:调用参数[1,2]的虚拟机格式,使用remix提供的js工具,将合约调用者调用的参数数组[1,2]转化为虚拟机所需要的参数格式
fee_limit:最大消耗的SUN(1TRX = 1,000,000SUN)
call_value:本次调用往合约转账的SUN(1TRX = 1,000,000SUN)
owner_address:发起triggercontract的账户地址
返回值:TransactionExtention, TransactionExtention中包含未签名的交易Transaction
wallet/getcontract
作用:获取合约
demo: curl -X POST http://127.0.0.1:8090/wallet/getcontract -d '{"value":"4189139CB1387AF85E3D24E212A008AC974967E561"}'
参数说明:
value:合约地址,hexString格式
返回值:SmartContract,智能合约的内容
wallet/proposalcreate
作用:创建提案
demo: curl -X POST http://127.0.0.1:8090/wallet/proposalcreate -d {"owner_address" : "419844F7600E018FD0D710E2145351D607B3316CE9","parameters":[{"key": 0,"value": 100000},{"key": 1,"value": 2}] }
参数说明:
owner_address:创建人地址
parameters:提案参数
返回值:创建提案的交易
wallet/getproposalbyid
作用:根据id查询提案
demo: curl -X POST http://127.0.0.1:8090/wallet/getproposalbyid -d {"id":1}
参数说明:
id:提案id
返回值:提案详细信息
wallet/listproposals
作用:查询所有提案
demo: curl -X POST http://127.0.0.1:8090/wallet/listproposals
参数说明:无
返回值:提案列表信息
wallet/proposalapprove
作用:提案批准
demo: curl -X POST http://127.0.0.1:8090/wallet/proposalapprove -d {"owner_address" : "419844F7600E018FD0D710E2145351D607B3316CE9", "proposal_id":1, "is_add_approval":true}
参数说明:
owner_address:批准人地址
proposal_id:提案id
is_add_approval:是否批准
返回值:批准提案的交易
wallet/proposaldelete
作用:删除提案
demo: curl -X POST http://127.0.0.1:8090/wallet/proposaldelete -d {"owner_address" : "419844F7600E018FD0D710E2145351D607B3316CE9", "proposal_id":1}
参数说明:
owner_address:删除人的地址,只有提案所有人允许删除提案
proposal_id:提案id
返回值:删除提案的交易
wallet/getaccountresource
作用:查询账户的资源信息
demo: curl -X POST http://127.0.0.1:8090/wallet/getaccountresource -d {"address" : "419844f7600e018fd0d710e2145351d607b3316ce9"}
参数说明:
address:查询账户的地址
返回值:账户的资源信息
wallet/exchangecreate
作用:创建交易对
demo:curl -X POST http://127.0.0.1:8090/wallet/exchangecreate -d {"owner_address":"419844f7600e018fd0d710e2145351d607b3316ce9", 、
"first_token_id":token_a, "first_token_balance":100, "second_token_id":token_b,"second_token_balance":200}
参数说明:
first_token_id :第1种token的id
first_token_balance:第1种token的balance
second_token_id : 第2种token的id
second_token_balance:第2种token的balance
返回值:创建交易对的transaction。
wallet/exchangeinject
作用:给交易对注资,注资后可以防止交易对价格波动太大
demo:curl -X POST http://127.0.0.1:8090/wallet/exchangeinject -d {"owner_address":"419844f7600e018fd0d710e2145351d607b3316ce9", "exchange_id":1, "token_id":"74726f6e6e616d65", "quant":100}
参数说明:
owner_address:交易对创建者的地址,hexString格式
exchange_id:交易对id
token_id: token的id,一般情况是token的name,需要是hexString格式
quant:注资token的数量
返回值:注资的transaction。
wallet/exchangewithdraw
作用:对交易对撤资,撤资后容易引起交易对价格波动太大。
demo:curl -X POST http://127.0.0.1:8090/wallet/exchangewithdraw -d {"owner_address":"419844f7600e018fd0d710e2145351d607b3316ce9", "exchange_id":1, "token_id":"74726f6e6e616d65", "quant":100}
参数说明:
owner_address:是交易对创建者的地址,hexString格式
exchange_id:交易对id
token_id: token的id,一般情况是token的name,需要是hexString格式
quant:撤资token的数量
返回值:撤资的transaction
wallet/exchangetransaction
作用:参与交易对交易。
demo:curl -X POST http://127.0.0.1:8090/wallet/exchangetransaction -d {"owner_address":"419844f7600e018fd0d710e2145351d607b3316ce9", "exchange_id":1, "token_id":"74726f6e6e616d65", "quant":100,"expected":10}
参数说明:
owner_address:是交易对创建者的地址,hexString格式
exchange_id:交易对id
token_id: 卖出的token的id,一般情况是token的name,需要是hexString格式
quant:卖出token的数量
expected:期望买入token的数量
返回值:token交易的transaction
wallet/getexchangebyid
作用:根据id查询交易对
demo:curl -X POST http://127.0.0.1:8090/wallet/getexchangebyid -d {"id":1}
参数说明:
id:交易对id
返回值:交易对
wallet/listexchanges
作用:查询所有交易对
demo:curl -X POST http://127.0.0.1:8090/wallet/listexchanges
参数说明:
返回值:所有交易对
wallet/getchainparameters
作用:查询所有交易对
demo:curl -X POST http://127.0.0.1:8090/wallet/getchainparameters
参数说明:
返回值:区块链委员会可以设置的所有参数
wallet/getnodeinfo(Odyssey-v3.2开始支持)
作用:获取当前node的信息
demo: curl -X GET http://127.0.0.1:8090/wallet/getnodeinfo
参数说明:无
返回值:当前节点的信息NodeInfo
wallet/updatesetting
作用:更新合约的consume_user_resource_percent
demo: curl -X POST http://127.0.0.1:8090/wallet/updatesetting -d '{"owner_address": "419844f7600e018fd0d710e2145351d607b3316ce9", "contract_address": "41c6600433381c731f22fc2b9f864b14fe518b322f", "consume_user_resource_percent": 7}'
参数说明:
owner_address:是交易对创建者的地址,hexString格式
contract_address:要修改的合约的地址
consume_user_resource_percent:指定的使用该合约用户的资源占比
返回值:TransactionExtention, TransactionExtention中包含未签名的交易Transaction
wallet/updateenergylimit
作用:更新合约的origin_energy_limit
demo: curl -X POST http://127.0.0.1:8090/wallet/updatesetting -d '{"owner_address": "419844f7600e018fd0d710e2145351d607b3316ce9", "contract_address": "41c6600433381c731f22fc2b9f864b14fe518b322f", "origin_energy_limit": 7}'
参数说明:
owner_address:是交易对创建者的地址,hexString格式
contract_address:要修改的合约的地址
origin_energy_limit:创建者设置的,在一次合约执行或创建过程中创建者自己消耗的最大的energy
返回值:TransactionExtention, TransactionExtention中包含未签名的交易Transaction
wallet/getdelegatedresource(Odyssey-v3.2开始支持)
作用:查看一个账户代理给另外一个账户的资源情况
demo: curl -X POST http://127.0.0.1:8090/wallet/getdelegatedresource -d '
{
"fromAddress": "419844f7600e018fd0d710e2145351d607b3316ce9",
"toAddress": "41c6600433381c731f22fc2b9f864b14fe518b322f"
}'
参数说明:
fromAddress:是要查询的账户地址,hexString格式
toAddress:代理对象的账户地址,hexString格式
返回值:账户的资源代理的列表,列表的元素为DelegatedResource
wallet/getdelegatedresourceaccountindex(Odyssey-v3.2开始支持)
作用:查看一个账户给哪些账户代理了资源
demo: curl -X POST http://127.0.0.1:8090/wallet/getdelegatedresourceaccountindex -d '
{
"value": "419844f7600e018fd0d710e2145351d607b3316ce9",
}'
参数说明:
value:是要查询的账户地址,hexString格式
返回值:账户的资源代理概况,结构为DelegatedResourceAccountIndex