Skip to content
This repository was archived by the owner on Jun 10, 2026. It is now read-only.

How to format amounts

Tobias Schubotz edited this page Jul 23, 2020 · 13 revisions

This doc specifies the different types of formatting amounts inside the Safe apps.

Full amount

Used when the entire amount matters.

  • No truncation, always show all numbers.
  • Thousands and decimal separators are used according to user's locale.

Short amount

Used in cases where horizontal screen real estate is limited and the complete amount is not super important.

  • Cut off after the 5th decimal, no matter how many decimals there are: 0.12345
  • Remove trailing zeroes, i.e. display 0.10000 as 0.1
  • Use the 5 decimals up until 999.99999
  • Use 1 decimal less from 1,000.0001 until 9,999.9999 (Use comma as thousands-separator)
  • Use 1 decimal less from 10,000.001 until 99,999.999
  • Use 1 decimal less from 100,000.01 until 999,999.99
  • Use 1 decimal less from 1,000,000.1 until 9,999,999.9
  • From 10,000,000 No Decimals until 99,999,999
  • Then Use 10.001M until 999.999M
  • Then 1.001B until 999.999B
  • Then 1.001T until 999T
  • Then just > 999T
  • Thousands and decimal separators are used according to user's locale.
  • M, B, T should be localized.
  • (Edit June 19) For amounts smaller then 0.00001, display < 0.00001 (Otherwise it would show as 0.00000 which is weird since the balance is actually >0.

This format has been discussed on a Github issue

Fiat numbers

The same rules from above apply to fiat numbers as well. Make sure to used the right amount of numbers after the decimal separator, maximum, respective to the respective fiat currency (i.e. maximum 2 for USD). The system formater of the respective operating system should be used.

Clone this wiki locally