Skip to content

bigint-migration-guide.md

Latest commit

 

History

History
606 lines (466 loc) · 27.4 KB

bigint-migration-guide.md

File metadata and controls

606 lines (466 loc) · 27.4 KB

BN.js to BigInt Migration Guide

This guide covers migrating call-sites from the legacy app/util/number/index.js (BN.js-based) to the new app/util/number/bigint.ts (native BigInt-based).

Why migrate?

  • Performance: Native BigInt is a V8 primitive — no library overhead, no object allocation per operation.
  • Bundle size: Removes bnjs4 and number-to-bn from the dependency graph.
  • Type safety: bigint is a first-class TypeScript type with compile-time checks. No more as any casts.
  • Simpler API: Arithmetic uses native operators (+, -, *, /, >, ===) instead of method chains (.add(), .sub(), .mul(), .div(), .gt(), .eq()).

Quick start

// BEFORE
import { hexToBN, BNToHex, weiToFiatNumber } from '../util/number';

const balance = hexToBN(balanceHex);
const staked = hexToBN(stakedHex);
const total = balance.add(staked);
const fiat = weiToFiatNumber(total.toString('hex'), rate, 2);

// AFTER
import {
  hexToBigInt,
  bigIntToHex,
  weiToFiatNumber,
} from '../util/number/bigint';

const balance = hexToBigInt(balanceHex);
const staked = hexToBigInt(stakedHex);
const total = balance + staked;
const fiat = weiToFiatNumber(total, rate, 2);

Import change

// BEFORE — legacy BN.js module
import { hexToBN, BNToHex, fromWei, toWei, ... } from '../util/number';
// or
import { hexToBN, BNToHex, fromWei, toWei, ... } from '../util/number/index';

// AFTER — BigInt module
import { hexToBigInt, bigIntToHex, fromWei, toWei, ... } from '../util/number/bigint';

util/number import burndown (by team)

ESLint still allows a fixed set of files to import the deprecated BN.js module app/util/number/index.js. That allowlist lives in .eslintrc.js as utilNumberImportBurndownFiles. After migrating a file to app/util/number/bigint, remove its path from that array so new legacy imports cannot creep back in.

Imports that resolve to the same file count too: for example from '../util/number', from '../util/number/index', and (from under app/util/) from '../number' all resolve to index.js and are subject to the same fence unless the file is on the allowlist.

The table below maps each burndown path to the GitHub team(s) from .github/CODEOWNERS using the same rule as GitHub: the last pattern in the file that matches the path wins. Shared app/util/confirmation/, app/util/custom-gas/, app/util/networks/, and app/util/transactions/ have explicit owner lines so burndown PRs route like adjacent product code. If your area is not covered, add or tighten a CODEOWNERS entry in a follow-up PR.

@MetaMask/card

  • app/components/UI/Card/hooks/useAssetBalances.tsx
  • app/components/UI/Card/hooks/useCardDelegation.test.ts
  • app/components/UI/Card/hooks/useCardDelegation.ts
  • app/components/UI/Card/hooks/useNeedsGasFaucet.ts
  • app/components/UI/Card/sdk/CardSDK.ts

@MetaMask/confirmations

  • app/components/Views/confirmations/components/gas/max-base-fee-input/max-base-fee-input.tsx
  • app/components/Views/confirmations/components/gas/priority-fee-input/priority-fee-input.tsx
  • app/components/Views/confirmations/components/info/typed-sign-v3v4/simulation/components/native-value-display/native-value-display.tsx
  • app/components/Views/confirmations/components/info/typed-sign-v3v4/simulation/components/value-display/value-display.tsx
  • app/components/Views/confirmations/components/transactions/custom-amount/custom-amount.tsx
  • app/components/Views/confirmations/context/send-context/utils.ts
  • app/components/Views/confirmations/hooks/gas/useCancelSpeedupGas/useCancelSpeedupGas.ts
  • app/components/Views/confirmations/hooks/send/useBalance.ts
  • app/components/Views/confirmations/hooks/send/useCurrencyConversions.ts
  • app/components/Views/confirmations/hooks/send/usePercentageAmount.ts
  • app/components/Views/confirmations/hooks/useTokenAmount.ts
  • app/components/Views/confirmations/legacy/components/CustomNonceModal/index.js
  • app/components/Views/confirmations/legacy/components/WatchAssetRequest/index.js
  • app/components/Views/confirmations/utils/send.ts
  • app/core/Engine/controllers/gas-fee-controller/gas-fee-controller-init.test.ts
  • app/util/confirm-tx.js
  • app/util/conversions.js
  • app/util/confirmation/gas.ts
  • app/util/confirmation/transactions.ts
  • app/util/custom-gas/index.js

@MetaMask/confirmations and @MetaMask/earn (co-owned)

  • app/components/Views/confirmations/external/staking/hooks/useStakingDetails.ts

@MetaMask/design-system-engineers

  • app/component-library/components-temp/CustomSpendCap/CustomInput/CustomInput.tsx
  • app/component-library/components-temp/CustomSpendCap/CustomSpendCap.tsx

@MetaMask/earn

Includes Stake UI and Money paths owned via **/Earn/**, **/earn/**, **/Money/**, **/money/**, and app/components/UI/Stake in CODEOWNERS.

  • app/components/UI/Earn/Views/EarnInputView/EarnInputView.test.tsx
  • app/components/UI/Earn/Views/EarnLendingDepositConfirmationView/components/Erc20TokenHero/index.tsx
  • app/components/UI/Earn/Views/EarnLendingDepositConfirmationView/index.tsx
  • app/components/UI/Earn/Views/EarnLendingWithdrawalConfirmationView/index.tsx
  • app/components/UI/Earn/Views/EarnWithdrawInputView/EarnWithdrawInputView.tsx
  • app/components/UI/Earn/components/EarnLendingBalance/index.tsx
  • app/components/UI/Earn/components/Earnings/EarningsHistory/EarningsHistory.utils.ts
  • app/components/UI/Earn/components/InputDisplay/InputDisplay.test.tsx
  • app/components/UI/Earn/hooks/useEarnGasFee.ts
  • app/components/UI/Earn/hooks/useEarnInput.ts
  • app/components/UI/Earn/hooks/useEarnings.ts
  • app/components/UI/Earn/hooks/useInput.ts
  • app/components/UI/Earn/hooks/useMultichainInputHandlers.ts
  • app/components/UI/Earn/hooks/useMusdBalance.ts
  • app/components/UI/Earn/hooks/useMusdCtaVisibility.ts
  • app/components/UI/Earn/utils/number.ts
  • app/components/UI/Earn/utils/token/index.ts
  • app/components/UI/Earn/utils/tron.ts
  • app/components/UI/Money/constants/activityStyles.ts
  • app/components/UI/Money/hooks/useMoneyAccountBalance.ts
  • app/components/UI/Money/utils/moneyActivityFiat.ts
  • app/components/UI/Stake/components/StakingBalance/StakingBanners/ClaimBanner/ClaimBanner.tsx
  • app/components/UI/Stake/components/StakingConfirmation/TokenValueStack/TokenValueStack.test.tsx
  • app/components/UI/Stake/components/StakingConfirmation/TokenValueStack/TokenValueStack.tsx
  • app/components/UI/Stake/components/StakingConfirmation/YouReceiveCard/YouReceiveCard.test.tsx
  • app/components/UI/Stake/components/StakingConfirmation/YouReceiveCard/YouReceiveCard.tsx
  • app/components/UI/Stake/hooks/useBalance.ts
  • app/components/Views/confirmations/hooks/earn/useCustomAmount.tsx
  • app/selectors/earnController/earn/index.ts

@MetaMask/metamask-assets

  • app/components/UI/AssetOverview/Price/Price.advanced.tsx
  • app/components/UI/AssetOverview/Price/Price.legacy.tsx
  • app/components/UI/AssetOverview/utils/marketDetails.ts
  • app/components/UI/CollectibleOverview/index.js
  • app/components/UI/Tokens/util/deriveBalanceFromAssetMarketDetails.test.ts
  • app/components/UI/Tokens/util/deriveBalanceFromAssetMarketDetails.ts
  • app/components/Views/AssetDetails/index.tsx
  • app/components/Views/DetectedTokens/components/Token.tsx
  • app/selectors/assets/assets-list.ts

@MetaMask/mobile-core-ux

  • app/components/UI/TransactionElement/utils-gas.js
  • app/components/UI/TransactionElement/utils.js
  • app/components/Views/UnifiedTransactionsView/useUnifiedTxActions.test.ts
  • app/util/networks/index.js

@MetaMask/mobile-platform

  • app/core/Engine/Engine.ts

@MetaMask/money-movement

  • app/components/UI/Ramp/Aggregator/Views/BuildQuote/BuildQuote.test.tsx
  • app/components/UI/Ramp/Aggregator/Views/BuildQuote/BuildQuote.tsx
  • app/components/UI/Ramp/Aggregator/Views/OrdersList/OrdersList.tsx
  • app/components/UI/Ramp/Aggregator/Views/SendTransaction/SendTransaction.tsx
  • app/components/UI/Ramp/Aggregator/components/OrderDetails.tsx
  • app/components/UI/Ramp/Aggregator/components/OrderListItem/OrderListItem.tsx
  • app/components/UI/Ramp/Aggregator/components/Quote/Quote.tsx
  • app/components/UI/Ramp/Aggregator/hooks/useBalance.test.ts
  • app/components/UI/Ramp/Aggregator/hooks/useBalance.ts
  • app/components/UI/Ramp/Aggregator/hooks/useERC20GasLimitEstimation.ts
  • app/components/UI/Ramp/Aggregator/hooks/useHandleSuccessfulOrder.ts
  • app/components/UI/Ramp/Aggregator/hooks/useIntentAmount.ts
  • app/components/UI/Ramp/Aggregator/utils/index.ts
  • app/components/UI/Ramp/Deposit/utils/index.ts
  • app/components/UI/Ramp/utils/getOrderAmount.ts
  • app/components/UI/Ramp/utils/v2OrderToast.ts

@MetaMask/notifications

  • app/components/UI/Notification/TransactionNotification/index.js

@MetaMask/social-ai

  • app/components/Views/SocialLeaderboard/TraderPositionView/components/QuickBuyBottomSheet/useQuickBuyBottomSheet.ts
  • app/components/Views/SocialLeaderboard/TraderPositionView/components/QuickBuyBottomSheet/useQuickBuyQuotes.ts
  • app/components/Views/SocialLeaderboard/utils/formatters.ts

@MetaMask/swaps-engineers

  • app/components/UI/Bridge/components/QuoteSelectorView/QuoteRow.tsx
  • app/components/UI/Bridge/components/QuoteSelectorView/index.tsx
  • app/components/UI/Bridge/hooks/useBridgeQuoteData/index.ts
  • app/components/UI/Bridge/hooks/useFormattedBalanceWithThreshold/index.ts
  • app/components/UI/Bridge/hooks/useHasSufficientGas/index.ts
  • app/components/UI/Bridge/hooks/useInsufficientBalance/index.ts
  • app/components/UI/Bridge/hooks/useTokenBalanceInUsd/index.ts
  • app/components/UI/Bridge/hooks/useTokensWithBalance/index.ts
  • app/components/UI/Bridge/utils/exchange-rates.ts
  • app/components/UI/Bridge/utils/formatNetworkFee.test.ts
  • app/components/UI/Bridge/utils/formatNetworkFee.ts
  • app/components/UI/Bridge/utils/transaction-history.ts

@MetaMask/transactions and @MetaMask/confirmations (co-owned)

  • app/util/transactions/index.js
  • app/util/transactions/index.test.ts

No matching CODEOWNERS rule yet

These burndown paths did not match any owner line in .github/CODEOWNERS at the time this section was added. Coordinate migration with the relevant feature DRI or extend CODEOWNERS so reviews route correctly.

  • app/components/UI/AccountInfoCard/index.js
  • app/components/UI/HardwareWallet/AccountDetails/index.tsx
  • app/components/UI/MultichainBridgeTransactionListItem/MultichainBridgeTransactionListItem.tsx
  • app/components/UI/UrlAutocomplete/Result.tsx
  • app/components/Views/GasEducationCarousel/index.js
  • app/components/Views/NetworksManagement/NetworkDetailsView/hooks/useNetworkValidation.ts
  • app/components/hooks/useAddressBalance/useAddressBalance.ts
  • app/components/hooks/useGetFormattedTokensPerChain.tsx
  • app/components/hooks/useGetTotalFiatBalanceCrossChains.tsx
  • app/core/GasPolling/GasPolling.ts
  • app/core/NotificationManager.js
  • app/selectors/multichain/evm.ts

Function mapping (A → Z)

Legacy (index.js) BigInt (bigint.ts) Notes
hexToBN(hex) hexToBigInt(hex) Returns bigint instead of BN
BNToHex(bn) bigIntToHex(bi) Accepts bigint, returns 0x-prefixed string
safeBNToHex(value) safeBigIntToHex(value) Null-safe wrapper
safeNumberToBN(value) safeNumberToBigInt(value) Truncates decimals, returns bigint
isBN(value) isBigInt(value) Checks typeof value === 'bigint'
toBN(value) BigInt(value) Direct native constructor
fromWei(value, unit) fromWei(value, unit) Same API, accepts bigint input
toWei(value, unit) toWei(value, unit) Returns bigint instead of BN
fromTokenMinimalUnit(v, d) fromTokenMinimalUnit(v, d) Same API, accepts bigint input
toTokenMinimalUnit(v, d) toTokenMinimalUnit(v, d) Returns bigint instead of BN
renderFromWei(v) renderFromWei(v) Identical API and output
renderFromTokenMinimalUnit(v, d) renderFromTokenMinimalUnit(v, d) Identical API and output
weiToFiat(wei, rate, currency) weiToFiat(wei, rate, currency) Accepts bigint directly (no .toString() needed)
weiToFiatNumber(wei, rate, dec) weiToFiatNumber(wei, rate, dec) Accepts bigint directly
balanceToFiat(...) balanceToFiat(...) Same API
balanceToFiatNumber(...) balanceToFiatNumber(...) Same API
fiatNumberToWei(fiat, rate) fiatNumberToWei(fiat, rate) Returns bigint instead of BN
fiatNumberToTokenMinimalUnit(...) fiatNumberToTokenMinimalUnit(...) Returns bigint instead of BN
addHexPrefix(str) addHexPrefix(str) Behavior diverges for uppercase 0X prefixes (legacy bug fixed in bigint) — see note below
renderNumber(str) renderNumber(str) Behavior diverges for integer strings — see note below
toHexadecimal(dec) toHexadecimal(dec) null/undefined pass through (same as legacy); minor difference for other falsy inputs (0, '') — see note below
isZeroValue(v) isZeroValue(v) Same behavior, also accepts bigint
calculateEthFeeForMultiLayer(p) calculateEthFeeForMultiLayer(p) Same API
conversionUtil(...) conversionUtil(...) Same API

Functions with identical names (e.g. fromWei, renderFromWei) have the same API — just change the import path.

renderNumber behavior change

The bigint renderNumber fixes a long-standing bug in the legacy implementation:

// Legacy (index.js): if (index === 0) return number;
// BigInt (bigint.ts): if (index === -1) return number;

indexOf('.') returns -1 when the string has no decimal point, not 0. The legacy check is a typo, so for integer-only strings legacy falls through to substring(0, -1 + 6) which truncates the value to its first 5 characters.

Input Legacy output BigInt output
'1.123456789' '1.12345' '1.12345'
'1.123' '1.123' '1.123'
'12345' '12345' '12345'
'123456' '12345' ⚠️ '123456'
'123456789' '12345' ⚠️ '123456789'
'.123' '.123' '.123'

In practice this affects integer-valued crypto amounts ≥ 100,000 displayed by the Ramp / Bridge / Deposit notification flows (the only call sites). Migrating to the bigint version will cause those values to render with their full integer portion instead of being silently chopped to 5 characters. This is a fix, but it is a visible behavioral change — verify your feature tolerates it before switching.

addHexPrefix behavior change

The bigint addHexPrefix fixes another long-standing bug in the legacy implementation: how it handles uppercase 0X prefixes.

// Legacy (index.js)
export const addHexPrefix = (str) => {
  if (typeof str !== 'string' || str.match(regex.hexPrefix)) {
    return str; // (1)
  }

  if (str.match(regex.hexPrefix)) {
    // (2) unreachable — same regex as (1)
    return str.replace('0X', '0x');
  }

  if (str.startsWith('-')) {
    return str.replace('-', '-0x'); // (3) runs even for '-0X…'
  }

  return `0x${str}`; // (4) runs for '0X…'
};

regex.hexPrefix is /^-?0x/u — case-sensitive. So the early-return at (1) only matches lowercase 0x / -0x; uppercase variants fall through. Branch (2) repeats the same regex, so it can never run, and the intended 0X → 0x normalization is unreachable. Uppercase inputs end up in (3) or (4), producing malformed strings.

The bigint version replaces (2) with str.match(/^-?0X/u) so uppercase prefixes are correctly normalized to lowercase before returning.

Input Legacy output BigInt output
'0x1a2b' '0x1a2b' '0x1a2b'
'1a2b' '0x1a2b' '0x1a2b'
'-1a2b' '-0x1a2b' '-0x1a2b'
'0X1A2B' '0x0X1A2B' ⚠️ '0x1A2B'
'-0X1A2B' '-0x0X1A2B' ⚠️ '-0x1A2B'

In practice, all known production call sites pass lowercase hex strings (or strings that don't start with a prefix at all), so the divergence is unlikely to affect production. But because the parity tests for these inputs are describe.skip'd as a known-divergent case, the bigint version is not a guaranteed-identical drop-in for addHexPrefix when callers might pass uppercase 0X prefixes — verify your input shape before migrating.

Arithmetic migration

BN.js uses method chains. Native BigInt uses operators.

// Addition
bn1.add(bn2)          →  bi1 + bi2

// Subtraction
bn1.sub(bn2)          →  bi1 - bi2

// Multiplication
bn1.mul(bn2)          →  bi1 * bi2

// Division (integer)
bn1.div(bn2)          →  bi1 / bi2

// Modulo
bn1.mod(bn2)          →  bi1 % bi2

// Negation
bn1.neg()             →  -bi1

// Absolute value
bn1.abs()             →  bigIntAbs(bi1)   // or: bi1 < 0n ? -bi1 : bi1

// Exponentiation
bn1.pow(bn2)          →  bi1 ** bi2

Comparison migration

// Equality
bn1.eq(bn2)           →  bi1 === bi2

// Greater than
bn1.gt(bn2)           →  bi1 > bi2

// Greater than or equal
bn1.gte(bn2)          →  bi1 >= bi2

// Less than
bn1.lt(bn2)           →  bi1 < bi2

// Less than or equal
bn1.lte(bn2)          →  bi1 <= bi2

// Zero check
bn1.isZero()          →  bi1 === 0n

Conversion / serialization

// To decimal string
bn.toString(10)       →  bi.toString(10)    // or bi.toString()

// To hex string
bn.toString(16)       →  bi.toString(16)
bn.toString('hex')    →  bi.toString(16)

// To 0x-prefixed hex
BNToHex(bn)           →  bigIntToHex(bi)

// From 0x-prefixed hex
hexToBN(hex)          →  hexToBigInt(hex)

Common migration patterns

Pattern 1: Hex balance → fiat

// BEFORE
const balanceBN = hexToBN(balanceHex);
const stakedBN = hexToBN(stakedHex || '0x00');
const totalHex = balanceBN.add(stakedBN).toString('hex');
const fiat = weiToFiatNumber(totalHex, conversionRate, 2);

// AFTER
const balance = hexToBigInt(balanceHex);
const staked = hexToBigInt(stakedHex || '0x00');
const fiat = weiToFiatNumber(balance + staked, conversionRate, 2);

Pattern 2: Native ETH send (value encoding)

// BEFORE
import { BNToHex, toWei } from '../util/number';
trxnParams.value = BNToHex(toWei(value ?? '0'));

// AFTER
import { bigIntToHex, toWei } from '../util/number/bigint';
trxnParams.value = bigIntToHex(toWei(value ?? '0'));

Pattern 3: ERC-20 token amount encoding

// BEFORE
import { BNToHex, toTokenMinimalUnit } from '../util/number';
const amount = toTokenMinimalUnit(value, decimals);
const data = generateTransferData('transfer', {
  toAddress: to,
  amount: BNToHex(amount),
});

// AFTER
import { bigIntToHex, toTokenMinimalUnit } from '../util/number/bigint';
const amount = toTokenMinimalUnit(value, decimals);
const data = generateTransferData('transfer', {
  toAddress: to,
  amount: bigIntToHex(amount),
});

Pattern 4: Zero check on hex balance

// BEFORE
hexToBN(stakedBalance).isZero();

// AFTER
hexToBigInt(stakedBalance) === 0n;

Pattern 5: Fiat display for a balance

// BEFORE
weiToFiat(hexToBN(balance) as any, rate, 'usd');

// AFTER
weiToFiat(hexToBigInt(balance), rate, 'usd');

Pattern 6: Rendering wei for display

// BEFORE & AFTER are identical — renderFromWei accepts hex strings directly:
renderFromWei(balanceHex);

Gotchas

1. BigInt cannot mix with Number in arithmetic

// ERROR — will throw at runtime
const result = 1n + 2;

// CORRECT — both operands must be the same type
const result = 1n + 2n;
const result = 1n + BigInt(someNumber);

2. BigInt division truncates (no decimals)

// BigInt division is integer division
5n / 2n === 2n; // not 2.5

// For fractional results, convert to string first then use BigNumber or parseFloat
const ethString = fromWei(weiBigInt); // returns string like "1.5"
const ethFloat = parseFloat(ethString);

3. BigInt cannot be serialized to JSON directly

JSON.stringify(1n); // throws TypeError

// Convert to string or number first
JSON.stringify(bi.toString());
JSON.stringify(Number(bi)); // only safe for values < 2^53

4. BigInt is not instanceof anything

// BN.js
value instanceof BN; // works

// BigInt
value instanceof BigInt; // ERROR — BigInt is not a constructor
typeof value === 'bigint'; // correct check
isBigInt(value); // utility from bigint.ts

5. BigInt comparisons use ===, not .eq()

// BigInt literals need the n suffix
if (balance === 0n) { ... }   // correct
if (balance === 0) { ... }    // always false — different types
if (balance == 0) { ... }     // works but avoid loose equality

6. toWei / toTokenMinimalUnit return bigint, not BN

If your code chains BN methods on the result, you need to switch to BigInt operators:

// BEFORE
toWei('1').add(toWei('2'));

// AFTER
toWei('1') + toWei('2');

7. toHexadecimal falsy-input handling

Both the legacy and BigInt versions pass null and undefined through unchanged — there is no divergence for those inputs.

The implementations differ for non-null falsy inputs:

Input Legacy BigInt
null null null
undefined undefined undefined
0 0 (number) '0' (string)
'' '' '0'

Legacy short-circuits via if (!decimal) return decimal;, so any falsy value is passed through as-is (including the raw number 0 and the empty string). BigInt narrows that guard to decimal == null, so 0 and '' fall through to BigInt(String(decimal)).toString(16) and produce the string '0'.

In practice all known call sites pass non-empty hex / decimal strings, so this divergence is unlikely to affect production. If your call site can pass raw 0 or '' and downstream code distinguishes them from '0', normalize the input before switching imports.

Migration checklist

For each file you migrate:

  1. Change imports from ../util/number (or ../util/number/index) to ../util/number/bigint
  2. Replace hexToBN → hexToBigInt, BNToHex → bigIntToHex
  3. Replace BN method chains with native operators (+, -, *, ===, >, etc.)
  4. Replace .isZero() with === 0n
  5. Replace .toString('hex') with .toString(16) or bigIntToHex()
  6. Remove any as any or as unknown as BN casts (no longer needed)
  7. Update type annotations from BN to bigint
  8. Run yarn jest <your-file> to confirm tests pass
  9. Run yarn lint:tsc to confirm no type errors

Parity tests

Two test suites verify that the BigInt module produces identical results to the legacy module:

  • app/util/number/bigint-parity.test.ts — Function-by-function parity (94 tests)
  • app/util/number/bigint-migration-reference.test.ts — Call-site-specific migration patterns

Run them to confirm the safety net is green before and after your migration:

yarn jest app/util/number/bigint-parity.test.ts
yarn jest app/util/number/bigint-migration-reference.test.ts

Files identified for migration

These are the hot-path call-sites identified so far (see bigint-migration-reference.test.ts for exact before/after patterns):

# File Pattern
1 app/core/Engine/Engine.ts hexToBN + .add() + weiToFiatNumber
2 app/components/hooks/useGetTotalFiatBalanceCrossChains.tsx Same as #1, in a loop
3 app/selectors/multichain/evm.ts hexToBN + weiToFiat + .isZero()
4 app/selectors/assets/assets-list.ts hexToBN + weiToFiatNumber + fromWei
5 app/selectors/earnController/earn/index.ts hexToBN + conditional selection + weiToFiatNumber
6 app/components/Views/confirmations/context/send-context/utils.ts BNToHex(toWei(...)) + BNToHex(toTokenMinimalUnit(...))
7 app/components/UI/Ramp/Aggregator/hooks/useBalance.ts hexToBN
8 app/components/UI/Stake/hooks/useBalance.ts hexToBN