@gibs/bridge-sdk 1.13.1 → 1.18.0

package/dist/cjs/routing/usd-value.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The United States dollar value of a base-unit token amount at a given price, as
+ * a NUMBER — the numeric core of the user interface's `formatFiatValue` without the
+ * currency string. Returns null when the token is unpriced (`price` is null) or the
+ * computed value is not finite, mirroring the "return null for invalid state"
+ * convention so callers can fall back.
+ *
+ * @param params.balance - the amount in base units
+ * @param params.decimals - the token's decimals
+ * @param params.price - the token's United States dollar price, or null when unpriced
+ * @returns the dollar value as a number, or null
+ */
+export declare const usdValueOfAmount: (params: {
+    balance: bigint;
+    decimals: number;
+    price: number | null;
+}) => number | null;

package/dist/cjs/routing/usd-value.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usdValueOfAmount = void 0;
+const viem_1 = require("viem");
+/**
+ * The United States dollar value of a base-unit token amount at a given price, as
+ * a NUMBER — the numeric core of the user interface's `formatFiatValue` without the
+ * currency string. Returns null when the token is unpriced (`price` is null) or the
+ * computed value is not finite, mirroring the "return null for invalid state"
+ * convention so callers can fall back.
+ *
+ * @param params.balance - the amount in base units
+ * @param params.decimals - the token's decimals
+ * @param params.price - the token's United States dollar price, or null when unpriced
+ * @returns the dollar value as a number, or null
+ */
+const usdValueOfAmount = (params) => {
+    const { balance, decimals, price } = params;
+    if (price === null)
+        return null;
+    const whole = Number((0, viem_1.formatUnits)(balance, decimals));
+    if (!Number.isFinite(whole))
+        return null;
+    const value = whole * price;
+    if (!Number.isFinite(value))
+        return null;
+    return value;
+};
+exports.usdValueOfAmount = usdValueOfAmount;