ERC-8056 ERC-20 주식분할용 UI배율 확장 (Scaled UI Amount Extension for ERC-20 Tokens)
Draft · 토큰 · 2025-10-20 작성
주식 분할처럼 모든 보유자의 잔액이 동시에 바뀌어야 하는 상황이 있습니다. 이 ERC-20 확장은 그런 경우 실제 토큰을 발행·전송하지 않고 표시용 배율만 갱신해 지갑 화면의 잔액을 조정합니다.
왜 필요한가
회사가 2대1 주식분할을 하면 모든 주주의 보유량이 두 배로 보여야 합니다. 그런데 현재 ERC-20에는 이를 처리할 효율적인 방법이 없어서, 보유자 전원에게 신규 토큰을 발행하고 전송해야 합니다. 이는 가스비가 많이 들고 운영이 복잡하며, 이 토큰을 예치해 둔 DeFi 프로토콜의 내부 회계도 분할로 깨질 수 있습니다. 이런 비효율 때문에 주식 같은 실물자산(RWA)을 토큰화해 이더리움에서 다루는 일이 제한되어 왔습니다.
구현해야 하는 것
event UIMultiplierUpdated(uint256 oldMultiplier, uint256 newMultiplier, uint256 effectiveAtTimestamp);: UI 배율이 바뀔 때마다 반드시 발생해야 하는 이벤트로, 이전 배율과 새 배율, 적용 시각을 기록합니다.event TransferWithUIAmount(address indexed from, address indexed to, uint256 amount, uint256 uiAmount);: 토큰 전송 시 raw 금액과 함께 UI로 환산된 금액도 알려주는 선택적 이벤트입니다.event UIMultiplierUpdateCancelled(uint256 cancelledMultiplier, uint256 cancelledEffectiveAt);: 예약돼 있던 배율 변경이 취소되거나 다른 예약으로 대체됐을 때 발생하는 선택적 이벤트입니다.function uiMultiplier() external view returns (uint256);: 현재 적용 중인 UI 배율을 18자리 소수(1e18=1.0)로 반환합니다.function toUIAmount(uint256 rawAmount) external view returns (uint256);: raw 금액을 UI 표시용 금액으로 환산합니다.function fromUIAmount(uint256 uiAmount) external view returns (uint256);: UI 표시용 금액을 raw 금액으로 환산합니다.function balanceOfUI(address account) external view returns (uint256);: 해당 계정의 잔액을 UI 배율이 적용된 값으로 반환합니다.function totalSupplyUI() external view returns (uint256);: 전체 공급량을 UI 배율이 적용된 값으로 반환합니다.function newUIMultiplier() external view returns (uint256);: 아직 적용되지 않고 예약돼 있는 새 UI 배율을 반환합니다.function effectiveAt() external view returns (uint256);: 예약된 새 배율이 적용되기 시작하는 타임스탬프를 반환합니다.
심층 설명
핵심 인터페이스 IScaledUIAmount
준수 컨트랙트는 IScaledUIAmount를 반드시 구현해야 합니다. uiMultiplier()는 현재 UI 배율을 18자리 소수(1e18=1.0)로 반환합니다. 배율이 바뀔 때마다 UIMultiplierUpdated 이벤트를 반드시 발생시켜야 합니다. TransferWithUIAmount와 UIMultiplierUpdateCancelled는 이벤트이므로 인터페이스 ID에 영향을 주지 않아 선택 사항으로 핵심 인터페이스에 함께 정의되어 있습니다.
필수 확장 IScaledUIAmountNewUIMultiplier
준수 컨트랙트는 이 확장도 반드시 구현해야 합니다. newUIMultiplier()는 예약되었지만 아직 적용되지 않은 배율을, effectiveAt()은 그 배율이 적용되기 시작하는 타임스탬프를 반환합니다. 배율을 어떻게 갱신하는지는 구현에 맡겨져 있지만, 예약된 다음 배율을 조회할 수 있는 창구는 표준으로 강제됩니다.
선택 확장: 변환(Conversion)
IScaledUIAmountConversion은 선택 사항으로, toUIAmount(rawAmount)는 raw 금액을 UI 금액으로, fromUIAmount(uiAmount)는 반대로 UI 금액을 raw 금액으로 바꿔주는 온체인 계산 도우미 함수입니다.
선택 확장: 잔액(Balances)
IScaledUIAmountBalances도 선택 사항으로, balanceOfUI(account)는 특정 계정의 UI 조정 잔액을, totalSupplyUI()는 UI 조정된 전체 공급량을 온체인에서 바로 조회할 수 있게 해 줍니다.
ERC-165 인터페이스 감지
준수 컨트랙트는 ERC-165를 구현해야 하며 IScaledUIAmount 조회 시 true를 반환해야 합니다. 선택 확장을 구현한 컨트랙트도 해당 확장의 인터페이스 ID에 대해 true를 반환해야 합니다. 인터페이스 ID는 IScaledUIAmount가 0xa60bf13d, IScaledUIAmountNewUIMultiplier가 0x4bd27648, IScaledUIAmountConversion이 0x57854fc3, IScaledUIAmountBalances가 0xd890fd71입니다.
구현 요구사항 4가지
우선 ERC-165 인터페이스 감지를 구현해야 합니다. 또한 UI 배율은 정밀도를 위해 반드시 18자리 소수를 써야 합니다(1e18=1.0). 표준 ERC-20 함수인 balanceOf, transfer, transferFrom 등은 계속 raw 금액으로 동작해야 합니다. 마지막으로 배율이 바뀔 때마다 UIMultiplierUpdated 이벤트를 반드시 발생시켜야 합니다.
참조 구현의 배율 갱신 로직
참조 구현의 setUIMultiplier는 소유자만 호출할 수 있고, 새 배율은 0보다 커야 하며 적용 시각은 미래여야 합니다. 이전에 예약된 배율이 이미 적용된 상태라면 현재 배율을 갱신하고 새 예약을 등록하며 UIMultiplierUpdated를 발생시킵니다. 아직 적용되지 않은 예약이 남아 있다면 그 예약은 대체되는 것이므로 UIMultiplierUpdateCancelled를 먼저 발생시킨 뒤 새 예약으로 덮어씁니다. cancelUIMultiplierUpdate는 적용 시각 전에 예약을 취소해 배율을 원래 상태로 되돌립니다.
아직 Draft 상태인 제안
이 제안은 현재 Draft 상태입니다. 배율 갱신 방식, 예약 취소 가능 여부 등 구현 세부사항이 아직 각 토큰 발행자에게 맡겨져 있어, 표준 문구나 범위가 앞으로 바뀌거나 중단될 수 있습니다.
쓸 때 주의할 점
- 배율 조작 위험: 권한 없는 주소가 UI 배율을 바꾸면 사용자가 자신의 보유량을 오인할 수 있습니다. setUIMultiplier 같은 함수는 소유자나 지정된 역할 등 권한 있는 주소로만 제한해야 합니다.
- 정수 오버플로우: 배율을 곱하는 연산에서 오버플로우가 발생할 위험이 있습니다. SafeMath나 Solidity 0.8 이상의 기본 오버플로우 보호를 사용해야 합니다.
- 사용자 혼동: UI 금액이 raw 금액과 다르다는 점을 명확히 전달하는 것이 중요합니다. 통합사는 UI 조정 잔액을 보여줄 때 이를 분명히 표기해야 합니다.
- 오라클 의존성: 배율을 자동으로 갱신하는 시스템이라면 오라클에 의존할 수 있는데, 오라클 장애나 조작이 표시 잔액에 영향을 줄 수 있습니다.