Frais de transaction TRC-20 sur TRON expliqués
Comment les transferts TRC-20 sont payés sur TRON, coût du brûlage de TRX, estimation et réduction des frais. Le Paymaster est déprécié.
Relu par Maurice Sobiera
Les frais d’une transaction TRC-20 correspondent au coût d’un appel à un contrat de token sur TRON, payé en Energy (exécution) et en Bandwidth (taille). Sans ressource stakée ou déléguée, le réseau brûle du TRX à la place : 0,0001 TRX par Energy et 0,001 TRX par Bandwidth sur le mainnet, selon la documentation TRON.
Pourquoi un transfert TRC-20 nécessite-t-il du TRX ?
Un transfert TRC-20 est un appel à un contrat intelligent, et TRON facture des ressources pour chaque appel de contrat. Le token lui-même ne paie jamais. Selon la documentation TRON sur les ressources, la Bandwidth couvre la taille en octets d’une transaction, et l’Energy couvre l’exécution du contrat intelligent.
Le standard des tokens fongibles sur TRON est le TIP-20, connu sous le nom de TRC-20. Un contrat qui le suit expose des fonctions comme transfer, approve et balanceOf, et chaque appel qui modifie l’état s’exécute sur la TRON Virtual Machine.
Les comptes obtiennent de la Bandwidth et de l’Energy de deux façons : en stakant du TRX, ou en recevant des ressources qu’un autre compte a déléguées. Chaque compte activé dispose aussi d’un quota gratuit de Bandwidth de 600, mais l’Energy n’a pas de quota gratuit. Si une adresse détient des tokens mais aucun TRX, aucun stake et aucune délégation, le transfert ne peut pas être payé. Dans notre API, un tel envoi échoue avec le statut 422 et le message balance is not sufficient.
Combien coûte un transfert TRC-20 ?
Le coût correspond à l’Energy utilisée multipliée par le prix de l’Energy, auquel s’ajoute le coût de la Bandwidth lorsque le repli par brûlage de TRX s’applique. La page sur le paiement des ressources indique les taux de brûlage actuels sur le mainnet :
| Ressource | Taux de brûlage | En TRX |
|---|---|---|
| Energy | 100 sun par Energy | 0,0001 TRX |
| Bandwidth | 1 000 sun par Bandwidth | 0,001 TRX |
Ces deux taux sont des paramètres de la chaîne, qui peuvent changer par proposition. Interrogez donc wallet/getchainparameters pour obtenir les valeurs actuelles. L’Energy utilisée dépend du contrat et de l’état du destinataire : il n’existe donc pas de prix fixe par transfert.
À titre d’illustration, un appel qui utilise 65 000 Energy et 345 Bandwidth, sans ressource stakée, brûlerait 65 000 × 0,0001 = 6,5 TRX pour l’Energy et 345 × 0,001 = 0,345 TRX pour la Bandwidth, soit 6,845 TRX au total. Ces deux nombres sont des valeurs d’exemple, et non des mesures d’un token précis. Mesurez votre propre transfert avant de planifier avec un chiffre.
Qu’est-ce que la limite de frais ?
La limite de frais est le montant maximal, en sun, qu’un appel de contrat peut dépenser en Energy. Chaque transaction de contrat intelligent qui modifie l’état sur TRON porte un champ fee_limit. Selon la page sur le paiement des ressources, une transaction qui utiliserait plus d’Energy que ne le permet la limite est annulée avec OUT_OF_ENERGY, et l’Energy déjà consommée reste facturée jusqu’à cette limite.
Le plafond de fee_limit sur le mainnet est de 15 000 TRX au moment de la rédaction, selon le paramètre de chaîne getMaxFeeLimit. Fixez la limite au-dessus de votre coût mesuré en Energy, avec une marge, afin qu’un transfert n’échoue pas en cours de route tout en coûtant de l’Energy. Une limite élevée affaiblit la protection qu’offre la limite contre les contrats qui s’emballent. Gardez donc la marge modeste.
Comment estimer l’Energy d’un transfert ?
Simulez l’appel avec la méthode TriggerConstantContract de l’API du nœud TRON. Selon la référence TriggerConstantContract, elle permet d’estimer la consommation d’Energy d’un appel de contrat sans le diffuser. Après un transfert réel, GetTransactionInfoById renvoie l’Energy effectivement utilisée. Notre calculateur d’énergie TRON et le guide des frais TRON aident à la conversion en TRX.
Comment réduire les frais TRC-20 ?
Vous pouvez arrêter de brûler du TRX en fournissant de l’Energy depuis une autre source. Les options habituelles sont :
| Option | Fonctionnement | Compromis |
|---|---|---|
| Brûler du TRX | Le repli par défaut | Coût le plus élevé par transfert aux taux ci-dessus |
| Staker du TRX | Le staking donne au compte de l’Energy et de la Bandwidth | Le TRX reste bloqué pendant toute la durée |
| Déléguer des ressources | Un autre compte délègue de l’Energy à l’expéditeur | Nécessite un fournisseur de ressources |
| Louer de l’Energy | Un tiers loue de l’Energy en gros auprès des stakers | Nécessite un service distinct |
L’option la moins chère dépend de votre volume de transferts et des prix du moment. Comparez-les donc à partir de l’Energy mesurée sur vos propres transferts.
Qu’est-il advenu du Paymaster de Chaingateway ?
Le Paymaster de Chaingateway est déprécié. Il prenait en charge la Bandwidth et l’Energy au sein de l’API, de sorte qu’un portefeuille n’avait pas besoin de TRX avant d’envoyer des tokens TRC-20. Les intégrations qui appellent déjà les points de terminaison du Paymaster continuent de fonctionner, mais vous ne devriez pas en construire de nouvelles.
Pour parrainer les frais aujourd’hui, nous recommandons TronFuel, un service distinct qui loue de l’Energy en gros auprès de stakers. Il n’a aucun point de terminaison dans l’API Chaingateway. Le guide Sponsor TRC20 Fees de notre documentation décrit la situation actuelle. Les versions précédentes de cet article citaient une économie en pourcentage fixe. Nous l’avons retirée, car nous ne pouvons pas l’étayer par une mesure : l’économie dépend du taux de brûlage, du prix de l’Energy et de votre volume.
Comment envoyer un token TRC-20 avec l’API ?
Appelez POST /api/v2/tron/transactions/trc20 avec l’expéditeur, le destinataire, le contrat du token et le montant, ainsi que le password ou la privatekey de l’expéditeur. L’expéditeur doit disposer de suffisamment d’Energy et de Bandwidth, soit grâce au staking et à la délégation, soit grâce à du TRX pouvant être brûlé. La référence de l’API liste les paramètres.
Avant d’envoyer un lot de transferts TRC-20, parcourez cette liste de contrôle :
- Mesurez l’Energy d’un transfert réel avec
GetTransactionInfoById. - Vérifiez que l’adresse expéditrice dispose d’Energy stakée ou déléguée, ou de suffisamment de TRX pour couvrir le brûlage.
- Gardez à l’esprit que les 600 Bandwidth gratuits ne couvrent une transaction que si la transaction entière y tient.
- Conservez une trace du prix de l’Energy au moment de l’envoi, car il peut changer par proposition.
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.