# @ledgerhq/live-currency-format

> Ledger Live currency formatting utilities

Latest version **0.15.0** (published 2026-09-11) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @ledgerhq/live-currency-format
pnpm add @ledgerhq/live-currency-format
yarn add @ledgerhq/live-currency-format
bun add @ledgerhq/live-currency-format
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.15.0 |
| Published | 2026-09-11 |
| First published | 2026-01-24 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 469.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 618 |
| Maintainers | phenry-ledger, sergii-shkolin, gbrahm-ledger, ldg-github-ci, vbouzon, ledger-releaser |
| Keywords | Ledger |

## Links

- npm: https://www.npmjs.com/package/@ledgerhq/live-currency-format
- Repository: https://github.com/LedgerHQ/ledger-live
- Homepage: https://github.com/LedgerHQ/ledger-live/tree/develop/libs/live-currency-format
- Issues: https://github.com/LedgerHQ/ledger-live/issues
- npm.io page: https://npm.io/package/@ledgerhq/live-currency-format

## Dependencies (1)

- [bignumber.js](https://npm.io/package/bignumber.js.md) ^9.1.2

## Recent versions

- 0.15.0 (latest) — 2026-09-11
- 0.14.4-nightly.20260912020511 (nightly) — 2026-09-12
- 0.14.4-nightly.20260911020507 — 2026-09-11
- 0.14.4-nightly.20260910020512 — 2026-09-10
- 0.14.4-nightly.20260909020514 — 2026-09-09
- 0.14.3-nightly.20260908020515 — 2026-09-08
- 0.14.3 — 2026-09-07
- 0.14.3-nightly.20260905020452 — 2026-09-05
- 0.14.3-nightly.20260904020502 — 2026-09-04
- 0.14.3-nightly.20260903021109 — 2026-09-03
- 0.14.3-nightly.20260902021544 — 2026-09-02
- 0.14.3-nightly.20260901020738 — 2026-09-01
- 0.14.3-nightly.20260829020445 — 2026-08-29
- 0.14.2-nightly.20260828043625 — 2026-08-28
- 0.14.2 — 2026-08-27
- … 210 more at https://npm.io/package/@ledgerhq/live-currency-format/versions

## README

# live-currency-format

> [!NOTE]
> **Status: STABLE** — Production-ready; API is considered stable.

Locale-aware currency formatting utilities for Ledger Live. Handles display of crypto and fiat amounts, parsing user input back into BigNumber values, RTL language support, and price formatting. Used across both desktop and mobile UIs wherever a balance, fee, or price must be rendered as a human-readable string.

## What it does

- Formats `BigNumber` crypto/fiat amounts respecting locale decimal separators and grouping
- Parses user-typed currency strings back into `BigNumber` (input sanitization)
- Formats price values (fiat countervalues, market prices)
- Provides RTL utility helpers for correct text direction in Arabic, Hebrew, etc.
- Exposes locale detection utilities used by the formatters

## Key exports / concepts

- `formatCurrencyUnit(unit, value, options)` — main formatting function for any currency unit
- `parseCurrencyUnit(unit, str)` — inverse of format; returns a BigNumber
- `BigNumberToLocaleString` — low-level locale-aware number stringifier
- `sanitizeValueString` — cleans raw user input before parsing
- `formatPrice` / `priceFormat` — countervalue / market price display
- `isRTL` / RTL helpers — direction utilities

## Usage context

Used by both `apps/ledger-live-desktop` and `apps/ledger-live-mobile`, and by `libs/ledger-live-common`, wherever amounts need to be displayed or entered. This is a leaf dependency with no Ledger Live runtime dependencies of its own.

---
_Source: https://npm.io/package/@ledgerhq/live-currency-format · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._