TRON插件
演示
依赖配置中心
配置项 | 参考值 |
---|---|
tron.addr | https://nile.trongrid.io |
插件介绍
创建账户
请求URL: /tron/account
请求方式: POST
请求参数:
参数名 | 类型 | 说明 | 是否必填 |
---|---|---|---|
userId | string | 用户ID | 是 |
请求示例:
{
"userId": 888
}
返回示例:
{
"msg": "success",
"code": 0,
"data": {
"private": "1c970d47f04ef579e2e231a49be364e61d11205d6eb016ac93462d8e8a4f18cb",
"public": "023ebd694ee707093db64a21702e4b42859b26438e578b2d36558695123cfaecd5",
"address": "TFvXBgeRiZzbxdK6rTYh8xPsrAKZ4hxcag",
"hexAccount": "0x414eaf7560457821e4fe15fbfac02ef7395ba859"
}
}
根据区块高度获取区块信息
请求URL: /tron/blockByNumber
请求方式: GET
请求参数:
参数名 | 类型 | 说明 | 是否必填 |
---|---|---|---|
blockNumber | string | 区块高度 | 是 |
请求示例:
/tron/blockByNumber?blockNumber=42455319
返回示例:
{
"msg": "success",
"code": 0,
"data": {
"number": "0x3ce2b0f",
"size": "0x10f34",
"timestamp": "0x66a64d93",
"gasLimit": "0x2292979a0",
"gasUsed": "0x3925d4",
"hash": "0x0000000003ce2b0f20064eb1a0ace2c282e7b6aa1ab826900f36faee9701dc19",
"parentHash": "0x0000000003ce2b0e4c29d3da01b0964b9f733b2e22c6a50661e1242ac8a2ca51",
"miner": "0x2a4d700c196a78f8ff7f0bf17d93fe6018396d2e",
"transactions": [
{
"blockHash": "0x0000000003ce2b0f20064eb1a0ace2c282e7b6aa1ab826900f36faee9701dc19",
"blockNumber": "0x3ce2b0f",
"from": "0x2c4797125956cd64c003707666b0b70eed64b98f",
"to": "0xa614f803b6fd780986a42c78ec9c7f77e6ded13c",
"gas": "0x7c97",
"gasPrice": "0x1a4",
"hash": "0x1b2dc5f3d123c975ce6c218a74f8af4548b7230ad25f128ffd6f8d8a034ebe9d",
"input": "0xa9059cbb
000000000000000000000041e63003e1ea4f8432cde67ba164bc275ad007aaac
00000000000000000000000000000000000000000000000000
000000002dc6c0",
"nonce": "0x0000000000000000",
"r": "0x2610baf24249307da7056b19d581d08166d5f158f292398af29b7f4eee4b62e3",
"s": "0xc1a32682c70d16b275ba7e8d123f0ddd1f3d3323082218b1d66dac1ef7c80965",
"v": "0x1b",
"transactionIndex": "0x0",
"value": "0x0"
}
]
}
}
获取最新区块高度
请求URL: /tron/blockNumber
请求方式: GET
请求参数:
无
请求示例:
无
返回示例:
{
"msg": "success",
"code": 0,
"data": 63843720
}
获取用户余额
请求URL: /tron/balance
请求方式: GET
请求参数:
参数名 | 类型 | 说明 | 是否必填 |
---|---|---|---|
account | string | 账户地址 | 是 |
请求示例:
/tron/balance?account=0x9999f79A9Ae77b8454b7C73c9C06532ab4f2d1d9
返回示例:
{
"msg": "success",
"code": 0,
"data": 1996900000
}
获取建议gas price 值
请求URL: /tron/suggestGasPrice
请求方式: GET
请求参数:
无
请求示例:
无
返回示例:
{
"msg": "success",
"code": 0,
"data": 420
}
预估交易gas值
请求URL: /tron/estimateGas
请求方式: GET
请求参数:
参数名 | 类型 | 说明 | 是否必填 |
---|---|---|---|
from | string | 账户地址 | 是 |
to | string | 账户/合约地址 | 是 |
amount | string | 金额 | 是 |
input | string | 交易输入 | 是 |
请求示例:
/tron/estimateGas?from=0x9999f79A9Ae77b8454b7C73c9C06532ab4f2d1d9&
to=0xd7452e76f884e8a59350409859110799ccb36810&amount=0&input=f76e8ba9
0000000000000000000000009999f79a9ae77b8454b7c73c9c06532ab4f2d1d9
0000000000000000000000000000000000000000000000000000000000000004
0000000000000000000000000000000000000000000000000000000000000060
0000000000000000000000000000000000000000000000000000000000000061
68747470733a2f2f746573746e65742e6273637363616e2e636f6d2f74782f30
7834343635663735366666363734363762303638393366363733346231303732
3565303461336330626166376233653766366339323138366461316137663437
3600000000000000000000000000000000000000000000000000000000000000
返回示例:
{
"msg": "success",
"code": 0,
"data": 266434
}
根据交易hash获取交易信息
请求URL: /tron/transactionByHash
请求方式: GET
请求参数:
参数名 | 类型 | 说明 | 是否必填 |
---|---|---|---|
hash | string | 交易哈希 | 是 |
请求示例:
/tron/transactionByHash?hash=0x71e97a2889a0dae2f153f1a3182fb8a74fd7cdef52b641f17875ae533415c110
返回示例:
{
"msg": "success",
"code": 0,
"data": {
"blockNumber": "0x2ea88d6",
"from": "0x9999f79a9ae77b8454b7c73c9c06532ab4f2d1d9",
"to": "0xd7452e76f884e8a59350409859110799ccb36810",
"gas": "0x0",
"gasPrice": "0x1a4",
"hash": "0x4d6d23bded318250b47c6b4f78336d2082c5aadfdb965d38fae3be8f798ed5ac",
"input": "0x",
"nonce": "0x0000000000000000",
"value": "0x1",
"transactionIndex": "0x0",
"logs": [],
"type": "0x0",
"status": "0x1"
}
}
发送原生币(tron)交易
请求URL: /tron/transferTron
请求方式: POST
请求参数:
参数名 | 类型 | 说明 | 是否必填 |
---|---|---|---|
from | string | 账户地址 | 是 |
to | string | 账户地址 | 是 |
amount | string | 金额 | 是 |
请求示例:
{
"from": "0x9999f79A9Ae77b8454b7C73c9C06532ab4f2d1d9",
"to": "0xd7452e76f884e8a59350409859110799ccb36810",
"amount": "1"
}
返回示例:
{
"msg": "success",
"code": 0,
"data": "4d6d23bded318250b47c6b4f78336d2082c5aadfdb965d38fae3be8f798ed5ac"
}
发送代币交易
请求URL: /tron/transferAsset
请求方式: POST
请求参数:
参数名 | 类型 | 说明 | 是否必填 |
---|---|---|---|
from | string | 账户地址 | 是 |
to | string | 账户地址 | 是 |
tokenId | string | 代币ID | 是 |
tokenValue | string | 代币金额 | 是 |
请求示例:
{
"from": "0x9999f79A9Ae77b8454b7C73c9C06532ab4f2d1d9",
"to": "0xd7452e76f884e8a59350409859110799ccb36810",
"tokenId": "1",
"tokenValue": "1"
}
返回示例:
{
"msg": "success",
"code": 0,
"data": "4d6d23bded318250b47c6b4f78336d2082c5aadfdb965d38fae3be8f798ed5ac"
}
发送合约交易
请求URL: /tron/transferTriggerSmart
请求方式: POST
请求参数:
参数名 | 类型 | 说明 | 是否必填 |
---|---|---|---|
from | string | 账户地址 | 是 |
to | string | 账户地址 | 是 |
input | string | 交易输入 | 是 |
gas | string | 交易费 | 是 |
value | string | 交易金额 | 是 |
tokenId | string | 代币ID | 是 |
tokenValue | string | 代币金额 | 是 |
请求示例:
{
"from": "0x9999f79A9Ae77b8454b7C73c9C06532ab4f2d1d9",
"to": "0xd7452e76f884e8a59350409859110799ccb36810",
"input": "0x3be9ece7
000000000000000000000000ba8e28bdb6e49fbb3f5cd82a9f5ce8363587f1f6
00000000000000000000000000000000000000000000000000000000000f4263
0000000000000000000000000000000000000000000000000000000000000001",
"gas": "0x245498",
"value": "1",
"tokenId": "1",
"tokenValue": "1"
}
返回示例:
{
"msg": "success",
"code": 0,
"data": "4d6d23bded318250b47c6b4f78336d2082c5aadfdb965d38fae3be8f798ed5ac"
}
获取账户列表
请求URL: /tron/accounts
请求方式: GET
请求参数:
参数名 | 类型 | 说明 | 是否必填 |
---|---|---|---|
pageSize | string | 每页数量 | 是 |
pageNum | string | 页数 | 是 |
请求示例:
/tron/accounts?pageSize=10&pageNum=1
返回示例:
{
"msg": "success",
"code": 0,
"data": {
"records": [
{
"userId": 555,
"privateKey": "",
"publicKey": "",
"address": "TFvXBgeRiZzbxdK6rTYh8xPsrAKZ4hxcag",
"hexAddress": "0x414eaf7560457821e4fe15fbfac02ef7395ba859",
"create_time": "0001-01-01T00:00:00Z",
"update_time": "0001-01-01T00:00:00Z"
}
],
"total": 5
}
}
获取交易列表
请求URL: /tron/txs
请求方式: GET
请求参数:
参数名 | 类型 | 说明 | 是否必填 |
---|---|---|---|
pageSize | string | 每页数量 | 是 |
pageNum | string | 页数 | 是 |
请求示例:
/tron/txs?pageSize=10&pageNum=1
返回示例:
{
"msg": "success",
"code": 0,
"data": {
"records": [
{
"hash": "4d6d23bded318250b47c6b4f78336d2082c5aadfdb965d38fae3be8f798ed5ac",
"address": "0x9999f79A9Ae77b8454b7C73c9C06532ab4f2d1d9",
"status": 0,
"create_time": "2024-07-28T22:57:47.765+08:00",
"update_time": "2024-07-28T22:57:47.765+08:00"
}
],
"total": 1
}
}