Token Minimum Unit
Pronunciation: TOH-kun MIN-uh-mum YOO-nit
Also known as: Smallest Token Unit, Atomic Unit
Definition
Token Minimum Unit is the smallest quantity of a token that the underlying ledger can represent as one integer base unit. For a token with six decimals, the minimum unit normally equals one millionth of a displayed token. It defines mathematical divisibility and should not be confused with a minimum transfer, minimum order, or economically useful dust threshold.
Overview
Mechanism and important distinctions
Smart contracts usually store token balances as integers representing a smallest accounting unit. A token configured with six decimal places expresses 1.25 whole tokens as 1,250,000 base units. The conversion happens in wallet and integration software; the blockchain does not move a fractional integer. This choice prevents rounding inconsistencies in consensus-critical calculations, but only if application code respects the declared scale.
Decimals are formatting metadata rather than a promise of real-world purchasing power. A token with eighteen decimals can still enforce a larger minimum transfer amount in its contract. Payment processors should parse amounts using exact decimal arithmetic, reject excess precision explicitly and test both very small and very large values. Never rely on binary floating-point conversion for values that directly determine how much a customer must send.
Related glossary concepts
Token Issuer; Token Transfer Restriction; Blacklistable Token
Primary reference
Example
A token has six decimal places. A wallet balance of 1.25 tokens corresponds to 1,250,000 smallest units, and a transfer request of 0.0000001 tokens cannot be represented exactly under that token's on-chain precision. Correct software converts user-visible amounts to integer base units before signing.
Comparison
Use the actual on-chain decimals for that contract, not the display label or a global assumption. Represent amounts in integers or exact decimal arithmetic; floating-point rounding can cause underpayment and lost dust. Decimal precision is not the same as a blockchain's gas unit or the token's minimum permitted transfer size, which may impose separate restrictions.
Key Takeaway
Convert token amounts into exact integer base units to avoid payment rounding errors.
Sources
- ERC-20: Token Standard — Ethereum Improvement Proposals (2026-08-02)
- OpenZeppelin ERC-20 Documentation — OpenZeppelin (2026-08-02)
- OpenZeppelin Access Control — OpenZeppelin (2026-08-02)