以太坊兼容的 eth_* 系列 JSON-RPC 方法——账户、区块、交易、合约、过滤器、链信息查询。
以太坊兼容的 eth_* 系列 JSON-RPC 方法。账户、区块、交易、合约、过滤器、链信息查询。
本组接口
账户与余额
| 接口 | 用途 |
|---|---|
| eth_accounts | 列出节点管理的账户（TRON 上通常为空） |
| eth_getBalance | 查询账户 TRX 余额 |
区块查询
| 接口 | 用途 |
|---|---|
| eth_blockNumber | 查询最新区块高度 |
| eth_getBlockByHash | 按区块哈希查询区块 |
| eth_getBlockByNumber | 按区块高度查询区块 |
| eth_getBlockReceipts | 查询区块内所有交易的 receipt |
| eth_getBlockTransactionCountByHash | 按哈希查询区块的交易数量 |
| eth_getBlockTransactionCountByNumber | 按高度查询区块的交易数量 |
| eth_getWork | 返回当前 TRON 区块哈希 |
交易查询
| 接口 | 用途 |
|---|---|
| eth_getTransactionByHash | 按哈希查询交易 |
| eth_getTransactionByBlockHashAndIndex | 按区块哈希 + 索引查询交易 |
| eth_getTransactionByBlockNumberAndIndex | 按区块高度 + 索引查询交易 |
| eth_getTransactionReceipt | 查询交易 receipt |
合约与存储
| 接口 | 用途 |
|---|---|
| eth_call | 只读模拟合约调用（不上链） |
| eth_getCode | 查询合约字节码 |
| eth_getStorageAt | 查询合约存储槽位的值 |
| eth_estimateGas | 估算交易需要消耗的能量 |
| eth_gasPrice | 查询当前能量单价（sun） |
过滤器与日志
| 接口 | 用途 |
|---|---|
| eth_newFilter | 创建日志过滤器 |
| eth_newBlockFilter | 创建新区块过滤器 |
| eth_getFilterChanges | 轮询过滤器变化 |
| eth_getFilterLogs | 获取过滤器匹配的全部日志 |
| eth_getLogs | 直接按条件查询日志 |
| eth_uninstallFilter | 卸载过滤器 |
链与协议信息
| 接口 | 用途 |
|---|---|
| eth_chainId | 查询链 ID（TRON 上为创世块哈希低 4 字节） |
| eth_coinbase | 返回节点关联的 SR 地址 |
| eth_protocolVersion | 协议版本号 |
| eth_syncing | 节点同步状态 |
相关资源
- TVM 与 EVM 对比 —— eth_* 在两条链上的行为差异（特别是 chainId、selfdestruct、create2）
- 将以太坊合约迁移到 TRON —— 用 Web3.js / ethers / viem 直接对接 TRON
- buildTransaction —— TRON 专用：构造各类 TRON 特有交易