Token Display Unit

Overview

Meaning and boundaries

Token Display Unit is the human-readable unit shown to users after token base units are scaled, rounded, formatted, or converted. A token display unit is a human-readable denomination obtained by scaling integer base units with the token’s decimal specification. Interfaces may further round for readability, but the ledger and payment-matching logic should retain the unrounded quantity. The asset’s network and contract address remain part of its identity.

How it works in practice

Start from the precise integer balance in the underlying ledger. The interface applies the token’s verified decimal scale and then formats the number for the chosen locale and screen size. When an operator copies a payment amount or approves a payout, provide the unambiguous full-precision value. An abbreviated amount suitable for a dashboard should never be inserted into a smart-contract call or used as a final reconciliation key.

Checks and failure points

Rounding a displayed value can mislead customers about what will be sent. Never calculate payable amounts from abbreviated UI strings such as ‘1.2K’, and label the asset and network clearly.

Operational evidence and decisions

Display formatting can include localization, decimal-place limits and compact abbreviations. Those presentation choices should not be reused as machine-readable values in invoices or contract calls. A payment summary may show six visible decimal places while the asset’s ledger supports more, so the application should disclose an exact amount when a user authorizes a transfer. Invoices and payouts should reconcile against base units, not against screenshots of formatted balances.

How it differs from related terms

Display units are formatted quantities for people; base units are exact integers for contract calls and accounting calculations. Related entries: Token Base Unit; Token Decimals; Token Denomination.