ERC-7538 곱셈 계수 토큰 (Multiplicative Tokens)
Draft · 토큰 · 2023-10-18 작성
토큰 메타데이터에 곱셈 계수(multiplier) 필드를 넣어 지갑 등이 사용자에게 보여 주는 잔액을 이 계수를 곱한 값으로 표시하게 하는 표준입니다. 소수 단위 토큰과 0.5 같은 증분 표현이 가능해집니다.
왜 필요한가
여러 프로젝트는 대체 가능 토큰과 대체 불가능 토큰 등 다양한 토큰을 만들어야 합니다. 기존 표준이 이런 발행에는 알맞지만 일부 표준은 토큰을 소수 단위로 쪼개어 표현하는 기능을 지원하지 않습니다. 또 어떤 토큰은 공급량이 저절로 늘어나는 인플레이션이나 줄어드는 디플레이션 장치를 내장하고 싶어 하고 0.5처럼 관례에서 벗어난 증분으로 전송을 허용하고 싶어 할 수도 있습니다. 기존의 소수 자릿수(decimals) 방식은 10의 거듭제곱 단위로만 값을 나눌 수 있어 이런 요구를 담기 어렵습니다. 이 표준은 ERC-1046 메타데이터에 곱셈 계수 필드를 추가해 표시 값을 계수 곱으로 계산하는 방식으로 이 문제를 풉니다.
구현해야 하는 것
multiplier: string | undefined;: 사용자에게 보여 줄 값을 만들 때 곱하는 양수 계수입니다. 정의하지 않으면 1로 간주하며 10진법의 정확한 값이므로 부동소수점 오차에 주의해야 합니다.decimals: never;: 이 표준에서는 decimals 필드를 이제 지원하지 않는다는 뜻입니다.
심층 설명
ERC-1046 메타데이터 확장
이 표준은 ERC-1046과 호환되는 토큰 유형, 특히 ERC-20과 ERC-1155를 확장합니다. multiplier를 쓰는 토큰은 해석된(resolved) ERC-1046 tokenURI 안에 MultiplierMetadata 인터페이스를 반드시(MUST) 구현해야 합니다. 즉 계수는 컨트랙트 함수가 아니라 tokenURI로 연결되는 메타데이터 문서에 들어갑니다. Rationale은 ERC-1046을 활용하면 대부분의 경우 가스 효율이 좋아진다고 설명합니다.
multiplier 필드의 규칙
multiplier는 사용자에게 보여 줄 표현을 만들기 위한 양수 계수입니다. 타입은 string | undefined이며 정의하지 않으면 기본값 1로 간주합니다. 이 값은 10진법(base 10)의 정확한 값(EXACT VALUE)이므로, 구현자는 부동소수점 오차를 조심해야 합니다. Rationale은 숫자를 문자열로 표현하면 필요할 때 더 높은 정밀도를 얻을 수 있고 decimals 대신 곱셈 계수를 쓰면 10의 거듭제곱이 아닌 증분도 다룰 수 있으며 인플레이션·디플레이션 처리가 매끄러워진다고 설명합니다.
decimals 금지
메타데이터 인터페이스에서 decimals 필드는 never 타입으로 선언되어 더 이상 지원하지 않습니다. 또한 multiplier를 사용하는 토큰 컨트랙트는 decimals라는 이름의 메서드를 가져서는 안 됩니다(MUST NOT). 두 방식이 함께 있으면 표시 값 계산이 충돌하기 때문에, 이 표준은 곱셈 계수 하나로 통일합니다.
기존 방식과의 비호환
이 표준은 ERC-1046 호환 토큰 표준의 decimals라는 이름의 메서드, 그리고 ERC-1046의 decimals 필드와 호환되지 않습니다. 기존에 decimals 기반으로 잔액을 표시하던 구현을 그대로 둔 채 multiplier를 덧붙일 수는 없다는 뜻입니다.
제안 상태
이 문서는 2023년 10월 18일에 만들어진 Draft(초안) 상태의 제안입니다. 내용이 앞으로 바뀔 수 있으므로 구현 전에 최신 상태를 확인하는 것이 좋습니다.
쓸 때 주의할 점
- 반올림 오류 악용 가능성: multiplier 필드를 잘못 처리하면 반올림 오류가 생길 수 있고 악의적인 행위자가 이를 악용할 수 있습니다. 컨트랙트는 이런 문제를 피하도록 계수를 정확하게 처리해야 합니다(MUST).
- 계수는 반드시 양수: 표시 문제를 막기 위해 multiplier는 양수여야 합니다(MUST). 0은 양수가 아닙니다.
- 극단적인 계수의 표시 문제: 특별히 크거나 작은 계수는 표시에 어려움을 일으킬 수 있습니다(MAY). 그래도 지갑은 UI/UX 문제나 추가 보안 문제를 일으키지 않으면서 전체 숫자를 표시하려고 노력해야 합니다(SHOULD).