Comisiones de Tron: bandwidth, energy y fee_limit
Cómo se cobran las comisiones de Tron: bandwidth, energy, orden de quema, fee_limit en llamadas a contratos y energy dinámica en contratos muy usados.
Revisado por Maurice Sobiera
Una comisión de Tron es el coste en recursos de una transacción: bandwidth por su tamaño y energy por ejecutar smart contracts. Si su cuenta tiene pocos recursos, la red quema TRX para cubrir la diferencia. Este artículo explica el orden de pago, el fee_limit que limita una llamada a un contrato y el modelo de energy dinámica.
¿Por qué existen las comisiones de Tron?
Toda transacción, salvo una consulta, consume bandwidth, así que cada transacción tiene un precio en un recurso limitado. El modelo de recursos de TRON define el bandwidth como el tamaño en bytes de una transacción. La energy mide el cálculo en la TRON Virtual Machine y solo se aplica cuando se despliega o se llama a un contrato.
Las cuentas obtienen recursos al hacer staking de TRX o al recibir recursos delegados. Además, cada cuenta recibe una asignación gratuita de 600 de bandwidth al día. Todo lo que exceda de eso se paga con TRX quemados. Las tarifas y las asignaciones son parámetros de red que las propuestas de gobernanza pueden cambiar, así que lea los valores actuales de la cadena en lugar de fijarlos en el código. El endpoint de Chaingateway GET /api/v2/tron/chainparameters los devuelve.
¿En qué orden se pagan las comisiones?
La red descuenta primero los recursos en staking y quema TRX en último lugar. El orden difiere un poco entre bandwidth y energy.
| Paso | Bandwidth (transacción estándar) | Energy (llamada a un contrato) |
|---|---|---|
| 1 | Bandwidth en staking o delegado | Energy en staking o delegada |
| 2 | Asignación gratuita diaria de 600 | Quemar TRX a 100 sun por unidad |
| 3 | Quemar TRX a 1000 sun por byte | Ninguno |
La energy no tiene asignación gratuita, así que una llamada a un contrato desde una cuenta sin energy en staking siempre quema TRX. Las transacciones que crean una cuenta nueva siguen otras reglas. No usan la asignación gratuita y queman 0,1 TRX si el bandwidth en staking no las cubre. Una transferencia de un token TRC10 también puede pagarse con el bandwidth prepagado del emisor del token.
Un ejemplo práctico: una transacción de 265 bytes necesita 265 de bandwidth. El tamaño incluye la firma, la estructura de protobuf y una reserva de 64 bytes para el resultado, tal como las definen java-tron y las reglas de codificación de protobuf. Si el remitente no tiene bandwidth en staking y ya ha gastado los 600 gratuitos, la quema cuesta 265 × 1000 sun, es decir, 0,265 TRX. La guía de comisiones de TRON muestra cómo obtener el tamaño en bytes.
¿Cómo consulto los recursos que le quedan a una cuenta?
Consulte el endpoint wallet/getaccountresource del nodo y reste lo usado del límite. El documento del modelo de recursos da estas fórmulas. Los campos ausentes cuentan como 0.
Remaining free bandwidth = freeNetLimit - freeNetUsedRemaining staked bandwidth = NetLimit - NetUsedRemaining energy = EnergyLimit - EnergyUsedLos recursos se recuperan en 24 horas tras su uso. Por eso una wallet que envía unas pocas transferencias al día puede mantenerse dentro de su bandwidth gratuito, mientras que cualquier llamada a un contrato necesita energy en staking o delegada para evitar quemar TRX. Compruebe el saldo antes de cada lote de envíos en lugar de dar por supuesto el estado anterior.
¿Qué es fee_limit?
El fee_limit es la cantidad máxima de TRX, en sun, que una llamada a un contrato puede quemar. Le protege de un consumo de energy inesperadamente alto. El documento del modelo de recursos lo describe como un valor entre 0 y 15 000 000 000 sun, es decir, 15 000 TRX. El límite superior es en sí mismo un parámetro de red. La respuesta de parámetros de cadena de Chaingateway lo muestra como getMaxFeeLimit.
El documento recorre una estimación. Un contrato necesitaba como máximo unos 20 000 de energy. A 100 sun por unidad, son 2 000 000 sun, o 2 TRX. Si el desarrollador del contrato se ha comprometido a cubrir el 90 por ciento de la energy, la parte de quien llama es de 200 000 sun, y ese es el fee_limit que debe fijar.
Para obtener la estimación de energy, llame al método estimateenergy del nodo antes de enviar la llamada. El nodo debe ejecutarse con vm.estimateEnergy=true.
¿Cuánto cuesta una transacción fallida?
El coste de una llamada fallida a un contrato depende de cómo falló. Si el contrato se detiene con un REVERT, solo paga las instrucciones que se ejecutaron antes. Si se bloquea por un error o por un timeout, la red descuenta toda la energy permitida para la transacción. Ese total incluye su energy en staking, la parte del desarrollador y los TRX quemados hasta el fee_limit.
Por eso un fee_limit bajo no es solo un tope de gasto. Si el límite queda por debajo de lo que necesita la llamada, la ejecución falla y la energy usada hasta ese momento no se reembolsa.
¿Por qué cambia el coste de energy de un contrato?
Los contratos populares pueden costar más energy por el modelo de energy dinámica. El documento del modelo de recursos lo describe como un mecanismo de equilibrio. Si el consumo base de energy de un contrato supera un umbral dentro de un periodo de mantenimiento, las llamadas a ese contrato cuestan más en el periodo siguiente. El periodo de mantenimiento actual es de 6 horas.
Cada contrato tiene un energy_factor, que empieza en 0. La energy que cuesta una llamada es la energy base multiplicada por 1 + energy_factor. En mainnet, el documento indica un increase_factor de 0,2 y un max_factor de 3,4. Un contrato en el máximo cuesta por tanto 4,4 veces su energy base. El factor vuelve a bajar cuando el uso del contrato cae al umbral o por debajo. Puede leer el factor actual de un contrato con la llamada de nodo getcontractinfo.
En los pagos, esto significa que una estimación de energy de la semana pasada puede quedarse corta hoy. Estime antes de cada envío o añada un margen al fee_limit. Para un ejemplo con USDT y la diferencia de energy según el destinatario, consulte la guía de comisiones de TRON.
Cómo escribimos estos artículos
¿Listo para construirlo tú mismo? Obtenga su clave de API — prueba de 7 días, sin tarjeta — o consulte API de Tron para la referencia completa de los endpoints.