CSV-Format für Massenüberweisungen von Token: Vorlage + häufige Fehler

Die CSV für eine Massenüberweisung von Token braucht genau zwei Spalten — Empfängeradresse, dann Betrag —, einen Empfänger pro Zeile, durch ein Komma getrennt, mit einem Punkt als Dezimaltrennzeichen und ohne Kopfzeile. Das ist das gesamte Format. Laden Sie die fertige Vorlage unten herunter, ersetzen Sie die Platzhalterzeilen durch Ihre echten Adressen, und Sie sind fertig; der Rest dieses Artikels existiert, weil Tabellenkalkulationen sich auf sieben vorhersehbare Arten gegen diese Einfachheit wehren — und weil zehn Minuten Dateihygiene billiger sind als eine einzige unumkehrbare Fehlüberweisung.

Vorlage herunterladen

CSV-Vorlage herunterladen — drei Beispielzeilen im richtigen Format:

TYourRecipientAddressHere111111111,100
TYourRecipientAddressHere222222222,25.5
TYourRecipientAddressHere333333333,10

Eine bewusste Sicherheitseigenschaft: Die Platzhalteradressen haben das richtige Format (34 Zeichen, beginnend mit T), sind aber keine echten TRON-Adressen, daher lehnt der Validator der dApp sie beim Hochladen ab. Sie können also nicht versehentlich Geld an die Vorlage senden — ersetzen Sie jede Zeile durch echte Empfänger, und die Datei besteht die Prüfung.

Das Format, Zeile für Zeile

Jede Zeile ist ein Empfänger und folgt einer Regel:

<TRON-Adresse>,<Betrag>

• Adresse: eine TRON-Adresse in base58 — beginnt mit T, genau 34 Zeichen. Keine Leerzeichen drumherum, keine Anführungszeichen.
• Komma: das Spaltentrennzeichen. Ein Komma pro Zeile, sonst nichts.
• Betrag: eine einfache Zahl. Punkt für Dezimalstellen (25.5), keine Tausendertrennzeichen (10000, nicht 10,000), keine Währungssymbole, keine Leerzeichen am Ende.
• Keine Kopfzeile. Die erste Zeile muss bereits ein echter Empfänger sein — address,amount als Text wird als ungültige Adresse markiert (so sagt Ihnen der Validator, dass Sie sie löschen sollen).
• Duplikate sind erlaubt, aber nicht bedeutungslos: Dieselbe Adresse zweimal bedeutet zwei Überweisungen an diese Wallet. Entfernen Sie Duplikate zuerst, es sei denn, genau das ist gewollt.

Dieselbe zweispaltige Liste lässt sich auch direkt als einfacher Text in die dApp einfügen, und XLS/XLSX-Dateien mit denselben zwei Spalten funktionieren unverändert — CSV ist einfach das portabelste der drei Formate.

Export aus den Werkzeugen, die Sie schon nutzen

Das Format ist trivial; beim Export geht es schief. Die drei häufigsten Wege:

Google Tabellen. Adressen in Spalte A, Beträge in Spalte B, sonst nichts auf dem Blatt — keine Titelzeile, keine Notizspalte. Formatieren Sie die Betragsspalte als einfache Zahl (Format → Zahl → Zahl, dann die Anzeige der Tausendertrennzeichen entfernen; noch besser: Format → Zahl → Nur-Text, nachdem Sie die Werte mit Punkt eingegeben haben). Exportieren Sie über Datei → Herunterladen → Kommagetrennte Werte (.csv). Google Tabellen exportiert, was Sie sehen — zeigt die Spalte 10,000, landet genau dieses Komma in Ihrer Datei.

Excel. Die gefährliche Variable ist das Systemgebietsschema: Auf vielen europäischen Systemen — auch auf deutschen — schreibt Excel eine semikolongetrennte „CSV“ mit Komma als Dezimalzeichen — eine Datei, die richtig aussieht und falsch eingelesen wird. Zwei Lösungen: Entweder stellen Sie in der Arbeitsmappe den Punkt als Dezimaltrennzeichen ein (Optionen → Erweitert → „Trennzeichen vom Betriebssystem übernehmen“ deaktivieren), oder Sie umgehen die Falle ganz und laden die .xlsx selbst hoch, die die dApp mit demselben zweispaltigen Layout akzeptiert.

Alles andere (Notion, Airtable, ein Datenbank-Dump): Exportieren Sie, was das Werkzeug liefert, und kopieren Sie die zwei Spalten dann einmal durch einen reinen Texteditor. Das entfernt typografische Anführungszeichen, unsichtbare Zeichen und Rich-Text-Reste in einem Schritt — zehn Sekunden, die regelmäßig einen erneuten Upload ersparen.

Egal welcher Weg: Öffnen Sie die fertige Datei einmal in einem Texteditor, nicht in einer Tabellenkalkulation. Was Sie dort sehen — Kommas, Punkte, keine Anführungszeichen, keine Kopfzeile —, ist genau das, was der Parser sieht.

Die sieben klassischen Fehler

Jahre an Support-Gesprächen lassen sich auf diese Liste reduzieren:

1. Komma als Dezimalzeichen. Tabellenkalkulationen in vielen Gebietsschemata (der Großteil Europas, Brasilien und mehr) schreiben 1,5 für anderthalb. In einer kommagetrennten Datei liest sich das als zwei Spalten — ein Betrag von 1 und Datenmüll dahinter. Stellen Sie das Format der Betragsspalte vor dem Export auf Punkt als Dezimalzeichen um.
2. Tausendertrennzeichen. 10,000 zerfällt auf dieselbe fatale Weise in Spalten; 10 000 mit Leerzeichen scheitert an der Zahlenerkennung. Beträge müssen nackt sein: 10000.
3. Eine übrig gebliebene Kopfzeile. address,amount in Zeile eins. Löschen Sie sie.
4. Leerzeichen und unsichtbare Zeichen. Adressen aus Chats, Telegram oder Webseiten kommen mit Leerzeichen, Tabs oder Zeichen der Breite null. Der Validator markiert sie, aber wenn Sie die Spalte vorher in der Tabelle bereinigen, sparen Sie einen erneuten Upload.
5. Werte in Anführungszeichen. Manche Exporter setzen jede Zelle in Anführungszeichen ("TAbc...","100"). Die meisten Parser tolerieren das, doch gemischte oder verirrte Anführungszeichen (ein Anführungszeichen mitten in einer Adresse) zerlegen Zeilen unvorhersehbar. Exportieren Sie schlichte CSV ohne Anführungszeichen.
6. Adressen aus dem falschen Netzwerk. Eine Ethereum-Adresse 0x… oder ein Börsen-Memo in der Adressspalte. TRON-Adressen beginnen mit T und haben 34 Zeichen; alles andere kann keine TRC-20-Token empfangen und wird markiert.
7. Tippfehler in base58. Eine von Hand bearbeitete Adresse mit einem falschen Zeichen scheitert meist an der Prüfsumme und wird markiert — so ist der Validator gedacht. Der gefährliche Fall ist eine gültige Adresse, die der falschen Person gehört; das kann keine Software erkennen — dafür gibt es den Prüfbildschirm.

Datei vor dem Versand prüfen

Ein neunzigsekündiger Pre-Flight-Check, der fast alles findet:

1. Nach der Adressspalte sortieren — Duplikate liegen dann nebeneinander und fallen auf, fehlerhafte Einträge wandern nach oben oder unten.
2. Zeilenzahl prüfen — mit der erwarteten Empfängerzahl abgleichen. Eine Abweichung um eins bedeutet meist eine Kopfzeile oder eine leere letzte Zeile.
3. Betragsspalte summieren und die Summe notieren. Nach dem Hochladen zeigt die dApp die eingelesene Summe auf dem Prüfbildschirm — beide Zahlen müssen exakt übereinstimmen. Weichen sie ab, ist ein Dezimal- oder Trennzeichenproblem durchgerutscht.
4. Eingelesene Liste in der dApp überfliegen. Die Validierung hat fehlerhafte Adressen und Duplikate bereits markiert; Ihre Aufgabe ist die menschliche Prüfung — sehen Namen, Beträge und Summe wie die beabsichtigte Auszahlung aus?
5. Zum ersten Mal mit dieser Liste? Senden Sie vor dem vollen Durchlauf einen kleinen Test-Batch an einige Zeilen, wie es die Schritt-für-Schritt-Anleitung empfiehlt. On-Chain-Überweisungen sind unumkehrbar; die Probe ist der einzige Rückgängig-Knopf.

FAQ

Braucht die Datei einen bestimmten Namen oder eine bestimmte Kodierung? Keinen bestimmten Namen. Verwenden Sie einfaches UTF-8 (das, was jede Tabellenkalkulation standardmäßig exportiert). Vermeiden Sie Editoren, die eine Byte-Order-Mark hinzufügen oder die Datei in Rich Text umwandeln.

Kann ich XLS/XLSX statt CSV verwenden? Ja — die dApp akzeptiert CSV, XLS und XLSX mit demselben zweispaltigen Layout, und Sie können die Liste auch als Text einfügen. CSV übersteht den Weg zwischen Werkzeugen mit den wenigsten Überraschungen, deshalb werden Vorlagen in diesem Format geliefert.

Wie bringe ich verschiedene Token in eine Datei? Gar nicht — eine Datei ist eine Verteilung eines Tokens. Der Token wird vor dem Hochladen in der dApp gewählt; für verschiedene Token führen Sie getrennte Batches aus.

Gibt es eine Begrenzung der Dateigröße? Praktisch nein: Listen mit mehr als etwa 150 Empfängern werden einfach als mehrere aufeinanderfolgende Batch-Transaktionen in einem Ablauf verarbeitet. Der Gebührenrechner zeigt die Kosten für jede Listengröße, und die vollständige Anleitung beschreibt den gesamten Versandprozess rund um diese Datei.