01

1,000,000은 1개일까 100만 개일까

블록 탐색기에서 토큰 거래의 원시 데이터를 보면 ‘1000000’ 같은 큰 정수가 나오는데, 지갑 화면에는 ‘1 USDC’로 표시되는 경우가 있습니다. ERC-20 토큰은 잔액을 소수점 없는 정수로 저장하고, decimals라는 값으로 소수점을 몇 자리 찍어 보여줄지 알려주기 때문입니다.

이 글은 decimals가 잔액 표시에 어떻게 쓰이는지, decimals가 다른 토큰에서 같은 원시 값이 얼마나 다른 수량이 되는지 가상의 표로 보여줍니다. 승인 금액을 읽을 때와 이름이 같은 가짜 토큰을 만났을 때 주의할 점도 정리합니다.

02

정수 저장과 decimals

ERC-20 표준은 토큰 계약이 balanceOf 같은 함수로 잔액을 돌려주도록 정하고, decimals 함수는 토큰이 사용하는 소수 자릿수를 알려준다고 설명합니다. 표준은 decimals를 선택 항목으로 두며, 이 값은 사용성을 위한 것이라고 밝힙니다. 계약 안의 모든 계산은 정수로 이뤄집니다.

Ethereum.org의 ERC-20 설명처럼 지갑과 앱은 원시 정수를 10의 decimals 제곱으로 나눠 사람이 읽기 쉬운 수량으로 보여줍니다. decimals가 6이면 원시 값 1,000,000이 1개, 18이면 원시 값 10의 18제곱이 1개입니다. decimals는 토큰의 가치나 분할 규칙을 바꾸지 않고, 표시 방법만 정합니다.

03

같은 원시 값, 다른 수량

아래 표는 원시 값 1,000,000이 decimals에 따라 화면에 어떻게 표시되는지 비교한 가상의 예시입니다.

decimals에 따른 표시 수량 (가상 예시)
토큰 (가상)decimals원시 값화면 표시 수량
토큰 A01,000,0001,000,000개
토큰 B61,000,0001개
토큰 C81,000,0000.01개
토큰 D181,000,0000.000000000001개

원시 값은 같아도 decimals에 따라 표시 수량이 10의 18제곱배까지 차이 납니다. 앱이 decimals를 잘못 읽으면 잔액이나 금액이 크게 틀려 보일 수 있습니다.

04

승인 금액을 읽을 때

토큰 사용 승인(approve) 거래의 금액도 원시 정수로 기록됩니다. 지갑이 이를 decimals로 변환해 보여주지 않고 원시 값 그대로 표시하면, 사용자는 금액의 크기를 가늠하기 어렵습니다. 특히 매우 큰 원시 값은 사실상 무제한 승인을 뜻하는 경우가 많습니다.

반대로 화면에는 ‘100’이라고 표시됐는데, 실제 원시 값이 다른 decimals 기준으로 계산돼 의도보다 훨씬 큰 금액일 가능성도 있습니다. 중요한 승인은 블록 탐색기에서 원시 값과 그 토큰의 decimals를 직접 확인해 실제 수량을 계산해 보는 것이 좋습니다.

05

이름과 기호는 증거가 아니다

ERC-20의 name과 symbol도 decimals처럼 계약이 스스로 알려주는 값입니다. 누구나 ‘USDC’라는 이름과 기호, decimals 6을 가진 토큰 계약을 만들 수 있습니다. 지갑에 처음 보는 ‘USDC’가 들어왔다면, 그것이 진짜인지는 이름이 아니라 계약 주소로 확인해야 합니다.

Ethereum.org의 보안 안내도 출처를 모르는 토큰과 그 토큰이 안내하는 사이트를 조심하라고 강조합니다. 가짜 토큰은 진짜와 같은 이름으로 지갑에 나타나 사용자를 피싱 사이트로 유도하는 데 쓰이기도 합니다.

06

토큰을 다룰 때 확인 순서

새 토큰을 받거나 승인할 때는 아래 순서로 확인해 보세요.

  1. 토큰의 계약 주소가 공식 자료에 나온 주소와 같은지 확인합니다.
  2. 블록 탐색기에서 그 계약의 decimals 값을 확인합니다.
  3. 승인 금액이나 거래 금액의 원시 값을 decimals로 나눠 실제 수량을 계산합니다.
  4. 같은 이름의 토큰이 여러 네트워크에 있다면 네트워크별 계약 주소를 따로 확인합니다.
  5. 출처를 모르는 토큰이 들어오면 거래하거나 그 토큰이 안내하는 사이트에 접속하지 않습니다.
07

네트워크 사이의 차이

같은 이름의 토큰이라도 네트워크마다 decimals가 다른 경우가 있습니다. 한 네트워크에서는 decimals 6, 다른 네트워크의 브리지 버전은 decimals 18로 발행될 수 있습니다. 두 네트워크 사이에서 금액을 직접 계산하거나 계약에 원시 값을 넣을 때는 각 네트워크의 decimals를 따로 확인해야 합니다.

개발자가 아니더라도, 거래 전에 지갑이 보여주는 수량과 블록 탐색기의 원시 값이 맞는지 한 번 대조해 보는 습관은 큰 실수를 막는 데 도움이 됩니다.

08

판단 전에 기억할 점

이 글의 토큰과 값은 표시 원리를 보여주기 위한 가상의 예시입니다. 실제 토큰의 decimals와 동작은 계약마다 다르고, 표준을 일부만 따르는 토큰도 있습니다.

실제로 확인할 때는 ERC-20 표준, Ethereum.org, 블록 탐색기의 최신 정보를 기준 시점과 함께 보세요. 여기 나온 숫자는 판단 재료일 뿐, 매매 신호가 아닙니다.