Referencia Rápida para Desarrolladores

Obtén acceso instantáneo a los parámetros esenciales, endpoints de red y fragmentos de código necesarios para el desarrollo en TRON. Esta referencia rápida cubre las configuraciones de la Mainnet y las redes de prueba, direcciones de contratos TRC-20 verificadas y patrones básicos de inicialización del SDK para que tu flujo de trabajo sea rápido y eficiente.

Endpoints de Red

Red Principal (Mainnet)

Mainnet

# Tarea: Anotar los endpoints RPC oficiales de la red principal y el Chain ID.
HTTP API (TronGrid):   https://api.trongrid.io
JSON-RPC (EVM):        https://api.trongrid.io/jsonrpc
gRPC:                  grpc.trongrid.io:50051
EVM Chain ID:          728126428  (0x2B6653DC)

Red de Prueba Nile

Nile Testnet

# Tarea: Anotar los endpoints RPC oficiales de la red de prueba Nile y el Chain ID.
HTTP API:              https://nile.trongrid.io
JSON-RPC (EVM):        https://nile.trongrid.io/jsonrpc
EVM Chain ID:          3448148188  (0xcd8690dc)
Faucet:                https://nileex.io/join/getJoinPage
Explorer:              https://nile.tronscan.org

Red de Prueba Shasta

Shasta Testnet

# Tarea: Anotar los endpoints RPC oficiales de la red de prueba Shasta y el Chain ID.
HTTP API:              https://api.shasta.trongrid.io
EVM Chain ID:          2494104990  (0x94a9059e)
Faucet:                https://shasta.tronex.io
Explorer:              https://shasta.tronscan.org

Claves de API

El acceso a TronGrid en la red principal se beneficia de una clave de API (encabezado TRON-PRO-API-KEY). Regístrate gratis en trongrid.io. Los endpoints de las redes de prueba no requieren clave.

---

Direcciones de Contratos Verificadas (Red Principal)

Mainnet Contracts

# Tarea: Usar estas direcciones TRC-20 verificadas para la integración en la red principal.
USDT (TRC-20):    TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDD (TRC-20):    TPYmHEhy5n8TCEfYGqW2rPxsghSfzghPDn
stUSDT (TRC-20):  TThzxNRLrW2Brp9DcTQU8i4Wd9udCWEdZ3
wstUSDT (TRC-20): TGkxzkDKyMeq2T7edKnyjZoFypyzjkkssq
WTRX (TRC-20):    TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR
SUN  (TRC-20):    TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S
JST  (TRC-20):    TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9
BTT  (TRC-20):    TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4
WIN  (TRC-20):    TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7

Direcciones de USDT en Redes de Prueba

Testnet USDT

# Tarea: Usar estas direcciones para la integración de USDT en las redes de prueba de TRON.
Nile Testnet:     TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf
Shasta Testnet:   TDZDd58a44n5Bvg7pfpcdWhZpv7XSt9PsU

---

Inicialización de tronweb

Red Principal (con clave de API)

init_mainnet.js

// Tarea: Inicializar TronWeb para la red principal con una clave de API Pro.
import TronWeb from "tronweb"

const tronWeb = new TronWeb({
  fullHost: 'https://api.trongrid.io',
  headers: { 'TRON-PRO-API-KEY': 'your-api-key-here' },
  privateKey: 'your-private-key-here', // omitir para solo lectura
});

Red de Prueba Nile

init_nile.js

// Tarea: Inicializar TronWeb para la red de prueba Nile.
const tronWeb = new TronWeb({
  fullHost: 'https://nile.trongrid.io',
  privateKey: 'your-private-key-here',
});

Solo lectura / navegador (inyección de TronLink)

init_injected.js

// Tarea: Conectarse a la instancia de window.tronWeb inyectada por TronLink.
if (window.tronWeb && window.tronWeb.ready) {
  const tronWeb = window.tronWeb;
  const address = tronWeb.defaultAddress.base58; // ej. TJY...
} else {
  console.warn('TronLink not installed or locked');
}

---

Llamadas Comunes a la API HTTP

Terminal

# Tarea: Consultas comunes de cuentas y transacciones mediante HTTP sin procesar.
# Obtener información de cuenta
curl https://api.trongrid.io/v1/accounts/{address}

# Obtener saldo de TRX (devuelve SUN)
curl https://api.trongrid.io/v1/accounts/{address} | jq '.data[0].balance'

# Obtener saldo de token TRC-20
curl "https://api.trongrid.io/v1/accounts/{address}/tokens?token_id=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&token_type=trc20"

# Obtener el último bloque
curl https://api.trongrid.io/wallet/getnowblock

# Transmitir una transacción firmada
curl -X POST https://api.trongrid.io/wallet/broadcasttransaction \
  -H 'Content-Type: application/json' \
  -d '{"transaction": {...}}'

---

Interacción con Contratos TRC-20 (tronweb)

trc20_ops.js

// Tarea: Cargar un contrato y realizar consultas de saldo y transferencias TRC-20.
const USDT = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
const contract = await tronWeb.contract().at(USDT);

// Obtener saldo
const balance = await contract.balanceOf(address).call();
const usdtAmount = tronWeb.toBigNumber(balance).div(1e6).toFixed(6);

// Transferir
const amount = tronWeb.toSun(10);
await contract.transfer(recipientAddress, amount).send();

---

Utilidades de Direcciones

address_utils.js

// Tarea: Convertir y validar direcciones TRON entre Hex y Base58.
// Convertir de hex a Base58
const base58 = tronWeb.address.fromHex('0x41....');

// Convertir de Base58 a hex
const hex = tronWeb.address.toHex('TXXX...');

// Validar
const isValid = tronWeb.isAddress('TXXX...');

---

Utilidades Extra para Desarrolladores

Verificar Metadatos TRC-20

token_metadata.js

// Tarea: Obtener los decimales y el símbolo de cualquier token TRC-20.
const contract = await tronWeb.contract().at('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t');
const [symbol, decimals, name] = await Promise.all([
  contract.symbol().call(),
  contract.decimals().call(),
  contract.name().call()
]);
console.log(`${name} (${symbol}): ${decimals} decimals`);

Activar una Nueva Cuenta

Comisión de Activación de Cuenta

Las cuentas nuevas deben ser activadas antes de poder realizar transacciones.

• Transferencia de TRX: ~1.1 TRX en total (1 TRX de comisión de protocolo + ~0.1 TRX de Ancho de banda).
• Transferencia de USDT: 13–15 TRX en total (mayor debido a los costos de Energía por la ejecución del contrato).

Históricamente la comisión era de 0.1 TRX, pero se incrementó a 1 TRX mediante la Propuesta #67 (2021) para prevenir el spam de creación de cuentas.

---

Diferencias Clave entre TVM y EVM

Comportamiento	Ethereum / EVM	TRON / TVM
block.timestamp	Segundos desde epoch	Milisegundos desde epoch
SELFDESTRUCT	EIP-6780 (solo transferencia de activos)	Alineado con EIP-6780 (Propuesta 106)
Codificación de dirección	address = hex de 20 bytes	address = 20 bytes, pero Base58 en las herramientas
Modelo de comisiones	Gas (ETH por unidad)	Energía (del Staking) + Ancho de banda (por byte)
Precompilados	Conjunto EVM completo	Parcial — algunos precompilados se comportan diferente
tx.origin	Permitido	Permitido pero con las mismas advertencias que en EVM

---

Parámetros de Red

Parámetro	Valor
Tiempo de bloque	~3 segundos
Finalidad	~19 bloques (~57 segundos)
Tasa de quema de Energía	100 sun por unidad de Energía
Tasa de quema de Ancho de banda	1,000 puntos de Ancho de banda por TRX
Ancho de banda gratuito por cuenta/día	600 puntos
Costo de Energía para transferencia de USDT	~31,895 (base) – ~64,895 (cuenta nueva); hasta 140k+ en picos de congestión
Recompensa de bloque	8 TRX (al SR productor)
Recompensa de votos	128 TRX por bloque (distribuidos entre los 127 SRs principales)

---

Enlaces Útiles

Recurso	URL
Documentación para Desarrolladores de TRON	developers.tron.network
Clave de API de TronGrid	trongrid.io
TRONSCAN (red principal)	tronscan.org
TronBox (npm)	npm install -g tronbox
tronweb (npm)	npm install tronweb
Repositorio TIP	github.com/tronprotocol/tips
Nodo completo java-tron	github.com/tronprotocol/java-tron