Формат CSV для массовых переводов токенов: шаблон и типичные ошибки

CSV для массового перевода токенов должен содержать ровно два столбца — адрес получателя, затем сумму, — по одному получателю на строку, через запятую, с точкой в качестве десятичного разделителя и без строки заголовков. Это весь формат. Скачайте готовый шаблон ниже, замените строки-заглушки своими реальными адресами — и готово; остальная часть статьи существует потому, что таблицы сопротивляются этой простоте семью предсказуемыми способами, а десять минут гигиены файла обходятся дешевле одного необратимого перевода не по адресу.

Скачайте шаблон

Скачать шаблон CSV — три примерные строки в правильном формате:

TYourRecipientAddressHere111111111,100
TYourRecipientAddressHere222222222,25.5
TYourRecipientAddressHere333333333,10

Одно намеренное свойство безопасности: адреса-заглушки похожи на настоящие по формату (34 символа, начинаются с T), но не являются реальными адресами TRON, поэтому валидатор dApp отклонит их при загрузке. Случайно отправить средства на шаблон невозможно — замените каждую строку реальными получателями, и файл пройдёт проверку.

Формат построчно

Каждая строка — это один получатель и одно правило:

<адрес TRON>,<сумма>

• Адрес: адрес TRON в формате base58 — начинается с T, ровно 34 символа. Без пробелов вокруг, без кавычек.
• Запятая: разделитель столбцов. Одна запятая на строку, больше ничего.
• Сумма: просто число. Точка для дробной части (25.5), без разделителей тысяч (10000, а не 10,000), без символов валют, без пробелов в конце.
• Без строки заголовков. Первая строка уже должна быть реальным получателем — текст address,amount будет помечен как недействительный адрес (так валидатор подсказывает, что его нужно удалить).
• Дубликаты допустимы, но имеют значение: один и тот же адрес дважды означает два перевода на этот кошелёк. Сначала уберите дубликаты, если только это не то, что вам действительно нужно.

Тот же список из двух столбцов можно вставить прямо в dApp как обычный текст, а файлы XLS/XLSX с теми же двумя столбцами работают как есть — CSV просто самый переносимый из трёх форматов.

Экспорт из привычных инструментов

Сам формат элементарен; ошибки возникают при экспорте. Три самых распространённых пути:

Google Таблицы. Держите адреса в столбце A, суммы в столбце B и больше ничего на листе — ни строки с заголовком, ни столбца с заметками. Задайте столбцу сумм формат обычного числа (Формат → Числа → Число, затем уберите отображение разделителя тысяч; ещё лучше — Формат → Числа → Обычный текст после ввода значений с точкой). Экспортируйте через Файл → Скачать → CSV. Таблицы экспортируют то, что вы видите, поэтому если в столбце отображается 10,000, эта запятая попадёт в файл.

Excel. Опасная переменная — региональные настройки системы: во многих европейских системах (и в русской локали) Excel записывает «CSV» с точкой с запятой в качестве разделителя и запятой в дробях — файл выглядит правильно, но разбирается неверно. Два решения: либо задайте в книге точку как десятичный разделитель (Параметры → Дополнительно → снимите флажок «Использовать системные разделители»), либо обойдите ловушку полностью и загрузите сам .xlsx — dApp принимает его с той же разметкой из двух столбцов.

Всё остальное (Notion, Airtable, выгрузка из базы данных): экспортируйте то, что выдаёт инструмент, а затем один раз пропустите два столбца через простой текстовый редактор. Так за одно действие удаляются «умные» кавычки, невидимые символы и остатки форматированного текста — десять секунд, которые регулярно экономят повторную загрузку.

Какой бы путь вы ни выбрали, откройте итоговый файл один раз в текстовом редакторе, а не в таблице. То, что вы там видите — запятые, точки, никаких кавычек, никаких заголовков, — ровно то, что увидит парсер.

Семь классических ошибок

Годы переписки с поддержкой сводятся к этому списку:

1. Запятая в дробях. Таблицы во многих локалях (большая часть Европы, Россия, Бразилия и не только) пишут 1,5 вместо полутора. В файле с разделителем-запятой это читается как два столбца — сумма 1 и мусор после неё. Перед экспортом настройте столбец сумм на точку в дробях.
2. Разделители тысяч. 10,000 точно так же фатально распадается на столбцы; 10 000 с пробелом не проходит разбор числа. Суммы должны быть «голыми»: 10000.
3. Забытая строка заголовков. address,amount в первой строке. Удалите её.
4. Пробелы и невидимые символы. Адреса, скопированные из чатов, Telegram или веб-страниц, приходят обёрнутыми в пробелы, табуляции или символы нулевой ширины. Валидатор их пометит, но если сначала обрезать столбец в таблице, повторная загрузка не понадобится.
5. Значения в кавычках. Некоторые экспортёры оборачивают каждую ячейку в кавычки ("TAbc...","100"). Большинство парсеров это терпят, но смешанные или случайные кавычки (кавычка внутри адреса) непредсказуемо ломают строки. Экспортируйте обычный CSV без кавычек.
6. Адреса из другой сети. Адрес Ethereum 0x… или мемо биржи, вставленные в столбец адресов. Адреса TRON начинаются с T и содержат 34 символа; всё остальное не может получать токены TRC-20 и будет помечено.
7. Опечатки в base58. Адрес, отредактированный вручную, с одним неверным символом обычно не проходит проверку контрольной суммы и помечается — так валидатор и задуман. Опасный случай — действительный адрес, принадлежащий не тому человеку, и его не поймает никакая программа: для этого и нужен экран проверки.

Проверьте файл перед отправкой

Девяностосекундная предполётная проверка, которая ловит почти всё:

1. Отсортируйте по столбцу адресов в таблице — дубликаты окажутся рядом и станут заметны, а неправильные записи уйдут в начало или конец.
2. Сверьте количество строк с ожидаемым числом получателей. Расхождение на одну строку обычно означает строку заголовков или пустую строку в конце.
3. Сложите столбец сумм и запишите итог. После загрузки dApp показывает на экране проверки итог по разобранным данным — два числа должны совпадать в точности. Если они различаются, проскочила проблема с дробной частью или разделителем.
4. Просмотрите разобранный список в dApp. К этому моменту валидация уже пометила неправильные адреса и дубликаты; ваша задача — проверка человеком: похожи ли имена, суммы и итог на ту выплату, которую вы задумали?
5. Работаете с этим списком впервые? Отправьте небольшой тестовый батч на несколько строк перед полной отправкой, как рекомендует пошаговый гайд. Ончейн-переводы необратимы; репетиция — единственная кнопка «отменить».

FAQ

Нужно ли файлу особое имя или кодировка? Особое имя не нужно. Используйте обычную UTF-8 (её по умолчанию экспортирует любая таблица). Избегайте редакторов, которые добавляют метку порядка байтов (BOM) или превращают файл в форматированный текст.

Можно ли использовать XLS/XLSX вместо CSV? Да — dApp принимает CSV, XLS и XLSX с той же разметкой из двух столбцов, а ещё список можно вставить как текст. CSV переживает перенос между инструментами с наименьшим числом сюрпризов, поэтому шаблоны и распространяются в этом формате.

Как указать разные токены в одном файле? Никак — один файл означает одну рассылку одного токена. Токен выбирается в dApp до загрузки; для разных токенов запускайте отдельные батчи.

Есть ли ограничение на размер файла? Практически нет: списки больше примерно 150 получателей просто обрабатываются как несколько последовательных пакетных транзакций в одном процессе. Калькулятор комиссий показывает стоимость для списка любого размера, а полное руководство описывает весь процесс отправки вокруг этого файла.