HTTP API 接口¶

本章节介绍节点的HTTP API及其用法。

首先，对HTTP API中地址格式的选择进行说明：TRON网络账户地址格式有两种：HexString格式和Base58格式。节点HTTP API支持地址格式选择，用户可以通过visible参数设置地址格式，默认值为false，参数及返回值中的地址格式均为hex格式，当visible设置为true时，参数及返回值中的地址格式均为Base58格式。如果参数格式与visible设置不匹配，将会报错。设置方式：

对于GET方式请求接口或者不需要参数的查询接口，通过在url中增加参数visible=true
```
http://127.0.0.1:8090/wallet/listexchanges?visible=true
```

对于POST方式请求接口，通过在json结构体最外层中增加参数"visible": true

curl -X POST http://127.0.0.1:8090/wallet/createtransaction -d
'{
    "owner_address": "TRGhNNfnmgLegT4zHNjEqDSADjgmnHvubJ",
    "to_address": "TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW",
    "amount": 1000000,
    "visible": true
}'

Fullnode HTTP API¶

FullNode HTTP API分类如下:

链上账户
转账和交易
账户资源
查询链上数据
智能合约
TRC-10通证
投票和SR
提案
去中心化交易所
TRONZ 匿名智能合约
Pending Pool

链上帐户¶

下面是链上账户相关API：

wallet/validateaddress
wallet/createaccount
wallet/getaccount
wallet/updateaccount
wallet/accountpermissionupdate
wallet/getaccountbalance
wallet/setaccountid
wallet/getaccountbyid

wallet/validateaddress¶

作用：检查地址是否正确

curl -X POST  http://127.0.0.1:8090/wallet/validateaddress -d '{"address": "4189139CB1387AF85E3D24E212A008AC974967E561"}'

参数说明：地址，可以是base58checksum、hexString、base64格式

返回值：地址正确或者错误

wallet/createaccount¶

作用：创建账号，一个已经激活的账号创建一个新账号。如果创建者账号有足够的通过质押TRX获得的带宽，那么创建账户只会消耗带宽，否则，会烧掉0.1个TRX来支付带宽费用，同时需要额外支付 1 TRX的创建费用

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/getaccount¶

作用：查询一个账户的信息

curl -X POST  http://127.0.0.1:8090/wallet/getaccount -d '{"address": "41E552F6487585C2B58BC2C9BB4492BC1F17132CD0"}'

参数：address 账户地址

返回值：Account对象

wallet/updateaccount¶

作用：修改账号名称

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/accountpermissionupdate¶

作用：修改账户权限

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/getaccountbalance¶

作用：查询账户历史余额

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/setaccountid¶

作用：设置一个账户的accountID

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查询一个账号的信息

curl -X POST  http://127.0.0.1:8090/wallet/getaccountbyid -d
'{"account_id":"6161616162626262"}'

参数说明：account_id 默认为hexString格式

返回值：Account对象

转账和交易¶

下面是转账和交易相关API：

wallet/createtransaction
wallet/broadcasttransaction
wallet/broadcasthex
wallet/getsignweight
wallet/getapprovedlist

wallet/createtransaction¶

作用：创建一个转账的Transaction，如果转账的to地址不存在，则在区块链上创建该账号

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/broadcasttransaction¶

作用：对签名后的transaction进行广播

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进行广播

curl -X POST  http://127.0.0.1:8090/wallet/broadcasthex -d '{"transaction":"0A8A010A0202DB2208C89D4811359A28004098A4E0A6B52D5A730802126F0A32747970652E676F6F676C65617069732E636F6D2F70726F746F636F6C2E5472616E736665724173736574436F6E747261637412390A07313030303030311215415A523B449890854C8FC460AB602DF9F31FE4293F1A15416B0580DA195542DDABE288FEC436C7D5AF769D24206412418BF3F2E492ED443607910EA9EF0A7EF79728DAAAAC0EE2BA6CB87DA38366DF9AC4ADE54B2912C1DEB0EE6666B86A07A6C7DF68F1F9DA171EEE6A370B3CA9CBBB00"}'

参数：签名之后的Transaction hex

返回值：广播是否成功

wallet/getsignweight¶

作用：查询多重签名的交易的相关信息

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¶

作用：查询多重签名的交易的相关信息

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}'

参数整体是一个完整的交易

返回值:已签名权重是否达到阈值（即是否满足验签标准），签名地址列表，交易信息。

帐户资源¶

下面是链上资源相关API：

wallet/getaccountresource
wallet/getaccountnet
wallet/unfreezebalance
wallet/getdelegatedresource
wallet/getdelegatedresourceaccountindex
wallet/freezebalancev2
wallet/unfreezebalancev2
wallet/cancelallunfreezev2
wallet/delegateresource
wallet/undelegateresource
wallet/withdrawexpireunfreeze
wallet/getavailableunfreezecount
wallet/getcanwithdrawunfreezeamount
wallet/getcandelegatedmaxsize
wallet/getdelegatedresourcev2
wallet/getdelegatedresourceaccountindexv2

wallet/getaccountresource¶

作用：查询账户的资源信息

curl -X POST  http://127.0.0.1:8090/wallet/getaccountresource -d {"address" : "419844f7600e018fd0d710e2145351d607b3316ce9"}

参数：

address：查询账户的地址，默认为hexString格式

返回值：账户的资源信息

wallet/getaccountnet¶

作用：查询带宽信息。

curl -X POST  http://127.0.0.1:8090/wallet/getaccountnet -d '{"address": "4112E621D5577311998708F4D7B9F71F86DAE138B5"}'

参数：address - 账户地址

返回值：带宽信息

wallet/freezebalance¶

作用：质押trx，获取带宽，获取投票权。该接口已废弃，请使用freezebalancev2进行质押。

wallet/unfreezebalance¶

作用：解锁Stake1.0阶段质押的，并已经结束质押期的trx，会同时失去这部分trx带来的带宽和投票权

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/getdelegatedresource¶

作用：查看一个账户代理给另外一个账户的资源情况

curl -X POST  http://127.0.0.1:8090/wallet/getdelegatedresource -d '
{
"fromAddress": "419844f7600e018fd0d710e2145351d607b3316ce9",
"toAddress": "41c6600433381c731f22fc2b9f864b14fe518b322f"
}'

参数：

fromAddress：是要查询的账户地址，默认为hexString格式
toAddress：代理对象的账户地址，默认为hexString格式

返回值：账户的资源代理的列表，列表的元素为DelegatedResource

wallet/getdelegatedresourceaccountindex¶

作用：查看一个账户给哪些账户代理了资源

curl -X POST  http://127.0.0.1:8090/wallet/getdelegatedresourceaccountindex -d '
{
"value": "419844f7600e018fd0d710e2145351d607b3316ce9",
}'

参数：

value：是要查询的账户地址，默认为hexString格式

返回值：账户的资源代理概况，结构为DelegatedResourceAccountIndex

wallet/freezebalancev2¶

作用：质押TRX

curl -X POST http://127.0.0.1:8090/wallet/freezebalancev2 -d
'{
    "owner_address": "41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
    "frozen_balance": 10000,
    "resource": "BANDWIDTH"
}'

参数：

owner_address: 质押TRX 账号的地址, HEX 格式或 Base58check 格式
frozen_balance: 质押TRX 的数量, 单位为sun
resource: 质押TRX 获取资源的类型, 可以是 BANDWIDTH 或者 ENERGY
permission_id: 可选参数，多重签名时使用

返回值：未签名的交易对象

wallet/unfreezebalancev2¶

作用：解锁通过Stake2.0机制质押的TRX, 释放所相应数量的带宽和能量，同时回收相应数量的投票权(TP)

curl -X POST http://127.0.0.1:8090/wallet/unfreezebalancev2 -d
'{
    "owner_address": "41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
    "unfreeze_balance": 1000000,
    "resource": "BANDWIDTH"
}'

参数：

owner_address: 解锁TRX 账号的地址, HEX 格式或 Base58check 格式
resource: 资源类型, BANDWIDTH 或者 ENERGY
unfreeze_balance: 解质押的TRX数量，单位为sun
permission_id: 可选参数，多重签名时使用

返回值：未签名的交易对象

wallet/cancelallunfreezev2¶

作用：取消所有未完成的解质押，将过期的解质押金额提取到账户余额中，将未过期的解质押金额重新质押

curl -X POST http://127.0.0.1:8090/wallet/cancelallunfreezev2 -d
'{
    "owner_address": "41e472f387585c2b58bc2c9bb4492bc1f17342cd1"
}'

参数：

owner_address: 账户地址, HEX 格式或 Base58check 格式
permission_id: 可选参数，多重签名时使用

返回值：未签名的交易对象

wallet/delegateresource¶

作用：将带宽或者能量资源代理给其它账户

curl -X POST http://127.0.0.1:8090/wallet/delegateresource -d
'{
    "owner_address": "41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
    "receiver_address": "41d1e7a6bc354106cb410e65ff8b181c600ff14292",
    "balance": 1000000,
    "resource": "BANDWIDTH",
    "lock": false
}'

参数：

owner_address: 交易发起者账号的地址, HEX 格式或 Base58check 格式
receiver_address: 资源的接收账户地址, HEX 格式或 Base58check 格式
balance: 代理balance数量的TRX所对应的资源给目标地址, 单位为sun
resource: 代理的资源类型, BANDWIDTH 或者 ENERGY
lock: true表示为该资源代理操作设置三天的锁定期，即资源代理给目标地址后的三天内不可以取消对其的资源代理，如果锁定期内，再次代理资源给同一目标地址，则锁定期将重新设置为3天。false表示本次资源代理没有锁定期，可随时取消对目标地址的资源代理
lock_period: 锁定周期，以区块时间（3s）为单位，表示锁定多少个区块的时间，当lock为true时，该字段有效。如果代理锁定期为1天，则lock_period为：28800
permission_id: 可选参数，多重签名时使用

返回值：未签名的交易对象

wallet/undelegateresource¶

作用：取消为目标地址代理的带宽或者能量

curl -X POST http://127.0.0.1:8090/wallet/undelegateresource -d
'{
    "owner_address": "41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
    "receiver_address": "41d1e7a6bc354106cb410e65ff8b181c600ff14292",
    "balance": 1000000,
    "resource": "BANDWIDTH"
}'

参数：

owner_address: 交易发起者账号的地址, HEX 格式或 Base58check 格式
receiver_address: 资源的接收账户地址, 也就是取消为该地址的资源代理。 HEX 格式或 Base58check 格式
balance: 取消代理 balance数量的TRX所对应的资源, 单位为sun
resource: 取消代理的资源类型, BANDWIDTH 或者 ENERGY
permission_id: 可选参数，多重签名时使用

返回值：未签名的交易对象

wallet/withdrawexpireunfreeze¶

作用：提取已过锁定期的解质押的本金

curl -X POST http://127.0.0.1:8090/wallet/withdrawexpireunfreeze -d
'{
    "owner_address": "41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
}'

参数：

owner_address: 交易发起者账号的地址, HEX 格式或 Base58check 格式
permission_id: 可选参数，多重签名时使用

返回值：未签名的交易对象

wallet/getavailableunfreezecount¶

作用：查询当前解质押剩余次数

curl -X POST http://127.0.0.1:8090/wallet/getavailableunfreezecount -d
'{
  "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "visible": true
}
'

参数：

owner_address: 交易发起者账号的地址

返回值：解质押的剩余次数

wallet/getcanwithdrawunfreezeamount¶

作用：查询在某时间点可以提取的解质押本金数量

curl -X POST http://127.0.0.1:8090/wallet/getcanwithdrawunfreezeamount -d
'{
  "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "timestamp": 1667977444000,
  "visible": true
}
'

参数：

owner_address: 交易发起者账号的地址
timestamp: 查询在该时间戳时，可提取的本金数量，单位为毫秒

返回值：解质押本金可提取数量

wallet/getcandelegatedmaxsize¶

作用：查询目标地址中指定类型资源的可代理数量，单位为sun

curl -X POST http://127.0.0.1:8090/wallet/getcandelegatedmaxsize -d
'{
  "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "type": 0,
  "visible": true
}
'

参数：

owner_address: 交易发起者账号的地址
type: 资源类型，0为带宽，1为能量

返回值：可代理带宽或者能量份额的最大值（单位为sun）

wallet/getdelegatedresourcev2¶

作用：查询在Stake2.0机制下，某地址代理给目标地址的资源情况

curl -X POST http://127.0.0.1:8090/wallet/getdelegatedresourcev2 -d
'{
  "fromAddress": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "toAddress": "TPswDDCAWhJAZGdHPidFg5nEf8TkNToDX1",
  "visible": true
}
'

参数：

fromAddress: 代理账户地址
toAddress: 资源的接收账户地址

返回值：某地址代理给目标地址的资源情况的列表

wallet/getdelegatedresourceaccountindexv2¶

作用：查询在Stake2.0阶段，某地址的资源委托索引。返回两个列表，一个是该帐户将资源委托给的地址列表(toAddress)，另一个是将资源委托给该帐户的地址列表(fromAddress)

curl -X POST http://127.0.0.1:8090/wallet/getdelegatedresourceaccountindexv2 -d
'{
  "value": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "visible": true
}
'

参数：

value: 账户地址

返回值：某地址的资源委托索引。返回两个列表，一个是该帐户将资源委托给的地址列表(toAddress)，另一个是将资源委托给该帐户的地址列表(fromAddress)

查询链上数据¶

下面是查询链上数据相关API：

wallet/getnowblock
wallet/getblock
wallet/getblockbynum
wallet/getblockbyid
wallet/getblockbylatestnum
wallet/getblockbylimitnext
wallet/getblockbalance
wallet/gettransactionbyid
wallet/gettransactioninfobyid
wallet/gettransactioncountbyblocknum
wallet/gettransactioninfobyblocknum
wallet/listnodes
wallet/getnodeinfo
wallet/getchainparameters
wallet/getenergyprices
wallet/getbandwidthprices
wallet/getburntrx

wallet/getnowblock¶

作用：查询最新块。

curl -X POST  http://127.0.0.1:8090/wallet/getnowblock

参数说明：无

返回值：当前块。

wallet/getblock¶

作用：根据区块高度或者区块哈希查询区块头信息或者整个区块信息

curl -X POST  http://127.0.0.1:8090/wallet/getblock -d '{"detail":false}'

参数:

id_or_num: 区块高度或者区块哈希，不设置表示查询最新区块
detail: 默认为false，表示只查询区块头信息，true表示查询整个区块

返回值：区块或者区块头。

wallet/getblockbynum¶

作用：通过高度查询块

curl -X POST  http://127.0.0.1:8090/wallet/getblockbynum -d '{"num": 1}'

参数说明：块高度。

返回值：块。

wallet/getblockbyid¶

作用：通过ID查询块

curl -X POST  http://127.0.0.1:8090/wallet/getblockbyid -d '{"value": "0000000000038809c59ee8409a3b6c051e369ef1096603c7ee723c16e2376c73"}'

参数说明：块ID。

返回值：块。

wallet/getblockbylatestnum¶

作用：查询最新的几个块

curl -X POST  http://127.0.0.1:8090/wallet/getblockbylatestnum -d '{"num": 5}'

参数说明：块的数量。

返回值：块的列表。

wallet/getblockbylimitnext¶

作用：按照范围查询块

curl -X POST  http://127.0.0.1:8090/wallet/getblockbylimitnext -d '{"startNum": 1, "endNum": 2}'

参数说明：

startNum：起始块高度，包含此块
endNum：截止块高度，不包含此此块

返回值：块的列表。

wallet/getblockbalance¶

作用：获取一个区块中所有的余额变化操作

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查询交易

curl -X POST  http://127.0.0.1:8090/wallet/gettransactionbyid -d '{"value": "d5ec749ecc2a615399d8a6c864ea4c74ff9f523c2be0e341ac9be5d47d7c2d62"}'

参数说明：交易ID。

返回值：交易信息。

wallet/gettransactioninfobyid¶

作用：根据id查询交易的fee，所在的block

curl -X POST  http://127.0.0.1:8090/wallet/gettransactioninfobyid -d '{"value" : "309b6fa3d01353e46f57dd8a8f27611f98e392b50d035cef213f2c55225a8bd2"}'

参数说明：value是交易id

返回值：Transaction的交易fee，所在block的高度，创建时间

wallet/gettransactioncountbyblocknum¶

作用：查询特定block上transaction的个数

curl -X POST  http://127.0.0.1:8090/wallet/gettransactioncountbyblocknum -d '{"num" : 100}'

参数说明：num是块的高度.

返回值：transaction的个数.

wallet/gettransactioninfobyblocknum¶

作用：获取特定区块的所有交易 Info 信息

curl -X POST  http://127.0.0.1:8090/wallet/gettransactioninfobyblocknum -d '{"num" : 100}'

参数说明：num是块的高度.

返回值：指定块中，包含的transactioninfo的列表.

wallet/listnodes¶

作用：查询api所在机器连接的节点。

curl -X POST  http://127.0.0.1:8090/wallet/listnodes

参数说明：无

返回值：节点列表。

wallet/getnodeinfo¶

作用：查看节点的信息

curl  http://127.0.0.1:8090/wallet/getnodeinfo

返回值：节点当前状态的相关信息

wallet/getchainparameters¶

作用：查询TRON网络动态参数

curl -X POST  http://127.0.0.1:8090/wallet/getchainparameters

返回值：区块链委员会可以设置的所有参数

wallet/getenergyprices¶

作用：查询能量单价历史

curl -X POST  http://127.0.0.1:8090/wallet/getenergyprices

返回值：所有历史能量单价信息。每次单价变动以逗号分隔，冒号前为毫秒时间戳，冒号后为以sun为单位的能量单价。

wallet/getbandwidthprices¶

作用：查询带宽单价历史

curl -X POST  http://127.0.0.1:8090/wallet/getbandwidthprices

返回值：所有历史带宽单价信息。每次单价变动以逗号分隔，冒号前为毫秒时间戳，冒号后为以sun为单位的带宽单价。

wallet/getburntrx¶

作用：查询燃烧的TRX数量

curl -X POST  http://127.0.0.1:8090/wallet/getburntrx

返回值：燃烧的TRX数量，以sun为单位。

智能合约¶

下面是智能合约相关API：

wallet/getcontract
wallet/getcontractinfo
wallet/deploycontract
wallet/triggersmartcontract
wallet/triggerconstantcontract
wallet/updatesetting
wallet/updateenergylimit
wallet/clearabi
wallet/estimateenergy

wallet/getcontract¶

作用：获取合约

curl -X POST  http://127.0.0.1:8090/wallet/getcontract -d '{"value":"4189139CB1387AF85E3D24E212A008AC974967E561"}'

参数说明：value：合约地址，默认为hexString格式

返回值：SmartContract，智能合约的内容

wallet/getcontractinfo¶

作用：获取合约

curl -X POST  http://127.0.0.1:8090/wallet/getcontractinfo -d '{"value":"4189139CB1387AF85E3D24E212A008AC974967E561"}'

参数说明：value：合约地址，默认为hexString格式

返回值：查询链上的合约信息。与wallet/getcontract接口不同的是，该接口不仅返回bytecode还会返回合约的runtime bytecode。runtime bytecode相比bytecode，不包含构造函数以及构造函数的参数信息。

wallet/deploycontract¶

作用：部署合约

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¶

作用：调用合约

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]转化为虚拟机所需要的参数格式
data：与智能合约进行交互的数据，包括所调用的合约函数和参数。可以选择通过该字段，也可以选择通过function_selector和parameter进行合约交互，当data与function_selector同时存在时，使用function_selector进行合约交互
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/triggerconstantcontract¶

作用：调用常量合约，产生的交易不上链

curl -X POST  http://127.0.0.1:8090/wallet/triggerconstantcontract -d '{"contract_address":"4189139CB1387AF85E3D24E212A008AC974967E561","function_selector":"set(uint256,uint256)","parameter":"00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002","call_value":100,"owner_address":"41D1E7A6BC354106CB410E65FF8B181C600FF14292"}'

参数说明：

contract_address，默认为hexString格式
function_selector，函数签名，不能有空格
parameter：调用参数[1,2]的虚拟机格式，使用remix提供的js工具，将合约调用者调用的参数数组[1,2]转化为虚拟机所需要的参数格式
data：合约字节码或者与智能合约进行交互的数据，包括所调用的合约函数和参数。可以选择通过该字段，也可以选择通过function_selector和parameter进行合约交互，当data与function_selector同时存在时，优先使用function_selector
owner_address：发起triggercontract的账户地址，默认为hexString格式
call_value：本次调用往合约转账的SUN（1TRX = 1,000,000SUN）
call_token_value:本次调用往合约中转账10币的数量，如果不设置token_id，这项设置为0或者不设置
token_id:本次调用往合约中转账10币的id，如果没有，不需要设置

返回值：TransactionExtention, TransactionExtention中包含未签名的交易Transaction

wallet/updatesetting¶

作用：更新合约的consume_user_resource_percent

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

curl -X POST  http://127.0.0.1:8090/wallet/updateenergylimit -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/clearabi¶

作用：创建清除智能合约ABI的交易对象

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/estimateenergy¶

作用：预估智能合约交易执行成功需要提供的能量

curl -X POST  http://127.0.0.1:8090/wallet/estimateenergy -d '{
  "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "contract_address": "TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs",
  "function_selector": "transfer(address,uint256)",
  "parameter": "00000000000000000000004115208EF33A926919ED270E2FA61367B2DA3753DA0000000000000000000000000000000000000000000000000000000000000032",
  "visible": true
}'

参数说明：

contract_address，默认为hexString格式
function_selector，函数签名，不能有空格
parameter：调用参数[1,2]的虚拟机格式，使用remix提供的js工具，将合约调用者调用的参数数组[1,2]转化为虚拟机所需要的参数格式
data：合约字节码或者与智能合约进行交互的数据，包括所调用的合约函数和参数。可以选择通过该字段，也可以选择通过function_selector和parameter进行合约交互，当data与function_selector同时存在时，优先使用function_selector
fee_limit：最大消耗的SUN（1TRX = 1,000,000SUN）
owner_address：发起triggercontract的账户地址，默认为hexString格式
call_value：本次调用往合约转账的SUN（1TRX = 1,000,000SUN）
call_token_value:本次调用往合约中转账10币的数量，如果不设置token_id，这项设置为0或者不设置
token_id:本次调用往合约中转账10币的id，如果没有，不需要设置

返回值：能量预估值

TRC10通证¶

下面是TRC10代币相关API：

wallet/getassetissuebyaccount
wallet/getassetissuebyname
wallet/getassetissuelistbyname
wallet/getassetissuebyid
wallet/getassetissuelist
wallet/getpaginatedassetissuelist
wallet/transferasset
wallet/participateassetissue
wallet/createassetissue
wallet/unfreezeasset
wallet/updateasset

wallet/getassetissuebyaccount¶

作用：查询账户发行的token。

curl -X POST  http://127.0.0.1:8090/wallet/getassetissuebyaccount -d '{"address": "41F9395ED64A6E1D4ED37CD17C75A1D247223CAF2D"}'

参数说明：发行者账户地址，默认为hexString格式

返回值：用户发行的token（一个用户只能发行一个token）。

wallet/getassetissuebyname¶

作用：根据名称查询token。

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¶

作用：根据名称查询token list。

curl -X POST  http://127.0.0.1:8090/wallet/getassetissuelistbyname -d '{"value": "44756354616E"}'

参数说明：通证名称，默认为hexString格式

返回值：token列表。

wallet/getassetissuebyid¶

作用：根据id查询token。

curl -X POST  http://127.0.0.1:8090/wallet/getassetissuebyid -d '{"value": "1000001"}'

参数说明：通证id

返回值：token。

wallet/getassetissuelist¶

作用：查询所有token列表

curl -X POST  http://127.0.0.1:8090/wallet/getassetissuelist

参数说明：无

返回值：token列表。

wallet/getpaginatedassetissuelist¶

作用：分页查询token列表

curl -X POST  http://127.0.0.1:8090/wallet/getpaginatedassetissuelist -d '{"offset": 0, "limit": 10}'

参数说明：offset是起始Token的index，limit是期望返回的Token数量

返回值：token列表。

wallet/transferasset¶

作用：转账Token

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/participateassetissue¶

作用：参与token发行

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/createassetissue¶

作用：发行Token

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/unfreezeasset¶

作用：解锁已经结束质押期的Token

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/updateasset¶

作用：修改token信息

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

投票和SR¶

下面是投票和SR相关API：

wallet/createwitness
wallet/updatewitness
wallet/listwitnesses
wallet/withdrawbalance
wallet/votewitnessaccount
wallet/getBrokerage
wallet/updateBrokerage
wallet/getReward
wallet/getnextmaintenancetime

wallet/createwitness¶

作用：申请成为超级代表

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/updatewitness¶

作用：修改witness的url

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/listwitnesses¶

作用：查询所有witness列表

curl -X POST  http://127.0.0.1:8090/wallet/listwitnesses

参数说明：无

返回值：witness列表。

wallet/withdrawbalance¶

作用：超级代表提现奖励到balance，每24个小时可以提现一次

curl -X POST http://127.0.0.1:8090/wallet/withdrawbalance -d '{
"owner_address":"41e472f387585c2b58bc2c9bb4492bc1f17342cd1",
}'

参数说明：

owner_address是提现账号的地址，默认为hexString格式
Permission_id可选参数，多重签名时使用，设置交易多重签名时使用的permissionId

返回值：提现Trx的transaction

wallet/votewitnessaccount¶

作用：对超级代表进行投票

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比例

curl -X GET  http://127.0.0.1:8090/wallet/getBrokerage -d '{
"address":"41E552F6487585C2B58BC2C9BB4492BC1F17132CD0"}'

参数说明：address是被投票的超级代表的地址，默认为hexString格式

返回值：witness当前Brokerage比例

wallet/updateBrokerage¶

作用：更新witness当前Brokerage比例

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/getReward¶

作用：查询投票人未领取的奖励

curl -X GET
http://127.0.0.1:8090/wallet/getReward -d '{
"address":"41E552F6487585C2B58BC2C9BB4492BC1F17132CD0"}'

参数说明：address是投票人地址，默认为hexString格式

返回值：投票人未领取的奖励

wallet/getnextmaintenancetime¶

作用：获取下次统计投票的时间

curl -X POST  http://127.0.0.1:8090/wallet/getnextmaintenancetime

参数说明：无

返回值：下次统计投票时间的毫秒数。

提案¶

下面是提案相关API：

wallet/proposalcreate
wallet/getproposalbyid
wallet/listproposals
wallet/proposalapprove
wallet/proposaldelete
wallet/getpaginatedproposallist

wallet/proposalcreate¶

作用：创建提案

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查询提案

curl -X POST  http://127.0.0.1:8090/wallet/getproposalbyid -d {"id":1}

参数说明：id：提案id

返回值：提案详细信息

wallet/listproposals¶

作用：查询所有提案

curl -X POST  http://127.0.0.1:8090/wallet/listproposals

参数说明：无

返回值：提案列表信息

wallet/proposalapprove¶

作用：提案批准

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¶

作用：删除提案

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/getpaginatedproposallist¶

作用：分页查询proposal列表

curl -X POST  http://127.0.0.1:8090/wallet/getpaginatedproposallist -d '{"offset": 0, "limit": 10}'

参数说明：offset是起始Token的index，limit是期望返回的Token数量

返回值：token列表。

去中心化交易所¶

下面是去中心化交易所相关API：

wallet/exchangecreate
wallet/exchangeinject
wallet/exchangewithdraw
wallet/exchangetransaction
wallet/getexchangebyid
wallet/listexchanges
wallet/getpaginatedexchangelist
wallet/marketsellasset
wallet/marketcancelorder
wallet/getmarketorderbyaccount
wallet/getmarketpairlist
wallet/getmarketorderlistbypair
wallet/getmarketpricebypair
wallet/getmarketorderbyid

wallet/exchangecreate¶

作用：创建交易对

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¶

作用：给交易对注资，注资后可以防止交易对价格波动太大

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¶

作用：对交易对撤资，撤资后容易引起交易对价格波动太大。

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¶

作用：参与交易对交易。

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查询交易对

curl -X POST  http://127.0.0.1:8090/wallet/getexchangebyid -d {"id":1}

参数说明：id：交易对id

返回值：交易对

wallet/listexchanges¶

作用：查询所有交易对

curl -X POST  http://127.0.0.1:8090/wallet/listexchanges

参数说明：无

返回值：所有交易对

wallet/getpaginatedexchangelist¶

作用：分页查询交易对列表

curl -X POST  http://127.0.0.1:8090/wallet/getpaginatedexchangelist -d '{"offset": 0, "limit":10}'

参数说明：offset是起始交易对的index，limit是期望返回的交易对数量

返回值：exchange列表

wallet/marketsellasset¶

作用：创建订单

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¶

作用：取消订单

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¶

作用：查询账户拥有的订单

curl -X POST  http://127.0.0.1:8090/wallet/getmarketorderbyaccount -d
'{
    "value": "4184894b42f66dce8cb84aec2ed11604c991351ac8"
}'

参数说明：

value：地址，默认为hexString格式

返回值：订单列表

wallet/getmarketpairlist¶

作用：查询存在的所有交易对

curl -X get  http://127.0.0.1:8090/wallet/getmarketpairlist

参数说明：无

返回值：交易对列表

wallet/getmarketorderlistbypair¶

作用：查询某交易对的所有订单

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¶

作用：查询某交易对的所有价格

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¶

作用：查询订单

curl -X POST  http://127.0.0.1:8090/wallet/getmarketorderbyid -d
'{
   "value": "orderid"
}'

参数说明： - value：order id，默认为hexString格式

返回值：订单

TRONZ 匿名智能合约¶

下面是 TRONZ 匿名智能合约相关API：

wallet/getexpandedspendingkey
wallet/getakfromask
wallet/getnkfromnsk
wallet/getspendingkey
wallet/getdiversifier
wallet/getincomingviewingkey
wallet/getzenpaymentaddress
wallet/createshieldedtransactionwithoutspendauthsig
wallet/scannotebyivk
wallet/scanandmarknotebyivk
wallet/scannotebyovk
wallet/createshieldnullifier
wallet/getshieldtransactionhash
wallet/createshieldedtransaction
wallet/getnewshieldedaddress
wallet/createshieldedcontractparameters
wallet/createshieldedcontractparameterswithoutask
wallet/scanshieldedtrc20notesbyivk
wallet/scanshieldedtrc20notesbyovk
wallet/isshieldedtrc20contractnotespent
wallet/gettriggerinputforshieldedtrc20contract
wallet/getrcm
wallet/getmerkletreevoucherinfo
wallet/isspend
wallet/createspendauthsig

wallet/getexpandedspendingkey¶

作用：获取expanded spending keys

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

curl -X POST  http://127.0.0.1:8090/wallet/getakfromask -d
'{
    "value": "653b3a3fdd40b60d2f53ba121df8840f6590384993f8fa9a0ecb0dfb23496604"
}'

参数说明：value：Ask

返回值：Ak

wallet/getnkfromnsk¶

作用：从nsk获得nk

curl -X POST  http://127.0.0.1:8090/wallet/getnkfromnsk -d
'{
    "value": "428ff3c9e101dc1fca08f7b0e3387b23b68016746ae565aefc19d112b696db01"
}'

参数说明：value：Nsk

返回值：Nk

wallet/getspendingkey¶

作用：获得spending key

curl -X GET  http://127.0.0.1:8090/wallet/getspendingkey

参数说明：无

返回值：Spending key

wallet/getdiversifier¶

作用：To get diversifier

curl -X GET  http://127.0.0.1:8090/wallet/getdiversifier

参数说明：无

返回值: Diversifier

wallet/getincomingviewingkey¶

作用：获得incoming viewing key

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¶

作用：获得支付地址

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

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）

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

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, 包含是否花费状态

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

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/createshieldnullifier¶

作用：To create a shielded nullifier

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

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¶

作用：创建匿名交易，请参照：示例

参数说明：

transparent_from_address：透明发送者的地址
from_amount：从透明地址转出的数额
ask：Ask
nsk：Nsk
ovk：Ovk
shielded_receives：匿名接收者信息
shieldedSpends：匿名发送者信息
transparent_to_address：透明接收者地址
to_amount：转入透明地址的数额

返回值：交易对象

wallet/getnewshieldedaddress¶

作用: 获得shieldedAddress

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三种类型

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三种类型

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, 并标记其是否已花费

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

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是否已被花费

参数说明：

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合约参数，生成触发合约的输入数据

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/getrcm¶

作用：获得一个rcm

curl -X GET  http://127.0.0.1:8090/wallet/getrcm

参数说明：无

返回值：rcm

wallet/getmerkletreevoucherinfo¶

作用：获得一个note的默克尔树信息

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是否已经被花费

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¶

作用：为一个交易创建一个签名

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

返回值：签名

Pending Pool¶

下面是Pending Pool相关API：

wallet/gettransactionfrompending
wallet/gettransactionlistfrompending
wallet/getpendingsize

wallet/gettransactionfrompending¶

作用：查询pending pool中的交易信息

curl -X POST  http://127.0.0.1:8090/wallet/gettransactionfrompending -d
'{
  "value": "txId"
}'

参数说明：value: 交易id，默认为hexString格式

返回值：交易的详细信息

wallet/gettransactionlistfrompending¶

作用：查询pending pool交易列表id

curl -X get  http://127.0.0.1:8090/wallet/gettransactionlistfrompending

参数说明：无

返回值：pending pool交易列表id

wallet/getpendingsize¶

作用：查询pending pool大小

curl -X get  http://127.0.0.1:8090/wallet/getpendingsize

参数说明：无

返回值：pending pool 大小

FullNode Solidity HTTP API¶

账户资源¶

walletsolidity/getaccount¶

作用：查询一个账号的信息

curl -X POST  http://127.0.0.1:8091/walletsolidity/getaccount -d '{"address": "41E552F6487585C2B58BC2C9BB4492BC1F17132CD0"}'

参数说明：address 默认为hexString 返回值：Account对象

walletsolidity/getdelegatedresource¶

作用：查看一个账户代理给另外一个账户的资源情况

curl -X POST  http://127.0.0.1:8091/walletsolidity/getdelegatedresource -d '
{
"fromAddress": "419844f7600e018fd0d710e2145351d607b3316ce9",
"toAddress": "41c6600433381c731f22fc2b9f864b14fe518b322f"
}'

参数说明：

fromAddress：是要查询的账户地址，默认为hexString格式
toAddress：代理对象的账户地址，默认为hexString格式

返回值：账户的资源代理的列表，列表的元素为DelegatedResource

walletsolidity/getdelegatedresourceaccountindex¶

作用：查看一个账户的资源代理情况

curl -X POST  http://127.0.0.1:8091/walletsolidity/getdelegatedresourceaccountindex -d '
{
"value": "419844f7600e018fd0d710e2145351d607b3316ce9",
}'

参数说明：

value：是要查询的账户地址，默认为hexString格式

返回值：账户的DelegatedResourceAccountIndex

walletsolidity/getaccountbyid¶

作用：通过accountId查询一个账号的信息

curl -X POST  http://127.0.0.1:8091/walletsolidity/getaccountbyid -d '{"account_id":"6161616162626262"}'

参数说明：account_id 默认为hexString格式

返回值：Account对象

walletsolidity/getavailableunfreezecount¶

作用：查询当前解质押剩余次数

curl -X POST http://127.0.0.1:8090/walletsolidity/getavailableunfreezecount -d
'{
  "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "visible": true
}
'

参数：

owner_address: 交易发起者账号的地址

返回值：解质押的剩余次数

walletsolidity/getcanwithdrawunfreezeamount¶

作用：查询在某时间点可以提取的解质押本金数量

curl -X POST http://127.0.0.1:8090/walletsolidity/getcanwithdrawunfreezeamount -d
'{
  "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "timestamp": 1667977444000,
  "visible": true
}
'

参数：

owner_address: 交易发起者账号的地址
timestamp: 查询在该时间戳时，可提取的本金数量，单位为毫秒

返回值：解质押本金可提取数量

walletsolidity/getcandelegatedmaxsize¶

作用：查询目标地址中指定类型资源的可代理数量，单位为sun

curl -X POST http://127.0.0.1:8090/walletsolidity/getcandelegatedmaxsize -d
'{
  "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "type": 0,
  "visible": true
}
'

参数：

owner_address: 交易发起者账号的地址
type: 资源类型，0为带宽，1为能量

返回值：可代理带宽或者能量份额的最大值（单位为sun）

walletsolidity/getdelegatedresourcev2¶

作用：查询在Stake2.0机制下，某地址代理给目标地址的资源情况

curl -X POST http://127.0.0.1:8090/walletsolidity/getdelegatedresourcev2 -d
'{
  "fromAddress": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "toAddress": "TPswDDCAWhJAZGdHPidFg5nEf8TkNToDX1",
  "visible": true
}
'

参数：

fromAddress: 代理账户地址
toAddress: 资源的接收账户地址

返回值：某地址代理给目标地址的资源情况的列表

walletsolidity/getdelegatedresourceaccountindexv2¶

作用：查询在Stake2.0阶段，某地址的资源委托索引。返回两个列表，一个是该帐户将资源委托给的地址列表(toAddress)，另一个是将资源委托给该帐户的地址列表(fromAddress)

curl -X POST http://127.0.0.1:8090/walletsolidity/getdelegatedresourceaccountindexv2 -d
'{
  "value": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "visible": true
}
'

参数：

value: 账户地址

返回值：某地址的资源委托索引。返回两个列表，一个是该帐户将资源委托给的地址列表(toAddress)，另一个是将资源委托给该帐户的地址列表(fromAddress)

投票和SR¶

walletsolidity/listwitnesses¶

作用：查询超级代表列表

curl -X POST  http://127.0.0.1:8091/walletsolidity/listwitnesses

参数说明：无

返回值：所有超级代表列表

TRC10 通证¶

walletsolidity/getassetissuelist¶

作用：查询所有Token列表

curl -X POST  http://127.0.0.1:8091/walletsolidity/getassetissuelist

参数说明：无

返回值：所有Token列表

walletsolidity/getpaginatedassetissuelist¶

作用：分页查询Token列表

curl -X POST  http://127.0.0.1:8091/walletsolidity/getpaginatedassetissuelist -d '{"offset": 0, "limit":10}'

参数说明：offset是起始Token的index，limit是期望返回的Token数量

返回值：Token列表

walletsolidity/getassetissuebyname¶

作用：根据名称查询token。

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¶

作用：根据名称查询token list。

curl -X POST  http://127.0.0.1:8091/walletsolidity/getassetissuelistbyname -d '{"value": "44756354616E"}'

参数说明：通证名称，默认为hexString。

返回值：token列表。

walletsolidity/getassetissuebyid¶

作用：根据id查询token。

curl -X POST  http://127.0.0.1:8091/walletsolidity/getassetissuebyid -d '{"value": "1000001"}'

参数说明：通证id

返回值：token。

区块¶

walletsolidity/getnowblock¶

作用：查询最新block

curl -X POST  http://127.0.0.1:8091/walletsolidity/getnowblock

参数说明：无

返回值：solidityNode上的最新block

walletsolidity/getblockbynum¶

作用：按照高度查询block

curl -X POST  http://127.0.0.1:8091/walletsolidity/getblockbynum -d '{"num" : 100}'

参数说明：num是块的高度

返回值：指定高度的block

walletsolidity/getblockbyid¶

作用：通过ID查询块

curl -X POST  http://127.0.0.1:8091/walletsolidity/getblockbyid-d '{"value":
"0000000000038809c59ee8409a3b6c051e369ef1096603c7ee723c16e2376c73"}'

参数说明：块ID。

返回值：块。

walletsolidity/getblockbylimitnext¶

作用：按照范围查询块

curl -X POST  http://127.0.0.1:8091/walletsolidity/getblockbylimitnext -d '{"startNum": 1, "endNum": 2}'

参数说明：

startNum：起始块高度，包含此块
endNum：截止块高度，不包含此此块

返回值：块的列表。

walletsolidity/getblockbylatestnum¶

作用：查询最新的几个块

curl -X POST  http://127.0.0.1:8091/walletsolidity/getblockbylatestnum -d '{"num": 5}'

参数说明：块的数量。

返回值：块的列表。

wallet/getnodeinfo¶

作用：获取当前node的信息

curl -X GET http://127.0.0.1:8091/wallet/getnodeinfo

参数说明：无

返回值：当前节点的信息NodeInfo

交易¶

walletsolidity/gettransactionbyid¶

作用：根据id查询交易

curl -X POST  http://127.0.0.1:8091/walletsolidity/gettransactionbyid -d '{"value" : "309b6fa3d01353e46f57dd8a8f27611f98e392b50d035cef213f2c55225a8bd2"}'

参数说明：value是交易id

返回值：指定ID的Transaction

walletsolidity/gettransactioncountbyblocknum¶

作用：查询特定block上transaction的个数

curl -X POST  http://127.0.0.1:8091/walletsolidity/gettransactioncountbyblocknum -d '{"num" : 100}'

参数说明：num是块的高度

返回值：transaction的个数

walletsolidity/gettransactioninfobyid¶

作用：根据id查询交易的fee，所在的block

curl -X POST  http://127.0.0.1:8091/walletsolidity/gettransactioninfobyid -d '{"value" : "309b6fa3d01353e46f57dd8a8f27611f98e392b50d035cef213f2c55225a8bd2"}'

参数说明：value是交易id

返回值：Transaction的交易fee，所在block的高度，创建时间

walletsolidity/gettransactioninfobyblocknum¶

作用：查询特定block上transaction的个数

curl -X POST  http://127.0.0.1:8091/walletsolidity/gettransactioninfobyblocknum -d '{"num" : 100}'

参数说明：num是块的高度

返回值：指定块中，包含的transactioninfo的列表

去中心化交易所¶

walletsolidity/getexchangebyid¶

作用：根据id查询交易对

curl -X POST  http://127.0.0.1:8091/walletsolidity/getexchangebyid -d {"id":1}

参数说明：

id：交易对id

返回值：交易对

walletsolidity/listexchanges¶

作用：查询所有交易对

curl -X POST  http://127.0.0.1:8091/walletsolidity/listexchanges

参数说明：无

返回值：所有交易对

TRONZ匿名智能合约¶

walletsolidity/getmerkletreevoucherinfo¶

作用：获得一个note的默克尔树信息

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

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, 包含是否花费状态

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

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是否已经被花费

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, 并标记其是否已花费

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

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是否已被花费

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是否已经被花费状态

注意: Note 中value 是由 scalingFactor 缩放后的值，scalingFactor 在匿名TRC-20合约中设置，实际金额 real_amount = value * scalingFactor。