Skip to content

jsonRPC API

概述

JSON-RPC 是一种无状态、轻量级的远程过程调用（RPC）协议。TRON 网络支持的 JSON-RPC 接口与以太坊兼容。然而，由于链机制和设计的差异，TRON 无法支持以太坊上的某些接口。同时，TRON 还提供了专用 API 来创建不同类型的交易。

请注意

  • JSON-RPC 服务需要在节点配置文件中启用并设置端口。如果未配置，默认情况下服务是禁用的。

如何启用或禁用节点的 JSON-RPC 服务

在节点的配置文件中添加以下项，然后启用或禁用它：

node.jsonrpc {  
    httpFullNodeEnable = true  
    httpFullNodePort = 50545  
    httpSolidityEnable = true  
    httpSolidityPort = 50555  
}

HEX 值编码

目前有两种关键的数据类型通过 JSON 传递：未格式化的字节数组和数量。两者都使用十六进制编码传递，但在格式化要求上有所不同：

当编码 QUANTITIES（整数、数字）时：编码为十六进制，前缀为“0x”，使用最紧凑的表示形式（例外：零应表示为“0x0”）。
示例：

  • 0x41（十进制 65）
  • 0x400（十进制 1024）
  • 错误：0x（应至少有一个数字 - 零应为“0x0”）
  • 错误：0x0400（不允许前导零）
  • 错误：ff（必须前缀为 0x）

当编码 UNFORMATTED DATA（字节数组、账户地址、哈希、字节码数组）时：编码为十六进制，前缀为“0x”，每个字节用两个十六进制数字表示。
示例：

  • 0x41（大小 1，“A”）
  • 0x004200（大小 3，“\0B\0”）
  • 0x（大小 0，“”）
  • 错误：0xf0f0f（必须是偶数位数）
  • 错误：004200（必须前缀为 0x）

eth

eth_accounts

返回客户端拥有的地址列表。

参数

无

返回值

空列表

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '

{"jsonrpc": "2.0", "id": 1, "method": "eth_accounts", "params": []}'

{"jsonrpc":"2.0","id":1,"result":[]}

eth_blockNumber

返回最新区块的编号。

参数

无

返回值

最新区块号。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":64}'

{"jsonrpc":"2.0","id":64,"result":"0x20e0cf0"}

eth_call

立即执行消息调用，而不在区块链上创建交易。

参数

1. Object - 交易调用对象，包含以下项。

项名称 数据类型 描述
from DATA, 20 Bytes 调用者地址。十六进制格式地址，去掉前缀 "41"
to DATA, 20 Bytes 合约地址。十六进制格式地址，去掉前缀 "41"
gas QUANTITY 不支持。值为 0x0
gasPrice QUANTITY 不支持。值为 0x0
value QUANTITY 不支持。值为 0x0
data DATA 方法签名和编码参数的哈希。

2. QUANTITY|TAG - 目前仅支持 "latest"。

返回值

DATA - 执行的合约函数的返回值。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_call",

    "params": [{

        "from": "0xF0CC5A2A84CD0F68ED1667070934542D673ACBD8",

        "to": "0x70082243784DCDF3042034E7B044D6D342A91360",

        "gas": "0x0",

        "gasPrice": "0x0",

        "value": "0x0",

        "data": "0x70a08231000000000000000000000041f0cc5a2a84cd0f68ed1667070934542d673acbd8"

    }, "latest"],

    "id": 1

}'

结果

{"jsonrpc":"2.0","id":1,"result":"0x"}

### eth_chainId

*返回 TRON 网络的 chainId，即创世区块哈希的最后四个字节。*

**参数**  

无

**返回值**  

DATA - TRON 网络的 chainId

**示例**

```curl

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":79}'

结果

{"jsonrpc":"2.0","id":79,"result":"0x2b6653dc"}

eth_coinbase

返回当前节点的超级代表地址。

参数

无

返回值

DATA - 节点的超级代表地址。（注意：如果配置了多个超级代表地址，则返回第一个地址；如果没有有效地址或地址未生成任何区块，则返回错误，错误信息为“etherbase must be explicitly specified”。）

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc": "2.0", "id": 1, "method": "eth_coinbase", "params": []}'

结果

{"jsonrpc":"2.0","id":1,"error":{"code":-32000,"message":"etherbase must be explicitly specified","data":"{}"}}

eth_estimateGas

通过 triggerConstantContract 获取所需的能量。

参数

object - 交易调用对象，包含以下项

项名称 数据类型 描述
from DATA, 20 Bytes 发送方地址
to DATA, 20 Bytes 接收方地址
gas QUANTITY 未使用。
gasPrice QUANTITY 未使用。
value QUANTITY 随此交易发送的值的整数
data DATA 方法签名和编码参数的哈希。

返回值

使用的能量量。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "id": 1,

    "method": "eth_estimateGas",

    "params": [{

        "from": "0x41F0CC5A2A84CD0F68ED1667070934542D673ACBD8",

        "to": "0x4170082243784DCDF3042034E7B044D6D342A91360",

        "gas": "0x01",

        "gasPrice": "0x8c",

        "value": "0x01",

        "data": "0x70a08231000000000000000000000041f0cc5a2a84cd0f68ed1667070934542d673acbd8"

    }]

}'

结果

{"jsonrpc":"2.0","id":1,"result":"0x0"}

eth_gasPrice

返回当前能量的价格（单位：sun）。

参数

无

返回值

当前能量的价格（单位：sun）的整数。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc": "2.0", "id": 1, "method": "eth_gasPrice", "params": []}'

结果

{"jsonrpc":"2.0","id":1,"result":"0x8c"}

eth_getBalance

返回给定地址账户的余额。

参数

索引 数据类型 描述
1 DATA, 20 Bytes 要查询余额的地址。
2 QUANTITY 目前仅支持 "latest"

返回值

QUANTITY - 当前余额的整数（单位：sun）。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getBalance",

    "params": ["0x41f0cc5a2a84cd0f68ed1667070934542d673acbd8", "latest"],

    "id": 64

}'

结果

{"jsonrpc":"2.0","id":64,"result":"0x492780"}

eth_getBlockByHash

通过哈希返回区块信息。

参数

索引 数据类型 描述
1 DATA, 32 Bytes 区块哈希
2 Boolean 如果为 true，则返回完整的交易对象；如果为 false，则仅返回交易的哈希。

返回值

object - 区块对象，如果未找到区块则返回 null。区块包含以下项。

项名称 数据类型 描述
number QUANTITY 区块号
hash DATA, 32 Bytes 区块哈希
parentHash DATA, 32 Bytes 父区块哈希
nonce QUANTITY 未使用
sha3Uncles DATA, 32 Bytes 区块中叔块数据的 SHA3
logsBloom DATA, 256 Bytes 区块日志的布隆过滤器。
transactionsRoot DATA, 32 Bytes 区块交易树的根
stateRoot DATA, 32 Bytes 区块最终状态树的根
receiptsRoot DATA, 32 Bytes 区块收据树的根
miner DATA, 20 Bytes 受益者地址，挖矿奖励将给予该地址
difficulty QUANTITY 该区块的难度整数
totalDifficulty QUANTITY 直到该区块的链的总难度整数
extraData DATA 该区块的“额外数据”字段
size QUANTITY 该区块的大小（单位：字节）
gasLimit QUANTITY 该区块允许的最大 gas
gasUsed QUANTITY 该区块中所有交易使用的总 gas
timestamp QUANTITY 区块创建时的 Unix 时间戳，单位为秒。
transactions Array 交易对象数组，或根据最后一个参数返回的 32 字节交易哈希。
uncles Array 叔块哈希数组

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getBlockByHash",

    "params": ["0x0000000000f9cc56243898cbe88685678855e07f51c5af91322c225ce3693868", false],

    "id": 1

}'

结果

{"jsonrpc":"2.0","id":1,"result":null}

eth_getBlockByNumber

通过区块号返回区块信息。

参数

索引 数据类型 描述
1 QUANTITY|TAG 区块号的整数，或字符串 "earliest"、"latest"
2 Boolean 如果为 true，则返回完整的交易对象；如果为 false，则仅返回交易的哈希。

返回值

object - 区块对象，如果未找到区块则返回 null。参见 eth_getBlockByHash

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getBlockByNumber",

    "params": ["0xF9CC56", true],

    "id": 1

}'

结果

{"jsonrpc":"2.0","id":1,"result":null}

eth_getBlockTransactionCountByHash

通过区块哈希返回区块中的交易数量。

参数

DATA, 32 Bytes - 区块哈希

返回值

QUANTITY - 该区块中的交易数量的整数。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "id": 1,

    "method": "eth_getBlockTransactionCountByHash",

    "params": ["0x00000000020ef11c87517739090601aa0a7be1de6faebf35ddb14e7ab7d1cc5b"]

}'

结果

{"jsonrpc":"2.0","id":1,"result":"0x39"}

eth_getBlockTransactionCountByNumber

通过区块号返回区块中的交易数量。

参数

QUANTITY|TAG - 区块号的整数，或字符串 "earliest" 或 "latest"。

返回值

QUANTITY - 该区块中的交易数量的整数。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getBlockTransactionCountByNumber",

    "params": ["0xF96B0F"],

    "id": 1

}'

结果

{"jsonrpc":"2.0","id":1,"result":"0x23"}

eth_getCode

返回给定智能合约地址的运行时代码。

参数

索引 数据类型 描述
1 DATA, 20 Bytes 合约地址
2 QUANTITY|TAG 目前仅支持 "latest"

返回值

DATA - 给定地址的运行时代码。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getCode",

    "params": ["0x4170082243784DCDF3042034E7B044D6D342A91360", "latest"],

    "id": 64

}'

结果

{"jsonrpc":"2.0","id":64,"result":"0x"}

eth_getStorageAt

返回给定地址的存储位置的值。可用于获取合约中变量的值。

参数

索引 数据类型 描述
1 DATA, 20 Bytes 地址
2 QUANTITY 存储位置的整数
3 QUANTITY|TAG 目前仅支持 "latest"

返回值

DATA - 该存储位置的值。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getStorageAt",

    "params": ["0xE94EAD5F4CA072A25B2E5500934709F1AEE3C64B", "0x29313b34b1b4beab0d3bad2b8824e9e6317c8625dd4d9e9e0f8f61d7b69d1f26", "latest"],

    "id": 1

}'

结果

{"jsonrpc":"2.0","id":1,"result":"0x0000000000000000000000000000000000000000000000000000000000000000"}

eth_getTransactionByBlockHashAndIndex

通过区块哈希和交易索引位置返回交易信息。

参数

索引 数据类型 描述
1 DATA, 32 Bytes 区块哈希
2 QUANTITY 交易索引位置

返回值

object - 交易对象，如果未找到交易则返回 null。交易包含以下项。

项名称 数据类型 描述
blockHash DATA, 32 Bytes 交易所在区块的哈希
blockNumber QUANTITY 交易所在区块的区块号
from DATA, 20 Bytes 发送方地址
gas QUANTITY 未使用。
gasPrice QUANTITY 能量价格
hash DATA, 32 Bytes 交易哈希
input DATA 随交易发送的数据
nonce QUANTITY 未使用
to DATA, 20 Bytes 接收方地址
transactionIndex QUANTITY 交易在区块中的索引位置
value QUANTITY 转账金额（单位：sun）
v QUANTITY ECDSA 恢复 id
r DATA, 32 Bytes ECDSA 签名 r
s DATA, 32 Bytes ECDSA 签名 s

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getTransactionByBlockHashAndIndex",

    "params": ["00000000020ef11c87517739090601aa0a7be1de6faebf35ddb14e7ab7d1cc5b", "0x0"],

    "id": 64

}'

结果

{

    "jsonrpc": "2.0",

    "id": 64,

    "result": {

        "blockHash": "0x00000000020ef11c87517739090601aa0a7be1de6faebf35ddb14e7ab7d1cc5b",

        "blockNumber": "0x20ef11c",

        "from": "0xb4f1b6e3a1461266b01c2c4ff9237191d5c3d5ce",

        "gas": "0x0",

        "gasPrice": "0x8c",

        "hash": "0x8dd26d1772231569f022adb42f7d7161dee88b97b4b35eeef6ce73fcd6613bc2",

        "input": "0x",

        "nonce": null,

        "r": "0x6212a53b962345fb8ab02215879a2de05f32e822c54e257498f0b70d33825cc5",

        "s": "0x6e04221f5311cf2b70d3aacfc444e43a5cf14d0bf31d9227218efaabd9b5a812",

        "to": "0x047d4a0a1b7a9d495d6503536e2a49bb5cc72cfe",

        "transactionIndex": "0x0",

        "type": "0x0",

        "v": "0x1b",

        "value": "0x203226"

    }

}

eth_getTransactionByBlockNumberAndIndex

通过区块号和交易索引位置返回交易信息。

参数

索引 数据类型 描述
1 QUANTITY|TAG 区块号，或字符串 "earliest"、"latest",
2 QUANTITY 交易索引位置

返回值

object - 交易对象，如果未找到交易则返回 null。参见 eth_getTransactionByBlockHashAndIndex

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getTransactionByBlockNumberAndIndex",

    "params": ["0xfb82f0", "0x0"],

    "id": 64

}'

结果

{"jsonrpc":"2.0","id":64,"result":null}

eth_getTransactionByHash

通过交易哈希返回交易信息。

参数

DATA, 32 Bytes - 交易哈希

返回值

object - 交易对象，如果未找到交易则返回 null。参见 eth_getTransactionByBlockHashAndIndex

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getTransactionByHash",

    "params": ["c9af231ad59bcd7e8dcf827afd45020a02112704dce74ec5f72cb090aa07eef0"],

    "id": 64

}'

结果

{

    "jsonrpc": "2.0",

    "id": 64,

    "result": {

        "blockHash": "0x00000000020ef11c87517739090601aa0a7be1de6faebf35ddb14e7ab7d1cc5b",

        "blockNumber": "0x20ef11c",

        "from": "0x6eced5214d62c3bc9eaa742e2f86d5c516785e14",

        "gas": "0x0",

        "gasPrice": "0x8c",

        "hash": "0xc9af231ad59bcd7e8dcf827afd45020a02112704dce74ec5f72cb090aa07eef0",

        "input": "0x",

        "nonce": null,

        "r": "0x433eaf0a7df3a08c8828a2180987146d39d44de4ac327c4447d0eeda42230ea8",

        "s": "0x6f91f63b37f4d1cd9342f570205beefaa5b5ba18d616fec643107f8c1ae1339d",

        "to": "0x0697250b9d73b460a9d2bbfd8c4cacebb05dd1f1",

        "transactionIndex": "0x6",

        "type": "0x0",

        "v": "0x1b",

        "value": "0x1cb2310"

    }

}

eth_getTransactionReceipt

通过交易哈希返回交易信息：收据、交易费用、区块高度等。请参考 http api: wallet/gettransactioninfobyid

参数

DATA, 32 Bytes - 交易哈希

返回值

object - 交易收据对象，如果未找到收据则返回 null。交易收据包含以下项。

项名称 数据类型 描述
transactionHash DATA, 32 Bytes 交易哈希
transactionIndex QUANTITY 交易在区块中的索引位置
blockHash DATA, 32 Bytes 交易所在区块的哈希
blockNumber QUANTITY 交易所在区块的区块号
from DATA, 20 Bytes 发送方地址
to DATA, 20 Bytes 接收方地址
cumulativeGasUsed QUANTITY 区块中执行该交易时使用的总 gas 量
gasUsed QUANTITY 该交易单独使用的 gas 量
contractAddress DATA, 20 Bytes 如果交易是合约创建，则为创建的合约地址，否则为 null。
logs Array 该交易生成的日志对象数组
logsBloom DATA, 256 Bytes 用于轻客户端快速检索相关日志的布隆过滤器
root DATA 交易后的状态根（Byzantium 之前）
status QUANTITY 1（成功）或 0（失败）

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getTransactionReceipt",

    "params": ["c9af231ad59bcd7e8dcf827afd45020a02112704dce74ec5f72cb090aa07eef0"],

    "id": 64

}'

结果

{

    "jsonrpc": "2.0",

    "id": 64,

    "result": {

        "blockHash": "0x00000000020ef11c87517739090601aa0a7be1de6faebf35ddb14e7ab7d1cc5b",

        "blockNumber": "0x20ef11c",

        "contractAddress": null,

        "cumulativeGasUsed": "0x646e2",

        "effectiveGasPrice": "0x8c",

        "from": "0x6eced5214d62c3bc9eaa742e2f86d5c516785e14",

        "gasUsed": "0x0",

        "logs": [],

        "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",

        "status": "0x1",

        "to": "0x0697250b9d73b460a9d2bbfd8c4cacebb05dd1f1",

        "transactionHash": "0xc9af231ad59bcd7e8dcf827afd45020a02112704dce74ec5f72cb090aa07eef0",

        "transactionIndex": "0x6",

        "type": "0x0"

    }

}

eth_getWork

返回当前区块的哈希。

参数

无

返回值

Array - 包含以下属性的数组：

索引 数据类型 描述
1 DATA, 32 Bytes 区块哈希
2 DATA 未使用
3 DATA 未使用

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getWork",

    "params": [],

    "id": 73

}'

结果

{

    "jsonrpc": "2.0",

    "id": 73,

    "result": ["0x00000000020e73915413df0c816e327dc4b9d17069887aef1fff0e854f8d9ad0", null, null]

}

eth_protocolVersion

返回 java-tron 区块版本。

参数

无

返回值

String - 当前 java-tron 区块版本

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":64}'

结果

{"jsonrpc":"2.0","id":64,"result":"0x16"}

eth_syncing

返回一个包含节点同步状态数据的对象。

参数

无

返回值

Object|Boolean, 包含同步状态数据的对象或 FALSE（当未同步时），对象中的项包括：
startingBlock QUANTITY 导入开始的区块（只有在同步到达头部后才会重置）
currentBlock QUANTITY 当前区块
highestBlock QUANTITY 预估的最高区块

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":64}'

结果

{

    "jsonrpc": "2.0",

    "id": 64,

    "result": {

        "startingBlock": "0x20e76cc",

        "currentBlock": "0x20e76df",

        "highestBlock": "0x20e76e0"

    }

}

eth_newFilter

根据过滤选项创建一个过滤器对象，以便在状态更改（日志）时通知。

参数

Object - 过滤选项：

字段 类型 描述
fromBlock QUANTITY|TAG 整数区块号，或 "latest"
toBlock QUANTITY|TAG 整数区块号，或 "latest"
address DATA|Array, 20 Bytes 合约地址或日志应源自的地址列表。
topics Array of DATA 主题

返回值

QUANTITY - 过滤器 ID。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"address":["cc2e32f2388f0096fae9b055acffd76d4b3e5532","E518C608A37E2A262050E10BE0C9D03C7A0877F3"],"fromBlock":"0x989680","toBlock":"0x9959d0","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",null,["0x0000000000000000000000001806c11be0f9b9af9e626a58904f3e5827b67be7","0x0000000000000000000000003c8fb6d064ceffc0f045f7b4aee6b3a4cefb4758"]]}],"id":1}'

结果

{"jsonrpc":"2.0","id":1,"result":"0x2bab51aee6345d2748e0a4a3f4569d80"}

eth_newBlockFilter

在节点中创建一个过滤器，以便在新区块到达时通知。

参数

无。

返回值

QUANTITY - 过滤器 ID。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":1}'

结果

{"jsonrpc":"2.0","id":1,"result":"0x2bab51aee6345d2748e0a4a3f4569d80"}

eth_getFilterChanges

轮询过滤器，返回自上次轮询以来发生的日志数组。

参数

QUANTITY - 过滤器 ID。

返回值

  • 对于使用 eth_newFilter 创建的过滤器，返回日志对象列表，每个日志对象包含以下参数：
字段 类型 描述
removed TAG 如果日志由于链重组被移除则为 true。如果是有效日志则为 false。
logIndex QUANTITY 日志在区块中的索引位置。如果是待处理日志则为 null。
transactionIndex QUANTITY 创建日志的交易索引位置。如果是待处理日志则为 null。
transactionHash DATA, 32Bytes 创建日志的交易哈希。
blockHash DATA, 32 Bytes 日志所在区块的哈希。如果是待处理日志则为 null。
blockNumber QUANTITY 日志所在区块的区块号。
address DATA, 32 Bytes 日志来源的地址。
data DATA 包含一个或多个 32 字节的非索引日志参数。
topics DATA[] 事件主题和索引参数。
  • 对于使用 eth_newBlockFilter 创建的过滤器，返回区块哈希（DATA, 32 Bytes）。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getFilterChanges",

    "params": [

        "0xc11a84d5e906ecb9f5c1eb65ee940b154ad37dce8f5ac29c80764508b901d996"

    ],

    "id": 71

}'

结果

{

    "jsonrpc": "2.0",

    "id": 71,

    "error": {

        "code": -32000,

        "message": "filter not found",

        "data": "{}"

    }

}

eth_getFilterLogs

返回与给定过滤器 ID 匹配的所有日志数组。

参数

QUANTITY - 过滤器 ID。

返回值

参见 eth_getFilterChanges。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_getFilterLogs",

    "params": [

        "0xc11a84d5e906ecb9f5c1eb65ee940b154ad37dce8f5ac29c80764508b901d996"

    ],

    "id": 71

}'

结果

{

    "jsonrpc": "2.0",

    "id": 71,

    "error": {

        "code": -32000,

        "message": "filter not found",

        "data": "{}"

    }

}

eth_uninstallFilter

卸载给定 ID 的过滤器。当不再需要监视时应始终调用此方法。此外，如果过滤器在一段时间内未通过 eth_getFilterChanges 请求，则会超时。

参数

QUANTITY - 过滤器 ID。

返回值

Boolean - 如果过滤器成功卸载则为 true，否则为 false。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "jsonrpc": "2.0",

    "method": "eth_uninstallFilter",

    "params": [

        "0xc11a84d5e906ecb9f5c1eb65ee940b154ad37dce8f5ac29c80764508b901d996"

    ],

    "id": 71

}'

结果

{

    "jsonrpc": "2.0",

    "id": 71,

    "result": true

}

eth_getLogs

返回与给定过滤器对象匹配的所有日志数组。

参数

Object - 过滤选项，包括以下字段：

字段 类型 描述
fromBlock QUANTITY|TAG （可选，默认："latest"）整数区块号，或 "latest" 表示最后一个挖出的区块
toBlock QUANTITY|TAG （可选，默认："latest"）整数区块号，或 "latest" 表示最后一个挖出的区块
address DATA|Array, 20 Bytes （可选）合约地址或日志应源自的地址列表。
topics Array of DATA （可选）32 字节 DATA 主题数组。主题是顺序相关的。每个主题也可以是具有 "or" 选项的 DATA 数组。
blockhash DATA, 32 Bytes （可选）区块哈希

返回值

参见 eth_getFilterChanges。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"address":["cc2e32f2388f0096fae9b055acffd76d4b3e5532","E518C608A37E2A262050E10BE0C9D03C7A0877F3"],"fromBlock":"0x989680","toBlock":"0x9959d0","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",null,["0x0000000000000000000000001806c11be0f9b9af9e626a58904f3e5827b67be7","0x0000000000000000000000003c8fb6d064ceffc0f045f7b4aee6b3a4cefb4758"]]}],"id":1}'

结果

{

    "jsonrpc": "2.0",

    "id": 71,

    "result": []

}

net

net_listening

如果客户端正在主动监听网络连接，则返回 true。

参数

无

返回

Boolean - 如果正在监听，则为 true，否则为 false。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":64}'

结果

{"jsonrpc":"2.0","id":64,"result":true}

net_peerCount

返回当前连接到客户端的对等节点数量。

参数

无

返回

QUANTITY - 连接的对等节点数量的整数。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":64}'

结果

{"jsonrpc":"2.0","id":64,"result":"0x9"}

net_version

返回创世区块的哈希值。

参数

无

返回

String - 创世区块的哈希值。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":64}'

结果

{"jsonrpc":"2.0","id":64,"result":"0x2b6653dc"}

web3

web3_clientVersion

返回当前客户端版本。

参数

无

返回

String - 当前客户端版本

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc": "2.0", "id": 1, "method": "web3_clientVersion", "params": []}'

结果

{"jsonrpc":"2.0","id":1,"result":"TRON/v4.3.0/Linux/Java1.8/GreatVoyage-v4.2.2.1-281-gc1d9dfd6c"}

web3_sha3

返回给定数据的 Keccak-256 哈希值（非标准化的 SHA3-256）。

参数

DATA - 要转换为 SHA3 哈希的数据

返回

DATA - 给定字符串的 SHA3 结果。

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"jsonrpc": "2.0", "id": 1, "method": "web3_sha3", "params": ["0x68656c6c6f20776f726c64"]}'

结果

{"jsonrpc":"2.0","id":1,"result":"0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"}

buildTransaction

创建交易，不同类型的交易具有不同的参数

TransferContract

参数

对象 - 对象中的项如下：

参数名称 数据类型 描述
from DATA, 20 字节 交易发送方的地址。
to DATA, 20 字节 交易接收方的地址。
value DATA 转账金额

返回

对象 - TransferContract 交易或错误

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "id": 1337,

    "jsonrpc": "2.0",

    "method": "buildTransaction",

    "params": [

        {

            "from": "0xC4DB2C9DFBCB6AA344793F1DDA7BD656598A06D8",

            "to": "0x95FD23D3D2221CFEF64167938DE5E62074719E54",

            "value": "0x1f4"

        }]}'

结果

{"jsonrpc":"2.0","id":1337,"result":{"transaction":{"visible":false,"txID":"ae02a80abd985a6f05478b9bbf04706f00cdbf71e38c77d21ed77e44c634cef9","raw_data":{"contract":[{"parameter":{"value":{"amount":500,"owner_address":"41c4db2c9dfbcb6aa344793f1dda7bd656598a06d8","to_address":"4195fd23d3d2221cfef64167938de5e62074719e54"},"type_url":"type.googleapis.com/protocol.TransferContract"},"type":"TransferContract"}],"ref_block_bytes":"957e","ref_block_hash":"3922d8c0d28b5283","expiration":1684469286000,"timestamp":1684469226841},"raw_data_hex":"0a02957e22083922d8c0d28b528340f088c69183315a66080112620a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412310a1541c4db2c9dfbcb6aa344793f1dda7bd656598a06d812154195fd23d3d2221cfef64167938de5e62074719e5418f40370d9bac2918331"}}}

TransferAssetContract

参数

对象 - 对象中的项如下：
from DATA, 20 字节 交易发送方的地址
to DATA, 20 字节 交易接收方的地址
tokenId QUANTITY 代币 ID
tokenValue QUANTITY TRC10 代币的转账金额

返回

对象 - TransferAssetContract 交易或错误

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "method": "buildTransaction",

    "params": [

        {

            "from": "0xC4DB2C9DFBCB6AA344793F1DDA7BD656598A06D8",

            "to": "0x95FD23D3D2221CFEF64167938DE5E62074719E54",

            "tokenId": 1000016,

            "tokenValue": 20

        }

    ],

    "id": 44,

    "jsonrpc": "2.0"

}

'

结果

{"jsonrpc":"2.0","id":44,"error":{"code":-32600,"message":"assetBalance must be greater than 0.","data":"{}"}}

CreateSmartContract

参数

对象 - 对象中的项如下：
from DATA, 20 字节 交易发送方的地址
name DATA 智能合约的名称。
gas DATA 费用限制
abi DATA 智能合约的 ABI。
data DATA 智能合约的字节码。
consumeUserResourcePercent QUANTITY 用户资源消耗百分比。
originEnergyLimit QUANTITY 初始能量限制。
value DATA 通过 call_value 传递的数据。
tokenId QUANTITY 代币 ID
tokenValue QUANTITY TRC10 代币的转账金额

返回

对象 - CreateSmartContract 交易或错误

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

    "id": 1337,

    "jsonrpc": "2.0",

    "method": "buildTransaction",

    "params": [

        {

            "from": "0xC4DB2C9DFBCB6AA344793F1DDA7BD656598A06D8",

            "name": "transferTokenContract",

            "gas": "0x245498",

            "abi": "[{\"constant\":false,\"inputs\":[],\"name\":\"getResultInCon\",\"outputs\":[{\"name\":\"\",\"type\":\"trcToken\"},{\"name\":\"\",\"type\":\"uint256\"},{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":true,\"stateMutability\":\"payable\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"name\":\"toAddress\",\"type\":\"address\"},{\"name\":\"id\",\"type\":\"trcToken\"},{\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"TransferTokenTo\",\"outputs\":[],\"payable\":true,\"stateMutability\":\"payable\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"msgTokenValueAndTokenIdTest\",\"outputs\":[{\"name\":\"\",\"type\":\"trcToken\"},{\"name\":\"\",\"type\":\"uint256\"},{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":true,\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"payable\":true,\"stateMutability\":\"payable\",\"type\":\"constructor\"}]\n",

            "data": "6080604052d3600055d2600155346002556101418061001f6000396000f3006080604052600436106100565763ffffffff7c010000000000000000000000000000000000000000000000000000000060003504166305c24200811461005b5780633be9ece71461008157806371dc08ce146100aa575b600080fd5b6100636100b2565b60408051938452602084019290925282820152519081900360600190f35b6100a873ffffffffffffffffffffffffffffffffffffffff600435166024356044356100c0565b005b61006361010d565b600054600154600254909192565b60405173ffffffffffffffffffffffffffffffffffffffff84169082156108fc029083908590600081818185878a8ad0945050505050158015610107573d6000803e3d6000fd5b50505050565bd3d2349091925600a165627a7a72305820a2fb39541e90eda9a2f5f9e7905ef98e66e60dd4b38e00b05de418da3154e7570029",

            "consumeUserResourcePercent": 100,

            "originEnergyLimit": 11111111111111,

            "value": "0x1f4",

            "tokenId": 1000033,

            "tokenValue": 100000

        }

    ]

}

'

结果

{"jsonrpc":"2.0","id":1337,"result":{"transaction":{"visible":false,"txID":"598d8aafbf9340e92c8f72a38389ce9661b643ff37dd2a609f393336a76025b9","contract_address":"41dfd93697c0a978db343fe7a92333e11eeb2f967d","raw_data":{"contract":[{"parameter":{"value":{"token_id":1000033,"owner_address":"41c4db2c9dfbcb6aa344793f1dda7bd656598a06d8","call_token_value":100000,"new_contract":{"bytecode":"6080604052d3600055d2600155346002556101418061001f6000396000f3006080604052600436106100565763ffffffff7c010000000000000000000000000000000000000000000000000000000060003504166305c24200811461005b5780633be9ece71461008157806371dc08ce146100aa575b600080fd5b6100636100b2565b60408051938452602084019290925282820152519081900360600190f35b6100a873ffffffffffffffffffffffffffffffffffffffff600435166024356044356100c0565b005b61006361010d565b600054600154600254909192565b60405173ffffffffffffffffffffffffffffffffffffffff84169082156108fc029083908590600081818185878a8ad0945050505050158015610107573d6000803e3d6000fd5b50505050565bd3d2349091925600a165627a7a72305820a2fb39541e90eda9a2f5f9e7905ef98e66e60dd4b38e00b05de418da3154e7570029","consume_user_resource_percent":100,"name":"transferTokenContract","origin_address":"41c4db2c9dfbcb6aa344793f1dda7bd656598a06d8","abi":{"entrys":[{"outputs":[{"type":"trcToken"},{"type":"uint256"},{"type":"uint256"}],"payable":true,"name":"getResultInCon","stateMutability":"Payable","type":"Function"},{"payable":true,"inputs":[{"name":"toAddress","type":"address"},{"name":"id","type":"trcToken"},{"name":"amount","type":"uint256"}],"name":"TransferTokenTo","stateMutability":"Payable","type":"Function"},{"outputs":[{"type":"trcToken"},{"type":"uint256"},{"type":"uint256"}],"payable":true,"name":"msgTokenValueAndTokenIdTest","stateMutability":"Payable","type":"Function"},{"payable":true,"stateMutability":"Payable","type":"Constructor"}]},"origin_energy_limit":11111111111111,"call_value":500}},"type_url":"type.googleapis.com/protocol.CreateSmartContract"},"type":"CreateSmartContract"}],"ref_block_bytes":"80be","ref_block_hash":"ac7c3d59c55ac92c","expiration":1634030190000,"fee_limit":333333280,"timestamp":1634030131693},"raw_data_hex":"0a0280be2208ac7c3d59c55ac92c40b0fba79ec72f5ad805081e12d3050a30747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e437265617465536d617274436f6e7472616374129e050a1541c4db2c9dfbcb6aa344793f1dda7bd656598a06d812fc040a1541c4db2c9dfbcb6aa344793f1dda7bd656598a06d81adb010a381a0e676574526573756c74496e436f6e2a0a1a08747263546f6b656e2a091a0775696e743235362a091a0775696e743235363002380140040a501a0f5472616e73666572546f6b656e546f22141209746f416464726573731a0761646472657373220e120269641a08747263546f6b656e22111206616d6f756e741a0775696e743235363002380140040a451a1b6d7367546f6b656e56616c7565416e64546f6b656e4964546573742a0a1a08747263546f6b656e2a091a0775696e743235362a091a0775696e743235363002380140040a0630013801400422e0026080604052d3600055d2600155346002556101418061001f6000396000f3006080604052600436106100565763ffffffff7c010000000000000000000000000000000000000000000000000000000060003504166305c24200811461005b5780633be9ece71461008157806371dc08ce146100aa575b600080fd5b6100636100b2565b60408051938452602084019290925282820152519081900360600190f35b6100a873ffffffffffffffffffffffffffffffffffffffff600435166024356044356100c0565b005b61006361010d565b600054600154600254909192565b60405173ffffffffffffffffffffffffffffffffffffffff84169082156108fc029083908590600081818185878a8ad0945050505050158015610107573d6000803e3d6000fd5b50505050565bd3d2349091925600a165627a7a72305820a2fb39541e90eda9a2f5f9e7905ef98e66e60dd4b38e00b05de418da3154e757002928f40330643a157472616e73666572546f6b656e436f6e747261637440c7e3d28eb0c30218a08d0620e1843d70edb3a49ec72f9001a086f99e01"}}}

TriggerSmartContract

参数

对象 - 对象中的项如下：
from DATA, 20 字节 交易发送方的地址
to DATA, 20 字节 智能合约的地址
data DATA 调用的合约函数和参数
gas DATA 费用限制
value DATA 通过 call_value 传递的数据
tokenId QUANTITY 代币 ID
tokenValue QUANTITY TRC10 代币的转账金额

返回

对象 - TriggerSmartContract 交易或错误

示例

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{"id": 1337,

    "jsonrpc": "2.0",

    "method": "buildTransaction",

    "params": [

        {

            "from": "0xC4DB2C9DFBCB6AA344793F1DDA7BD656598A06D8",

            "to": "0xf859b5c93f789f4bcffbe7cc95a71e28e5e6a5bd",

            "data": "0x3be9ece7000000000000000000000000ba8e28bdb6e49fbb3f5cd82a9f5ce8363587f1f600000000000000000000000000000000000000000000000000000000000f42630000000000000000000000000000000000000000000000000000000000000001",

            "gas": "0x245498",

            "value": "0xA",

            "tokenId": 1000035,

            "tokenValue": 20

        }

    ]

    }

'

结果

{"jsonrpc":"2.0","id":1337,"result":{"transaction":{"visible":false,"txID":"c3c746beb86ffc366ec0ff8bf6c9504c88f8714e47bc0009e4f7e2b1d49eb967","raw_data":{"contract":[{"parameter":{"value":{"amount":10,"owner_address":"41c4db2c9dfbcb6aa344793f1dda7bd656598a06d8","to_address":"41f859b5c93f789f4bcffbe7cc95a71e28e5e6a5bd"},"type_url":"type.googleapis.com/protocol.TransferContract"},"type":"TransferContract"}],"ref_block_bytes":"958c","ref_block_hash":"9d8c6bae734a2281","expiration":1684469328000,"timestamp":1684469270364},"raw_data_hex":"0a02958c22089d8c6bae734a22814080d1c89183315a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a1541c4db2c9dfbcb6aa344793f1dda7bd656598a06d8121541f859b5c93f789f4bcffbe7cc95a71e28e5e6a5bd180a70dc8ec5918331"}}}