TRC10 vs TRC20 : différences et coûts
TRC10 est un jeton Tron natif sans contrat intelligent, TRC20 un jeton à contrat. Comparez émission, frais, décimales, consultation du solde et appels API.
Relu par Maurice Sobiera
TRC10 et TRC20 sont les deux standards de jetons sur Tron. Un jeton TRC10 est un actif natif enregistré par le protocole, sans contrat intelligent. Un jeton TRC20 est un contrat intelligent sur la Tron Virtual Machine (TVM) qui suit l’interface ERC-20 d’Ethereum. Ils diffèrent par l’émission, le coût d’un transfert et la consultation du solde.
Qu’est-ce qu’un jeton TRC10 ?
Un jeton TRC10 est un actif au niveau du protocole. Vous l’émettez avec le contrat système AssetIssueContract, sans déployer de code de contrat. Les soldes des détenteurs sont stockés dans le compte lui-même. L’appel de nœud getaccount les renvoie dans le champ assetV2, comme le décrit la documentation TRON de getaccount.
Émettre un jeton TRC10 n’est pas gratuit. La valeur par défaut des frais d’émission d’actif dans le client de référence java-tron est de 1 024 TRX (1024000000 sun), définie dans son DynamicPropertiesStore. C’est un paramètre de la chaîne : vérifiez la valeur actuelle avant d’émettre un jeton. Le point d’accès Chaingateway GET /api/v2/tron/chainparameters la renvoie sous getAssetIssueFee, et l’exemple de la spécification de l’API affiche 1024000000.
L’offre est fixée à l’émission. La liste des contrats système comprend des opérations pour émettre, transférer et mettre à jour un jeton TRC10, et pour débloquer son offre initiale. UpdateAssetContract ne modifie que la description, l’URL et les quotas de bande passante gratuite. Aucune de ces opérations n’augmente l’offre totale.
Qu’est-ce qu’un jeton TRC20 ?
Un jeton TRC20 est un contrat intelligent qui met en œuvre l’interface de TIP-20. TIP-20 dérive d’ERC-20, et la TVM est compatible avec l’Ethereum Virtual Machine. Les fonctions obligatoires sont totalSupply, balanceOf, transfer, transferFrom, approve et allowance. Le contrat doit émettre les événements Transfer et Approval.
Les fonctions name, symbol et decimals sont facultatives dans le standard. Le code qui lit un jeton ne doit pas supposer qu’elles existent. Comme la logique réside dans le code du contrat, un jeton TRC20 peut ajouter des règles comme la création, la destruction ou des listes de blocage. Le standard lui-même ne les définit pas.
En quoi TRC10 et TRC20 diffèrent-ils ?
TRC10 est moins cher à transférer et plus simple à lire, tandis que TRC20 est plus flexible et passe par des appels de contrat. Le tableau compare les points qui comptent pour une intégration.
| Point | TRC10 | TRC20 |
|---|---|---|
| Mise en œuvre | Actif natif du protocole | Contrat intelligent sur la TVM |
| Identifié par | Identifiant numérique du jeton, comme 1004920 | Adresse du contrat |
| Ressource utilisée par un transfert | Bande passante | Bande passante et énergie |
| Décimales | precision de 0 à 6 | Fonction facultative decimals(), un uint8 |
| Consultation du solde | Champ assetV2 du compte | Appel balanceOf sur le contrat |
| Évolution de l’offre | Fixée à l’émission | Définie par le code du contrat |
| Logique personnalisée | Aucune | Tout ce que le contrat met en œuvre |
En quoi les frais de transfert diffèrent-ils ?
Les transferts TRC10 n’ont besoin que de bande passante, alors que les transferts TRC20 ont aussi besoin d’énergie. Le modèle de ressources de Tron définit la bande passante comme la taille en octets d’une transaction. L’énergie mesure le travail de la TVM et n’est consommée que lorsqu’un contrat intelligent est déployé ou déclenché.
Si un compte dispose de trop peu d’une ressource, le réseau brûle des TRX à la place. Selon le même document, les prix actuels sont de 1 000 sun par octet de bande passante et de 100 sun par unité d’énergie. Une transaction de 200 octets consomme donc 200 de bande passante, soit 0,2 TRX si elle doit être brûlée. L’énergie d’un appel de contrat varie selon le contrat : mesurez-la avec un transfert de test. Il n’existe pas de rapport fixe entre les deux frais.
En quoi les décimales diffèrent-elles ?
Un jeton TRC10 peut avoir une précision de 6 au maximum. La validation de java-tron rejette une valeur plus élevée avec l’erreur « precision cannot exceed 6 ». Un jeton TRC20 renvoie ses décimales par la fonction facultative decimals(), dont le type de retour autorise des valeurs jusqu’à 255. Lisez toujours les décimales au lieu de supposer une valeur, car le montant brut sur la chaîne est un entier exprimé dans la plus petite unité.
Comment envoyer l’un ou l’autre jeton avec l’API Chaingateway ?
Utilisez POST /api/v2/tron/transactions/trc10 pour TRC10 et POST /api/v2/tron/transactions/trc20 pour TRC20. Une requête TRC10 exige from, to, tokenId et amount. Une requête TRC20 exige from, to, contractaddress et amount. Dans les deux cas, vous transmettez soit le password du portefeuille, soit une privatekey.
curl -X POST https://app.chaingateway.io/api/v2/tron/transactions/trc10 \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "from": "TLkkCeNdJKPNUwucdro84WjswkzM62LCTH", "to": "TUwmZghA7u2GxGxKaxM1mkCmsTF4wHs4vp", "tokenId": "1004920", "amount": 1, "password": "your-wallet-password" }'L’appel TRC20 a la même forme. Remplacez tokenId par contractaddress. Les adresses et l’identifiant de jeton ci-dessus sont les valeurs d’exemple de la spécification OpenAPI. Pour la liste complète des points d’accès Tron, consultez la référence de l’API Tron. Pour recevoir des dépôts, lisez comment recevoir des paiements TRC20. La planification des frais est traitée dans le guide des frais Tron.
Quel standard dois-je utiliser ?
Utilisez TRC20 si vous avez besoin d’une logique de contrat ou si vous voulez que votre jeton se comporte comme les jetons ERC-20 d’autres chaînes. Utilisez TRC10 si vous avez besoin d’un actif simple à offre fixe, avec des transferts peu coûteux et sans contrat à maintenir. Si vous acceptez des paiements dans un jeton existant, le choix est fait pour vous par l’émetteur du jeton. Vérifiez quel standard le jeton utilise et configurez la gestion de vos portefeuilles et de vos webhooks pour ce standard.
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.