주제별 원본 삽화: ChainView BTC866 주제별 원본 도해 · ChainView BTC866 Editorial · CC BY 4.0
계약은 정수를 기록
많은 토큰 계약은 잔고를 소수점이 없는 정수로 저장하고 지갑이 정해진 소수점 자리만큼 나누어 보여 줍니다. 소수점이 여섯 자리인 교육용 토큰의 원시 잔고 백만은 화면에서 한 토큰으로 표시됩니다. 이 설정은 토큰의 가치와 가격을 정하지 않습니다. 모든 토큰이 같은 자릿수를 쓰는 것은 아니며 표준의 선택적 정보가 누락되거나 도구가 잘못 해석할 수 있으므로 계약과 네트워크를 확인해야 합니다.
표시와 전송 단위 구분
사람에게 보이는 수량을 API와 계약에 넘길 때 원시 정수로 바꾸는 과정이 필요할 수 있습니다. 문서가 이미 원시 단위를 요구하는데 다시 곱하거나 반대로 나누면 큰 오류가 생깁니다. 자산 식별자와 소수점 정보, 요청 필드의 단위를 함께 기록하세요. 지원되는 최소 단위보다 작은 수량은 표현할 수 없으므로 반올림과 버림 규칙도 정해야 합니다. 화면에서 반올림되어 같아 보여도 실제 잔고와 요청 정수가 다를 수 있습니다.
부동 소수점 오차 피하기
프로그램의 일반 소수 자료형은 십진 소수를 정확히 표현하지 못하는 경우가 있습니다. 큰 잔고와 작은 단위를 함께 다룰 때는 정수 연산이나 정확한 십진 연산 도구를 사용하고 문자열 변환 규칙을 명시합니다. 과학 표기와 지역별 천 단위 구분 기호를 그대로 계약 입력으로 보내지 마세요. 입력 검증에서 음수와 너무 긴 소수, 자산별 최대값을 확인하고 전송 전 최종 원시 수량을 다시 표시하는 방법이 유용합니다.
토큰 식별자가 먼저
같은 이름과 티커를 쓰는 다른 계약이 있을 수 있어 소수점 정보만 맞아도 올바른 자산이라고 볼 수 없습니다. 공식 주소와 체인 식별자를 대조하고 신규 토큰을 지갑에 추가할 때 신뢰 경로에서 정보를 확인하세요. 토큰 이전 뒤 계약이 바뀌면 예전 설정을 계속 쓰지 않습니다. 원시 잔고가 갑자기 커졌다는 이유로 자산 가치가 늘었다고 설명하지 말고 단위 전환과 실제 경제적 변화를 분리해야 합니다.
간단한 대조 연습
소수점이 두 자리라면 표시 수량 십이 점 삼사에 해당하는 원시 정수는 천이백삼십사입니다. 수수료가 별도 자산으로 나가는 경우 토큰 수량 계산과 수수료 잔고를 각각 확인하세요. 거래 후 영수증과 이전·이후 잔고를 대조하고 표시 값의 반올림 차이를 설명합니다. 거래소의 최소 입출금은 계약의 최소 단위보다 클 수 있어 이 제한도 따로 읽어야 합니다. 단위 이름과 변환 방향을 적는 습관이 실수를 줄입니다.
직접 확인하는 연습
원시 수량에서 표시 수량으로 바꾼 뒤 다시 원시 정수로 되돌리는 검사를 해 보세요. 처음 값과 다르면 반올림과 자료형을 확인하고 실제 전송 전에 중단해야 합니다. 단위가 확실하지 않은 수량은 추정으로 처리하지 않습니다.
