查询网络

查询区块、交易、链参数、节点状态等链上信息的只读接口集合。

常见任务

目标推荐路径
查询最终确认状态使用 SolidityNode 的最新区块和 TransactionInfo 接口,见确认语义
顺序扫描已固化区块GetBlockByLimitNext(SolidityNode)GetTransactionInfoByBlockNum(SolidityNode),见交易所钱包集成
查询一笔交易的完整状态GetTransactionById(交易本体)→ GetTransactionInfoById(执行收据),见确认语义

本组接口

区块查询

接口用途
GetNowBlock查询最新已产出区块
GetBlock按高度或 ID 查询区块,可选只取区块头
GetBlockByNum按高度查询完整区块
GetBlockById按区块 ID 查询
GetBlockByLatestNum从链头往回查最近 N 个区块
GetBlockByLimitNext按高度区间批量查询
GetBlockBalance查询区块内所有余额变动操作

交易查询

接口用途
GetTransactionById查询交易本体(raw_data + 签名)
GetTransactionInfoById查询交易执行收据(receipt)
GetTransactionInfoByBlockNum批量查询某区块所有交易的 receipt
GetApprovedList从多签交易中恢复签名者地址列表

链参数与节点状态

接口用途
GetChainParameters查询全部链参数当前值
GetBandwidthPrices查询带宽单价的历史变化轨迹
GetEnergyPrices查询能量单价的历史变化轨迹
GetBurnTRX查询累计销毁的 TRX 总量
GetNodeInfo查询节点自身运行状态
ListNodes查询节点已连接的对等节点列表

相关资源

  • 区块 —— 区块结构与复合区块 ID
  • 共识与 DPoS —— 区块生产时间表、分叉选择、固化机制
  • 网络参数 —— 链参数完整列表与当前主网取值