이번 글의 질문과 확인 범위

거래 기록에서 value가 1000000으로 보였다고 해서 토큰 백만 개가 움직였다고 결론 내릴 수는 없습니다. 수량에 붙은 표시 단위를 먼저 확인해야 합니다. 금액의 원과 만원을 혼동하면 값이 만 배 달라지듯, 토큰 기록의 정수와 화면에 표시하는 소수 수량도 구분해야 합니다.
이 글의 숫자는 단위 계산을 위한 가상 값입니다. 특정 계약에서 읽은 잔액이나 실제 거래량이 아닙니다. 지갑을 연결하거나 송금을 실행하지 않고, 규격을 읽고 산술 결과만 확인했습니다.
decimals는 소수 수량으로 읽는 자리 수
ERC-20 규격의 decimals 설명은 정수 수량을 10의 해당 자리 수 거듭제곱으로 나누어 이용자 표시값으로 읽는 방식을 제시합니다. 이번 글의 계산식은 표시 수량 = 원본 정수 ÷ 10^decimals입니다. 이름·심볼·decimals는 규격에서 선택 항목으로 설명되므로 언제나 존재한다고 전제하지 않습니다. EIP-20의 decimals 항목을 확인했습니다.
단위를 바꾸는 계산은 토큰 가격이나 공급 규칙을 설명하는 계산과 다릅니다. 소수점 위치를 옮겨 원본 정수를 표시하는 것이며, 이 표만으로 자산의 경제적 가치를 평가할 수 없습니다. 여기서는 특정 토큰의 decimals를 조회하지도 않았습니다.
| 원본 정수 | 가정한 decimals | 표시 수량 |
|---|---|---|
| 1000000 | 6 | 1 |
| 1000000 | 18 | 0.000000000001 |
| 123456789 | 6 | 123.456789 |
| 9007199254740993 | 6 | 9007199254.740993 |
같은 정수인데 값이 달라지는 이유

첫 번째 행에서는 1000000을 1000000으로 나누므로 표시값이 1입니다. 두 번째 행에서는 같은 정수를 1000000000000000000으로 나눕니다. 결과는 0.000000000001입니다. 두 행의 원본 정수는 같지만 가정한 단위가 달라 표시 수량은 10^12배 차이 납니다.
실제 기록을 대조할 때는 원본 정수만 복사하지 말고 해당 네트워크와 자산 식별자, 단위의 출처까지 같이 적어야 합니다. 다른 토큰의 자리 수를 가져오거나 이름이 비슷하다는 이유로 18자리를 넣으면 정확한 정수를 가지고도 잘못된 표시값을 만들 수 있습니다.
큰 정수는 소수점 이전부터 달라질 수 있다
기존 Python 비교에 이어 2026년 10월 25일 Node.js v20.20.2에서도 원본 문자열 9007199254740993을 확인했습니다. Number로 바꾼 뒤 BigInt로 변환하면 9007199254740992이고, 원본 문자열에서 곧바로 BigInt를 만들면 9007199254740993입니다. 큰 정수 형식을 마지막에 적용해도 중간에 잃은 1은 복원되지 않습니다. Number→BigInt와 문자열→BigInt 실행 결과 · 네트워크 없는 JavaScript 재현 코드
이 오류는 보기 좋게 소수점을 몇 자리 표시하는 문제와도 다릅니다. 화면에 표시할 때만 마지막 자리에서 반올림하는 것과 계산 전에 원본 정수 자체를 바꾸는 것은 구분해야 합니다. 원본 문자열, 자리 수, 정확한 환산 결과를 별도 칸에 남기면 표시 과정과 데이터 처리 과정을 나누어 점검할 수 있습니다. 산술 도구는 Python Decimal 공식 안내를 참고했습니다.
단위를 확인하지 못했을 때 남길 기록
원본을 보존한 정수 9007199254740993에 decimals 6을 적용한 결과는 9007199254.740993입니다. 이는 단위 계산용 입력이며 실제 토큰 잔액이 아닙니다. 단위를 확인하지 못했다면 변환을 보류하고, 이미 사람이 읽는 수량으로 환산된 필드라면 다시 10의 거듭제곱으로 나누지 않습니다. 데이터 형식과 단위 확인이 둘 다 끝나야 표시값을 만들 수 있습니다.
기록 양식은 네트워크, 자산 식별자, 원본 값, 원본 값의 형식, decimals, 단위 확인 출처, 환산식, 표시 반올림 순서로 구성할 수 있습니다. 토큰 확인 자체가 필요하면 네트워크와 컨트랙트 주소를 구분하는 글을 함께 읽으세요.
이번 계산이 설명하지 않는 것
수량 환산이 맞아도 거래 실행 성공, 받는 서비스의 입금 반영, 계약의 신뢰성, 유동성과 가격은 별도 확인 대상입니다. “1토큰”이라는 표시를 만들었다는 사실만으로 1달러 가치나 출금 가능성을 확인한 것은 아닙니다. decimals는 투자 판단이나 송금 복구를 대신하지 않습니다.
검산 JSON의 cases 배열에는 raw_integer·decimals·display_exact가, float_comparison에는 raw_integer와 float_then_integer가 있습니다. 표의 값은 실제 거래가 아닌 계산 예제로 표시했습니다. 실제 거래의 단위를 읽을 때는 그 계약과 기록의 출처를 새로 확인해야 합니다.
편집자 의견
토큰 수량을 대조할 때는 화면의 소수보다 원시 정수와 decimals의 짝부터 보겠습니다. 같은 정수도 자리 수를 다르게 적용하면 표시 수량이 달라지므로, 소수 표기만 비교하는 방식은 단위 오류를 찾기 어렵습니다.
네트워크나 토큰 주소가 달라졌다면 앞서 사용한 자리 수를 그대로 가져오지 않겠습니다. 자리 수 환산이 맞는다는 결과와 금액의 경제적 가치가 맞는다는 판단도 구분합니다.
판단 근거: decimals는 소수 수량으로 읽는 자리 수
확인한 원자료
표의 4행을 직접 검산하기
2026-11-03 정정: 이 글이 연결한 파일의 항목 이름은 cases와 float_comparison입니다. 이전의 coin·coin_float 안내는 파일 구조와 맞지 않았습니다. 원본 2026-10-13 가상 입력과 표의 수치는 바꾸지 않았습니다.
기존 검산 JSON 내려받기와 검사 코드 내려받기(Python 3)를 같은 빈 폴더에 저장하세요. 코드를 check-units.py, JSON을 units.json으로 저장하고 다음 명령을 실행합니다. Python 3 표준 라이브러리만 사용합니다.
python3 check-units.py units.json
정상 입력에서는 checked_rows: 4, exact_unit_cases: all_match, float_comparison: matches를 출력합니다. 코드는 cases의 원본 정수를 10^decimals로 나눈 분수와 표시값을 정확히 대조합니다. 값이 다르거나 필요한 항목이 없으면 오류로 멈춥니다. 기존 큰 정수의 float 변환 차이도 별도로 대조합니다.
2026-11-03 재검산은 기존 가상 입력 4개와 파일 구조를 다시 대조한 것입니다. 실제 계약·잔액·지갑·가격·송금 결과를 새로 조회한 기록이 아닙니다. 코드는 입력 파일을 읽기만 하며 네트워크 요청이나 파일 쓰기를 하지 않습니다.