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

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

Original ERC · ← ERCs