Qu'est-ce qu'une adresse TRC20 ?
Ce qu'est une adresse TRC20 : préfixe T, 34 caractères Base58Check, écriture hex 41, adresses de contrat et de portefeuille, TRC-20 face à ERC-20 et BEP-20.
Relu par Maurice Sobiera
Une adresse TRC20 est une adresse de compte TRON servant à envoyer et à recevoir des tokens TRC20 comme l’USDT. Elle compte 34 caractères, commence par T et utilise l’encodage Base58Check, par exemple TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t. Il n’existe pas de type d’adresse TRC20 distinct : la même adresse détient des TRX, des tokens TRC10 et des tokens TRC20.
Quand un exchange demande votre « adresse USDT TRC20 », il attend votre adresse TRON habituelle. Son format ne ressemble en rien aux adresses 0x d’Ethereum ou de BSC. TRON ajoute aussi un détail qui déroute les développeurs : la même adresse a une seconde écriture, hexadécimale, qui commence par 41.
Ce guide traite de l’encodage, de la différence entre hex et Base58, des adresses de portefeuille et de contrat, de la comparaison entre TRC-20, ERC-20 et BEP-20, et de la validation d’une adresse dans le code. Si vous cherchez plutôt les endpoints, la page API d’adresses TRC20 explique comment créer des adresses, s’abonner aux dépôts et envoyer de l’USDT depuis ces adresses.
À quoi ressemble une adresse TRC20 ?
Sous sa forme lisible, une adresse TRON est encodée en Base58Check, comme le décrit la documentation développeur de Tron. Base58 est l’alphabet que Bitcoin utilise aussi. Il contient tous les chiffres et toutes les lettres, sauf 0, O, I et l, faciles à confondre à l’impression. Une adresse TRON valide :
- commence par
T - compte exactement 34 caractères
- ne contient que des caractères de l’alphabet Base58
Le terme « Check » signifie que l’encodage porte une somme de contrôle intégrée. Sous la surface Base58, une adresse fait 25 octets : un octet de préfixe 0x41, un identifiant de compte de 20 octets et 4 octets de somme de contrôle. Un seul caractère mal saisi invalide cette somme. Un portefeuille peut donc rejeter la faute de frappe avant qu’une transaction soit signée. Contrairement à la casse optionnelle d’EIP-55 sur Ethereum, la somme de contrôle d’une adresse TRON n’est pas facultative. Toute adresse valide en possède une.
Quelle est la différence entre TRC-20, ERC-20 et BEP-20 ?
L’USDT seul existe sur ces trois réseaux, et leurs formats se croisent donc chaque jour dans les formulaires de retrait et les tickets de support. Voici ce qui les distingue, avec les sources et les dates dans les paragraphes sous le tableau :
| TRC-20 (TRON) | ERC-20 (Ethereum) | BEP-20 (BNB Smart Chain) | |
|---|---|---|---|
| Format d’adresse | T + 33 caractères Base58 | 0x + 40 caractères hex | 0x + 40 caractères hex |
| Somme de contrôle | Base58Check, toujours présente | casse EIP-55, optionnelle | casse EIP-55, optionnelle |
| Risque de collage croisé avec les autres | Aucun, le format échoue à la validation | Élevé : chaînes identiques à celles de BEP-20 | Élevé : chaînes identiques à celles d’ERC-20 |
| Temps de bloc | 3 s | 12 s | 0,45 s |
| Délai de finalité | environ 1 min | environ 13 min (deux epochs) | finalité rapide |
| Unité de frais | Energy et Bandwidth, TRX brûlés en solution de repli | gas, payé en ETH | gas, payé en BNB |
Les lignes du milieu expliquent pourquoi cet article met en garde contre les chaînes EVM plutôt que contre TRON. Une adresse ERC-20 et une adresse BEP-20 sont la même chaîne de caractères. Rien dans l’adresse n’indique donc à l’expéditeur ou au validateur de quelle chaîne il s’agit. Une adresse TRON ne peut jamais être prise pour l’une d’elles. L’erreur que commettent réellement les utilisateurs de TRON se situe dans la ligne du réseau : choisir le mauvais réseau dans la liste déroulante d’un exchange.
Les lignes de durée demandent des sources et des dates. La documentation Tron sur le consensus (mise à jour le 20 octobre 2026) indique un slot de 3 secondes. Un bloc devient irréversible quand au moins 19 Super Representatives distincts ont produit un bloc à cette hauteur ou au-delà. Cela prend en général environ une minute ; ethereum.org définit des slots de 12 secondes et des epochs de 32 slots, soit 768 secondes pour deux epochs, environ 13 minutes. BSC a atteint son temps de bloc de 0,45 seconde avec le hard fork Fermi du 14 janvier 2026, comme le décrit notre guide du nœud BSC. Beaucoup d’exchanges attendent la fenêtre de finalité de Tron avant de créditer un dépôt, ce qui explique pourquoi « envoyé » et « crédité » peuvent être séparés d’une minute.
Comment une adresse TRON est-elle dérivée ?
La dérivation ressemble plus à celle d’Ethereum que l’aspect du résultat ne le laisse penser. La documentation Tron précise que les 20 octets qui suivent le préfixe 41 sont identiques à l’adresse Ethereum dérivée de la même clé publique. Les étapes sont les suivantes :
- Générer une clé privée sur la courbe secp256k1, la même que celle de Bitcoin et d’Ethereum.
- Calculer la clé publique et la hacher avec Keccak-256.
- Conserver les 20 derniers octets du hash. Jusque-là, c’est exactement la procédure d’Ethereum.
- Ajouter devant l’octet
0x41(le préfixe du mainnet TRON), ce qui donne 21 octets. - Hacher ces 21 octets deux fois avec SHA-256 et prendre les 4 premiers octets comme somme de contrôle.
- Ajouter la somme de contrôle à la fin et encoder les 25 octets en Base58.
Le T initial n’est pas un choix de marque. Il découle de l’encodage : une chaîne de 25 octets qui commence par 0x41 produit un texte Base58 qui commence par T.
Base58Check avec de vrais chiffres
Un encodage se retient mieux quand on peut le refaire soi-même. Voici donc l’adresse du contrat USDT assemblée à partir de ses parties. La charge utile de 21 octets est le préfixe 41 suivi de l’identifiant de compte de 20 octets :
payload: 41a614f803b6fd780986a42c78ec9c7f77e6ded13csha256(payload): 3a42512dd4f64e4d9dad3d5e6aa0ecf55adbd8a85979135cf211ba347278d029sha256(again): 710277f5d80b170d90e2ec6c52caa368bc74b9226e3befe5c09825a0eedbfb68checksum: 710277f5La somme de contrôle correspond aux 4 premiers octets du second hash. Ajoutez-la à la charge utile et vous obtenez 25 octets : 41a614f803b6fd780986a42c78ec9c7f77e6ded13c710277f5. Traitez ces octets comme un grand nombre, divisez-le par 58 à répétition et associez chaque reste à l’alphabet Base58. Le résultat est TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t, l’adresse que tous les portefeuilles affichent.
Le décodage suit le même chemin à l’envers : de Base58 vers 25 octets, on détache les 4 derniers, on hache deux fois les 21 premiers avec SHA-256 et on compare. Si la comparaison échoue, un caractère a été altéré en route et l’adresse ne doit pas être utilisée. Ce contrôle explique pourquoi un bon portefeuille rejette une adresse TRON mal saisie. La probabilité qu’une faute de frappe aléatoire produise quand même une somme de contrôle de 4 octets valide est de 1 sur 2^32, soit environ une sur quatre milliards. EIP-55 indique qu’une adresse Ethereum a en moyenne 15 bits de contrôle et précise que son schéma n’est « pas aussi bon qu’un code de contrôle de 4 octets ». Le schéma de TRON est donc le plus strict des deux.
Quelle est la différence entre la forme hex 41 et la forme T ?
Ce sont deux écritures d’une même adresse. Avec l’API de nœud propre à TRON ou avec des bibliothèques de bas niveau, les adresses reviennent en hexadécimal, avec un 41 au début. Prenons le contrat du token USDT :
Base58: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6tHex: 41a614f803b6fd780986a42c78ec9c7f77e6ded13cLes deux écritures identifient le même compte. La forme hex correspond aux 21 octets bruts (préfixe plus identifiant) sans la somme de contrôle. La forme Base58 entoure ces octets de la somme de contrôle, à l’usage des humains. Les portefeuilles et les explorateurs affichent T.... Les réponses brutes des nœuds et les transactions signées utilisent 41....
Deux conséquences pratiques en découlent :
- Ne comparez jamais des adresses comme des chaînes sans normaliser l’encodage. Sinon,
TR7N...et41a6...ressemblent à deux comptes différents pour votre code. - Si vous retirez le préfixe
41de la forme hex, les 20 octets restants sont l’adresse Ethereum que produit la même clé publique. La même clé privée contrôle donc le compte correspondant sur les deux chaînes, même s’il s’agit de comptes distincts avec des soldes distincts. Ne réutilisez pas une même clé sur les deux réseaux sans raison.
Convertir d’une forme à l’autre
La conversion est assez courte pour être écrite soi-même, sans importer un SDK TRON. Pour passer de Base58 à l’hex, on décode et on retire la somme de contrôle. Dans l’autre sens, on la recalcule :
import bs58 from "bs58";import { createHash } from "node:crypto";
const sha256 = (b) => createHash("sha256").update(b).digest();
function base58ToHex(address) { const raw = Buffer.from(bs58.decode(address)); return raw.subarray(0, 21).toString("hex"); // drop 4 checksum bytes}
function hexToBase58(hex) { const payload = Buffer.from(hex, "hex"); // 21 bytes, starts with 41 const checksum = sha256(sha256(payload)).subarray(0, 4); return bs58.encode(Buffer.concat([payload, checksum]));}Choisissez une forme canonique pour le stockage et convertissez aux frontières. Stocker du Base58 garde votre base de données conforme à ce que voient les utilisateurs et les explorateurs. Stocker de l’hex correspond au contenu des données brutes des nœuds. Les deux fonctionnent, mais mélanger les deux dans la même table fait naître le bug « même adresse, aucune correspondance », que l’on découvre en général en rapprochant des dépôts à 2 h du matin.
Quelle est la différence entre une adresse de contrat et une adresse de portefeuille ?
Les portefeuilles comme les smart contracts se trouvent à des adresses T..., et rien dans la chaîne ne permet de les distinguer. La documentation Tron nomme les deux types : les comptes externes, contrôlés par une clé privée, et les comptes de contrat, contrôlés par du code déployé. La distinction compte surtout pour l’USDT :
- Votre adresse de portefeuille est celle où vous recevez l’USDT. Elle appartient à votre clé privée.
- L’adresse du contrat TRC20 est celle où se trouve le code du token. Pour l’USDT sur TRON, c’est
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t.
Vous rencontrerez l’adresse du contrat à trois endroits :
- Quand vous ajoutez un token personnalisé à un portefeuille.
- Quand vous vérifiez sur Tronscan qu’un token est le véritable USDT et non une imitation au même nom.
- Quand vous appelez le token depuis le code.
Ne faites jamais une chose : envoyer des tokens vers l’adresse du contrat. Personne ne détient de clé privée pour un compte de contrat, et les tokens envoyés là sont donc perdus en pratique. Les explorateurs marquent les comptes de contrat avec l’étiquette « Contract ». C’est le moyen le plus rapide de savoir à quel type d’adresse vous avez affaire.
Comment vérifier une adresse sur Tronscan ?
Tronscan est l’explorateur de blocs de TRON, et il lève la plupart des doutes en moins d’une minute.
Collez l’adresse dans la barre de recherche. La page du compte affiche le solde en TRX, les avoirs en TRC20 et chaque transfert entrant et sortant. Une adresse de dépôt toute neuve peut n’afficher aucune donnée. La documentation Tron en donne la raison : un compte existe localement dès que vous générez sa clé, mais le réseau ne le reconnaît qu’après son activation, et d’ici là il est introuvable par les requêtes d’explorateur ou d’API. Le premier transfert entrant de TRX ou de TRC-10 l’active, et l’expéditeur paie les frais de création du compte, aujourd’hui 1 TRX sur le mainnet. « Aucune donnée pour l’instant » signifie donc « jamais utilisée », pas « invalide ».
Vérifiez ensuite le type du compte. Les comptes de contrat portent une étiquette « Contract » visible en haut de la page. L’argent va vers des comptes ordinaires. Si la destination qu’on vous a donnée porte l’étiquette de contrat, n’envoyez rien.
Pour les tokens, cherchez par adresse de contrat plutôt que par nom. Saisir « USDT » dans Tronscan renvoie le vrai token entouré d’imitations qui utilisent le même ticker, et sur TRON n’importe qui peut déployer un token appelé USDT. Le vrai se trouve à TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t : comparez donc l’adresse du contrat caractère par caractère avec la documentation de l’émetteur. Une page de token qui n’affiche pas cette adresse n’est pas l’actif que vous croyez.
Dernière étape après tout transfert : cherchez l’identifiant de la transaction. La page de détail indique l’expéditeur, le destinataire, le contrat du token, le montant et l’état de confirmation. Une fois le bloc solidifié, ce qui prend environ une minute, la transaction est définitive.
Comment éviter d’envoyer de l’USDT sur le mauvais réseau ?
L’USDT existe sur plusieurs chaînes à la fois : token TRC20 sur TRON, token ERC-20 sur Ethereum, token BEP-20 sur BSC. Le ticker est le même, mais les contrats sont distincts et les réseaux incompatibles.
TRON est en fait le cas favorable ici, car les formats diffèrent visiblement : une adresse T... ne peut pas être collée dans un formulaire de retrait Ethereum sans échouer à la validation, et une adresse 0x... échoue sur TRON. Le risque se trouve dans les menus de retrait des exchanges, où vous choisissez le réseau dans une liste déroulante à côté du champ d’adresse. Si vous choisissez « ERC20 » et collez une adresse TRON, un bon exchange bloque l’opération. Mais si vous possédez des adresses sur plusieurs réseaux et que vous collez par erreur celle qui correspond au réseau sélectionné, aucun validateur ne peut vous sauver. Indiquez explicitement le réseau partout où vous affichez ou acceptez une adresse. Pour le côté EVM de ce problème, où une même adresse existe sur de nombreuses chaînes à la fois, voir Qu’est-ce qu’une adresse BEP20 ?.
Qu’est-ce que l’empoisonnement d’adresse ?
Toutes les vérifications décrites jusqu’ici interceptent des accidents. L’empoisonnement d’adresse est délibéré. Il fonctionne parce que l’adresse empoisonnée est parfaitement valide.
Voici le principe. Un attaquant observe votre activité on-chain, puis génère par force brute une adresse vanity dont les premiers et derniers caractères correspondent à une adresse avec laquelle vous transigez régulièrement. Générer une adresse TRON qui reprend, disons, quatre caractères au début et quatre à la fin d’une cible est une affaire de temps de calcul, pas de cryptographie à casser. L’attaquant place ensuite cette adresse jumelle dans votre historique de transactions. Une méthode consiste à vous envoyer une très petite quantité de TRX ou de tokens (dust). Une autre est un transfert de token de valeur nulle qui fait apparaître l’adresse jumelle dans votre historique.
Le profit arrive des semaines plus tard, quand vous copiez « l’adresse habituelle » depuis votre historique de transferts plutôt que depuis vos propres notes. Les portefeuilles et les explorateurs abrègent les adresses à leurs premiers et derniers caractères, justement ceux que l’attaquant a imités, et le faux paraît donc correct au premier regard. Les pertes sont réelles : considérez donc comme non fiable toute adresse copiée depuis une liste d’historique.
Les défenses sont peu glamour et efficaces. Ne copiez jamais d’adresses depuis votre historique de transactions ; copiez-les depuis votre propre carnet d’adresses, votre base de données ou l’écran de réception du destinataire. Pour vérifier, comparez plus de huit caractères, ou mieux, comparez la chaîne entière une fois, puis appuyez-vous sur une liste d’autorisation. Pour les plateformes, la règle est structurelle : les destinations de paiement viennent de votre base de données, saisies et vérifiées une seule fois, et ne sont jamais déduites de l’historique on-chain. L’habitude de la transaction de test s’applique aussi ici : un petit transfert, confirmé sur Tronscan comme reçu par la personne visée, coûte quelques TRX et vaut mieux que n’importe quel contrôle visuel.
Comment valider une adresse TRC20 dans le code ?
Un premier contrôle consiste en une expression régulière sur l’alphabet Base58 :
const TRON_FORMAT = /^T[1-9A-HJ-NP-Za-km-z]{33}$/;L’expression régulière détecte une mauvaise longueur et les caractères interdits, mais pas les fautes de frappe à l’intérieur de l’alphabet. Pour cela, il faut vérifier la somme de contrôle :
import bs58 from "bs58";import { createHash } from "node:crypto";
const sha256 = (buf) => createHash("sha256").update(buf).digest();
function isValidTronAddress(address) { if (!/^T[1-9A-HJ-NP-Za-km-z]{33}$/.test(address)) return false;
const decoded = Buffer.from(bs58.decode(address)); if (decoded.length !== 25 || decoded[0] !== 0x41) return false;
const payload = decoded.subarray(0, 21); const checksum = decoded.subarray(21); const expected = sha256(sha256(payload)).subarray(0, 4); return expected.equals(checksum);}Un contrôle réussi prouve que la chaîne est une adresse TRON bien formée. Il ne prouve pas que le compte existe on-chain ni que quelqu’un en détient la clé, et il ne distingue pas un portefeuille d’un contrat. Pour savoir s’il s’agit d’un contrat, interrogez la chaîne ou consultez l’explorateur.
Pour contrôler une seule adresse sans écrire de code, le validateur d’adresses exécute le même test dans le navigateur pour des chaînes TRC-20, ERC-20 et BEP-20.
Comment les portefeuilles génèrent-ils des adresses TRON à partir d’une phrase de récupération ?
Quand une application de portefeuille vous remet une adresse TRON quelques secondes après que vous avez noté douze mots, voici le mécanisme qui travaille derrière. Les mots forment une phrase mnémonique BIP-39 qui se développe en une graine. À partir de la graine, BIP-32 dérive un arbre de paires de clés, toujours le même pour les mêmes mots. BIP-44 attribue à chaque blockchain sa propre branche au moyen d’un type de monnaie. Le registre SLIP-44 indique 195 pour Tron et 60 pour Ether, si bien que le chemin standard de votre première adresse TRON s’écrit m/44'/195'/0'/0/0.
Le type de monnaie est le détail à retenir. Les deux nombres apparaissent à un niveau durci (hardened) du chemin, et les mêmes mots de graine donnent donc des arbres de clés entièrement différents. C’est pourquoi la même phrase de récupération donne une adresse 0x dans un portefeuille EVM et une adresse T sans rapport dans un portefeuille TRON, et pourquoi aucun des deux portefeuilles ne voit les fonds de l’autre. Si vous restaurez une phrase dans un portefeuille réservé à Ethereum et que votre solde TRON semble disparu, rien n’est perdu : le portefeuille n’a simplement jamais dérivé la branche 195. Restaurez les mêmes mots dans un portefeuille compatible TRON, et l’adresse comme le solde réapparaissent.
L’index en fin de chemin s’incrémente : .../0/1 est votre deuxième adresse TRON issue des mêmes mots, .../0/2 la troisième. Les portefeuilles personnels dépassent rarement une poignée d’adresses. Les plateformes sont le cas inverse. Pour elles, des clés propres à chaque client, générées indépendamment et enregistrées via une API, sont la construction la plus sûre, car aucune phrase unique ne contrôle alors toutes les adresses de dépôt du système.
Comment obtenir une adresse de portefeuille TRC20 ?
Il y a deux voies, et le choix dépend de ce que vous voulez : une adresse pour vous, ou de nombreuses adresses pour une application.
La voie du portefeuille (une adresse, usage personnel)
Installez un portefeuille compatible TRON : TronLink est le portefeuille de navigateur standard du réseau, Trust Wallet couvre le mobile, Ledger le matériel. Créez un compte, notez la phrase de récupération hors ligne et ouvrez l’écran de réception. L’adresse T... qui s’y affiche est votre adresse de portefeuille TRC20 pour l’USDT et tous les autres tokens TRON. Sa création est gratuite et sans inscription : l’adresse fonctionne dès que le portefeuille la génère.
La voie de l’API (de nombreuses adresses, pour des applications)
Une plateforme qui crédite des dépôts par client a besoin d’une adresse par client, et cliquer mille fois dans l’interface d’un portefeuille n’est pas envisageable. POST /api/v2/tron/addresses en crée une via REST. POST /api/v2/tron/addresses/import enregistre à la place une clé que vous avez générée dans votre propre environnement. Dans les deux cas, un webhook sur l’adresse prévient votre backend quand un dépôt arrive, sans rien interroger en boucle sur Tronscan. La page API d’adresses TRC20 détaille les endpoints et les corps de requête.
Les envois échoués ne sont renvoyés que si vous appelez l’endpoint de nouvel essai. L’essai de 7 jours ne demande pas de KYC et couvre la phase de test. Les offres figurent sur la page des tarifs.
Un point propre à TRON se rattache à la question de l’adresse : recevoir est gratuit, mais transférer ensuite les dépôts coûte de la Bandwidth et de l’Energy. Sans Energy stakée, des TRX sont brûlés à raison de 100 sun par Energy et de 1 000 sun par Bandwidth, d’après la documentation Tron du 22 octobre 2026. Planifiez les coûts de consolidation avec le calculateur de frais TRON. Les expéditeurs réguliers réduisent la combustion continue en stakant des TRX pour de l’Energy.
Questions fréquentes
Oui. Une adresse TRC20 est simplement une adresse de compte TRON utilisée avec des tokens TRC20. La même adresse T... détient des TRX, des tokens TRC10 et des tokens TRC20. La mention « TRC20 » sur les pages de retrait des exchanges désigne le standard de token et le réseau, pas un type d’adresse particulier.
34 caractères, en commençant par T. Sous l’encodage Base58Check se trouvent 25 octets : l’octet de préfixe 0x41, un identifiant de compte de 20 octets et une somme de contrôle de 4 octets.
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t. C’est là que se trouve le code du token, et non une adresse où envoyer des fonds. Utilisez-la pour vérifier des tokens sur Tronscan ou pour ajouter l’USDT à un portefeuille manuellement. Les transferts envoyés au contrat lui-même sont irrécupérables.
C’est l’écriture hexadécimale de la même adresse. Les réponses brutes des nœuds TRON et les données des transactions utilisent l’hexadécimal avec le préfixe 41. Les portefeuilles et les explorateurs utilisent la forme Base58 qui commence par T. Convertissez l’une en l’autre avant de comparer des adresses dans le code.
Non, et les formats vous protègent ici : une adresse 0x échoue à la validation de TRON, et une adresse T... échoue à celle d’Ethereum. Le vrai risque est de choisir le mauvais réseau dans le menu de retrait d’un exchange en collant une adresse que vous possédez sur une autre chaîne. Faites toujours correspondre le nom du réseau au format de l’adresse.
Non. Les testnets TRON (Shasta, Nile) utilisent le même préfixe 0x41. Leurs adresses commencent donc aussi par T et passent la même validation. Séparez strictement les clés de testnet et de mainnet dans votre configuration : le format de l’adresse ne vous avertira pas si vous les mélangez.
Recevoir est gratuit ; envoyer coûte de la Bandwidth et de l’Energy. Sans Energy stakée, des TRX sont brûlés à raison de 100 sun par Energy et de 1 000 sun par Bandwidth. L’Energy qu’un transfert consomme dépend du contrat du token et du destinataire. Le calculateur de frais TRON calcule donc les chiffres pour votre cas. Staker des TRX pour obtenir de l’Energy réduit ce que vous payez réellement.
La transaction arrive dans un bloc en 3 secondes environ. Le bloc devient irréversible lorsqu’au moins 19 des 27 Super Representatives ont produit un bloc à cette hauteur ou au-delà, en général en une minute environ. Beaucoup d’exchanges créditent les dépôts TRC20 après ce délai. Une minute environ entre l’envoi et le crédit est donc un comportement normal, pas une transaction bloquée.
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.