1,000,000은 1개일까 100만 개일까
블록 탐색기에서 토큰 거래의 원시 데이터를 보면 ‘1000000’ 같은 큰 정수가 나오는데, 지갑 화면에는 ‘1 USDC’로 표시되는 경우가 있습니다. ERC-20 토큰은 잔액을 소수점 없는 정수로 저장하고, decimals라는 값으로 소수점을 몇 자리 찍어 보여줄지 알려주기 때문입니다.
이 글은 decimals가 잔액 표시에 어떻게 쓰이는지, decimals가 다른 토큰에서 같은 원시 값이 얼마나 다른 수량이 되는지 가상의 표로 보여줍니다. 승인 금액을 읽을 때와 이름이 같은 가짜 토큰을 만났을 때 주의할 점도 정리합니다.
정수 저장과 decimals
ERC-20 표준은 토큰 계약이 balanceOf 같은 함수로 잔액을 돌려주도록 정하고, decimals 함수는 토큰이 사용하는 소수 자릿수를 알려준다고 설명합니다. 표준은 decimals를 선택 항목으로 두며, 이 값은 사용성을 위한 것이라고 밝힙니다. 계약 안의 모든 계산은 정수로 이뤄집니다.
Ethereum.org의 ERC-20 설명처럼 지갑과 앱은 원시 정수를 10의 decimals 제곱으로 나눠 사람이 읽기 쉬운 수량으로 보여줍니다. decimals가 6이면 원시 값 1,000,000이 1개, 18이면 원시 값 10의 18제곱이 1개입니다. decimals는 토큰의 가치나 분할 규칙을 바꾸지 않고, 표시 방법만 정합니다.
같은 원시 값, 다른 수량
아래 표는 원시 값 1,000,000이 decimals에 따라 화면에 어떻게 표시되는지 비교한 가상의 예시입니다.
| 토큰 (가상) | decimals | 원시 값 | 화면 표시 수량 |
|---|---|---|---|
| 토큰 A | 0 | 1,000,000 | 1,000,000개 |
| 토큰 B | 6 | 1,000,000 | 1개 |
| 토큰 C | 8 | 1,000,000 | 0.01개 |
| 토큰 D | 18 | 1,000,000 | 0.000000000001개 |
원시 값은 같아도 decimals에 따라 표시 수량이 10의 18제곱배까지 차이 납니다. 앱이 decimals를 잘못 읽으면 잔액이나 금액이 크게 틀려 보일 수 있습니다.
승인 금액을 읽을 때
토큰 사용 승인(approve) 거래의 금액도 원시 정수로 기록됩니다. 지갑이 이를 decimals로 변환해 보여주지 않고 원시 값 그대로 표시하면, 사용자는 금액의 크기를 가늠하기 어렵습니다. 특히 매우 큰 원시 값은 사실상 무제한 승인을 뜻하는 경우가 많습니다.
반대로 화면에는 ‘100’이라고 표시됐는데, 실제 원시 값이 다른 decimals 기준으로 계산돼 의도보다 훨씬 큰 금액일 가능성도 있습니다. 중요한 승인은 블록 탐색기에서 원시 값과 그 토큰의 decimals를 직접 확인해 실제 수량을 계산해 보는 것이 좋습니다.
이름과 기호는 증거가 아니다
ERC-20의 name과 symbol도 decimals처럼 계약이 스스로 알려주는 값입니다. 누구나 ‘USDC’라는 이름과 기호, decimals 6을 가진 토큰 계약을 만들 수 있습니다. 지갑에 처음 보는 ‘USDC’가 들어왔다면, 그것이 진짜인지는 이름이 아니라 계약 주소로 확인해야 합니다.
Ethereum.org의 보안 안내도 출처를 모르는 토큰과 그 토큰이 안내하는 사이트를 조심하라고 강조합니다. 가짜 토큰은 진짜와 같은 이름으로 지갑에 나타나 사용자를 피싱 사이트로 유도하는 데 쓰이기도 합니다.
토큰을 다룰 때 확인 순서
새 토큰을 받거나 승인할 때는 아래 순서로 확인해 보세요.
- 토큰의 계약 주소가 공식 자료에 나온 주소와 같은지 확인합니다.
- 블록 탐색기에서 그 계약의 decimals 값을 확인합니다.
- 승인 금액이나 거래 금액의 원시 값을 decimals로 나눠 실제 수량을 계산합니다.
- 같은 이름의 토큰이 여러 네트워크에 있다면 네트워크별 계약 주소를 따로 확인합니다.
- 출처를 모르는 토큰이 들어오면 거래하거나 그 토큰이 안내하는 사이트에 접속하지 않습니다.
네트워크 사이의 차이
같은 이름의 토큰이라도 네트워크마다 decimals가 다른 경우가 있습니다. 한 네트워크에서는 decimals 6, 다른 네트워크의 브리지 버전은 decimals 18로 발행될 수 있습니다. 두 네트워크 사이에서 금액을 직접 계산하거나 계약에 원시 값을 넣을 때는 각 네트워크의 decimals를 따로 확인해야 합니다.
개발자가 아니더라도, 거래 전에 지갑이 보여주는 수량과 블록 탐색기의 원시 값이 맞는지 한 번 대조해 보는 습관은 큰 실수를 막는 데 도움이 됩니다.
판단 전에 기억할 점
이 글의 토큰과 값은 표시 원리를 보여주기 위한 가상의 예시입니다. 실제 토큰의 decimals와 동작은 계약마다 다르고, 표준을 일부만 따르는 토큰도 있습니다.
실제로 확인할 때는 ERC-20 표준, Ethereum.org, 블록 탐색기의 최신 정보를 기준 시점과 함께 보세요. 여기 나온 숫자는 판단 재료일 뿐, 매매 신호가 아닙니다.