토큰 대량 전송을 위한 CSV 형식: 템플릿 + 흔한 오류

토큰 대량 전송용 CSV에는 정확히 두 개의 열 — 수신자 주소, 그다음 금액 — 이 필요하며, 한 줄에 수신자 한 명, 쉼표로 구분, 소수점은 마침표, 헤더 행은 없습니다. 이것이 형식의 전부입니다. 아래의 준비된 템플릿을 내려받아 예시 행을 실제 주소로 바꾸면 끝입니다. 이 글의 나머지 내용은 스프레드시트가 예측 가능한 일곱 가지 방식으로 이 단순함을 방해하기 때문에, 그리고 10분의 파일 정리가 되돌릴 수 없는 오송금 한 건보다 훨씬 싸기 때문에 존재합니다.

템플릿 다운로드

CSV 템플릿 다운로드 — 올바른 형식의 예시 세 줄:

TYourRecipientAddressHere111111111,100
TYourRecipientAddressHere222222222,25.5
TYourRecipientAddressHere333333333,10

의도적인 안전장치가 하나 있습니다. 예시 주소는 형식상 그럴듯하지만(34자, T로 시작) 실제 TRON 주소가 아니므로, dApp의 검증기가 업로드 시 거부합니다. 템플릿으로 실수로 자금을 보낼 수는 없습니다 — 모든 행을 실제 수신자로 바꾸면 파일이 통과합니다.

형식, 한 줄씩

각 줄은 수신자 한 명이며 하나의 규칙을 따릅니다.

<TRON 주소>,<금액>

• 주소: base58 형식의 TRON 주소 — T로 시작하고 정확히 34자. 앞뒤 공백 없이, 따옴표 없이.
• 쉼표: 열 구분자. 한 줄에 쉼표 하나, 그 외에는 없음.
• 금액: 평범한 숫자. 소수점은 마침표(25.5), 천 단위 구분자 없음(10,000이 아니라 10000), 통화 기호 없음, 끝 공백 없음.
• 헤더 행 없음. 첫 줄부터 실제 수신자여야 합니다 — 텍스트 address,amount는 잘못된 주소로 표시됩니다(검증기가 지우라고 알려 주는 것입니다).
• 중복은 허용되지만 의미가 있습니다: 같은 주소가 두 번 나오면 그 지갑으로 두 번 전송한다는 뜻입니다. 정말 그것을 원하는 게 아니라면 먼저 중복을 제거하세요.

같은 두 열 목록을 일반 텍스트로 dApp에 바로 붙여 넣을 수도 있고, 같은 두 열을 가진 XLS/XLSX 파일도 그대로 동작합니다 — CSV는 셋 중 가장 호환성이 좋을 뿐입니다.

이미 쓰는 도구에서 내보내기

형식 자체는 간단합니다. 문제는 내보내기 과정에서 생깁니다. 가장 흔한 세 가지 경로:

Google 스프레드시트. 주소는 A열, 금액은 B열에 두고 시트에는 그 외 아무것도 두지 마세요 — 제목 행도, 메모 열도 없이. 금액 열은 일반 숫자 서식으로 지정합니다(서식 → 숫자 → 숫자, 그다음 천 단위 구분자 표시를 제거. 더 좋게는 마침표로 값을 입력한 뒤 서식 → 숫자 → 일반 텍스트). 파일 → 다운로드 → 쉼표로 구분된 값(.csv)으로 내보냅니다. 스프레드시트는 보이는 그대로 내보내므로, 열에 10,000이 표시되면 그 쉼표가 파일에 들어갑니다.

Excel. 위험한 변수는 시스템 지역 설정입니다. 많은 유럽 시스템에서 Excel은 세미콜론으로 구분하고 소수점에 쉼표를 쓰는 "CSV"를 만듭니다 — 겉보기엔 맞지만 잘못 해석되는 파일입니다. 해결책은 두 가지입니다. 통합 문서의 소수 구분 기호를 마침표로 설정하거나(옵션 → 고급 → "시스템 구분 기호 사용" 해제), 함정을 아예 피해 .xlsx 파일 자체를 업로드하세요. dApp은 같은 두 열 구성의 이 형식을 받아들입니다.

그 외 모든 것(Notion, Airtable, 데이터베이스 덤프): 도구가 만들어 주는 대로 내보낸 다음, 두 열을 일반 텍스트 편집기에 한 번 통과시키세요. 둥근 따옴표, 보이지 않는 문자, 서식 있는 텍스트의 잔재가 한 번에 제거됩니다 — 재업로드를 자주 막아 주는 10초입니다.

어떤 경로든, 최종 파일은 스프레드시트가 아닌 텍스트 편집기에서 한 번 열어 보세요. 거기서 보이는 것 — 쉼표, 마침표, 따옴표 없음, 헤더 없음 — 이 정확히 파서가 보는 것입니다.

대표적인 오류 일곱 가지

수년간의 고객 지원 대화는 이 목록으로 요약됩니다.

1. 쉼표 소수점. 많은 지역(유럽 대부분, 브라질 등)의 스프레드시트는 1.5를 1,5로 씁니다. 쉼표로 구분된 파일에서는 이것이 두 개의 열 — 금액 1과 그 뒤의 쓰레기 값 — 으로 읽힙니다. 내보내기 전에 금액 열이 마침표 소수점을 쓰도록 설정하세요.
2. 천 단위 구분자. 10,000도 같은 치명적인 방식으로 열이 나뉘고, 공백이 들어간 10 000은 숫자 해석에 실패합니다. 금액은 순수해야 합니다: 10000.
3. 남아 있는 헤더 행. 첫 줄의 address,amount. 지우세요.
4. 공백과 보이지 않는 문자. 채팅, 텔레그램, 웹 페이지에서 복사한 주소에는 공백, 탭, 폭이 0인 문자가 붙어 옵니다. 검증기가 표시해 주지만, 스프레드시트에서 미리 열을 정리하면 재업로드를 피할 수 있습니다.
5. 따옴표로 감싼 값. 일부 내보내기 도구는 모든 셀을 따옴표로 감쌉니다("TAbc...","100"). 대부분의 파서는 이를 허용하지만, 뒤섞이거나 엉뚱한 따옴표(주소 안의 따옴표)는 예측할 수 없게 줄을 깨뜨립니다. 따옴표 없는 일반 CSV로 내보내세요.
6. 다른 네트워크의 주소. 주소 열에 붙여 넣은 이더리움 0x… 주소나 거래소 메모. TRON 주소는 T로 시작하고 34자입니다. 그 외의 것은 TRC-20 토큰을 받을 수 없으며 표시됩니다.
7. base58 오타. 손으로 수정해 한 글자가 틀린 주소는 대개 체크섬 검사에 실패해 표시됩니다 — 검증기가 설계대로 동작하는 것입니다. 위험한 경우는 유효한 주소가 엉뚱한 사람의 것일 때이며, 어떤 소프트웨어도 이를 잡아낼 수 없습니다. 그래서 검토 화면이 있는 것입니다.

전송 전에 파일 확인하기

거의 모든 것을 잡아내는 90초 사전 점검:

1. 주소 열로 정렬하세요 — 중복이 나란히 붙어 눈에 띄고, 잘못된 항목은 맨 위나 맨 아래로 갑니다.
2. 행 수를 확인하세요 — 예상 수신자 수와 비교합니다. 하나 차이 나면 대개 헤더 행이나 끝의 빈 줄 때문입니다.
3. 금액 열의 합계를 구해 적어 두세요. 업로드 후 dApp은 검토 화면에 해석된 합계를 보여 줍니다 — 두 숫자가 정확히 일치해야 합니다. 다르다면 소수점이나 구분자 문제가 빠져나간 것입니다.
4. dApp에서 해석된 목록을 훑어보세요. 이 시점에서 검증은 이미 잘못된 주소와 중복을 표시했습니다. 여러분의 몫은 사람의 확인입니다 — 이름, 금액, 합계가 의도한 지급처럼 보이나요?
5. 이 목록으로 처음 보내나요? 단계별 가이드가 권하듯, 전체 전송 전에 몇 줄로 소액 테스트 배치를 보내세요. 온체인 전송은 되돌릴 수 없습니다. 리허설만이 유일한 실행 취소 버튼입니다.

FAQ

파일에 특정 이름이나 인코딩이 필요한가요? 특정 이름은 필요 없습니다. 일반 UTF-8(모든 스프레드시트가 기본으로 내보내는 형식)을 사용하세요. 바이트 순서 표시(BOM)를 추가하거나 파일을 서식 있는 텍스트로 바꾸는 편집기는 피하세요.

CSV 대신 XLS/XLSX를 써도 되나요? 네 — dApp은 같은 두 열 구성의 CSV, XLS, XLSX를 받으며, 목록을 텍스트로 붙여 넣을 수도 있습니다. CSV는 도구 간 이동 시 놀랄 일이 가장 적어서 템플릿이 이 형식으로 제공됩니다.

한 파일에 여러 토큰을 넣으려면? 그럴 수 없습니다 — 파일 하나는 토큰 하나의 분배 한 번입니다. 토큰은 업로드 전에 dApp에서 선택하며, 다른 토큰은 별도의 배치로 실행하세요.

파일 크기 제한이 있나요? 사실상 없습니다. 약 150명을 넘는 목록은 하나의 흐름 안에서 여러 개의 연속된 배치 트랜잭션으로 처리될 뿐입니다. 수수료 계산기는 어떤 목록 크기든 비용을 보여 주며, 전체 가이드는 이 파일을 둘러싼 전체 전송 과정을 다룹니다.