Format CSV pour les transferts de tokens en masse : modèle + erreurs fréquentes

Le CSV d'un transfert de tokens en masse a besoin d'exactement deux colonnes — l'adresse du destinataire, puis le montant —, un destinataire par ligne, séparés par une virgule, avec un point comme séparateur décimal et sans ligne d'en-tête. C'est tout le format. Téléchargez le modèle prêt à l'emploi ci-dessous, remplacez les lignes d'exemple par vos vraies adresses, et c'est terminé ; le reste de cet article existe parce que les tableurs combattent cette simplicité de sept façons prévisibles, et parce que dix minutes d'hygiène de fichier coûtent moins cher qu'un seul transfert irréversible envoyé au mauvais endroit.

Téléchargez le modèle

Télécharger le modèle CSV — trois lignes d'exemple au bon format :

TYourRecipientAddressHere111111111,100
TYourRecipientAddressHere222222222,25.5
TYourRecipientAddressHere333333333,10

Une propriété de sécurité voulue : les adresses d'exemple ont la bonne forme (34 caractères, commençant par T) mais ne sont pas de vraies adresses TRON, donc le validateur de la dApp les rejettera au chargement. Impossible d'envoyer des fonds au modèle par accident — remplacez chaque ligne par de vrais destinataires et le fichier passera.

Le format, ligne par ligne

Chaque ligne est un destinataire et suit une règle :

<adresse TRON>,<montant>

• Adresse : une adresse TRON en base58 — commence par T, exactement 34 caractères. Pas d'espaces autour, pas de guillemets.
• Virgule : le séparateur de colonnes. Une virgule par ligne, rien d'autre.
• Montant : un nombre simple. Point pour les décimales (25.5), pas de séparateur de milliers (10000, pas 10,000), pas de symbole monétaire, pas d'espace final.
• Pas de ligne d'en-tête. La première ligne doit déjà être un vrai destinataire — address,amount en texte sera signalé comme adresse invalide (c'est le validateur qui vous dit de la supprimer).
• Les doublons sont autorisés mais lourds de sens : la même adresse deux fois signifie deux transferts vers ce portefeuille. Dédoublonnez d'abord, sauf si c'est vraiment ce que vous voulez.

La même liste à deux colonnes peut aussi être collée directement dans la dApp en texte brut, et les fichiers XLS/XLSX avec les mêmes deux colonnes fonctionnent tels quels — le CSV est simplement le plus portable des trois.

Exporter depuis les outils que vous utilisez déjà

Le format est trivial ; c'est à l'export que tout se gâte. Les trois chemins les plus courants :

Google Sheets. Les adresses en colonne A, les montants en colonne B, rien d'autre sur la feuille — ni ligne de titre, ni colonne de notes. Formatez la colonne des montants en nombre simple (Format → Nombre → Nombre, puis retirez l'affichage du séparateur de milliers ; mieux encore, Format → Nombre → Texte brut après avoir saisi les valeurs avec un point décimal). Exportez via Fichier → Télécharger → Valeurs séparées par des virgules (.csv). Sheets exporte ce que vous voyez : si la colonne affiche 10,000, cette virgule atterrit dans votre fichier.

Excel. La variable dangereuse, ce sont les paramètres régionaux du système : sur de nombreux systèmes européens — dont les systèmes en français — Excel écrit un « CSV » séparé par des points-virgules avec une virgule décimale, un fichier qui a l'air juste et s'analyse de travers. Deux solutions : réglez le point comme séparateur décimal du classeur (Options → Options avancées → décochez « Utiliser les séparateurs système »), ou évitez le piège entièrement en chargeant le .xlsx lui-même, que la dApp accepte avec la même disposition à deux colonnes.

Tout le reste (Notion, Airtable, un export de base de données) : exportez ce que l'outil produit, puis faites passer les deux colonnes une fois par un éditeur de texte brut. Cela retire d'un coup les guillemets typographiques, les caractères invisibles et les restes de texte enrichi — dix secondes qui évitent régulièrement un nouveau chargement.

Quel que soit le chemin, ouvrez le fichier final une fois dans un éditeur de texte, pas dans un tableur. Ce que vous y voyez — virgules, points, pas de guillemets, pas d'en-tête — est exactement ce que verra l'analyseur.

Les sept erreurs classiques

Des années d'échanges avec le support se résument à cette liste :

1. Virgule décimale. Les tableurs de nombreuses régions (la plupart de l'Europe, dont la France, le Brésil et d'autres) écrivent 1,5 pour un et demi. Dans un fichier séparé par des virgules, cela se lit comme deux colonnes — un montant de 1 et des données parasites derrière. Réglez la colonne des montants sur le point décimal avant d'exporter.
2. Séparateurs de milliers. 10,000 se coupe en colonnes de la même façon fatale ; 10 000 avec une espace fait échouer l'analyse du nombre. Les montants doivent être nus : 10000.
3. Une ligne d'en-tête oubliée. address,amount en première ligne. Supprimez-la.
4. Espaces et caractères invisibles. Les adresses copiées depuis des messageries, Telegram ou des pages web arrivent entourées d'espaces, de tabulations ou de caractères de largeur nulle. Le validateur les signale, mais nettoyer la colonne dans votre tableur au préalable évite un nouveau chargement.
5. Valeurs entre guillemets. Certains exportateurs entourent chaque cellule de guillemets ("TAbc...","100"). La plupart des analyseurs le tolèrent, mais des guillemets mélangés ou égarés (un guillemet au milieu d'une adresse) cassent les lignes de façon imprévisible. Exportez un CSV simple, sans guillemets.
6. Adresses d'un autre réseau. Une adresse Ethereum 0x… ou un mémo d'exchange collé dans la colonne des adresses. Les adresses TRON commencent par T et font 34 caractères ; tout le reste ne peut pas recevoir de tokens TRC-20 et sera signalé.
7. Fautes de frappe en base58. Une adresse modifiée à la main avec un caractère erroné échoue généralement au contrôle de la somme de vérification et est signalée — le validateur fait son travail. Le cas dangereux est une adresse valide qui appartient à la mauvaise personne, et aucun logiciel ne peut la détecter : c'est le rôle de l'écran de vérification.

Vérifiez le fichier avant d'envoyer

Une vérification de quatre-vingt-dix secondes qui attrape presque tout :

1. Triez par la colonne des adresses dans votre tableur — les doublons deviennent voisins et visibles, et les entrées mal formées se rangent en haut ou en bas.
2. Vérifiez le nombre de lignes par rapport au nombre de destinataires attendu. Un écart d'une ligne signifie généralement une ligne d'en-tête ou une ligne vide à la fin.
3. Additionnez la colonne des montants et notez le total. Après le chargement, la dApp affiche le total analysé sur l'écran de vérification — les deux nombres doivent correspondre exactement. S'ils diffèrent, un problème de décimale ou de séparateur s'est glissé.
4. Parcourez la liste analysée dans la dApp. La validation a déjà signalé les adresses mal formées et les doublons ; votre rôle est le contrôle humain — les noms, montants et le total ressemblent-ils au paiement prévu ?
5. Première fois avec cette liste ? Envoyez un petit lot de test à quelques lignes avant l'envoi complet, comme le recommande le guide pas à pas. Les transferts on-chain sont irréversibles ; la répétition est le seul bouton « annuler ».

FAQ

Le fichier doit-il avoir un nom ou un encodage particulier ? Aucun nom particulier. Utilisez de l'UTF-8 simple (ce que tout tableur exporte par défaut). Évitez les éditeurs qui ajoutent une marque d'ordre des octets (BOM) ou convertissent le fichier en texte enrichi.

Puis-je utiliser XLS/XLSX au lieu de CSV ? Oui — la dApp accepte CSV, XLS et XLSX avec la même disposition à deux colonnes, et vous pouvez aussi coller la liste en texte. Le CSV survit aux passages d'un outil à l'autre avec le moins de surprises, c'est pourquoi les modèles sont fournis dans ce format.

Comment mettre plusieurs tokens dans un même fichier ? Ce n'est pas possible — un fichier correspond à une distribution d'un seul token. Le token se choisit dans la dApp avant le chargement ; pour des tokens différents, lancez des lots séparés.

Y a-t-il une limite de taille de fichier ? En pratique, non : les listes de plus de 150 destinataires environ sont simplement traitées en plusieurs transactions groupées consécutives dans un même flux. Le calculateur de frais montre les coûts pour toute taille de liste, et le guide complet couvre tout le processus d'envoi autour de ce fichier.