← Blog
10 min de lecture
|
Publié le
|
Mis à jour le

Frais Tron : bandwidth, energy et fee_limit

Comment Tron facture les frais : bandwidth, energy, ordre de consommation, fee_limit des appels de contrat et energy dynamique des contrats très sollicités.

Chapitres
C
Chaingateway Team
Experts blockchain

Relu par Maurice Sobiera

Les frais Tron sont le coût en ressources d’une transaction. Ils se paient en bandwidth pour sa taille et en energy pour l’exécution d’un smart contract. Si votre compte manque d’une ressource, le réseau brûle des TRX pour combler l’écart. Cet article explique l’ordre de paiement, le fee_limit qui plafonne un appel de contrat et le modèle d’energy dynamique qui fait varier les coûts.

Pourquoi les frais Tron existent-ils ?

Chaque transaction, sauf une simple requête de lecture, consomme de la bandwidth. Chacune a donc un prix dans une ressource limitée. Le modèle de ressources TRON définit la bandwidth comme la taille d’une transaction en octets. L’energy mesure le calcul dans la TRON Virtual Machine. Elle ne s’applique qu’au déploiement ou à l’appel d’un contrat.

Un compte obtient des ressources en stakant des TRX ou en recevant des ressources déléguées. Chaque compte dispose aussi d’une bandwidth gratuite de 600 par jour. Tout ce qui dépasse se paie en TRX brûlés. Les tarifs et les allocations sont des paramètres du réseau, que des propositions de gouvernance peuvent modifier. Lisez donc les valeurs actuelles sur la chaîne au lieu de les coder en dur. Le point d’accès Chaingateway GET /api/v2/tron/chainparameters les renvoie.

Dans quel ordre les frais sont-ils payés ?

Le réseau déduit d’abord les ressources stakées et brûle les TRX en dernier. L’ordre diffère légèrement entre bandwidth et energy.

ÉtapeBandwidth (transaction standard)Energy (appel de contrat)
1Bandwidth stakée ou déléguéeEnergy stakée ou déléguée
2Allocation gratuite quotidienne de 600Brûler des TRX à 100 sun par unité
3Brûler des TRX à 1 000 sun par octetAucune

L’energy n’a pas d’allocation gratuite. Un appel de contrat depuis un compte sans energy stakée brûle donc toujours des TRX. Les transactions qui créent un nouveau compte suivent d’autres règles. Elles sautent l’allocation gratuite et brûlent 0,1 TRX si la bandwidth stakée ne les couvre pas. Un transfert de jeton TRC10 peut aussi être payé par la bandwidth prépayée de l’émetteur du jeton.

Prenons un exemple chiffré : une transaction de 265 octets nécessite 265 de bandwidth. Cette taille inclut la signature, l’enveloppe protobuf et une réserve de 64 octets pour le résultat, comme le définissent java-tron et les règles d’encodage protobuf. Si l’expéditeur n’a pas de bandwidth stakée et a déjà utilisé ses 600 gratuits, la combustion coûte 265 × 1 000 sun, soit 0,265 TRX. Le guide des frais TRON montre comment obtenir la taille en octets.

Comment lire les ressources restantes d’un compte ?

Interrogez le point d’accès wallet/getaccountresource du nœud et soustrayez la valeur utilisée de la limite. Le document sur le modèle de ressources donne ces formules. Un champ absent compte pour 0.

Remaining free bandwidth = freeNetLimit - freeNetUsed
Remaining staked bandwidth = NetLimit - NetUsed
Remaining energy = EnergyLimit - EnergyUsed

Les ressources se régénèrent sur 24 heures après usage. Un portefeuille qui envoie quelques transferts par jour peut donc rester dans sa bandwidth gratuite. En revanche, tout appel de contrat exige de l’energy stakée ou déléguée pour éviter de brûler des TRX. Vérifiez le solde avant chaque série d’envois au lieu de supposer l’état précédent.

Qu’est-ce que le fee_limit ?

Le fee_limit est le montant maximal de TRX, en sun, qu’un appel de contrat peut brûler. Il vous protège d’une consommation d’energy inattendue. Le document sur le modèle de ressources le décrit comme une valeur comprise entre 0 et 15 000 000 000 sun, soit 15 000 TRX. La borne supérieure est elle-même un paramètre du réseau. La réponse des paramètres de chaîne de Chaingateway la liste sous le nom getMaxFeeLimit.

Le document déroule une estimation. Un contrat avait besoin d’environ 20 000 energy au maximum. À 100 sun par unité, cela fait 2 000 000 sun, soit 2 TRX. Si le développeur du contrat s’est engagé à couvrir 90 pour cent de l’energy, la part de l’appelant est de 200 000 sun, et c’est le fee_limit à définir.

Pour obtenir l’estimation d’energy, appelez la méthode estimateenergy du nœud avant d’envoyer l’appel. Le nœud doit tourner avec vm.estimateEnergy=true.

Combien coûte une transaction échouée ?

Le coût d’un appel de contrat échoué dépend de la façon dont il a échoué. Si le contrat s’arrête avec un REVERT, vous ne payez que les instructions exécutées avant. S’il plante à cause d’un bug ou d’un délai dépassé, le réseau déduit toute l’energy autorisée pour la transaction. Ce total comprend votre energy stakée, la part du développeur et les TRX brûlés jusqu’au fee_limit.

C’est pourquoi un fee_limit bas n’est pas un simple plafond de dépenses. Si la limite est inférieure à ce dont l’appel a besoin, l’exécution échoue, et l’energy déjà consommée n’est pas remboursée.

Pourquoi le coût en energy d’un contrat change-t-il ?

Les contrats populaires peuvent coûter plus d’energy à cause du modèle d’energy dynamique. Le document sur le modèle de ressources le décrit comme un mécanisme d’équilibrage. Si la consommation d’energy de base d’un contrat dépasse un seuil pendant une période de maintenance, les appels qui le visent coûtent plus cher à la période suivante. La période de maintenance actuelle est de 6 heures.

Chaque contrat a un energy_factor, qui démarre à 0. L’energy d’un appel est l’energy de base multipliée par 1 + energy_factor. Sur le mainnet, le document indique un increase_factor de 0,2 et un max_factor de 3,4. Un contrat au maximum coûte donc 4,4 fois son energy de base. Le facteur redescend quand l’usage du contrat retombe au seuil ou en dessous. Vous pouvez lire le facteur actuel d’un contrat avec l’appel de nœud getcontractinfo.

Pour les paiements, cela signifie qu’une estimation d’energy de la semaine dernière peut être trop basse aujourd’hui. Estimez avant chaque envoi, ou ajoutez une marge au fee_limit. Pour un exemple avec USDT et la différence d’energy selon le destinataire, consultez le guide des frais TRON.

Comment nous rédigeons ces articles

Prêt à le construire vous-même ? Obtenir votre clé API — essai de 7 jours, sans carte bancaire — ou consultez API Tron pour la référence complète des endpoints.

C
Chaingateway Team
Experts blockchain

L'équipe Chaingateway s'attache à simplifier l'intégration blockchain pour les développeurs du monde entier.