Desarrollo en TRON Nivel Medio: TVM, Recursos, Solidity, Contratos y Tokens TRC por Santiago Soñora

“Hola, mundo” en TRON

Un contrato inteligente básico en Solidity, compatible para desplegar en la red TRON.

📋 Copiar

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0; // TRON soporta versiones recientes de Solidity

contract HelloTron {
    string public message = "Hola, TRON!";

    function updateMessage(string memory newMessage) public {
        message = newMessage;
    }
}

Resultado:

Output

Contrato compilado con éxito. Bytecode y ABI listos para despliegue en TRON.

Comandos básicos

Familiarizarse con estos comandos es esencial para interactuar eficientemente con TRON:

Instalar TronBox (entorno de desarrollo)
📋 Copiar
```
npm install -g tronbox
```
Instala la interfaz de línea de comandos de TronBox, un framework de desarrollo similar a Truffle para TRON.
Instalar TronWeb (librería JS)
📋 Copiar
```
npm install tronweb
```
Instala la librería JavaScript oficial para interactuar con la red TRON (nodos, cuentas, contratos) desde tu código (Node.js o navegador).
Inicializar un proyecto TronBox
📋 Copiar
```
tronbox init
```
Crea la estructura de directorios y archivos base para un nuevo proyecto de desarrollo de contratos TRON con TronBox.

Configurar TronBox para redes TRON (ej: Nile Testnet, Mainnet)

📋 Copiar

Modifica el archivo `tronbox.js` en la raíz de tu proyecto. Ejemplo (usando variables de entorno):
```javascript
require('dotenv').config(); // Si usas plugin dotenv

module.exports = {
  networks: {
    nile: {
      privateKey: process.env.PRIVATE_KEY_DEL_DEPLOYER, // Desde .env
      host: "[https://nile.trongrid.io](https://nile.trongrid.io)", // URL RPC de la testnet Nile
      network_id: "*" // Cualquier ID de red
    },
    mainnet: {
      privateKey: process.env.PRIVATE_KEY_DEL_DEPLOYER, // Desde .env
      host: "[https://api.trongrid.io](https://api.trongrid.io)", // URL RPC de la red principal de TronGrid
      network_id: "*"
    }
  },
  solidity: {
    compilers: [{
      version: "0.8.0" // Especifica la versión de Solidity compatible con TVM
    }]
  }
};
```

Define las configuraciones para conectarte a las redes de TRON (URLs RPC, claves privadas) en el archivo de configuración de TronBox. Usa variables de entorno para la seguridad de las claves.

Compilar contratos con TronBox
📋 Copiar
```
tronbox compile
```
Compila los archivos Solidity en tu proyecto utilizando el compilador configurado en `tronbox.js`, generando el bytecode y el ABI para la TVM.
Obtener TRX de prueba (Nile Testnet) de un Faucet
📋 Copiar
```
Ir a https://nileex.io/join/getTestTron, pegar tu dirección de billetera TRON (ej: de TronLink) y reclamar tTRX.
```
Consigue tokens TRX gratuitos para cubrir los costos de recursos (Bandwidth y Energy) al probar contratos y transacciones en la Nile Testnet.
Desplegar contratos en Nile Testnet con TronBox
📋 Copiar
```
tronbox migrate --network nile
```
Ejecuta los scripts de migración definidos en TronBox para publicar tus contratos compilados en la Nile Testnet. Asegúrate de tener tTRX en la cuenta desplegadora.
Desplegar contratos en TRON Mainnet con TronBox
📋 Copiar
```
tronbox migrate --network mainnet
```
Ejecuta los scripts de migración para desplegar tus contratos en la red principal de TRON. Requiere TRX real en la cuenta especificada y suma precaución.

Interactuar con contrato (Lectura - TRC-20 balanceOf) usando TronWeb

📋 Copiar

// Usando TronWeb con un Provider (ej: TronGrid)
const contractAddress = 'TP...'; // Dirección del contrato TRC-20 en TRON
const tronWeb = new TronWeb('https://api.trongrid.io', 'https://api.trongrid.io', 'https://api.trongrid.io'); // Solo Provider

const contract = await tronWeb.contract().at(contractAddress);
const userAddress = 'TR...'; // Dirección TRON a consultar
const balance = await contract.balanceOf(userAddress).call();
// El balance se devuelve en la unidad más pequeña. Ajustar con decimales del token.
console.log('Balance TRC-20:', balance.toString());

Consulta el saldo de un token TRC-20 para una dirección dada utilizando la librería TronWeb. Llamada de lectura, no cuesta recursos.

Interactuar con contrato (Escritura - TRC-20 transfer) usando TronWeb

📋 Copiar

// Usando TronWeb con un Signer (Provider + Clave Privada o conectado a TronLink)
const contractAddress = 'TP...';
const tronWeb = new TronWeb('https://api.trongrid.io', 'https://api.trongrid.io', 'https://api.trongrid.io', PRIVATE_KEY_DEL_DEPLOYER); // Configurar con clave privada para firmar
// O usar TronLink inyectado: const tronWeb = window.tronWeb;

const contract = await tronWeb.contract().at(contractAddress);
const recipientAddress = 'TR...';
const amountToSend = 1000000; // Ejemplo: 1 token con 6 decimales

const transactionHash = await contract.transfer(recipientAddress, amountToSend).send();
console.log('Hash de transacción:', transactionHash);

Envía una cantidad de un token TRC-20 desde la cuenta configurada en TronWeb a otra dirección. Requiere firmar una transacción (con clave privada o billetera como TronLink) y consume recursos (Bandwidth y Energy).

Ver transacciones, direcciones y contratos en TronScan
📋 Copiar
```
Ir a https://tronscan.org/ (Mainnet) o https://nile.tronscan.org/ (Nile Testnet). Pegar un hash de transacción, dirección TRON o nombre de contrato en la barra de búsqueda.
```
Utiliza el explorador de bloques oficial de TRON para ver el estado y detalles de transacciones, el contenido de bloques, saldos de direcciones, tokens (TRC-10, TRC-20), votos de SRs, y verificar contratos desplegados en la red.
Congelar TRX para obtener Energy y Bandwidth
📋 Copiar
```
Usando la interfaz de TronLink Wallet (extensión o móvil) o la interfaz web de TronScan, ve a la sección 'Resources' o 'Energy & Bandwidth'. Selecciona la cantidad de TRX a 'Freeze'/'Stake' y por cuánto tiempo (mínimo 3 días) y confirma la transacción.
```
Proceso para obtener recursos de red (Bandwidth para transacciones básicas, Energy para ejecución de contratos) congelando TRX. Los TRX congelados no se gastan, pero se bloquean por un tiempo y te dan una asignación diaria de recursos.
Verificar código fuente de contrato en TronScan
📋 Copiar
```
En TronScan, busca la dirección de tu contrato desplegado. Ve a la pestaña 'Contract' y busca la opción 'Verify Contract Source Code'. Sigue las instrucciones (subir código fuente, seleccionar compilador).
```
Permite que el código fuente de tu contrato sea público y verificable en TronScan para transparencia y para permitir interacción desde el explorador.

Conceptos Clave

Comprender estos conceptos fundamentales te ayudará a dominar TRON de forma más organizada y eficiente:

TRON Virtual Machine (TVM):

El entorno de ejecución de los contratos inteligentes en TRON. Es compatible con EVM, lo que significa que la mayoría de los contratos escritos en Solidity o Vyper para Ethereum pueden compilarse y desplegarse en TRON con adaptaciones mínimas. Sin embargo, tiene su propia arquitectura y opcodes.
Mecanismo de Consenso: Delegated Proof of Stake (DPoS):

El algoritmo de consenso de TRON. Los poseedores de TRX votan por un conjunto limitado de Super Representantes (SRs) (27 activos). Estos SRs son responsables de validar transacciones, producir bloques y mantener la red. Este modelo permite altas velocidades de transacción y bajo costo, pero con un mayor grado de centralización comparado con otros mecanismos.
Recursos de Red: Energy y Bandwidth:

El sistema de tarifas de TRON, que es diferente del 'gas' en Ethereum y cadenas EVM. Las transacciones cuestan 'Bandwidth Points' (para transferencias básicas, etc.) o 'Energy' (para la ejecución de contratos inteligentes). Puedes obtener estos recursos congelando TRX (la forma recomendada y más económica) o pagando directamente en TRX por la transacción.
Estándares de Tokens TRC (TRC-10, TRC-20, TRC-721):

Estándares para tokens en la red TRON. TRC-10 son tokens nativos emitidos directamente en la capa base de TRON (no requieren un contrato inteligente desplegado, ej: USDT de Tether). TRC-20 es el estándar para tokens fungibles implementados como contratos inteligentes (funcionalmente idéntico a ERC-20). TRC-721 es el estándar para NFTs (funcionalmente idéntico a ERC-721).
Desarrollo con Herramientas Específicas (TronBox, Remix TVM, TronWeb):

Aunque usas Solidity, necesitas herramientas específicas para TRON. TronBox es el framework CLI para compilar y desplegar. Remix IDE tiene un plugin para la TVM. TronWeb es la librería JavaScript oficial para interactuar con la red TRON desde código (similar a ethers.js/web3.js).
Redes de TRON (Mainnet y Testnets - Nile):

Comprender las redes para desarrollo y despliegue: Nile Testnet es la red de prueba principal (usando tTRX del Faucet). TRON Mainnet es la red de producción donde se ejecutan las dApps con TRX real y otros tokens.
TronScan (Explorador de Bloques):

El explorador de bloques más importante para TRON. Similar a Etherscan o BSCScan, te permite buscar y verificar transacciones por hash, direcciones, bloques, ver información de tokens (TRC-10, TRC-20, TRC-721), votar por SRs, y ver el código fuente de contratos desplegados.
TRON Wallets (TronLink):

Billeteras diseñadas para el ecosistema TRON. TronLink es la extensión de navegador más popular (similar a Metamask), permitiendo gestionar activos TRON, interactuar con dApps y firmar transacciones. Comprender que es tu puerta de entrada a las dApps en TRON.
TronGrid (RPC Endpoints):

Un servicio que proporciona acceso a la red TRON a través de puntos finales API/RPC. Necesario para que las aplicaciones (dApps, backends) se conecten y consulten datos o envíen transacciones a la red TRON.
Gestión de Recursos (Energy y Bandwidth) Congelando TRX:

La práctica de bloquear TRX por un período (mínimo 3 días) para obtener asignaciones diarias de Bandwidth Points y Energy. Congelar una cantidad suficiente de TRX puede eliminar la necesidad de pagar TRX directamente por la mayoría de las transacciones y la ejecución de contratos, reduciendo significativamente los costos de operación de dApps.

Casos de uso

Algunos ejemplos de aplicaciones prácticas donde se utiliza TRON:

Desarrollar y desplegar contratos inteligentes en TRON para dApps, juegos o servicios de contenido digital:

Escribir lógica de negocio utilizando Solidity (adaptado para la TVM) y desplegarla en la red TRON para aprovechar sus altas velocidades de transacción y bajos costos operativos.
Crear y gestionar tokens TRC-20 (fungibles) o TRC-721 (NFTs) en TRON:

Desarrollar e implementar contratos que siguen los estándares TRC correspondientes para emitir tu propia criptomoneda, token de utilidad, token de gobernanza o colección de NFTs en la red TRON.
Construir interfaces (frontend) para interactuar con dApps y protocolos desplegados en TRON:

Desarrollar el frontend de aplicaciones web que se conectan a billeteras TRON (TronLink) y usan la librería TronWeb para leer datos de contratos, enviar transacciones o firmar mensajes en la red TRON.
Desarrollar backends que interactúan con contratos en TRON usando TronWeb y TronGrid:

Crear servicios backend que necesitan leer datos, monitorear eventos o enviar transacciones programáticamente (ej: para automatizar procesos, interactuar con sistemas externos, emitir tokens) en la red TRON utilizando la librería TronWeb y conectándose a través de un nodo RPC (TronGrid).
Optimizar y gestionar el uso de recursos (Energy/Bandwidth) congelando TRX para reducir costos operativos:

Diseñar estrategias de gestión de recursos, incluyendo congelar suficiente TRX para cubrir la Energy y Bandwidth necesarias para las operaciones de tu contrato y las transacciones de los usuarios, minimizando así los costos pagados en TRX.
Auditar y verificar contratos inteligentes desplegados en TRON utilizando TronScan:

Utilizar TronScan para ver el código fuente verificado de contratos públicos, analizar transacciones relevantes, y auditar la actividad de direcciones.
Participar en el ecosistema DeFi de TRON (JustSwap, JustLend, etc.):

Interactuar con protocolos DeFi populares en TRON utilizando una billetera compatible (TronLink), aprovechando las bajas tarifas y la velocidad para operaciones financieras descentralizadas.
Implementar transferencias de tokens TRC-10 (nativos) desde código:

Utilizar TronWeb para realizar transferencias de tokens TRC-10, que son gestionados de forma diferente a los tokens TRC-20 (basados en contratos).

Consejos para Principiantes

Aquí tienes algunas recomendaciones para facilitar tus inicios en TRON:

Entiende el Modelo de Recursos: Energy y Bandwidth (No es Gas):

Este es el cambio más significativo respecto a Ethereum. Olvídate de pagar gas por cada transacción. En TRON, las tarifas se cubren con Bandwidth Points (transacciones básicas) y Energy (ejecución de contratos). Aprende a obtenerlos congelando TRX o pagando directamente.
Usa TronLink y TronScan Constantemente:

TronLink es la billetera de navegador esencial para interactuar con dApps TRON. TronScan es tu explorador de bloques principal para verificar transacciones, contratos y direcciones. Dominarlos es fundamental.
Utiliza TronBox para Desarrollo Local y Despliegue:

TronBox es el framework de desarrollo más común para contratos TRON (similar a Truffle). Úsalo para compilar, probar y desplegar tus contratos en testnets y mainnet.
Aprende TronWeb para Interactuar con la Red desde Código:

Si vas a construir dApps o servicios que interactúan programáticamente con TRON, necesitarás la librería JavaScript TronWeb. Aprende a usarla para conectar a nodos, gestionar cuentas y llamar funciones de contratos.
Utiliza la Nile Testnet y el Faucet para Pruebas Gratuitas:

Siempre desarrolla y prueba tus contratos y dApps en la Nile Testnet (usando tTRX gratuito del Faucet) antes de ir a la red principal. Te permite depurar sin costo financiero real.
Sé Consciente de las Diferencias de la TVM con la EVM:

Aunque la TVM soporta Solidity, puede haber diferencias sutiles en el comportamiento o la disponibilidad de ciertas funcionalidades. Siempre prueba tu código Solidity en la TVM (usando TronBox o Remix con el plugin TVM).
Entiende los Estándares de Tokens TRC (TRC-10, TRC-20, TRC-721):

Familiarízate con los diferentes tipos de tokens en TRON y sus estándares. Saber la diferencia entre tokens nativos (TRC-10) y tokens de contrato (TRC-20, TRC-721) es importante para la interacción.
La Seguridad de Contratos y Claves Privadas es Crítica:

Los contratos desplegados en TRON son inmutables. Un bug puede ser costoso. La seguridad de tus claves privadas es fundamental. Sigue las mejores prácticas de seguridad.
Considera Congelar TRX para Obtener Recursos y Reducir Costos:

Congelar TRX es la forma más eficiente de obtener Energy y Bandwidth. Calcula cuántos recursos necesitas para las operaciones de tu dApp y considera congelar TRX para cubrirlos, haciendo que las transacciones sean 'gratuitas' en términos de TRX gastado en fees directos.
Revisa la Documentación Oficial para Aspectos Específicos de TRON:

La documentación para desarrolladores de TRON (developers.tron.network) es tu mejor recurso para entender a fondo la TVM, el sistema de recursos, los estándares TRC y cómo usar las herramientas específicas de TRON.

Herramientas relacionadas

Si te interesa TRON, también podrías explorar estas herramientas:

Recursos útiles

Amplía tus conocimientos con estos enlaces y materiales: