TronGrid
TronGrid 是 TRON 网络的托管节点服务,提供免运维的 FullNode、SolidityNode、JSON-RPC、gRPC endpoint,并提供预索引扩展 API。
TronGrid 是 TRON 网络的托管节点服务,作用类似以太坊生态中的 Infura 或 Alchemy:开发者无需自行部署和维护节点,就可以通过 HTTPS 或 gRPC endpoint 连接 TRON 网络,读取链上状态、构建和广播交易,并接入常用工具链。
除标准节点 endpoint 外,TronGrid 还提供一组预索引扩展 API,用于查询标准节点接口不直接返回的账户历史、Token 转账、合约事件和内部交易等数据。
TronGrid 的核心能力可以分为两类:
| 能力 | 说明 |
|---|---|
| 节点服务 | 提供 FullNode HTTP、SolidityNode HTTP、JSON-RPC 和 gRPC endpoint,用于交易构建、广播、链上状态读取和工具链接入。 |
| 扩展 API | 提供 TronGrid V1 API,用于查询账户历史、TRC-20 转账、合约事件、内部交易、Token 余额和区块统计等预索引数据。 |
主网站和控制台入口:
| 资源 | 链接 |
|---|---|
| TronGrid 网站 | https://www.trongrid.io |
| Shasta 测试网 | https://www.trongrid.io/shasta |
| API key / 配额管理 | 登录 TronGrid 控制台后管理 |
前置阅读
节点服务
作为托管节点服务,TronGrid 代理 TRON 节点的标准接口:
| API 类型 | 典型用途 |
|---|---|
| FullNode HTTP API | 构建交易、广播交易、读取最新链头状态 |
| SolidityNode HTTP API | 读取已固化交易、账户和区块状态 |
| JSON-RPC API | 接入 ethers、web3.js、viem 等以太坊兼容工具链 |
| gRPC API | 服务端程序直接调用 TRON 原生 gRPC 接口 |
FullNode 和 SolidityNode 的选择取决于是否需要最终状态。交易构建和广播通常使用 FullNode;交易确认、余额对账和已固化区块读取应使用 SolidityNode。详细选型见 FullNode 与 SolidityNode 选择指南。
常用网络 endpoint 见 网络。gRPC 调用示例见 通过 gRPC 调用 TRON。
扩展 API
TronGrid V1 API 是 TronGrid 在标准节点 API 之外提供的预索引查询层。它适合按账户、合约、Token、事件或区块维度查询历史数据,避免调用方自行扫描和解析每个区块。
常见查询目标包括:
| 查询目标 | 参考入口 |
|---|---|
| V1 API 分类与入口 | TronGrid V1 API 概览 |
| 账户状态和交易历史 | 账户与交易 |
| TRC-20 / TRC-721 转账历史 | 通过账户地址获取合约交易信息 |
| 合约事件日志 | 事件 |
| 内部交易 | 通过地址获取内部交易 |
扩展 API 是索引服务,不等同于节点共识层本身。需要最终状态时,应使用确认参数、分页游标、本地去重和必要的已固化状态校验。
API key
生产环境调用 TronGrid 应配置 API key。API key 用于身份识别、配额统计、限流控制和安全策略配置,不代表链上账户权限,也不会替应用签名交易。
API key 的创建、网络入口和请求头格式,见 API Key。安全设置(Origin、User-Agent、API 允许列表、JWT 等)见 安全设置。
Rate limit
TronGrid 会按 API key、账户、IP、接口类型和时间窗口限制请求量。被限流时,接口可能返回 429 或 403。客户端应使用退避、缓存、分页和断点续扫策略,不应高频轮询同一地址或同一区块范围。
限流维度、错误响应、重试策略和提高配额流程,见 TronGrid 速率限制。
与自建节点的关系
TronGrid 和自建节点不是互斥关系。TronGrid 适合快速接入、测试网开发、备用 endpoint 和预索引历史查询;自建节点适合高可控的生产链路、内部审计、专用索引和自定义节点配置。
| 维度 | TronGrid | 自建节点 |
|---|---|---|
| 运维成本 | 无需自行同步和维护节点 | 需要部署、同步、监控和升级 |
| 标准节点 API | 通过托管 endpoint 调用 | 由本地 java-tron 节点直接提供 |
| 历史查询 | V1 API 提供预索引查询 | 需要自建索引器或逐块扫描 |
| 可控性 | 受服务策略、配额和限流影响 | 可控制节点配置、数据保留和访问策略 |
托管 RPC、自建节点和索引器的取舍,见 RPC 与索引器服务商。
相关资源
- TronGrid V1 API 概览 —— 扩展 API 分类和入口
- API Key —— 网络入口、API key 创建和请求头格式
- TronGrid 速率限制 —— 配额、429 / 403、退避和提高配额
- FullNode HTTP API —— 标准节点读写接口
- Solidity HTTP API —— 已固化状态读取接口
- JSON-RPC API —— 以太坊兼容工具链入口
- 网络 —— Mainnet、Shasta、Nile 的 endpoint
- RPC 与索引器服务商 —— 托管 RPC、自建节点和索引器选型
Updated 26 days ago