Skip to main content

Conversion rules

decimalAmountToRaw(value, decimals) accepts 0–18 decimals. It rejects excess fractional digits and values above uint64 without rounding or truncating. Maximum raw amount: 18446744073709551615. Conversion accepts zero; transfer, issue, reissue, and burn amounts must be positive. toRawAmountString normalizes a raw integer. It does not convert decimal input. Do not convert user input to Number or multiply floating-point amounts by powers of ten. Do not derive transaction amounts from approximate displayAmount.

Unknown metadata

When metadataPending is true or decimals are unknown, display labelled atomic units until trusted metadata is available. Keep large integers as strings in JSON.