连接到 TRON 网络

📘
前置阅读

账户与密钥

领取测试网 Token

在 TRON 上开发，第一步是选定要连接的网络。测试阶段通常使用 Shasta 或 Nile；生产环境使用 Mainnet；需要完整控制权时，可以运行自己的全节点。

连接方式本身很简单：确定 endpoint，用 SDK 初始化客户端，然后再构造、签名和广播交易。本文先给出常用 endpoint，再给出 TronWeb 和 Trident 的最小初始化示例。

常用 HTTP endpoint

以下 endpoint 可用于快速开发和测试：

网络	全节点 HTTP endpoint
Mainnet	`https://api.trongrid.io`
Shasta 测试网	`https://api.shasta.trongrid.io`
Nile 测试网	`https://nile.trongrid.io`
本地节点	`http://127.0.0.1:8090` 或 `http://localhost:8090`

TronGrid 是常用的托管节点服务。Mainnet 请求通常需要 TRON-PRO-API-KEY；测试网适合入门、调试和教程演练。更多网络参数见 Networks。

JavaScript（TronWeb）接入

TronWeb 是常用的 JavaScript SDK，适合浏览器 DApp、Node.js 脚本和后端服务。它封装了交易构造、签名、广播和合约调用。

const { TronWeb } = require('tronweb');

const tronWeb = new TronWeb({
  fullHost: 'https://api.shasta.trongrid.io',
  // Mainnet: https://api.trongrid.io
  // Nile: https://nile.trongrid.io
  headers: { 'TRON-PRO-API-KEY': 'YOUR_API_KEY' }, // Mainnet usually requires an API key
  privateKey: 'your private key'
});

在前端 DApp 中，不要把私钥写进代码。前端应通过 TronLink 等钱包请求用户签名；服务端脚本才适合直接配置私钥。

Java（Trident）接入

Trident 是 TRON 的 Java SDK，适合 Java 后端、交易所系统、托管钱包和批处理任务。它支持地址生成、交易构造、签名、广播，并封装了常用 gRPC 调用。

import org.tron.trident.core.ApiWrapper;

// Shasta testnet
ApiWrapper wrapperShasta = ApiWrapper.ofShasta("YOUR_PRIVATE_KEY_HERE");
// Nile testnet
ApiWrapper wrapperNile = ApiWrapper.ofNile("YOUR_PRIVATE_KEY_HERE");
// Mainnet
ApiWrapper wrapperMainnet = ApiWrapper.ofMainnet("YOUR_PRIVATE_KEY_HERE", "YOUR_API_KEY_HERE");

// Custom full node URL
// ApiWrapper wrapperCustom = ApiWrapper.of("YOUR_PRIVATE_KEY_HERE", "http://your-custom-fullnode:8090");

公共节点、托管服务与自建节点

公共 endpoint 可以让你马上开始开发，但会受到速率限制、可用性和索引能力约束。生产环境建议在以下方案中选择：

托管节点服务：上线快，适合多数 DApp、钱包和后台服务。
自建全节点：控制权最高，适合交易所、索引器、风控系统和高频服务。
混合方案：主路径使用自建节点，托管服务作为备用 endpoint。

需要自建节点时，先读节点与客户端，再按部署全节点或 SR 节点操作。

前置阅读

常用 HTTP endpoint

JavaScript（TronWeb）接入

Java（Trident）接入

公共节点、托管服务与自建节点

相关资源