Multipliers
ERC-8056 conversion between raw ERC-20 balances and the share-equivalent amount represented by a Stock Token.
#Scaled UI amounts
Stock Tokens implement ERC-8056. Corporate actions change the shares-per-token ratio through uiMultiplier() without rebasing raw ERC-20 balances or total supply.
Share-equivalent amount = raw token amount × uiMultiplier / 1e18| View | Meaning |
|---|---|
| balanceOf(account) | Raw ERC-20 balance |
| uiMultiplier() | Current shares-per-token ratio, scaled by 1e18 |
| balanceOfUI(account) | Share-equivalent balance |
| totalSupplyUI() | Share-equivalent supply |
| newUIMultiplier() | Scheduled multiplier value |
| effectiveAt() | Timestamp for the scheduled value |
#Position accounting
A position record should preserve both raw token units and the multiplier context used to express share-equivalent notional. Comparing a strike or payoff quantity against the wrong unit can create silent under-coverage or over-coverage.
The Chainlink Stock Token feed incorporates the multiplier. Multiply raw token balance by the feed price for token value; do not separately scale that price.
#Primary sources
- ERC-8056: Scaled UI Amount Extension
Ethereum standard defining multiplier-adjusted display amounts while raw ERC-20 balances remain unchanged.
- Building with Stock Tokens
Official integration guide for ERC-20 operations, ERC-8056 views, liquidity surfaces and onchain pricing.
- Oracles & Price Feeds
Official Chainlink feed semantics, multiplier treatment, pause behavior and L2 safety checks.