Comment fonctionne la délégation de ressources sur TRON
TRON ne facture pas de frais de gaz à la manière d’Ethereum. Chaque compte dispose à la place de deux réservoirs de ressources, l’énergie et le bandwidth. L’énergie est consommée par l’exécution des contrats intelligents, le bandwidth par toutes les transactions, avec ou sans contrat. Quand l’un des deux est vide, le réseau brûle des TRX de votre solde pour combler le manque, et c’est ce brûlage qui rend les opérations coûteuses.
Les ressources viennent de deux endroits. Soit vous stakez des TRX : en les immobilisant, vous recevez une part proportionnelle de la réserve mondiale d’énergie ou de bandwidth, qui se reconstitue sur 24 heures. Soit vous recevez une délégation : un autre compte stake des TRX et affecte les ressources produites à votre adresse. Votre compte les utilise exactement comme si vous les aviez stakées vous-même ; pour la machine virtuelle, il n’y a aucune différence. La délégation n’est ni un canal de paiement ni une couche intermédiaire, c’est l’affectation directe, on-chain, de droits sur des ressources d’un compte à un autre.
Ce que Stake 2.0 a changé
Avec l’ancien modèle (Stake 1.0), vous choisissiez au moment du staking si vos TRX produiraient de l’énergie ou du bandwidth, et vous ne pouviez dégeler que la totalité du montant, après un blocage de 3 jours. La délégation existait, mais restait rudimentaire : des TRX stakés produisaient un type de ressource, que vous pouviez éventuellement orienter vers une autre adresse.
Stake 2.0, activé sur le réseau principal en avril 2023, a restructuré tout cela :
- Les ressources d’une seule position stakée peuvent être réparties et déléguées à plusieurs adresses en même temps. Vous ne transférez pas de TRX, vous redistribuez la production de ressources.
- Le dégel se fait par tranches : vous pouvez dégeler une partie sans toucher au reste de la position, ce qui permet de gérer sa liquidité sans perturber les délégations en cours.
- Le dégel prend environ 14 jours : après l’appel à
unfreezeBalanceV2, les TRX entrent dans une file d’attente et restent bloqués jusqu’à ce que vous puissiez appelerwithdrawExpireUnfreezepour les récupérer. Des TRX actuellement délégués ne peuvent pas être dégelés : le délégateur doit d’abord reprendre la délégation avecunDelegateResource.
Pour qui reçoit de l’énergie déléguée, la conséquence est concrète : si la délégation n’est pas verrouillée, le délégateur peut la reprendre à tout moment avec unDelegateResource, et votre solde de ressources baisse immédiatement. Aucun délai de grâce n’existe côté récepteur.
Ce qu’une délégation enregistre
Quand un délégateur appelle delegateResource, la transaction enregistre trois choses : l’adresse du délégateur, l’adresse du destinataire et la quantité d’énergie (ou de bandwidth) déléguée. Le réseau ajuste ensuite les limites de ressources dans l’état du compte destinataire.
En interne, les nœuds TRON suivent séparément les ressources déléguées et les ressources détenues en propre. Si vous interrogez un compte avec wallet/getaccount sur l’API HTTP, vous verrez des champs comme delegated_frozenV2_balance_for_energy et acquired_delegated_frozenV2_balance_for_energy : le premier est ce que vous avez envoyé, le second ce que vous avez reçu. Aucun TRX ne bouge dans l’opération, ils restent dans le solde staké du délégateur.
À l’exécution d’une transaction, la machine virtuelle regarde l’énergie disponible du compte qui l’exécute, stakée en propre et reçue par délégation. Si elle suffit, elle la déduit de cette réserve unique : l’énergie stakée en propre et l’énergie déléguée partagent une seule limite et un seul compteur d’utilisation, sans ordre entre elles. Si la réserve est épuisée, des TRX sont brûlés depuis le solde libre du compte au taux réseau en vigueur. Ce taux n’est pas fixe ; il est calculé en fonction de l’énergie totale du réseau et du prix de brûlage défini par les paramètres on-chain.
Comment l’énergie se reconstitue
L’énergie n’est pas un crédit à usage unique. L’énergie utilisée se reconstitue linéairement sur une fenêtre de 24 heures. Si votre compte a une limite de 100,000 unités d’énergie et que vous en consommez 65,000 dans un appel de contrat, vous serez de nouveau au maximum au bout de 24 heures. À mi-chemin, après 12 heures, la moitié de l’énergie utilisée (environ 32,500) sera revenue et vous disposerez d’environ 67,500 unités.
Cette reconstitution vaut aussi bien pour l’énergie stakée en propre que pour l’énergie déléguée. Son rythme est lié au maximum du compte, pas à une horloge mondiale : deux comptes avec des limites différentes se reconstituent à des vitesses absolues différentes, même si les deux reviennent au plein en 24 heures.
Pour des opérations à haute fréquence, ce cycle de 24 heures est la contrainte principale. Une délégation dimensionnée pour un transfert par jour ne couvrira pas dix transferts par jour, même si la quantité totale d’énergie paraît suffisante sur le papier. Il faut compter avec le rythme de reconstitution, pas seulement avec la capacité totale.
Reprendre et répartir des délégations
Une délégation n’est pas permanente. Le délégateur peut appeler unDelegateResource à tout moment pour reprendre ses ressources, avec effet immédiat : l’énergie disponible du destinataire baisse du montant repris dès le bloc suivant, sans délai de carence ni compensation au niveau du protocole.
Réaffecter une délégation, c’est-à-dire diriger la même production de ressources vers un autre destinataire, demande deux transactions : reprendre la délégation au destinataire actuel, puis déléguer au nouveau. Ce sont des opérations on-chain distinctes, qui consomment elles-mêmes du bandwidth. Stake 2.0 permet de les regrouper plus efficacement qu’avant, mais elles ne sont toujours pas atomiques dans une seule transaction.
Un cas à connaître : si la position stakée d’un délégateur produit, disons, 200,000 unités d’énergie et qu’il en a délégué 150,000 à l’adresse A, il peut déléguer les 50,000 restantes à l’adresse B sans toucher à la délégation de A. La seule contrainte est que le total délégué ne peut pas dépasser le total produit ; une tentative au-delà échoue au niveau de la transaction.
Ce que cela signifie pour l’énergie louée
Un service de location comme tronenergyrent.com fonctionne entièrement dans ce modèle. Quand vous louez de l’énergie, le service stake des TRX, produit de l’énergie, puis appelle delegateResource vers votre adresse. Du point de vue de votre compte, vous recevez acquired_delegated_frozenV2_balance_for_energy exactement comme décrit plus haut. Vous ne détenez pas de TRX, vous disposez d’une allocation temporaire de ressources.
La durée de location est la période pendant laquelle le service maintient cette délégation active. Un bloc de 65,000 unités d’énergie couvre un transfert USDT standard ; le calculateur donne le prix de chaque durée et le coût exact pour votre volume de transferts. Rapportée à la journée, une location courte coûte plus cher qu’une longue : les locations longues offrent un prix journalier plus bas en échange d’un engagement plus long.
Le bandwidth suit le même modèle
Tout ce qui précède s’applique au bandwidth, à une différence près. Chaque compte reçoit 600 unités de bandwidth gratuites par jour, quel que soit son staking. Cette allocation couvre les simples transferts de TRX, mais pas la part de bandwidth de transferts TRC-20 à haute fréquence. Staker ou recevoir du bandwidth délégué relève votre limite au-dessus de ce seuil de 600.
Déléguer du bandwidth à un compte ajoute à sa capacité, en plus de l’allocation gratuite qu’il a déjà. L’ordre de consommation est le suivant : d’abord le bandwidth staké (le vôtre et celui qui vous est délégué, comptés comme une seule limite), puis le bandwidth gratuit quotidien, puis le brûlage de TRX. Cet ordre compte si vous voulez calculer précisément à quel moment le brûlage commence pour un compte donné.
Lire l’état des délégations via l’API
Si vous développez des outils ou voulez surveiller une délégation, voici les appels utiles :
wallet/getaccount: l’état complet du compte, y compris les champs de ressources déléguées et reçueswallet/getdelegatedresourcev2: l’enregistrement de délégation entre deux adresses, avec la quantité exacte d’énergie et, le cas échéant, la date d’expiration du verrouillagewallet/getcanwithdrawunfreezeamount: pour un délégateur, la part de son dégel en attente déjà disponible au retrait
getdelegatedresourcev2 est particulièrement utile pour vérifier qu’une délégation est bien active et correctement dimensionnée avant d’exécuter des transactions qui en dépendent. Ne partez jamais du principe qu’une délégation est en place parce qu’elle a été configurée la veille : vérifiez l’état on-chain avant de vous y fier.