HTTP API 接口¶
API INDEX¶
| transaction | account | shielded transactions |
|---|---|---|
| createtransaction | updateaccount | getexpandedspendingkey |
| gettransactionsign | createaccount | getakfromask |
| gettransactionbyid | createaddress | getnkfromnsk |
| gettransactioninfobyid | getaccountnet | getspendingkey |
| gettransactioncountbyblocknum | getaccount | getdiversifier |
| getdeferredtransactionbyid | generateaddress | getincomingviewingkey |
| canceldeferredtransactionbyid | validateaddress | getzenpaymentaddress |
| getdeferredtransactioninfobyid | getaccountresource | scannotebyivk |
| getsignweight | setaccountid | scanandmarknotebyivk |
| addtransactionsign | getaccountbyid | scannotebyovk |
| gettransactioninfobyblocknum | accountpermissionupdate | getrcm |
| gettransactionfrompending | getdelegatedresource | getmerkletreevoucherinfo |
| gettransactionlistfrompending | getdelegatedresourceaccountindex | isspend |
| getpendingsize | ||
| block | freezebalance | createspendauthsig |
| getnowblock | unfreezebalance | createshieldnullifier |
| getblockbynum | unfreezeasset | getshieldtransactionhash |
| getblockbyid | withdrawbalance | createshieldedtransaction |
| getblockbylimitnext | votewitnessaccount | createshieldedtransaction withoutspendauthsig |
| getblockbylatestnum | updatewitness | getnewshieldedaddress |
| getblockbalance | createwitness | |
| getbrokerage | ||
| getreward | ||
| updateBrokerage | ||
| getaccountbalance |
| asset | exchange | transfer |
|---|---|---|
| createassetissue | exchangecreate | easytransferbyprivate |
| participateassetissue | exchangeinject | easytransferassetbyprivate |
| getassetissuebyaccount | exchangewithdraw | transferasset |
| getassetissuebyname | exchangetransaction | easytransfer |
| getassetissuelistbyname | getexchangebyid | easytransferasset |
| getassetissuelist | getpaginatedexchangelist | |
| getpaginatedassetissuelist | getpaginatedexchangelist | |
| getassetissuebyid | listexchanges | |
| updateasset | getpaginatedexchangelist |
| proposal | smart contract | shielded TRC20 contract |
|---|---|---|
| getpaginatedproposallist | deploycontract | createshieldedcontractparameters |
| proposalcreate | getcontract | createshieldedcontractparameterswithoutask |
| getproposalbyid | triggerconstantcontract | scanshieldedtrc20notesbyivk |
| listproposals | triggersmartcontract | scanshieldedtrc20notesbyovk |
| proposalapprove | clearabi | isshieldedtrc20contractnotespent |
| proposaldelete | updateenergylimit | gettriggerinputforshieldedtrc20contract |
| getapprovedlist | updatesetting |
| market | others | |
|---|---|---|
| marketsellasset | broadcasttransaction | |
| marketcancelorder | broadcasthex | |
| getmarketorderbyaccount | listnodes | |
| getmarketpairlist | listwitnesses | |
| getmarketorderlistbypair | getnextmaintenancetime | |
| getmarketpricebypair | getnodeinfo | |
| getmarketorderbyid | getchainparameters | |
| getburntrx |
hexString和base58check转码demo¶
php: https://github.com/tronprotocol/Documentation/blob/master/TRX_CN/index.php
3.6版本之后，增加参数visible，当visible设置为true时，相应的地址和字符串不再需要转码。该参数针对所有的接口有效，包括solidityNode接口和FullNode接口
当参数visible为true时，输入的地址必须为base58格式，字符串为可见字符串，输出的格式也是如此；如果设置为false 或不设置时，接口行为同原来保持一致。如果参数格式与visible设置不匹配，将会报错。
设置参数方式：
- 不需要参数的查询接口，通过在url中增加参数。如
http://127.0.0.1:8090/wallet/listexchanges?visible=true - POST方式请求接口时，通过在json体最外层中增加参数。如
curl -X POST http://127.0.0.1:8090/wallet/createtransaction -d '{ "owner_address": "TRGhNNfnmgLegT4zHNjEqDSADjgmnHvubJ", "to_address": "TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW", "amount": 1000000, "visible": true }' - GET方式请求接口时，通过在url中增加参数。同方式1。
SolidityNode接口¶
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
返回值：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
返回值：指定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是块的高度.
返回值：transaction的个数.
/walletsolidity/gettransactioninfobyid
作用：根据id查询交易的fee，所在的block
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/gettransactioninfobyid -d '{"value" : "309b6fa3d01353e46f57dd8a8f27611f98e392b50d035cef213f2c55225a8bd2"}'
参数说明：value是交易id
返回值：Transaction的交易fee，所在block的高度，创建时间
/walletsolidity/gettransactioninfobyblocknum(Odyssey-v3.7开始支持)
作用：查询特定block上transaction的个数
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/gettransactioninfobyblocknum -d '{"num" : 100}'
参数说明：num是块的高度.
返回值：指定块中，包含的transactioninfo的列表.
/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
参数说明：
返回值：所有交易对
walletsolidity/getaccountbyid
作用：通过accountId查询一个账号的信息
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getaccountbyid -d '{"account_id":"6161616162626262"}'
参数说明：account_id 默认为hexString格式
返回值：Account对象
walletsolidity/getblockbyid
作用：通过ID查询块
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getblockbyid-d '{"value":
"0000000000038809c59ee8409a3b6c051e369ef1096603c7ee723c16e2376c73"}'
参数说明：块ID。
返回值：块。
walletsolidity/getblockbylimitnext
作用：按照范围查询块
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getblockbylimitnext -d '{"startNum": 1, "endNum": 2}'
参数说明：
startNum：起始块高度，包含此块
endNum：截止块高度，不包含此此块
返回值：块的列表。
walletsolidity/getblockbylatestnum
作用：查询最新的几个块
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getblockbylatestnum -d '{"num": 5}'
参数说明：块的数量。
返回值：块的列表。
/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
/walletsolidity/getdeferredtransactionbyid
作用：通过交易id查询延迟交易
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getdeferredtransactionbyid -d '{"value" : "309b6fa3d01353e46f57dd8a8f27611f98e392b50d035cef213f2c55225a8bd2"}'
参数说明：value是交易id
返回值：指定ID的Transaction
/walletsolidity/getdeferredtransactioninfobyid
作用：根据id查询交易的fee，所在的block
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/getdeferredtransactioninfobyid -d '{"value" : "309b6fa3d01353e46f57dd8a8f27611f98e392b50d035cef213f2c55225a8bd2"}'
参数说明：value是交易id
返回值：Transaction的交易fee，所在block的高度，创建时间
/walletsolidity/getmerkletreevoucherinfo
作用：获得一个note的默克尔树信息
demo: curl -X POST http://127.0.0.1:8090/walletsolidity/getmerkletreevoucherinfo -d
'{
"out_points":[{
"hash":"185b3e085723f5862b3a3c3cf54d52f5c1eaf2541e3a1e0ecd08bc12cd958d74",
"index":0
}]
}'
参数说明：
out_points：Note信息
返回值：一个note的默克尔树信息
/walletsolidity/scannotebyivk
作用：查询与ivk相关的所有的notes
demo: curl -X POST http://127.0.0.1:8090/walletsolidity/scannotebyivk -d
'{
"start_block_index": 0,
"end_block_index": 100,
"ivk": "80a481c3c739e54b4e0608090b3a1a6e9f8dce42346e95bf5a2d8a487bf45c05"
}'
参数说明：
start_block_index：开始区块高度，包含自身
end_block_index：结束区块高度，不包含自身
ivk：Incoming viewing key
返回值：Notes列表
注意：区间限制（end_block_index - start_block_index <= 1000）
- /walletsolidity/scanandmarknotebyivk
作用：查询与ivk相关的所有的notes, 包含是否花费状态
demo: curl -X POST http://127.0.0.1:8090/walletsolidity/scanandmarknotebyivk -d
'{
"start_block_index": 0,
"end_block_index": 100,
"ivk": "80a481c3c739e54b4e0608090b3a1a6e9f8dce42346e95bf5a2d8a487bf45c05",
"ak": "1d4f9b5551f4aa9443ceb263f0e208eb7e26080264571c5ef06de97a646fe418",
"nk": "748522c7571a9da787e43940c9a474aa0c5c39b46c338905deb6726fa3678bdb"
}'
参数说明：
start_block_index：开始区块高度，包含自身
end_block_index：结束区块高度，不包含自身
ivk：Incoming viewing key
ak：Ak key
nk：Nk key
返回值：Notes列表
注意：区间限制（end_block_index - start_block_index <= 1000）
/walletsolidity/scannotebyovk
作用：查询与ovk相关的所有的notes
demo: curl -X POST http://127.0.0.1:8090/walletsolidity/scannotebyovk -d
'{
"start_block_index": 0,
"end_block_index": 100,
"ovk": "705145aa18cbe6c11d5d0011419a98f3d5b1d341eb4727f1315597f4bdaf8539"
}'
参数说明：
start_block_index：开始区块高度，包含自身
end_block_index：结束区块高度，不包含自身
ovk：Outgoing viewing key
返回值：Notes列表
注意：区间限制（end_block_index - start_block_index <= 1000）
/walletsolidity/isspend
作用：查询一个note是否已经被花费
demo: curl -X POST http://127.0.0.1:8090/walletsolidity/isspend -d
'{
"ak": "a3e65d509b675aaa2aeda977ceff11eebd76218079b6f543d78a615e396ca129",
"nk": "62cfda9bea09a53cf2a21022057913734a8458969e11e0bb9c59ead48fbce83e",
"note": {
"payment_address": "ztron1aqgauawtkelxfu2w6s48cwh0mchjt6kwpj44l4wym3pullx0294j4r4v7kpm75wnclzycsw73mq",
"rcm": "74a16c1b27ec7fbf06881d9d35ddaab1554838b1bddcd54f6bd8a9fb4ba0b80a",
"value": 500000000
},
"txid": "7d09e471bb047d3ac044d5d6691b3721a2dddbb683ac02c207fbe78af6302463",
"index": 1
}'
参数说明：
ak：Ak
nk：Nk
note：Note信息
txid：交易id
index：Note索引
返回值：一个note是否已经被花费状态
/walletsolidity/scanshieldedtrc20notesbyivk
作用：查询匿名TRC20合约中与ivk相关的所有notes, 并标记其是否已花费
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/scanshieldedtrc20notesbyivk -d
'{
"start_block_index": 9200,
"end_block_index": 9240,
"shielded_TRC20_contract_address": "41274fc7464fadac5c00c893c58bce6c39bf59e4c7",
"ivk": "9f8e74bb3d7188a2781dc1db38810c6914eef4570a79e8ec8404480948e4e305",
"ak":"8072d9110c9de9d9ade33d5d0f5890a7aa65b0cde42af7816d187297caf2fd64",
"nk":"590bf33f93f792be659fd404df91e75c3b08d38d4e08ee226c3f5219cf598f14"
}'
参数说明：
start_block_index：开始区块高度，包含自身
end_block_index：结束区块高度，不包含自身
shielded_TRC20_contract_address: 匿名TRC20合约地址
ivk：Incoming viewing key
ak：Ak key
nk：Nk key
返回值：Notes列表
注意：区间限制（end_block_index - start_block_index <= 1000）
/walletsolidity/scanshieldedtrc20notesbyovk
作用：查询匿名TRC20合约中与ovk相关的所有notes
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/scanshieldedtrc20notesbyovk -d
'{
"start_block_index": 9200,
"end_block_index": 9240,
"shielded_TRC20_contract_address": "41274fc7464fadac5c00c893c58bce6c39bf59e4c7",
"ovk": "0ff58efd75e083fe4fd759c8701e1c8cb6961c4297a12b2c800bdb7b2bcab889"
}'
参数说明：
start_block_index：开始区块高度，包含自身
end_block_index：结束区块高度，不包含自身
shielded_TRC20_contract_address: 匿名TRC20合约地址
ovk：Outgoing viewing key
返回值：Notes列表
注意：区间限制（end_block_index - start_block_index <= 1000）
/walletsolidity/isshieldedtrc20contractnotespent
作用：查询匿名TRC20合约的note是否已被花费
demo: curl -X POST http://127.0.0.1:8091/walletsolidity/scanshieldedtrc20notesbyovk -d
'{
"note": {
"value": 40,
"payment_address":"ztron1768kf7dy4qquefp46szk978d65eeua66yhr4zv260c0uzj68t3tfjl3en9lhyyfxalv4jus30xs",
"rcm": "296070782a94c6936b0b4f6daf8d7c7605a4374fe595b96148dc0f4b59015d0d"
},
"ak": "8072d9110c9de9d9ade33d5d0f5890a7aa65b0cde42af7816d187297caf2fd64",
"nk": "590bf33f93f792be659fd404df91e75c3b08d38d4e08ee226c3f5219cf598f14",
"position": 272,
"shielded_TRC20_contract_address": "41274fc7464fadac5c00c893c58bce6c39bf59e4c7"
}'
参数说明：
note：Note信息
ak：Ak
nk：Nk
position：note承诺在匿名合约Merkle树叶子节点的位置索引
shielded_TRC20_contract_address: 匿名TRC20合约地址
返回值：一个note是否已经被花费状态
value 是由 scalingFactor 缩放后的值，scalingFactor 在匿名TRC-20合约中设置，实际金额 real_amount = value * scalingFactor。
FullNode接口¶
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是转账数量
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：转账合约
/wallet/gettransactionsign
作用：使用私钥签名交易。建议使用离线方式签名交易。
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/broadcasthex
作用：对签名后的transaction hex进行广播
demo：curl -X POST http://127.0.0.1:8090/wallet/broadcasthex -d '{"transaction":"0A8A010A0202DB2208C89D4811359A28004098A4E0A6B52D5A730802126F0A32747970652E676F6F676C65617069732E636F6D2F70726F746F636F6C2E5472616E736665724173736574436F6E747261637412390A07313030303030311215415A523B449890854C8FC460AB602DF9F31FE4293F1A15416B0580DA195542DDABE288FEC436C7D5AF769D24206412418BF3F2E492ED443607910EA9EF0A7EF79728DAAAAC0EE2BA6CB87DA38366DF9AC4ADE54B2912C1DEB0EE6666B86A07A6C7DF68F1F9DA171EEE6A370B3CA9CBBB00"}'
参数说明：签名之后的Transaction hex
返回值：广播是否成功
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格式
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：修改名称的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是投票数量
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：投票的Transaction
wallet/getBrokerage
作用：查询witness当前Brokerage比例
demo：curl -X GET http://127.0.0.1:8090/wallet/getBrokerage -d '{
"address":"41E552F6487585C2B58BC2C9BB4492BC1F17132CD0"}'
参数说明：
address是被投票的超级代表的地址，默认为hexString格式
返回值：witness当前Brokerage比例
wallet/getReward
作用：查询投票人未领取的奖励
demo：curl -X GET
http://127.0.0.1:8090/wallet/getReward -d '{
"address":"41E552F6487585C2B58BC2C9BB4492BC1F17132CD0"}'
参数说明：
address是投票人地址，默认为hexString格式
返回值：投票人未领取的奖励
wallet/updateBrokerage
作用：更新witness当前Brokerage比例
demo：curl -X POST http://47.252.81.126:8090/wallet/updateBrokerage -d '{
"owner_address":"41E552F6487585C2B58BC2C9BB4492BC1F17132CD0",
"brokerage":30}'
参数说明：
owner_address是被投票的超级代表的地址，默认为hexString格式
brokerage是witness想要更新为的Brokerage比例
返回值：更新Brokerage的Transaction
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发行人地址，默认为hexString格式
name是token名称，默认为hexString格式
abbr是token简称，默认为hexString格式
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
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：
发行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格式
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：
更新witness的Transaction
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格式，这个地址需要事先创建好
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：创建账号的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格式
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：申请超级代表的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转账数量
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：token转账的Transaction
【注意】
- 当前的asset_name为token名称。当委员会通过AllowSameTokenName提议后asset_name改为token ID的String类型。
wallet/easytransfer
作用：快捷转账，该接口已被废弃。
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
作用：快捷转账TRC10代币，该接口已被废弃。
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
作用：通过密码创建地址，该接口已被废弃。
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格式
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：参与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表示受委托账户的地址，默认为hexString格式
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：质押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
receiverAddress表示受委托账户的地址，默认为hexString格式
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：解锁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格式
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：解锁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格式
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：提现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全部的免费带宽
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：
修改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
返回值：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/getblockbalance
作用：获取一个区块中所有的余额变化操作
demo: curl -X POST http://127.0.0.1:8090/wallet/getblockbalance -d
'{
"hash": "000000000000dc2a3731e28a75b49ac1379bcc425afc95f6ab3916689fbb0189",
"number": 56362,
"visible": true
}'
参数说明：区块hash和number必须一致。
返回值：
'{
"block_identifier": {
"hash": "000000000000dc2a3731e28a75b49ac1379bcc425afc95f6ab3916689fbb0189",
"number": 56362
},
"timestamp": 1530060672000,
"transaction_balance_trace": [
{
"transaction_identifier": "e6cabb1833cd1f795eed39d8dd7689eaa70e5bb217611766c74c7aa9feea80df",
"operation": [
{
"operation_identifier": 0,
"address": "TPttBLmFuykRi83y9HxDoEWxTQw6CCcQ4p",
"amount": -100000
},
{
"operation_identifier": 1,
"address": "TLsV52sRDL79HXGGm9yzwKibb6BeruhUzy",
"amount": 100000
},
{
"operation_identifier": 2,
"address": "TPttBLmFuykRi83y9HxDoEWxTQw6CCcQ4p",
"amount": -10000000
},
{
"operation_identifier": 3,
"address": "TMrysg7DbwR1M8xqhpaPdVCHCuWFhw7uk1",
"amount": 10000000
}
],
"type": "TransferContract",
"status": "SUCCESS"
}
]
}'
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
返回值：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是块的高度.
返回值：transaction的个数.
/wallet/gettransactioninfobyblocknum(Odyssey-v3.7开始支持)
作用：查询特定block上transaction的个数
demo: curl -X POST http://127.0.0.1:8090/wallet/gettransactioninfobyblocknum -d '{"num" : 100}'
参数说明：num是块的高度.
返回值：指定块中，包含的transactioninfo的列表.
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/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数量。
返回值：交易，含执行结果。
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：转账的通证数量，单位是通证的最小单位。
返回值：交易，含执行结果。
wallet/generateaddress
作用：创建一个随机的私钥和地址。该接口已被废弃，建议使用离线方式创建地址。
demo: curl -X POST http://127.0.0.1:8090/wallet/generateaddress
参数说明：无
返回值：地址和私钥
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的账户地址，默认为hexString格式
name：合约名
origin_energy_limit: 创建者设置的，在一次合约执行或创建过程中创建者自己消耗的最大的energy，是大于0的整数
call_token_value:本次调用往合约中转账10币的数量，如果不设置token_id，这项设置为0或者不设置
token_id:本次调用往合约中转账10币的id，如果没有，不需要设置
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：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的账户地址，默认为hexString格式
call_token_value:本次调用往合约中转账10币的数量，如果不设置token_id，这项设置为0或者不设置
token_id:本次调用往合约中转账10币的id，如果没有，不需要设置
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：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：提案参数
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：创建提案的交易
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：批准人地址，默认为hexString格式
proposal_id：提案id
is_add_approval：是否批准
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：批准提案的交易
wallet/proposaldelete
作用：删除提案
demo: curl -X POST http://127.0.0.1:8090/wallet/proposaldelete -d {"owner_address" : "419844F7600E018FD0D710E2145351D607B3316CE9", "proposal_id":1}
参数说明：
owner_address：删除人的地址，只有提案所有人允许删除提案，默认为hexString格式
proposal_id：提案id
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：删除提案的交易
wallet/getaccountresource
作用：查询账户的资源信息
demo: curl -X POST http://127.0.0.1:8090/wallet/getaccountresource -d {"address" : "419844f7600e018fd0d710e2145351d607b3316ce9"}
参数说明：
address：查询账户的地址，默认为hexString格式
返回值：账户的资源信息
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，默认为hexString格式
first_token_balance：第1种token的balance
second_token_id ： 第2种token的id，默认为hexString格式
second_token_balance：第2种token的balance
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：创建交易对的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的数量
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：注资的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的数量
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：撤资的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的数量
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：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/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：要修改的合约的地址，默认为hexString格式
consume_user_resource_percent：指定的使用该合约用户的资源占比
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：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：要修改的合约的地址，默认为hexString格式
origin_energy_limit：创建者设置的，在一次合约执行或创建过程中创建者自己消耗的最大的energy
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：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
wallet/getnodeinfo(Odyssey-v3.2.2开始支持)
作用：查看节点的信息
demo: curl http://127.0.0.1:8090/wallet/getnodeinfo
返回值：节点当前状态的相关信息(省略)
wallet/setaccountid
作用：设置一个账户的accountID
demo: curl -X POST http://127.0.0.1:8090/wallet/setaccountid -d '{
"owner_address":"41a7d8a35b260395c14aa456297662092ba3b76fc0","account_id":"6161616162626262"}'
参数说明：
owner_address：是交易对创建者的地址，默认为hexString格式
account_id accountid,默认为hexString格式
返回值:设置AccountID的transaction
wallet/getaccountbyid
作用：通过accountId查询一个账号的信息
demo: curl -X POST http://127.0.0.1:8090/wallet/getaccountbyid -d
'{"account_id":"6161616162626262"}'
参数说明：account_id 默认为hexString格式
返回值：Account对象
wallet/getaccountbalance
作用：查询账户历史余额
demo: curl -X POST http://127.0.0.1:8090/wallet/getaccountbalance -d
'{
"account_identifier": {
"address": "TLLM21wteSPs4hKjbxgmH1L6poyMjeTbHm"
},
"block_identifier": {
"hash": "0000000000010c4a732d1e215e87466271e425c86945783c3d3f122bfa5affd9",
"number": 68682
},
"visible": true
}'
参数说明： 账户 address + 区块 hash 和 number，区块 hash 和 number 必须匹配一致。
返回值：
{
"balance": 64086449348265042,
"block_identifier": {
"hash": "0000000000010c4a732d1e215e87466271e425c86945783c3d3f122bfa5affd9",
"number": 68682
}
}
返回值说明：返回值中的 block_identifier 表示账户余额发生变化的区块
wallet/getdeferredtransactionbyid
作用：通过交易id查询延迟交易
demo: curl -X POST http://127.0.0.1:8090/wallet/getdeferredtransactionbyid -d '{"value": "d5ec749ecc2a615399d8a6c864ea4c74ff9f523c2be0e341ac9be5d47d7c2d62"}'
参数说明：交易ID。
返回值：交易信息。
wallet/canceldeferredtransactionbyid
作用：创建取消延迟交易对象
demo: curl -X POST http://127.0.0.1:8090/wallet/canceldeferredtransactionbyid -d '{
"transactionId":"34e6b6497b71100756790a7f20cd729376768dd2bebb6a4a9c5e87b920d5de10",
"ownerAddress":"41a7d8a35b260395c14aa456297662092ba3b76fc0"}'
参数说明：
owner_address：取消交易账户的地址，同时也是发起交易的账户地址，默认为hexString格式
transactionId:交易ID
返回值：交易对象。
wallet/getdeferredtransactioninfobyid
作用：根据id查询延迟交易的fee，所在的block
demo: curl -X POST http://127.0.0.1:8090/wallet/getdeferredtransactioninfobyid -d '{"value" : "309b6fa3d01353e46f57dd8a8f27611f98e392b50d035cef213f2c55225a8bd2"}'
参数说明：value是交易id
返回值：Transaction的交易fee，所在block的高度，创建时间
wallet/triggerconstantcontract
作用：调用常量合约，产生的交易不上链
demo: curl -X POST http://127.0.0.1:8090/wallet/triggerconstantcontract -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）
owner_address：发起triggercontract的账户地址，默认为hexString格式
可选参数Permission_id，多重签名时使用，设置交易多重签名时使用的permissionId
返回值：TransactionExtention, TransactionExtention中包含未签名的交易Transaction
wallet/clearabi
作用：创建清除智能合约ABI的交易对象
demo: curl -X POST http://127.0.0.1:8090/wallet/clearabi -d '{
"owner_address":"41a7d8a35b260395c14aa456297662092ba3b76fc0",
"contract_address":"417bcb781f4743afaacf9f9528f3ea903b3782339f"}'
参数说明：
owner_address：创建合约的账户地址，默认为hexString格式
contract_address：合约地址,默认为hexString
返回值:交易对象
wallet/addtransactionsign
作用：给交易签名，支持多重签名。建议使用离线方式添加签名。
demo: curl -X POST http://127.0.0.1:8090/wallet/addtransactionsign -d '{
"transaction": {
"visible": true,
"txID": "752cece5a68e40e30eaeeb4c5844b3f4b004d23485ccef42e0609a9a90eeb675",
"raw_data": {
"contract": [{
"parameter": {
"value": {
"data": "a9059cbb0000000000000000000000415a523b449890854c8fc460ab602df9f31fe4293f00000000000000000000000000000000000000000000000000000000000001f4",
"owner_address": "TRGhNNfnmgLegT4zHNjEqDSADjgmnHvubJ",
"contract_address": "TVf6sdWWu8zvmtcWfZerMDefoptiVhbhXC"
},
"type_url": "type.googleapis.com/protocol.TriggerSmartContract"
},
"type": "TriggerSmartContract"
}],
"ref_block_bytes": "0883",
"ref_block_hash": "84c32fcee77f6be7",
"expiration": 1556449785000,
"fee_limit": 10000,
"timestamp": 1556449725625
},
"raw_data_hex": "0a020883220884c32fcee77f6be740a8e98b9da62d5aae01081f12a9010a31747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e54726967676572536d617274436f6e747261637412740a1541a7d8a35b260395c14aa456297662092ba3b76fc0121541d7f5e9b3b997006444c1646ecfae6549b5737e622244a9059cbb0000000000000000000000415a523b449890854c8fc460ab602df9f31fe4293f00000000000000000000000000000000000000000000000000000000000001f470b999889da62d9001904e"
},
"privateKey": "950139607044677436d29ff1ea2900c9402f783a91547cdc47cf706f1129c76a"
}'
参数说明：
transaction：交易对象
privateKey： owner_address对应的私钥，hexString格式，存在泄漏私钥的风险。
返回值:签名后的交易对象
wallet/getsignweight
作用：查询多重签名的交易的相关信息
demo: curl -X POST http://127.0.0.1:8090/wallet/getsignweight -d '{
"signature": [
"e0bd4a60f1b3c89d4da3894d400e7e32385f6dd690aee17fdac4e016cdb294c5128b66f62f3947a7182c015547496eba95510c113bda2a361d811b829343c36501",
"596ead6439d0f381e67f30b1ed6b3687f2bd53ce5140cdb126cfe4183235804741eeaf79b4e91f251fd7042380a9485d4d29d67f112d5387bc7457b355cd3c4200"
],
"txID": "0ae84a8439f5aa8fd2c458879a4031a7452aebed8e6e99ffbccd26842d4323c4",
"raw_data": {
"contract": [{
"parameter": {
"value": {
"amount": 1000000,
"owner_address": "TRGhNNfnmgLegT4zHNjEqDSADjgmnHvubJ",
"to_address": "TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW"
},
"type_url": "type.googleapis.com/protocol.TransferContract"
},
"type": "TransferContract"
}],
"ref_block_bytes": "163d",
"ref_block_hash": "77ef4ace148b05ba",
"expiration": 1555664823000,
"timestamp": 1555664763418
},
"raw_data_hex": "0a02163d220877ef4ace148b05ba40d8c5e5a6a32d5a69080112630a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412320a1541a7d8a35b260395c14aa456297662092ba3b76fc01215415a523b449890854c8fc460ab602df9f31fe4293f18c0843d2802709af4e1a6a32d",
"visible": true}'
参数说明：
参数整体是一个完整的交易
返回值:已签名权重是否达到阈值（即是否满足验签标准），签名地址列表，permission的详细信息，已签名的权重及交易信息。
wallet/getapprovedlist
作用：查询多重签名的交易的相关信息
demo: curl -X POST http://127.0.0.1:8090/wallet/getapprovedlist -d '{
"signature": [
"e0bd4a60f1b3c89d4da3894d400e7e32385f6dd690aee17fdac4e016cdb294c5128b66f62f3947a7182c015547496eba95510c113bda2a361d811b829343c36501",
"596ead6439d0f381e67f30b1ed6b3687f2bd53ce5140cdb126cfe4183235804741eeaf79b4e91f251fd7042380a9485d4d29d67f112d5387bc7457b355cd3c4200"
],
"txID": "0ae84a8439f5aa8fd2c458879a4031a7452aebed8e6e99ffbccd26842d4323c4",
"raw_data": {
"contract": [{
"parameter": {
"value": {
"amount": 1000000,
"owner_address": "TRGhNNfnmgLegT4zHNjEqDSADjgmnHvubJ",
"to_address": "TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW"
},
"type_url": "type.googleapis.com/protocol.TransferContract"
},
"type": "TransferContract"
}],
"ref_block_bytes": "163d",
"ref_block_hash": "77ef4ace148b05ba",
"expiration": 1555664823000,
"timestamp": 1555664763418
},
"raw_data_hex": "0a02163d220877ef4ace148b05ba40d8c5e5a6a32d5a69080112630a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412320a1541a7d8a35b260395c14aa456297662092ba3b76fc01215415a523b449890854c8fc460ab602df9f31fe4293f18c0843d2802709af4e1a6a32d",
"visible": true}'
参数整体是一个完整的交易
返回值:已签名权重是否达到阈值（即是否满足验签标准），签名地址列表，交易信息。
wallet/accountpermissionupdate
作用：为账户创建多重签名
demo: curl -X POST http://127.0.0.1:8090/wallet/accountpermissionupdate -d
'{
"owner_address": "TRGhNNfnmgLegT4zHNjEqDSADjgmnHvubJ",
"owner": {
"type": 0,
"permission_name": "owner",
"threshold": 1,
"keys": [{
"address": "TRGhNNfnmgLegT4zHNjEqDSADjgmnHvubJ",
"weight": 1
}]
},
"witness": {
"type": 1,
"permission_name": "witness",
"threshold": 1,
"keys": [{
"address": "TRGhNNfnmgLegT4zHNjEqDSADjgmnHvubJ",
"weight": 1
}]
},
"actives": [{
"type": 2,
"permission_name": "active12323",
"threshold": 2,
"operations": "7fff1fc0033e0000000000000000000000000000000000000000000000000000",
"keys": [{
"address": "TNhXo1GbRNCuorvYu5JFWN3m2NYr9QQpVR",
"weight": 1
}, {
"address": "TKwhcDup8L2PH5r6hxp5CQvQzZqJLmKvZP",
"weight": 1
}]
}],
"visible": true}'
参数说明：
owner_address：创建合约的账户地址，默认为hexString格式
owner：账户owner权限的分配信息
witness：出块权限的分配信息，如果不是witness，不需要设置
actives：其他功能权限的分配信息
返回值:账户创建多重签名的transaction
wallet/getexpandedspendingkey
作用：获取expanded spending keys
demo: curl -X POST http://127.0.0.1:8090/wallet/getexpandedspendingkey -d
'{
"value": "06b02aaa00f230b0887ff57a6609d76691369972ac3ba568fe7a8a0897fce7c4"
}'
参数说明：
value：Spending key
返回值： Expanded spending keys. 由三个key组成，分别是 ask、 nsk和ovk.
wallet/getakfromask
作用：从ask获得ak
demo: curl -X POST http://127.0.0.1:8090/wallet/getakfromask -d
'{
"value": "653b3a3fdd40b60d2f53ba121df8840f6590384993f8fa9a0ecb0dfb23496604"
}'
参数说明：
value：Ask
返回值：Ak
wallet/getnkfromnsk
作用：从nsk获得nk
demo: curl -X POST http://127.0.0.1:8090/wallet/getnkfromnsk -d
'{
"value": "428ff3c9e101dc1fca08f7b0e3387b23b68016746ae565aefc19d112b696db01"
}'
参数说明：
value：Nsk
返回值：Nk
wallet/getspendingkey
作用：获得spending key
demo: curl -X GET http://127.0.0.1:8090/wallet/getspendingkey
参数说明：无
返回值：Spending key
wallet/getdiversifier
作用：To get diversifier
demo: curl -X GET http://127.0.0.1:8090/wallet/getdiversifier
参数说明：无
返回值: Diversifier
wallet/getincomingviewingkey
作用：获得incoming viewing key
demo: curl -X POST http://127.0.0.1:8090/wallet/getincomingviewingkey -d
'{
"ak":"b443f1a303ef5837ba95750b48b6fef15f9c77f63a8c28c161bcd6613f423b5c",
"nk":"632137e69179df3d10e252fcce85d13464c3163fe7a619edf8d43ebefa8162d9"
}'
参数说明：
ak：Ak
nk：Nk
返回值：Incoming viewing key
wallet/getzenpaymentaddress
作用：获得支付地址
demo: curl -X POST http://127.0.0.1:8090/wallet/getzenpaymentaddress -d
'{
"ivk":"8c7852e10862d8eec058635974f70f24c1f8d73819131bb5b54028d0a9408a03",
"d":"736ba8692ed88a5473e009"
}'
参数说明：
ivk：Ivk
d：D
返回值：支付地址
wallet/createshieldedtransactionwithoutspendauthsig
作用：To create shielded transaction without using ask
demo: curl -X POST http://127.0.0.1:8090/wallet/createshieldedtransactionwithoutspendauthsig -d
'{
"ivk":"8c7852e10862d8eec058635974f70f24c1f8d73819131bb5b54028d0a9408a03",
"d":"736ba8692ed88a5473e009"
}'
参数说明：
transparent_from_address：透明发送者的地址
from_amount：从透明地址转出的数额
ask：Ask
nsk：Nsk
ovk：Ovk
shielded_receives：匿名接收者信息
shieldedSpends：匿名发送者信息
transparent_to_address：透明接收者地址
to_amount：转入透明地址的数额
返回值：交易对象
wallet/createshieldedtransactionwithoutspendauthsig
作用：创建匿名交易（不需要提供ask）
demo: curl -X POST http://127.0.0.1:8090/wallet/createshieldedtransactionwithoutspendauthsig -d
'{
"ak": "bf051629fd8122cd9dd8591d72947b026c214cf7cdac1f68eff97179727d38e9",
"nsk": "42963d26af8122204273fa3489d9efd6babf1f7179ff193c955a1f3d9c2df10c",
"ovk": "bc9848a83966709655b12efadc9e978785858316045e0115a0e72567a9a2a823",
"shielded_spends": [
{
"note": {
"value": 500000000,
"payment_address": "ztron1jld8fmvujrz2vgkc867zuwklmewy4ypw0wtwgweqs2paee0uhc8f3azy90el770arksa2kunl02",
"rcm": "723053bcbfecdf5da66c18ab0376476ef308c61b7abe891b2c01e903bcb87c0e"
},
"alpha": "2608999c3a97d005a879ecdaa16fd29ae434fb67b177c5e875b0c829e6a1db04",
"voucher": {
"tree": {
"left": {
"content": "a3d5c9b2db9699f32afec5febbd5586ce9ff33a0bef6fee5691028313b8e1f6a"
},
"parents": [
{
"content": "d9c38484296b3aa8f5e8b59d418a3775e2bb414e75498ad352e4614f05aae548"
},
{
"content": "d0420777afdc4151c3f14fbe4c714d82dc15873edb1ca65ebb3887334a4bae15"
}
]
},
"rt": "fb1115d5ddd16c5427c3a608d6b5add5967e70f51c890307c6142083a2c28565"
},
"path": "2020b2eed031d4d6a4f02a097f80b54cc1541d4163c6b6f5971f88b6e41d35c538142012935f14b676509b81eb49ef25f39269ed72309238b4c145803544b646dca62d20e1f34b034d4a3cd28557e2907ebf990c918f64ecb50a94f01d6fda5ca5c7ef722028e7b841dcbc47cceb69d7cb8d94245fb7cb2ba3a7a6bc18f13f945f7dbd6e2a20a5122c08ff9c161d9ca6fc462073396c7d7d38e8ee48cdb3bea7e2230134ed6a20d2e1642c9a462229289e5b0e3b7f9008e0301cbb93385ee0e21da2545073cb582016d6252968971a83da8521d65382e61f0176646d771c91528e3276ee45383e4a20fee0e52802cb0c46b1eb4d376c62697f4759f6c8917fa352571202fd778fd712204c6937d78f42685f84b43ad3b7b00f81285662f85c6a68ef11d62ad1a3ee0850200769557bc682b1bf308646fd0b22e648e8b9e98f57e29f5af40f6edb833e2c492008eeab0c13abd6069e6310197bf80f9c1ea6de78fd19cbae24d4a520e6cf3023208d5fa43e5a10d11605ac7430ba1f5d81fb1b68d29a640405767749e841527673206aca8448d8263e547d5ff2950e2ed3839e998d31cbc6ac9fd57bc6002b15921620cd1c8dbf6e3acc7a80439bc4962cf25b9dce7c896f3a5bd70803fc5a0e33cf00206edb16d01907b759977d7650dad7e3ec049af1a3d875380b697c862c9ec5d51c201ea6675f9551eeb9dfaaa9247bc9858270d3d3a4c5afa7177a984d5ed1be245120d6acdedf95f608e09fa53fb43dcd0990475726c5131210c9e5caeab97f0e642f20bd74b25aacb92378a871bf27d225cfc26baca344a1ea35fdd94510f3d157082c201b77dac4d24fb7258c3c528704c59430b630718bec486421837021cf75dab65120ec677114c27206f5debc1c1ed66f95e2b1885da5b7be3d736b1de98579473048204777c8776a3b1e69b73a62fa701fa4f7a6282d9aee2c7a6b82e7937d7081c23c20ba49b659fbd0b7334211ea6a9d9df185c757e70aa81da562fb912b84f49bce722043ff5457f13b926b61df552d4e402ee6dc1463f99a535f9a713439264d5b616b207b99abdc3730991cc9274727d7d82d28cb794edbc7034b4f0053ff7c4b68044420d6c639ac24b46bd19341c91b13fdcab31581ddaf7f1411336a271f3d0aa52813208ac9cf9c391e3fd42891d27238a81a8a5c1d3a72b1bcbea8cf44a58ce738961320912d82b2c2bca231f71efcf61737fbf0a08befa0416215aeef53e8bb6d23390a20e110de65c907b9dea4ae0bd83a4b0a51bea175646a64c12b4c9f931b2cb31b4920d8283386ef2ef07ebdbb4383c12a739a953a4d6e0d6fb1139a4036d693bfbb6c20d0420777afdc4151c3f14fbe4c714d82dc15873edb1ca65ebb3887334a4bae1520d9c38484296b3aa8f5e8b59d418a3775e2bb414e75498ad352e4614f05aae5482001000000000000000000000000000000000000000000000000000000000000000600000000000000"
}
],
"shielded_receives": [
{
"note": {
"value": 40000000,
"payment_address": "ztron1wd46s6fwmz99gulqpxul6zffqtevzfpl93ng3s5834fhwf6e7w5l6zmjhmpvtwsc4wxa7dusmvr",
"rcm": "ccced07d36641fc93cba33cddda7064cb82f6962a0bdf15a4240a4a742770e03"
}
}
]
}'
参数说明：
transparent_from_address：透明发送者的地址
from_amount：从透明地址转出的数额
ak：Ak
nsk：Nsk
ovk：Ovk
shielded_receives：匿名接收者信息
shieldedSpends：匿名发送者信息
transparent_to_address：透明接收者地址
to_amount：转入透明地址的数额
返回值：交易对象
wallet/scannotebyivk
作用：查询与ivk相关的所有的notes
demo: curl -X POST http://127.0.0.1:8090/wallet/scannotebyivk -d
'{
"start_block_index": 0,
"end_block_index": 100,
"ivk": "80a481c3c739e54b4e0608090b3a1a6e9f8dce42346e95bf5a2d8a487bf45c05"
}'
参数说明：
start_block_index：开始区块高度，包含自身
end_block_index：结束区块高度，不包含自身
ivk：Incoming viewing key
返回值：Notes列表
注意：区间限制（end_block_index - start_block_index <= 1000）
- /wallet/scanandmarknotebyivk
作用：查询与ivk相关的所有的notes, 包含是否花费状态
demo: curl -X POST http://127.0.0.1:8090/wallet/scanandmarknotebyivk -d
'{
"start_block_index": 0,
"end_block_index": 100,
"ivk": "80a481c3c739e54b4e0608090b3a1a6e9f8dce42346e95bf5a2d8a487bf45c05",
"ak": "1d4f9b5551f4aa9443ceb263f0e208eb7e26080264571c5ef06de97a646fe418",
"nk": "748522c7571a9da787e43940c9a474aa0c5c39b46c338905deb6726fa3678bdb"
}'
参数说明：
start_block_index：开始区块高度，包含自身
end_block_index：结束区块高度，不包含自身
ivk：Incoming viewing key
ak：Ak key
nk：Nk key
返回值：Notes列表
注意：区间限制（end_block_index - start_block_index <= 1000）
wallet/scannotebyovk
作用：查询与ovk相关的所有的notes
demo: curl -X POST http://127.0.0.1:8090/wallet/scannotebyovk -d
'{
"start_block_index": 0,
"end_block_index": 100,
"ovk": "705145aa18cbe6c11d5d0011419a98f3d5b1d341eb4727f1315597f4bdaf8539"
}'
参数说明：
start_block_index：开始区块高度，包含自身
end_block_index：结束区块高度，不包含自身
ovk：Outgoing viewing key
返回值：Notes列表
注意：区间限制（end_block_index - start_block_index <= 1000）
wallet/getrcm
作用：获得一个rcm
demo: curl -X GET http://127.0.0.1:8090/wallet/getrcm
参数说明：无
返回值：rcm
wallet/getmerkletreevoucherinfo
作用：获得一个note的默克尔树信息
demo: curl -X POST http://127.0.0.1:8090/wallet/getmerkletreevoucherinfo -d
'{
"out_points":[{
"hash":"185b3e085723f5862b3a3c3cf54d52f5c1eaf2541e3a1e0ecd08bc12cd958d74",
"index":0
}]
}'
参数说明：
out_points：Note信息
返回值：一个note的默克尔树信息
wallet/isspend
作用：查询一个note是否已经被花费
demo: curl -X POST http://127.0.0.1:8090/wallet/isspend -d
'{
"ak": "a3e65d509b675aaa2aeda977ceff11eebd76218079b6f543d78a615e396ca129",
"nk": "62cfda9bea09a53cf2a21022057913734a8458969e11e0bb9c59ead48fbce83e",
"note": {
"payment_address": "ztron1aqgauawtkelxfu2w6s48cwh0mchjt6kwpj44l4wym3pullx0294j4r4v7kpm75wnclzycsw73mq",
"rcm": "74a16c1b27ec7fbf06881d9d35ddaab1554838b1bddcd54f6bd8a9fb4ba0b80a",
"value": 500000000
},
"txid": "7d09e471bb047d3ac044d5d6691b3721a2dddbb683ac02c207fbe78af6302463",
"index": 1
}'
参数说明：
ak：Ak
nk：Nk
note：Note信息
txid：交易id
index：Note索引
返回值：一个note是否已经被花费状态
wallet/createspendauthsig
作用：为一个交易创建一个签名
demo: curl -X POST http://127.0.0.1:8090/wallet/createspendauthsig -d
'{
"ask": "e3ebcba1531f6d9158d9c162660c5d7c04dadf77d85d7436a9c98b291ff69a09",
"tx_hash": "3b78fee6e956f915ffe082284c5f18640edca9c57a5f227e5f7d7eb65ad61502",
"alpha": "2608999c3a97d005a879ecdaa16fd29ae434fb67b177c5e875b0c829e6a1db04"
}'
参数说明：
ask：Ask
tx_hash：交易哈希
alpha：Alpha
返回值：签名
wallet/createshieldnullifier
作用：To create a shielded nullifier
demo: curl -X POST http://127.0.0.1:8090/wallet/createshieldnullifier -d
'{
"note": {
"payment_address": "ztron1aqgauawtkelxfu2w6s48cwh0mchjt6kwpj44l4wym3pullx0294j4r4v7kpm75wnclzycsw73mq",
"rcm": "74a16c1b27ec7fbf06881d9d35ddaab1554838b1bddcd54f6bd8a9fb4ba0b80a",
"value": 500000000
},
"voucher": {
"tree": {
"left": {
"content": "a4d763fae3fee78964ccdf7567ec3062c95a5b97825d731202d3dfa6cb01c143"
}
},
"rt": "7dc3652c2a16e8518a8be0e3e038f9d28c3eb96f13e8da8acc2a9b650702f33e"
},
"ak": "a3e65d509b675aaa2aeda977ceff11eebd76218079b6f543d78a615e396ca129",
"nk": "62cfda9bea09a53cf2a21022057913734a8458969e11e0bb9c59ead48fbce83e"
}'
参数说明：
note：Note信息
voucher：Voucher信息
ak：Ak
nk：Nk
返回值：匿名的nullifier
wallet/getshieldtransactionhash
作用：获得一笔匿名交易的hash
demo: curl -X POST http://127.0.0.1:8090/wallet/getshieldtransactionhash -d
'{
"txID": "de639a64497d86bb27e34a2953093a0cc488ec4c7bc9624ac5857d3799748595",
"raw_data": {
"contract": [
{
"parameter": {
"value": {
"binding_signature": "2b8ae5e11ecad3e6946f54b7ad513bd8692a3edae72d29e266b28e47c9b37ccdb38e3b6433575694b6681136b1734f85afcfe672061d2ee7368755ad0b96a80b",
"spend_description": [
{
"value_commitment": "cbe1063adbe7e10919421fa6133f03150253913f5aff02d165e2c019cea4a869",
"anchor": "fb1115d5ddd16c5427c3a608d6b5add5967e70f51c890307c6142083a2c28565",
"nullifier": "93e329d464e1dbddc8bb4d2dcc939a796dfe11e985d4e9033a15edf0e3df4f35",
"rk": "10c702d6dff1509502ee5acc0b01d4b4531b2ff53b0dd54488aea6031b5e6d16",
"zkproof": "abf64b3beacfd873b1db764c3da9f739993518f3f740e761cb8af60682b7171892895c3ccfb550c3cf757e906dbf5313a3676b8226b0b84960f76a185c8d3fdfc3fa9c08479a704852d7b3dfeb913cf13e01c25657561e00a06c61e7c65b50b812902ddc4f17bfe2bcb2f247c2dc6132d0f0e0abcecc0332fdd99077af10d07bbdb88c4fd257948428e233c57f84eee8b2eeab2162c1aeccf2e1dfaa306d5803a8b2d281a549440fbd5a3657a830c1ca07a384cea446aa077b195b29b23023b1"
}
],
"receive_description": [
{
"value_commitment": "f6d45db8ec5a1c8dbbde040b4ea138efbe8db2d0597ed2306ff3fdd0620b3c5a",
"note_commitment": "ec3f5472ac8114a9a07987d1c2a0e1254504e352d9574971e77084293900312e",
"epk": "719eeb5ebaeeccc55c9f0d73767aadf0c0513603400ccb50bd789637d984b8e6",
"c_enc": "3a6c4fe0e79f5b23fed34a419c4728d0b26bca23180a22871743b0a9444c27663cf07c55a0ea6db504d70421768bf17384e180b2ad8b8be88ff5cf662c53a4ba086effc3a4b1df39265f71dfac884bff5a69e1dcdcae8aecf6ae443168ffab692a5c1e4908b415dd830dcf6432fae1c32461132080da74d6b83d3d00887eb2ce9965a749f8d8410ea4182969371ac2fd5e0e74d27d883492a08e6209cd9959d74bb67c2a9fe7faac5a4777f1bff19cf0b6398a2faa9b194bbb93d60f132f382f7d693a722e8cbca1da084ee7e0c371397419a7259d1fa0943078cfe5ea352e4b53907bb6c04ca8ad409fb0ae0b110a6b312200e21ab79d543ae7aeb16802cf87afdac1e8954038caa42818f4ca2847fd642360c098accfeeade4abd1cc9ca3315a4336be224ba3516973c7dae3f41875457236675993df38d3a544470c4f9335d77b005e6a9aec40fd881b34852ec9bbbcc3d24ee92930eae770a5462ce04c4e37b0524ef07e00e8d58c810d6aefb19fa7bc2c3a2fdfab6dd4fe73dbecc0795a280f9b7ca35cc8bc1062aed8e26bd81ba33c6f4c318974636f6d796723e77772ced3dbc1f42afec6fc9bb61f8beac704affea9baf2e2de226250c1d427c7d78b1eb1d239e1f3eb6af0f017b80541333f4fce17340048d826b9b0be8477c996ad8bfc3440dc686fdff6d0d63986db4d95962d7977289cbfd14c745de7c79d4dc0bcd220e5b4ced5b409e79142e0f336e44ca29a9a87f6f43707d8c4936e895236dd2b393a478a8bc27b1f682496ba84a0ddc549da06cb7855c4d8680dc66ac40240733b7f",
"c_out": "50be6e77854d4c427b2af4f16e5275f0b0c206b3ea2d2a24ffb287ea356f323523354cd83d15e7c48e6f1fa103dfca3d49ca2263dbb0cd8bfb35d72cdcad1351de6fba7a30aea27184a68bcda19cc6da",
"zkproof": "a4e6c50d5753092d005689922c2bdeafc98775bce59db840974163ace23c13fec18112e32aae1c39842c645ed172ad8fa277e63c1e3d6d7fb12eb15d56b573237b776f562a81d0e6be362d147d8604fdfec421482270ca82950de1883fda06e719f5d256d7a039769bffc570a1778d70c17295d1c0336a6ae0903d2460dc139a9563c2d40f37bffefa73003a55af1ff0861b6f79ef40099b6a0cb25ab3f40727210e4629647d0711abff125712a5f0d64fcb6e6a6b0b34478d7da0552b493a80"
}
]
},
"type_url": "type.googleapis.com/protocol.ShieldedTransferContract"
},
"type": "ShieldedTransferContract"
}
],
"ref_block_bytes": "0d59",
"ref_block_hash": "7356ce5c35d8265e",
"expiration": 1559237283000,
"timestamp": 1559201285590
},
"raw_data_hex": "0a020d5922087356ce5c35d8265e40b899a3ceb02d5a940b0833128f0b0a35747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e536869656c6465645472616e73666572436f6e747261637412d50a1acb020a20cbe1063adbe7e10919421fa6133f03150253913f5aff02d165e2c019cea4a8691220fb1115d5ddd16c5427c3a608d6b5add5967e70f51c890307c6142083a2c285651a2093e329d464e1dbddc8bb4d2dcc939a796dfe11e985d4e9033a15edf0e3df4f35222010c702d6dff1509502ee5acc0b01d4b4531b2ff53b0dd54488aea6031b5e6d162ac001abf64b3beacfd873b1db764c3da9f739993518f3f740e761cb8af60682b7171892895c3ccfb550c3cf757e906dbf5313a3676b8226b0b84960f76a185c8d3fdfc3fa9c08479a704852d7b3dfeb913cf13e01c25657561e00a06c61e7c65b50b812902ddc4f17bfe2bcb2f247c2dc6132d0f0e0abcecc0332fdd99077af10d07bbdb88c4fd257948428e233c57f84eee8b2eeab2162c1aeccf2e1dfaa306d5803a8b2d281a549440fbd5a3657a830c1ca07a384cea446aa077b195b29b23023b122c2070a20f6d45db8ec5a1c8dbbde040b4ea138efbe8db2d0597ed2306ff3fdd0620b3c5a1220ec3f5472ac8114a9a07987d1c2a0e1254504e352d9574971e77084293900312e1a20719eeb5ebaeeccc55c9f0d73767aadf0c0513603400ccb50bd789637d984b8e622c4043a6c4fe0e79f5b23fed34a419c4728d0b26bca23180a22871743b0a9444c27663cf07c55a0ea6db504d70421768bf17384e180b2ad8b8be88ff5cf662c53a4ba086effc3a4b1df39265f71dfac884bff5a69e1dcdcae8aecf6ae443168ffab692a5c1e4908b415dd830dcf6432fae1c32461132080da74d6b83d3d00887eb2ce9965a749f8d8410ea4182969371ac2fd5e0e74d27d883492a08e6209cd9959d74bb67c2a9fe7faac5a4777f1bff19cf0b6398a2faa9b194bbb93d60f132f382f7d693a722e8cbca1da084ee7e0c371397419a7259d1fa0943078cfe5ea352e4b53907bb6c04ca8ad409fb0ae0b110a6b312200e21ab79d543ae7aeb16802cf87afdac1e8954038caa42818f4ca2847fd642360c098accfeeade4abd1cc9ca3315a4336be224ba3516973c7dae3f41875457236675993df38d3a544470c4f9335d77b005e6a9aec40fd881b34852ec9bbbcc3d24ee92930eae770a5462ce04c4e37b0524ef07e00e8d58c810d6aefb19fa7bc2c3a2fdfab6dd4fe73dbecc0795a280f9b7ca35cc8bc1062aed8e26bd81ba33c6f4c318974636f6d796723e77772ced3dbc1f42afec6fc9bb61f8beac704affea9baf2e2de226250c1d427c7d78b1eb1d239e1f3eb6af0f017b80541333f4fce17340048d826b9b0be8477c996ad8bfc3440dc686fdff6d0d63986db4d95962d7977289cbfd14c745de7c79d4dc0bcd220e5b4ced5b409e79142e0f336e44ca29a9a87f6f43707d8c4936e895236dd2b393a478a8bc27b1f682496ba84a0ddc549da06cb7855c4d8680dc66ac40240733b7f2a5050be6e77854d4c427b2af4f16e5275f0b0c206b3ea2d2a24ffb287ea356f323523354cd83d15e7c48e6f1fa103dfca3d49ca2263dbb0cd8bfb35d72cdcad1351de6fba7a30aea27184a68bcda19cc6da32c001a4e6c50d5753092d005689922c2bdeafc98775bce59db840974163ace23c13fec18112e32aae1c39842c645ed172ad8fa277e63c1e3d6d7fb12eb15d56b573237b776f562a81d0e6be362d147d8604fdfec421482270ca82950de1883fda06e719f5d256d7a039769bffc570a1778d70c17295d1c0336a6ae0903d2460dc139a9563c2d40f37bffefa73003a55af1ff0861b6f79ef40099b6a0cb25ab3f40727210e4629647d0711abff125712a5f0d64fcb6e6a6b0b34478d7da0552b493a802a402b8ae5e11ecad3e6946f54b7ad513bd8692a3edae72d29e266b28e47c9b37ccdb38e3b6433575694b6681136b1734f85afcfe672061d2ee7368755ad0b96a80b70d68b8ebdb02d"
}'
参数说明：
transaction：交易对象
返回值：一笔匿名交易的hash
wallet/createshieldedtransaction
作用：创建匿名交易
请参照：[示例](Tron-shielded-transaction.md)
参数说明：
transparent_from_address：透明发送者的地址
from_amount：从透明地址转出的数额
ask：Ask
nsk：Nsk
ovk：Ovk
shielded_receives：匿名接收者信息
shieldedSpends：匿名发送者信息
transparent_to_address：透明接收者地址
to_amount：转入透明地址的数额
返回值：交易对象
wallet/getnewshieldedaddress
作用: 获得shieldedAddress
demo: curl -X GET http://127.0.0.1:8090/wallet/getnewshieldedaddress
参数说明: 无
返回值: Spending key
返回值: Ask key
返回值: Nsk key
返回值: Outgoing viewing key
返回值: Ak Key
返回值: Nk key
返回值: incoming viewing key
返回值: Diversifier
返回值: pkD
返回值: payment address
wallet/createshieldedcontractparameters
作用：创建匿名TRC20合约交易的相关参数，包括mint, transfer和burn三种类型
demo: curl -X POST http://127.0.0.1:8090/wallet/createshieldedcontractparameters -d
'{
"ask": "0f63eabdfe2bbfe08012f6bb2db024e6809c16e8ed055aa41a6095424f192005",
"nsk": "cd43d722fd4b6b01f19449ea826c3e935609648520fcc2a95c0026f0fa9ee404",
"ovk": "1797de3b7f33cafffe3fe18c6b43ec6760add2ad81b10978d1fca5290497ede9",
"from_amount": "5000",
"shielded_receives": {
"note": {
"value": 50,
"payment_address": "ztron15js0jkuxczt8caq5hp59rnh6rgf34sek7vqn9u6ljelxv4nuzz2x9qe3ffm2wzz6ck53yxyhxs6",
"rcm": "74baec30dfac8ed59968955ff245ae002009005194e5b824c35ab88c52e5170e"
}
},
"shielded_TRC20_contract_address": "41f3392eaa7d38749176e0671dbc6912f8ef956943"
}'
参数说明：
ask：Ask
nsk：Nsk
ovk：Outgoing view key
from_amount：mint的金额，根据缩放因子scalingFactor，和note值中的 value 成比例关系，即 from_amount = value * scalingFactor. 在上面的示例中，scalingFactor值为100
shielded_receives: 待创建的匿名合约notes
shielded_TRC20_contract_address: 匿名TRC20合约地址
返回值：匿名TRC20合约交易的参数
注意：根据待创建的匿名合约交易类型的不同，输入的参数不同
wallet/createshieldedcontractparameterswithoutask
作用：在没有Ask的情况下，创建匿名TRC20合约交易的相关参数，包括mint, transfer和burn三种类型
demo: curl -X POST http://127.0.0.1:8090/wallet/createshieldedcontractparameterswithoutask -d
'{
"ovk": "cd361834b3adc06f130de24f7d0c18f92a093cc885d9ce492cc6c02071f7a4f0",
"from_amount": "5000",
"shielded_receives": {
"note": {
"value": 50,
"payment_address": "ztron13lvfnt4rau4ad9mmgztd3aftw49e3amz8gm2kvyzrsaw0ugz2grxwkvcfys5e2gkchj7cnnetjz",
"rcm": "499e73f2f8aaf05fac41a35b8343bde27f6629cbe66d35da5364a99b94a55a06"
}
},
"shielded_TRC20_contract_address": "41f3392eaa7d38749176e0671dbc6912f8ef956943"
}'
参数说明：
ovk：Outgoing view key
from_amount：mint的金额，根据缩放因子 scalingFactor，和note值中的value成比例关系，即 from_amount = value * scalingFactor. 在上面的示例中，scalingFactor值为100
shielded_receives: 待创建的匿名合约notes
shielded_TRC20_contract_address: 匿名TRC20合约地址
返回值：匿名TRC20合约交易的参数
注意：根据待创建的匿名合约交易类型的不同，输入的参数不同
wallet/scanshieldedtrc20notesbyivk
作用：查询匿名TRC20合约中与ivk相关的所有notes, 并标记其是否已花费
demo: curl -X POST http://127.0.0.1:8090/wallet/scanshieldedtrc20notesbyivk -d
'{
"start_block_index": 9200,
"end_block_index": 9240,
"shielded_TRC20_contract_address": "41274fc7464fadac5c00c893c58bce6c39bf59e4c7",
"ivk": "9f8e74bb3d7188a2781dc1db38810c6914eef4570a79e8ec8404480948e4e305",
"ak":"8072d9110c9de9d9ade33d5d0f5890a7aa65b0cde42af7816d187297caf2fd64",
"nk":"590bf33f93f792be659fd404df91e75c3b08d38d4e08ee226c3f5219cf598f14"
}'
参数说明：
start_block_index：开始区块高度，包含自身
end_block_index：结束区块高度，不包含自身
shielded_TRC20_contract_address: 匿名TRC20合约地址
ivk：Incoming viewing key
ak：Ak key
nk：Nk key
返回值：Notes列表
注意：区间限制（end_block_index - start_block_index <= 1000）
wallet/scanshieldedtrc20notesbyovk
作用：查询匿名TRC20合约中与ovk相关的所有notes
demo: curl -X POST http://127.0.0.1:8090/wallet/scanshieldedtrc20notesbyovk -d
'{
"start_block_index": 9200,
"end_block_index": 9240,
"shielded_TRC20_contract_address": "41274fc7464fadac5c00c893c58bce6c39bf59e4c7",
"ovk": "0ff58efd75e083fe4fd759c8701e1c8cb6961c4297a12b2c800bdb7b2bcab889"
}'
参数说明：
start_block_index：开始区块高度，包含自身
end_block_index：结束区块高度，不包含自身
shielded_TRC20_contract_address: 匿名TRC20合约地址
ovk：Outgoing viewing key
返回值：Notes列表
注意：区间限制（end_block_index - start_block_index <= 1000）
wallet/isshieldedtrc20contractnotespent
作用：查询匿名TRC20合约的note是否已被花费
demo: curl -X POST http://127.0.0.1:8090/wallet/scanshieldedtrc20notesbyovk -d
'{
"note": {
"value": 40,
"payment_address":"ztron1768kf7dy4qquefp46szk978d65eeua66yhr4zv260c0uzj68t3tfjl3en9lhyyfxalv4jus30xs",
"rcm": "296070782a94c6936b0b4f6daf8d7c7605a4374fe595b96148dc0f4b59015d0d"
},
"ak": "8072d9110c9de9d9ade33d5d0f5890a7aa65b0cde42af7816d187297caf2fd64",
"nk": "590bf33f93f792be659fd404df91e75c3b08d38d4e08ee226c3f5219cf598f14",
"position": 272,
"shielded_TRC20_contract_address": "41274fc7464fadac5c00c893c58bce6c39bf59e4c7"
}'
参数说明：
note：Note信息
ak：Ak
nk：Nk
position：note承诺在匿名合约Merkle树叶子节点的位置索引
shielded_TRC20_contract_address: 匿名TRC20合约地址
返回值：一个note是否已经被花费状态
注意: Note 中value是由 scalingFactor缩放后的值，scalingFactor在匿名TRC-20合约中设置，实际金额 `real_amount` = `value` * `scalingFactor`。
- wallet/gettriggerinputforshieldedtrc20contract
作用: 对于没有授权签名的匿名TRC-20合约参数，生成触发合约的输入数据
demo: curl -X POST http://127.0.0.1:8090/wallet/gettriggerinputforshieldedtrc20contract -d
'{
"shielded_TRC20_Parameters": {"spend_description": [{"value_commitment": "e3fcc8609ff6a4b00b77a00ef624f305cec5f55cc7312ff5526d0b3057f2ef9e","anchor": "4c9cbebece033dc1d253b93e4a3682187daae4f905515761d10287b801e69816","nullifier": "74edce8798a3976ee41e045bb666f3a121c27235b0f1b44b3456d2c84bc725dc","rk": "9dcf4254aa7c4fb7c8bc6956d4b0c7c6c87c37a2552e7bf4e60c12cb5bc6c8cd","zkproof": "9926045cd1442a7d20153e6abda9f77a6526895f0a29a57cb1bc76ef6b7cacef2d0f4c94aa97c3acacdb95cabb065057b7edb4cbea098149a8aa7114a6a6b340c58007ac64b64e592eb18fdd299de5962a2a32ab0caebb2ab198704c751a9d0e143d68a50257d7c9e2230a7420fa46450299fd167141367e201726532d8e815413d8571d6c8c12937674dec92caf1f4583ebe560ac4c7eba290deee0a1c0da5f72c0b9df89fb3b338c683b654b3dc2373a4c2a4fef7f4fa489b44405fb7d2bfb"}],"binding_signature": "11e949887d9ec92eb32c78f0bc48afdc9a16a2ecbd5a0eca1be070fb900eeda347918bd6e9521d4baf1f74963bee0c1956559623a9e7cbc886941b227341ea06","message_hash": "7e6a00736c4f9e0036cb74c7fa3b1e3cd8f6bf0f038edeb03b668c4c5536a357","parameter_type": "burn"},
"spend_authority_signature": [
{
"value": "eeaaecd725ac80ec398b95cf188b769c1be66cc8e76e6c90843b7f23818704595719ce8bf694ffb8cd7aaa8739d50fe8eea7ba39d5026c4b019c973185ca7201"
}
],
"amount": "6000",
"transparent_to_address": "4140cd765f8e637a2bbe00f9bc458f6b21eb0e648f"
}'
参数说明:
shielded_TRC20_Parameters: 生成的匿名TRC-20合约参数
spend_authority_signature: 授权签名
amount: 交易金额
transparent_to_address: 接收者地址.
返回值: 触发TRC-20合约的输入数据
wallet/marketsellasset
作用：创建订单
demo: curl -X POST http://127.0.0.1:8090/wallet/marketsellasset -d
'{
"owner_address": "4184894b42f66dce8cb84aec2ed11604c991351ac8",
"sell_token_id": "5f",
"sell_token_quantity": 100,
"buy_token_id": "31303030303031",
"buy_token_quantity": 200
}'
参数说明：
owner_address：订单发起者地址，默认为hexString格式
sell_token_id：卖出asset的id，默认为hexString格式
sell_token_quantity：卖出asset的数量
buy_token_id：买入asset的id，默认为hexString格式
buy_token_quantity：最少买入的asset的数量
返回值：交易对象
wallet/marketcancelorder
作用：取消订单
demo: curl -X POST http://127.0.0.1:8090/wallet/marketcancelorder -d
'{
"owner_address": "4184894b42f66dce8cb84aec2ed11604c991351ac8",
"order_id": "0a7af584a53b612bcff1d0fc86feab05f69bc4528f26a4433bb344d453bd6eeb"
}'
参数说明：
owner_address：订单发起者地址，默认为hexString格式
order_id：取消订单的id
返回值：交易对象
wallet/getmarketorderbyaccount
作用：查询账户拥有的订单
demo: curl -X POST http://127.0.0.1:8090/wallet/getmarketorderbyaccount -d
'{
"value": "4184894b42f66dce8cb84aec2ed11604c991351ac8"
}'
参数说明：
value：地址，默认为hexString格式
返回值：订单列表
wallet/getmarketpairlist
作用：查询存在的所有交易对
demo: curl -X get http://127.0.0.1:8090/wallet/getmarketpairlist
参数说明：
无
返回值：交易对列表
wallet/getmarketorderlistbypair
作用：查询某交易对的所有订单
demo: curl -X POST http://127.0.0.1:8090/wallet/getmarketorderlistbypair -d
'{
"sell_token_id": "5f" ,
"buy_token_id": "31303030303031"
}'
参数说明：
sell_token_id：卖出asset的id，默认为hexString格式
buy_token_id：买入asset的id，默认为hexString格式
返回值：订单列表
wallet/getmarketpricebypair
作用：查询某交易对的所有价格
demo: curl -X POST http://127.0.0.1:8090/wallet/getmarketpricebypair -d
'{
"sell_token_id": "5f"
"buy_token_id": "31303030303031"
}'
参数说明：
sell_token_id：卖出asset的id，默认为hexString格式
buy_token_id：买入asset的id，默认为hexString格式
返回值：价格列表
wallet/getmarketorderbyid
作用：查询订单
demo: curl -X POST http://127.0.0.1:8090/wallet/getmarketorderbyid -d
'{
"value": "orderid"
}'
参数说明：
value：order id，默认为hexString格式
返回值：订单
wallet/getburntrx
作用：查询烧掉的trx总量
demo: curl -X get http://127.0.0.1:8090/wallet/getburntrx
参数说明：
无
返回值：烧掉的trx总量
wallet/gettransactionfrompending
作用：查询pending pool中的交易信息
demo: curl -X POST http://127.0.0.1:8090/wallet/gettransactionfrompending -d
'{
"value": "txId"
}'
参数说明：
value: 交易id，默认为hexString格式
返回值：交易的详细信息
wallet/gettransactionlistfrompending
作用：查询pending pool交易列表id
demo: curl -X get http://127.0.0.1:8090/wallet/gettransactionlistfrompending
参数说明：
无
返回值：pending pool交易列表id
wallet/getpendingsize
作用：查询pending pool大小
demo: curl -X get http://127.0.0.1:8090/wallet/getpendingsize
参数说明：
无
返回值：pending pool 大小