ERC-8056 ERC-20 UI multiplier extension for stock splits (Scaled UI Amount Extension for ERC-20 Tokens)
Draft · Tokens · created 2025-10-20
There are situations, like a stock split, where every holder's balance must change at the same time. This ERC-20 extension handles such cases without minting or transferring actual tokens, instead updating only a display multiplier to adjust the balance shown in wallet UIs.
Why it is needed
When a company does a 2-for-1 stock split, every shareholder's holdings should appear doubled. But ERC-20 currently has no efficient way to handle this, requiring new tokens to be minted and transferred to every holder. This is gas-intensive and operationally complex, and it can also break the internal accounting of DeFi protocols that hold the deposited token. This inefficiency has limited the handling of tokenized real-world assets (RWAs) like stocks on Ethereum.
What to implement
event UIMultiplierUpdated(uint256 oldMultiplier, uint256 newMultiplier, uint256 effectiveAtTimestamp);: An event that must fire whenever the UI multiplier changes, recording the previous multiplier, the new multiplier, and the effective time.event TransferWithUIAmount(address indexed from, address indexed to, uint256 amount, uint256 uiAmount);: An optional event that reports the UI-converted amount alongside the raw amount on token transfers.event UIMultiplierUpdateCancelled(uint256 cancelledMultiplier, uint256 cancelledEffectiveAt);: An optional event that fires when a scheduled multiplier change is cancelled or replaced by another scheduled change.function uiMultiplier() external view returns (uint256);: Returns the currently applied UI multiplier as an 18-decimal fraction (1e18 = 1.0).function toUIAmount(uint256 rawAmount) external view returns (uint256);: Converts a raw amount into a UI display amount.function fromUIAmount(uint256 uiAmount) external view returns (uint256);: Converts a UI display amount into a raw amount.function balanceOfUI(address account) external view returns (uint256);: Returns the given account's balance with the UI multiplier applied.function totalSupplyUI() external view returns (uint256);: Returns the total supply with the UI multiplier applied.function newUIMultiplier() external view returns (uint256);: Returns the new UI multiplier that is scheduled but not yet applied.function effectiveAt() external view returns (uint256);: Returns the timestamp at which the scheduled new multiplier begins to apply.
In depth
Core interface IScaledUIAmount
Compliant contracts must implement IScaledUIAmount. uiMultiplier() returns the current UI multiplier as an 18-decimal fraction (1e18 = 1.0). A UIMultiplierUpdated event must fire whenever the multiplier changes. TransferWithUIAmount and UIMultiplierUpdateCancelled are events, so they do not affect the interface ID, and are defined as optional within the core interface.
Required extension IScaledUIAmountNewUIMultiplier
Compliant contracts must also implement this extension. newUIMultiplier() returns a scheduled but not-yet-applied multiplier, and effectiveAt() returns the timestamp at which that multiplier begins to apply. How the multiplier is updated is left to the implementation, but the standard mandates a window for querying the next scheduled multiplier.
Optional extension: Conversion
IScaledUIAmountConversion is optional. toUIAmount(rawAmount) and fromUIAmount(uiAmount) are on-chain helper functions that convert a raw amount to a UI amount and vice versa.
Optional extension: Balances
IScaledUIAmountBalances is also optional. balanceOfUI(account) and totalSupplyUI() let callers directly query, on-chain, a given account's UI-adjusted balance and the UI-adjusted total supply.
ERC-165 interface detection
Compliant contracts must implement ERC-165 and must return true when queried for IScaledUIAmount. Contracts implementing an optional extension must also return true for that extension's interface ID. The interface IDs are 0xa60bf13d for IScaledUIAmount, 0x4bd27648 for IScaledUIAmountNewUIMultiplier, 0x57854fc3 for IScaledUIAmountConversion, and 0xd890fd71 for IScaledUIAmountBalances.
Four implementation requirements
First, ERC-165 interface detection must be implemented. The UI multiplier must use 18-decimal precision (1e18 = 1.0). Standard ERC-20 functions such as balanceOf, transfer, and transferFrom must continue to operate on raw amounts. Finally, a UIMultiplierUpdated event must fire whenever the multiplier changes.
Multiplier update logic in the reference implementation
In the reference implementation, setUIMultiplier can only be called by the owner; the new multiplier must be greater than zero and the effective time must be in the future. If a previously scheduled multiplier has already taken effect, the current multiplier is updated, a new schedule is registered, and UIMultiplierUpdated fires. If a not-yet-applied schedule remains, it is being replaced, so UIMultiplierUpdateCancelled fires first, then it is overwritten with the new schedule. cancelUIMultiplierUpdate cancels a schedule before its effective time, reverting the multiplier to its original state.
A proposal still in Draft status
This proposal is currently in Draft status. Implementation details such as how the multiplier is updated and whether a schedule can be cancelled are still left to each token issuer, so the standard's wording and scope may change or be discontinued going forward.
Things to watch out for
- Multiplier manipulation risk: If an unauthorized address can change the UI multiplier, users may misjudge their holdings. Functions like setUIMultiplier must be restricted to authorized addresses such as the owner or a designated role.
- Integer overflow: There is a risk of overflow in multiplier multiplication operations. SafeMath or Solidity 0.8+'s built-in overflow protection should be used.
- User confusion: It is important to clearly communicate that the UI amount differs from the raw amount. Integrators must clearly label UI-adjusted balances when displaying them.
- Oracle dependency: A system that automatically updates the multiplier may depend on an oracle, and oracle failure or manipulation can affect displayed balances.