@mezo-org/passport 0.4.0-dev.14 → 0.4.0-dev.15

package/dist/src/hooks/index.d.ts

@@ -9,5 +9,5 @@ export * from "./useSignInWithWallet";
 export * from "./useSignOut";
 export * from "./useSignUpWithWallet";
 export * from "./useUpdateMezoId";
-export * from "./useUpdatePassport";
+export * from "./useRefreshPassport";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,kDAAkD,EAClD,4BAA4B,EAC5B,oDAAoD,GACrD,MAAM,qBAAqB,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,kDAAkD,EAClD,4BAA4B,EAC5B,oDAAoD,GACrD,MAAM,qBAAqB,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA"}

package/dist/src/hooks/index.js

@@ -9,5 +9,5 @@ export * from "./useSignInWithWallet";
 export * from "./useSignOut";
 export * from "./useSignUpWithWallet";
 export * from "./useUpdateMezoId";
-export * from "./useUpdatePassport";
+export * from "./useRefreshPassport";
 //# sourceMappingURL=index.js.map

package/dist/src/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,kDAAkD,EAClD,4BAA4B,EAC5B,oDAAoD,GACrD,MAAM,qBAAqB,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,kDAAkD,EAClD,4BAA4B,EAC5B,oDAAoD,GACrD,MAAM,qBAAqB,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA"}

package/dist/src/hooks/useRefreshPassport.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Hook to update the passport using query invalidation mechanism.
+ * By calling the update function, the latest data will be refetched as soon as possible.
+ *
+ * @example
+ * const { updateCurrentAccount, updateUsdConversion } = useRefreshPassport()
+ *
+ * // Call this function to update the current account
+ * const handleUpdateCurrentAccount = async () => {
+ *   await updateCurrentAccount()
+ * }
+ */
+export declare function useRefreshPassport(): {
+    updateCurrentAccount: () => Promise<void>;
+    updateUsdConversion: () => Promise<void>;
+};
+//# sourceMappingURL=useRefreshPassport.d.ts.map

package/dist/src/hooks/useRefreshPassport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefreshPassport.d.ts","sourceRoot":"","sources":["../../../src/hooks/useRefreshPassport.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB;;;EAuBjC"}

package/dist/src/hooks/useRefreshPassport.js

@@ -0,0 +1,29 @@
+import { useQueryClient } from "@tanstack/react-query";
+import { useCallback } from "react";
+import { QUERY_KEYS } from "./constants";
+/**
+ * Hook to update the passport using query invalidation mechanism.
+ * By calling the update function, the latest data will be refetched as soon as possible.
+ *
+ * @example
+ * const { updateCurrentAccount, updateUsdConversion } = useRefreshPassport()
+ *
+ * // Call this function to update the current account
+ * const handleUpdateCurrentAccount = async () => {
+ *   await updateCurrentAccount()
+ * }
+ */
+export function useRefreshPassport() {
+    const queryClient = useQueryClient();
+    const updateCurrentAccount = useCallback(() => queryClient.invalidateQueries({
+        queryKey: [QUERY_KEYS.ACCOUNT, QUERY_KEYS.CURRENT],
+    }), [queryClient]);
+    const updateUsdConversion = useCallback(() => queryClient.invalidateQueries({
+        queryKey: [QUERY_KEYS.ASSETS_USD_CONVERSION],
+    }), [queryClient]);
+    return {
+        updateCurrentAccount,
+        updateUsdConversion,
+    };
+}
+//# sourceMappingURL=useRefreshPassport.js.map

package/dist/src/hooks/useRefreshPassport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefreshPassport.js","sourceRoot":"","sources":["../../../src/hooks/useRefreshPassport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IAEpC,MAAM,oBAAoB,GAAG,WAAW,CACtC,GAAG,EAAE,CACH,WAAW,CAAC,iBAAiB,CAAC;QAC5B,QAAQ,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC;KACnD,CAAC,EACJ,CAAC,WAAW,CAAC,CACd,CAAA;IAED,MAAM,mBAAmB,GAAG,WAAW,CACrC,GAAG,EAAE,CACH,WAAW,CAAC,iBAAiB,CAAC;QAC5B,QAAQ,EAAE,CAAC,UAAU,CAAC,qBAAqB,CAAC;KAC7C,CAAC,EACJ,CAAC,WAAW,CAAC,CACd,CAAA;IAED,OAAO;QACL,oBAAoB;QACpB,mBAAmB;KACpB,CAAA;AACH,CAAC"}

package/dist/src/utils/numbers.test.js

@@ -1,4 +1,6 @@
 import { formatNumberToCompactString, fromFixedPoint, roundUpNumber, } from "./numbers";
+import { formatNumberToLocaleString } from "./numbers";
+import { fromFixedPointToString } from "./numbers";
 describe("formatNumberToCompactString", () => {
     it("formats number less than 1000 with decimals", () => {
         expect(formatNumberToCompactString(123.456789, 2)).toBe("123.46");
@@ -51,4 +53,128 @@ describe("fromFixedPoint", () => {
         expect(fromFixedPoint(raw, 6, 2)).toBe(1000000000000000000);
     });
 });
+describe("formatNumberToLocaleString", () => {
+    it("formats zero with 0 decimals", () => {
+        expect(formatNumberToLocaleString(0, 0)).toBe("0");
+    });
+    it("formats zero with >0 decimals", () => {
+        expect(formatNumberToLocaleString(0, 2)).toBe("0.00");
+        expect(formatNumberToLocaleString(0, 4)).toBe("0.0000");
+    });
+    it("formats small decimal number", () => {
+        expect(formatNumberToLocaleString(0.123456, 2)).toBe("0.12");
+        expect(formatNumberToLocaleString(0.123456, 4)).toBe("0.1235");
+    });
+    it("formats number just above 1", () => {
+        expect(formatNumberToLocaleString(1.000001, 3)).toBe("1.000");
+        expect(formatNumberToLocaleString(1.234567, 2)).toBe("1.23");
+    });
+    it("formats whole number", () => {
+        expect(formatNumberToLocaleString(1234, 0)).toBe("1,234");
+        expect(formatNumberToLocaleString(1000, 2)).toBe("1,000.00");
+    });
+    it("formats number with trailing decimal zeroes", () => {
+        expect(formatNumberToLocaleString(10.1, 3)).toBe("10.100");
+        expect(formatNumberToLocaleString(5.0, 2)).toBe("5.00");
+    });
+    it("formats string input", () => {
+        expect(formatNumberToLocaleString("123.456", 2)).toBe("123.46");
+        expect(formatNumberToLocaleString("0.00123", 4)).toBe("0.0012");
+    });
+    it("formats negative number", () => {
+        expect(formatNumberToLocaleString(-123.456, 2)).toBe("-123.46");
+        expect(formatNumberToLocaleString("-0.00999", 3)).toBe("-0.010");
+    });
+    it("formats large number with commas", () => {
+        expect(formatNumberToLocaleString(12345678.9, 2)).toBe("12,345,678.90");
+    });
+    it("handles max decimals safely", () => {
+        expect(formatNumberToLocaleString(1.123456789, 8)).toBe("1.12345679");
+        expect(formatNumberToLocaleString("0.000000000000000001", 18)).toBe("0.000000000000000001");
+    });
+    it("defaults to 0 decimals if not passed", () => {
+        expect(formatNumberToLocaleString(1234.567)).toBe("1,235"); // rounds up by default
+    });
+    it("respects locale formatting", () => {
+        const val = 1234567.89;
+        const formatted = val.toLocaleString("default", {
+            minimumFractionDigits: 2,
+            maximumFractionDigits: 2,
+        });
+        expect(formatNumberToLocaleString(val, 2)).toBe(formatted);
+    });
+});
+describe("fromFixedPointToString", () => {
+    const toFixedPoint = (num) => BigInt(Math.round(num * 1e18));
+    const cases = [
+        { input: 2.0, expected: "2.000" },
+        { input: 2.009, expected: "2.009" },
+        { input: 2.01, expected: "2.010" },
+        { input: 2.015, expected: "2.016" },
+        { input: 2.05, expected: "2.050" },
+        { input: 2.09, expected: "2.090" },
+    ];
+    describe("withRoundUp: true", () => {
+        cases.forEach(({ input, expected }) => {
+            it(`formats ${input} → ${expected}`, () => {
+                const fixed = toFixedPoint(input);
+                expect(fromFixedPointToString(fixed, 18, 3, true)).toBe(expected);
+            });
+        });
+    });
+    describe("withRoundUp: false", () => {
+        const noRoundCases = [
+            { input: 2.0099, expected: "2.009" },
+            { input: 2.0159, expected: "2.015" },
+            { input: 2.0101, expected: "2.010" },
+            { input: 2.0199, expected: "2.019" },
+        ];
+        noRoundCases.forEach(({ input, expected }) => {
+            it(`formats ${input} → ${expected} (no rounding)`, () => {
+                const fixed = toFixedPoint(input);
+                expect(fromFixedPointToString(fixed, 18, 3, false)).toBe(expected);
+            });
+        });
+    });
+    describe("zero handling", () => {
+        it("formats 0 → 0.000 (3 decimals)", () => {
+            expect(fromFixedPointToString(0n, 18, 3)).toBe("0.000");
+        });
+        it("formats 0 → 0.0000 (4 decimals)", () => {
+            expect(fromFixedPointToString(0n, 18, 4)).toBe("0.0000");
+        });
+    });
+    describe("very small numbers below display threshold", () => {
+        it("returns <0.0001 for small number (3 decimals)", () => {
+            const small = BigInt(123); // ~1.23e-16
+            expect(fromFixedPointToString(small, 18, 4)).toBe("<0.0001");
+        });
+        it("returns <0.01 for small number with only 2 decimals", () => {
+            const tiny = BigInt(9999999999999); // <0.01
+            expect(fromFixedPointToString(tiny, 18, 2)).toBe("<0.01");
+        });
+    });
+    describe("input types", () => {
+        it("accepts bigint", () => {
+            const amount = 2100000000000000000n;
+            expect(fromFixedPointToString(amount, 18, 3)).toBe("2.100");
+        });
+        it("accepts string", () => {
+            expect(fromFixedPointToString("2000000000000000000", 18, 3)).toBe("2.000");
+        });
+        it("accepts number", () => {
+            expect(fromFixedPointToString(Number("1000000000000000000"), 18, 3)).toBe("1.000");
+        });
+    });
+    describe("high values", () => {
+        it("formats 1_000_000.123456789 correctly", () => {
+            const big = toFixedPoint(1_000_000.123456789);
+            expect(fromFixedPointToString(big, 18, 6)).toBe("1,000,000.123457");
+        });
+        it("formats 1e12 ETH", () => {
+            const big = BigInt("1000000000000000000000000000000");
+            expect(fromFixedPointToString(big, 18, 2)).toBe("1,000,000,000,000.00");
+        });
+    });
+});
 //# sourceMappingURL=numbers.test.js.map

package/dist/src/utils/numbers.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.test.js","sourceRoot":"","sources":["../../../src/utils/numbers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,aAAa,GACd,MAAM,WAAW,CAAA;AAElB,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,2BAA2B,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,2BAA2B,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,2BAA2B,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,2BAA2B,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,2BAA2B,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,2BAA2B,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAC/D,eAAe,CAChB,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,CAAA,CAAC,OAAO;QACnC,MAAM,CAAC,2BAA2B,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,2BAA2B,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,GAAG,GAAG,oBAAoB,CAAA,CAAC,gCAAgC;QACjE,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG,mBAAmB,CAAA,CAAC,mBAAmB;QACnD,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,GAAG,GAAG,0BAAkC,CAAA,CAAC,qBAAqB;QACpE,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"numbers.test.js","sourceRoot":"","sources":["../../../src/utils/numbers.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mezo-org/passport",
-  "version": "0.4.0-dev.14",
+  "version": "0.4.0-dev.15",
   "main": "dist/src/index.js",
   "license": "GPL-3.0-only",
   "scripts": {

package/src/hooks/index.ts

@@ -16,4 +16,4 @@ export * from "./useSignInWithWallet"
 export * from "./useSignOut"
 export * from "./useSignUpWithWallet"
 export * from "./useUpdateMezoId"
-export * from "./useUpdatePassport"
+export * from "./useRefreshPassport"

package/src/hooks/{useUpdatePassport.ts → useRefreshPassport.ts}

@@ -7,14 +7,14 @@ import { QUERY_KEYS } from "./constants"
  * By calling the update function, the latest data will be refetched as soon as possible.
  *
  * @example
- * const { updateCurrentAccount, updateUsdConversion } = useUpdatePassport()
+ * const { updateCurrentAccount, updateUsdConversion } = useRefreshPassport()
  *
  * // Call this function to update the current account
  * const handleUpdateCurrentAccount = async () => {
  *   await updateCurrentAccount()
  * }
  */
-export function useUpdatePassport() {
+export function useRefreshPassport() {
   const queryClient = useQueryClient()
 
   const updateCurrentAccount = useCallback(

package/src/utils/numbers.test.ts

@@ -4,6 +4,10 @@ import {
   roundUpNumber,
 } from "./numbers"
 
+import { formatNumberToLocaleString } from "./numbers"
+
+import { fromFixedPointToString } from "./numbers"
+
 describe("formatNumberToCompactString", () => {
   it("formats number less than 1000 with decimals", () => {
     expect(formatNumberToCompactString(123.456789, 2)).toBe("123.46")
@@ -71,3 +75,158 @@ describe("fromFixedPoint", () => {
     expect(fromFixedPoint(raw, 6, 2)).toBe(1000000000000000000)
   })
 })
+
+describe("formatNumberToLocaleString", () => {
+  it("formats zero with 0 decimals", () => {
+    expect(formatNumberToLocaleString(0, 0)).toBe("0")
+  })
+
+  it("formats zero with >0 decimals", () => {
+    expect(formatNumberToLocaleString(0, 2)).toBe("0.00")
+    expect(formatNumberToLocaleString(0, 4)).toBe("0.0000")
+  })
+
+  it("formats small decimal number", () => {
+    expect(formatNumberToLocaleString(0.123456, 2)).toBe("0.12")
+    expect(formatNumberToLocaleString(0.123456, 4)).toBe("0.1235")
+  })
+
+  it("formats number just above 1", () => {
+    expect(formatNumberToLocaleString(1.000001, 3)).toBe("1.000")
+    expect(formatNumberToLocaleString(1.234567, 2)).toBe("1.23")
+  })
+
+  it("formats whole number", () => {
+    expect(formatNumberToLocaleString(1234, 0)).toBe("1,234")
+    expect(formatNumberToLocaleString(1000, 2)).toBe("1,000.00")
+  })
+
+  it("formats number with trailing decimal zeroes", () => {
+    expect(formatNumberToLocaleString(10.1, 3)).toBe("10.100")
+    expect(formatNumberToLocaleString(5.0, 2)).toBe("5.00")
+  })
+
+  it("formats string input", () => {
+    expect(formatNumberToLocaleString("123.456", 2)).toBe("123.46")
+    expect(formatNumberToLocaleString("0.00123", 4)).toBe("0.0012")
+  })
+
+  it("formats negative number", () => {
+    expect(formatNumberToLocaleString(-123.456, 2)).toBe("-123.46")
+    expect(formatNumberToLocaleString("-0.00999", 3)).toBe("-0.010")
+  })
+
+  it("formats large number with commas", () => {
+    expect(formatNumberToLocaleString(12345678.9, 2)).toBe("12,345,678.90")
+  })
+
+  it("handles max decimals safely", () => {
+    expect(formatNumberToLocaleString(1.123456789, 8)).toBe("1.12345679")
+    expect(formatNumberToLocaleString("0.000000000000000001", 18)).toBe(
+      "0.000000000000000001",
+    )
+  })
+
+  it("defaults to 0 decimals if not passed", () => {
+    expect(formatNumberToLocaleString(1234.567)).toBe("1,235") // rounds up by default
+  })
+
+  it("respects locale formatting", () => {
+    const val = 1234567.89
+    const formatted = val.toLocaleString("default", {
+      minimumFractionDigits: 2,
+      maximumFractionDigits: 2,
+    })
+
+    expect(formatNumberToLocaleString(val, 2)).toBe(formatted)
+  })
+})
+
+describe("fromFixedPointToString", () => {
+  const toFixedPoint = (num: number) => BigInt(Math.round(num * 1e18))
+
+  const cases = [
+    { input: 2.0, expected: "2.000" },
+    { input: 2.009, expected: "2.009" },
+    { input: 2.01, expected: "2.010" },
+    { input: 2.015, expected: "2.016" },
+    { input: 2.05, expected: "2.050" },
+    { input: 2.09, expected: "2.090" },
+  ]
+
+  describe("withRoundUp: true", () => {
+    cases.forEach(({ input, expected }) => {
+      it(`formats ${input} → ${expected}`, () => {
+        const fixed = toFixedPoint(input)
+        expect(fromFixedPointToString(fixed, 18, 3, true)).toBe(expected)
+      })
+    })
+  })
+
+  describe("withRoundUp: false", () => {
+    const noRoundCases = [
+      { input: 2.0099, expected: "2.009" },
+      { input: 2.0159, expected: "2.015" },
+      { input: 2.0101, expected: "2.010" },
+      { input: 2.0199, expected: "2.019" },
+    ]
+
+    noRoundCases.forEach(({ input, expected }) => {
+      it(`formats ${input} → ${expected} (no rounding)`, () => {
+        const fixed = toFixedPoint(input)
+        expect(fromFixedPointToString(fixed, 18, 3, false)).toBe(expected)
+      })
+    })
+  })
+
+  describe("zero handling", () => {
+    it("formats 0 → 0.000 (3 decimals)", () => {
+      expect(fromFixedPointToString(0n, 18, 3)).toBe("0.000")
+    })
+
+    it("formats 0 → 0.0000 (4 decimals)", () => {
+      expect(fromFixedPointToString(0n, 18, 4)).toBe("0.0000")
+    })
+  })
+
+  describe("very small numbers below display threshold", () => {
+    it("returns <0.0001 for small number (3 decimals)", () => {
+      const small = BigInt(123) // ~1.23e-16
+      expect(fromFixedPointToString(small, 18, 4)).toBe("<0.0001")
+    })
+
+    it("returns <0.01 for small number with only 2 decimals", () => {
+      const tiny = BigInt(9999999999999) // <0.01
+      expect(fromFixedPointToString(tiny, 18, 2)).toBe("<0.01")
+    })
+  })
+
+  describe("input types", () => {
+    it("accepts bigint", () => {
+      const amount = 2100000000000000000n
+      expect(fromFixedPointToString(amount, 18, 3)).toBe("2.100")
+    })
+
+    it("accepts string", () => {
+      expect(fromFixedPointToString("2000000000000000000", 18, 3)).toBe("2.000")
+    })
+
+    it("accepts number", () => {
+      expect(fromFixedPointToString(Number("1000000000000000000"), 18, 3)).toBe(
+        "1.000",
+      )
+    })
+  })
+
+  describe("high values", () => {
+    it("formats 1_000_000.123456789 correctly", () => {
+      const big = toFixedPoint(1_000_000.123456789)
+      expect(fromFixedPointToString(big, 18, 6)).toBe("1,000,000.123457")
+    })
+
+    it("formats 1e12 ETH", () => {
+      const big = BigInt("1000000000000000000000000000000")
+      expect(fromFixedPointToString(big, 18, 2)).toBe("1,000,000,000,000.00")
+    })
+  })
+})