跳转到主要内容

什么是 Node API

Node API 让您的后端可以访问我们的 TRON 全节点。它就是 java-tron 节点本身的 API:/wallet/* 和 /walletsolidity/* 下相同的 HTTP 方法,以及相同的 gRPC 服务,通过密钥访问,配额和每秒限制由您的套餐决定。 通过节点构建和广播交易,在您这边签名。您的私钥始终不离开您的服务器。

地址

与 java-tron 一样,/walletsolidity/* 只根据已固化(已确认)的区块作答。节点在这两个路径下提供的每个方法均可使用。 HTTP 接受 GET 和 POST:使用 GET 时节点读取查询字符串,使用 POST 时读取 JSON 请求体——二者不会同时读取。 方法名区分大小写,与 java-tron 一致:/wallet/getaccount,但 /wallet/getReward。 当请求带有 Accept-Encoding: gzip 时,1 KB 及以上的响应会以 gzip 压缩。大多数 HTTP 库默认会发送该请求头;使用 curl 时,请加上 --compressed。

获取密钥

1

登录

在 tronrental.com 注册或登录。
2

选择套餐

打开控制台 → Node API。开通 7 天免费试用(充值满 $5 后解锁),或购买套餐,费用从您的账户余额中支付。参见套餐与计费。
3

创建端点

添加端点:填写名称,并可选设置 IP 白名单。每个端点就是一个独立的密钥。密钥只显示一次——请复制并妥善保存。参见端点与密钥。
4

发起第一次调用

在 TRON-PRO-API-KEY 请求头中发送密钥。
响应就是节点自身的 JSON。X-Node-API-WU 响应头表示本次调用消耗了多少配额单位——这次为 1。参见配额单位。

包含内容

  • /wallet/* 和 /walletsolidity/* 下的全部节点方法,以及 gRPC 服务 protocol.Wallet 和 protocol.WalletSolidity 的一元方法。
  • 密钥可放在请求头、URL 路径或 gRPC 元数据中。
  • 最多 10 个端点(视套餐而定),每个都有独立的密钥、IP 白名单和用量计数器。
  • 新区块固定计价:距链头 20 个以内的区块无论大小均为 3 WU,其回执为 2 WU。
  • Start、Growth 和 Pro 套餐为软限制:配额用完后,请求仍可正常使用,超出配额的用量按超额用量计费。
  • 支持 CORS,浏览器应用可以直接调用节点。

不包含的内容

以下内容不属于节点 API,因此 Node API 不提供:
  • 地址历史和索引数据——某个地址的转账、按地址查询的 TRC-20 转账、合约事件查询(如 /v1/... 和 /event/... 这类路径)。对它们的请求会得到 404 not_found。要跟踪转账,请读取区块及其回执——参见代码示例中的“监听 USDT”示例。
  • JSON-RPC(/jsonrpc、eth_* 方法)未开启。
  • 需要私钥的方法,如 gettransactionsign 或 easytransferbyprivate。节点不提供这些方法;对它们的请求会得到 404 method_not_found,且不计费。请在您这边签名。
  • 其他 gRPC 服务以及 gRPC 服务器反射。参见 gRPC。
要估算一次合约调用将消耗的能量,请用相同的参数调用 triggerconstantcontract,并读取响应中的 energy_used。

响应头

通过 gRPC 时,相同的值位于尾部元数据中:x-node-api-wu、x-node-api-mode、retry-after,被拒绝时还有 x-node-api-reason。

后续步骤

端点与密钥

如何传递密钥、IP 白名单、浏览器应用。

代码示例

使用 TronWeb、tronpy、curl 和 grpcurl 接入、发送 USDT 和监听 USDT。

套餐与计费

配额、限制、超额用量、试用和续费。

限制与错误

所有拒绝代码、gRPC 状态和降级模式。