Function: formatBig()
ts
function formatBig(value: number | BigNumber, precision?: number): string;Defined in: lib/helpers/bignum.ts:72
Render a BigNumber (or JS number) to a string at precision significant digits.
Parameters
| Parameter | Type | Default value |
|---|---|---|
value | | number | BigNumber | undefined |
precision | number | DEFAULT_PRECISION |
Returns
string
Remarks
- An EXACT INTEGER is rendered in full fixed notation regardless of
precision: an integer carries no fractional precision to lose, so8000000000000stays8000000000000rather than being truncated to8e+12. (Bounded at 30 digits to avoid pathological astronomically-large integers printing thousands of characters; beyond that, sig-fig exponential is used.) - Non-integers are rendered at
precisionsignificant digits (default 8), stripping trailing zeros — avoiding thetoPrecisionartifact that mangled safe values, while still giving the caller control over how many digits they want (raiseprecisionfor more). - Exact zero renders as
'0'. (Genuinely tiny values like2.54e-5are preserved, NOT snapped.)