@mezo-org/passport 0.5.0 → 0.5.1-dev.0

package/dist/src/components/Dropdown/Root/AccountBalance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccountBalance.d.ts","sourceRoot":"","sources":["../../../../../src/components/Dropdown/Root/AccountBalance.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,UAAU,EAAgB,MAAM,qBAAqB,CAAA;AAS9D,KAAK,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAEvD,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,KAAK,EAAE,mBAAmB,qBAuDhE"}
+{"version":3,"file":"AccountBalance.d.ts","sourceRoot":"","sources":["../../../../../src/components/Dropdown/Root/AccountBalance.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,UAAU,EAAgB,MAAM,qBAAqB,CAAA;AAS9D,KAAK,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAEvD,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,KAAK,EAAE,mBAAmB,qBA8DhE"}

package/dist/src/components/Dropdown/Root/AccountBalance.js

@@ -11,16 +11,20 @@ export default function AccountBalance(props) {
     const { overrides, ...restProps } = props;
     const [, theme] = useStyletron();
     const { nativeBalanceRefetchInterval } = usePassportContext();
-    const { data: tokensBalancesData, isError: isTokensBalancesError, isPending: isTokensBalancesDataPending, } = useTokensBalances({
+    const { data: tokensBalancesData, isError: isTokensBalancesError, isPending: isTokensBalancesDataPending, error: tokensBalancesError, } = useTokensBalances({
         queryOptions: {
             refetchInterval: nativeBalanceRefetchInterval,
         },
     });
-    const { data: borrowData, isError: isBorrowDataError, isPending: isBorrowDataPending, } = useBorrowData();
+    const { data: borrowData, isError: isBorrowDataError, isPending: isBorrowDataPending, error: borrowDataError, } = useBorrowData();
     if (isTokensBalancesDataPending || isBorrowDataPending) {
         return React.createElement(ListingItem, { isLoading: true, overrides: overrides });
     }
     if (isTokensBalancesError || isBorrowDataError) {
+        console.log("isTokensBalancesError: ", isTokensBalancesError);
+        console.log("tokensBalancesError: ", tokensBalancesError);
+        console.log("isBorrowDataError: ", isBorrowDataError);
+        console.log("borrowDataError: ", borrowDataError);
         return (React.createElement(AccountError, { padding: `${theme.sizing.scale500} ${theme.sizing.scale800}`, topic: "account balance", overrides: overrides }));
     }
     const totalBalanceInUsd = Object.values(tokensBalancesData).reduce((acc, tokenBalance) => acc + tokenBalance.usd.value, 0n);

package/dist/src/components/Dropdown/Root/AccountBalance.js.map

@@ -1 +1 @@
-{"version":3,"file":"AccountBalance.js","sourceRoot":"","sources":["../../../../../src/components/Dropdown/Root/AccountBalance.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAc,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,WAAW,MAAM,gBAAgB,CAAA;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,YAAY,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAA;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAItE,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,KAA0B;IAC/D,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAA;IACzC,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,YAAY,EAAE,CAAA;IAChC,MAAM,EAAE,4BAA4B,EAAE,GAAG,kBAAkB,EAAE,CAAA;IAE7D,MAAM,EACJ,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,2BAA2B,GACvC,GAAG,iBAAiB,CAAC;QACpB,YAAY,EAAE;YACZ,eAAe,EAAE,4BAA4B;SAC9C;KACF,CAAC,CAAA;IACF,MAAM,EACJ,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,mBAAmB,GAC/B,GAAG,aAAa,EAAE,CAAA;IAEnB,IAAI,2BAA2B,IAAI,mBAAmB,EAAE,CAAC;QACvD,OAAO,oBAAC,WAAW,IAAC,SAAS,QAAC,SAAS,EAAE,SAAS,GAAI,CAAA;IACxD,CAAC;IAED,IAAI,qBAAqB,IAAI,iBAAiB,EAAE,CAAC;QAC/C,OAAO,CACL,oBAAC,YAAY,IACX,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAC5D,KAAK,EAAC,iBAAiB,EACvB,SAAS,EAAE,SAAS,GACpB,CACH,CAAA;IACH,CAAC;IAED,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAChE,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EACnD,EAAE,CACH,CAAA;IAED,MAAM,kBAAkB,GAAG,MAAM,CAC/B,WAAW,CAAC,iBAAiB,EAAE,wBAAwB,CAAC,CACzD,CAAA;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;IAE9D,OAAO,CACL,oBAAC,WAAW,IACV,KAAK,EAAC,cAAc,EACpB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAC,mBAAmB,EAC5B,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,SAAS,KAChB,SAAS,GACb,CACH,CAAA;AACH,CAAC"}
+{"version":3,"file":"AccountBalance.js","sourceRoot":"","sources":["../../../../../src/components/Dropdown/Root/AccountBalance.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAc,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,WAAW,MAAM,gBAAgB,CAAA;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,YAAY,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAA;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAItE,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,KAA0B;IAC/D,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAA;IACzC,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,YAAY,EAAE,CAAA;IAChC,MAAM,EAAE,4BAA4B,EAAE,GAAG,kBAAkB,EAAE,CAAA;IAE7D,MAAM,EACJ,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,2BAA2B,EACtC,KAAK,EAAE,mBAAmB,GAC3B,GAAG,iBAAiB,CAAC;QACpB,YAAY,EAAE;YACZ,eAAe,EAAE,4BAA4B;SAC9C;KACF,CAAC,CAAA;IACF,MAAM,EACJ,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,eAAe,GACvB,GAAG,aAAa,EAAE,CAAA;IAEnB,IAAI,2BAA2B,IAAI,mBAAmB,EAAE,CAAC;QACvD,OAAO,oBAAC,WAAW,IAAC,SAAS,QAAC,SAAS,EAAE,SAAS,GAAI,CAAA;IACxD,CAAC;IAED,IAAI,qBAAqB,IAAI,iBAAiB,EAAE,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,qBAAqB,CAAC,CAAA;QAC7D,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,mBAAmB,CAAC,CAAA;QACzD,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAA;QACrD,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAA;QAEjD,OAAO,CACL,oBAAC,YAAY,IACX,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAC5D,KAAK,EAAC,iBAAiB,EACvB,SAAS,EAAE,SAAS,GACpB,CACH,CAAA;IACH,CAAC;IAED,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAChE,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EACnD,EAAE,CACH,CAAA;IAED,MAAM,kBAAkB,GAAG,MAAM,CAC/B,WAAW,CAAC,iBAAiB,EAAE,wBAAwB,CAAC,CACzD,CAAA;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;IAE9D,OAAO,CACL,oBAAC,WAAW,IACV,KAAK,EAAC,cAAc,EACpB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAC,mBAAmB,EAC5B,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,SAAS,KAChB,SAAS,GACb,CACH,CAAA;AACH,CAAC"}

package/dist/src/utils/number2.d.ts

@@ -0,0 +1,106 @@
+export declare const FLOATING_POINT_REGEX: RegExp;
+/** PUBLIC HELPER FUNCTIONS for calculations */
+/**
+ * Multiplies a bigint with a decimal number, taking into account the decimal places.
+ *
+ * @param bigint - The bigint value to multiply.
+ * @param number - The decimal number to multiply with.
+ * @returns The result of the multiplication as a bigint.
+ */
+export declare const multiplyBigIntWithDecimal: (bigint: bigint, number: number) => bigint;
+/**
+ * Converts a fixed-point number to another fixed-point number with a different decimal precision.
+ * @param args The arguments for the conversion.
+ *  - amount: required, the fixed-point number to convert.
+ *  - decimals: required, the current decimal precision of the number.
+ *  - targetDecimals: required, the target decimal precision for the conversion.
+ * @returns The converted fixed-point number.
+ */
+export declare const convertDecimals: ({ amount, decimals, targetDecimals, }: {
+    amount: bigint;
+    decimals: number;
+    targetDecimals: number;
+}) => bigint;
+/** Helper functions for input components */
+/**
+ * Trims decimal places to a specified precision - NO ROUNDING!
+ * @param value The value to trim
+ * @param precision The number of decimal places to keep
+ * @returns The trimmed value
+ */
+export declare const trimDecimals: (value: string, precision: number) => string;
+/**
+ * Trims integer part to a specified length - NO ROUNDING!
+ * @param value The value to trim
+ * @param precision The number of integer places to keep
+ * @returns The trimmed value
+ * @deprecated just compare the value to the max allowed value in the input component
+ */
+export declare const trimBeforeDecimals: (value: string, precision: number) => string;
+/**
+ * Normalizes a decimal number input by removing invalid characters and preventing multiple dots.
+ * @param value The value to normalize
+ * @returns The normalized value
+ */
+export declare const normalizeDecimalNumber: (value: string) => string;
+/**
+ * CONVERSION FUNCTIONS
+ * These functions convert between floating-point numbers and big integers as well as
+ * provide human-readable formats.
+ *
+ * They are used to ensure that numbers are correctly formatted for display and calculations
+ * and should be used in the UI and business logic to ensure correct number formatting.
+ */
+/** Basic conversion bigint <-> float  */
+/**
+ * Converts a floating-point number to a big integer representation.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the floating-point number to convert.
+ *   - decimals: optional, the number of decimal places to consider.
+ * @returns The big integer representation of the floating-point number.
+ */
+export declare const floatToBigInt: ({ amount, decimals, }: {
+    amount: string | number;
+    decimals?: number;
+}) => bigint;
+/**
+ * Converts a big integer representation to a floating-point number.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the big integer representation to convert.
+ *   - decimals: optional, the number of decimal places to consider.
+ *   - desiredDecimals: optional, the desired number of decimal places for the output.
+ * @returns The floating-point representation of the big integer.
+ */
+export declare const bigIntToFloat: ({ amount, decimals, desiredDecimals, }: {
+    amount: bigint;
+    decimals?: number;
+    desiredDecimals?: number;
+}) => string;
+/**  Human-readable formats */
+type AmountAsHumanReadableArguments<T extends number | string | bigint> = {
+    amount: T;
+    desiredDecimals?: number;
+    minDecimals?: number;
+    decimals?: number;
+};
+/**
+ * Helpers for setting correct arguments and getting unified human-readable
+ * formats across the app with _toHumanReadableFormat functions.
+ */
+export declare const amountAsUSD: <T extends number | string | bigint>(args: AmountAsHumanReadableArguments<T>) => AmountAsHumanReadableArguments<T>;
+export declare const amountAsToken: <T extends number | string | bigint>(args: AmountAsHumanReadableArguments<T>) => AmountAsHumanReadableArguments<T>;
+export declare const amountAsMusd: <T extends number | string | bigint>(args: AmountAsHumanReadableArguments<T>) => AmountAsHumanReadableArguments<T>;
+export declare const amountAsMats: <T extends number | string | bigint>(args: AmountAsHumanReadableArguments<T>) => AmountAsHumanReadableArguments<T>;
+/**
+ * Converts a floating-point number to a human-readable format - with thousands
+ * separators and specified decimal places.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the floating-point number to convert.
+ *   - desiredDecimals: optional, the desired number of decimal places for the output.
+ *   - minDecimals: optional, the minimum number of decimal places.
+ * @returns The human-readable format of the floating-point number.
+ */
+export declare const floatToHumanReadableFormat: ({ amount, desiredDecimals, minDecimals, }: AmountAsHumanReadableArguments<number | string>) => string;
+export declare const bigIntToHumanReadableFormat: ({ amount, decimals, desiredDecimals, minDecimals, }: AmountAsHumanReadableArguments<bigint>) => string;
+export {};
+//# sourceMappingURL=number2.d.ts.map

package/dist/src/utils/number2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number2.d.ts","sourceRoot":"","sources":["../../../src/utils/number2.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,oBAAoB,QAAsC,CAAA;AAuFvE,+CAA+C;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,EACd,QAAQ,MAAM,KACb,MAqBF,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,uCAI7B;IACD,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;CACvB,KAAG,MAMH,CAAA;AAED,4CAA4C;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,EAAE,WAAW,MAAM,KAAG,MAK/D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,MAAM,EACb,WAAW,MAAM,KAChB,MAMF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,WACM,CAAA;AAE1D;;;;;;;GAOG;AAEH,yCAAyC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,uBAG3B;IACD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,KAAG,MAeH,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,wCAI3B;IACD,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,KAAG,MAqEH,CAAA;AAED,8BAA8B;AAE9B,KAAK,8BAA8B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,IAAI;IACxE,MAAM,EAAE,CAAC,CAAA;IACT,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;GAGG;AAEH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAC5D,MAAM,8BAA8B,CAAC,CAAC,CAAC,KACtC,8BAA8B,CAAC,CAAC,CAIjC,CAAA;AAEF,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAC9D,MAAM,8BAA8B,CAAC,CAAC,CAAC,KACtC,8BAA8B,CAAC,CAAC,CAIjC,CAAA;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAC7D,MAAM,8BAA8B,CAAC,CAAC,CAAC,KACtC,8BAA8B,CAAC,CAAC,CAKjC,CAAA;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAC7D,MAAM,8BAA8B,CAAC,CAAC,CAAC,KACtC,8BAA8B,CAAC,CAAC,CAIjC,CAAA;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GAAI,2CAIxC,8BAA8B,CAAC,MAAM,GAAG,MAAM,CAAC,KAAG,MACa,CAAA;AAElE,eAAO,MAAM,2BAA2B,GAAI,qDAKzC,8BAA8B,CAAC,MAAM,CAAC,KAAG,MAkC3C,CAAA"}

package/dist/src/utils/number2.js

@@ -0,0 +1,289 @@
+// Matches floating point numbers with optional thousands separators
+export const FLOATING_POINT_REGEX = /^[^0-9]*([0-9,]+)(?:\.([0-9]*))?$/;
+const FRIENDLY_DECIMALS_AMOUNT = 6;
+/**
+ * HELPER FUNCTIONS
+ * These functions are used to convert between floating-point numbers and fixed-point numbers.
+ * They handle parsing, conversion, and formatting of numbers with specific decimal places.
+ * They shouldn't be used directly in the UI or business logic.
+ */
+/**
+ * Parses a floating-point string into a fixed-point number representation.
+ * @param floatingPointString The floating-point string to parse.
+ * @returns The fixed-point number representation or undefined if parsing fails.
+ */
+const parseToFixedPointNumber = (floatingPointString) => {
+    if (!floatingPointString.match(FLOATING_POINT_REGEX)) {
+        return undefined;
+    }
+    const [whole, decimals, ...extra] = floatingPointString.split(".");
+    // Only one `.` supported.
+    if (extra.length > 0) {
+        return undefined;
+    }
+    const noThousandsSeparatorWhole = whole.replace(",", "");
+    const setDecimals = decimals ?? "";
+    try {
+        return {
+            amount: BigInt([noThousandsSeparatorWhole, setDecimals].join("")),
+            decimals: setDecimals.length,
+        };
+    }
+    catch (error) {
+        return undefined;
+    }
+};
+/**
+ * Separates thousands in a number with commas.
+ * @param value The value to format.
+ * @param minDecimals The minimum number of decimal places.
+ * @param maxDecimals The maximum number of decimal places.
+ * @returns The formatted value with thousands separators.
+ */
+const separateThousandsWithComma = (value, minDecimals = 0, maxDecimals = 2) => {
+    let adjustedValue = value;
+    let adjustedMaxDecimals = maxDecimals;
+    // If passed value is not numeric we should return 0
+    if (Number.isNaN(+value.toString())) {
+        adjustedValue = 0;
+    }
+    if (typeof adjustedValue === "string") {
+        adjustedValue = +adjustedValue;
+    }
+    if (minDecimals > maxDecimals) {
+        adjustedMaxDecimals = minDecimals;
+    }
+    // Ensure maximumFractionDigits is within allowed range [0, 20]
+    const safeMaxDecimals = Math.max(0, Math.min(adjustedMaxDecimals, 20));
+    // @ts-expect-error - `maximumFractionDigits` wants to get number less than 21,
+    // but as the tokens have 18 decimals have, we can safely pass a parameter
+    return adjustedValue.toLocaleString("en-US", {
+        minimumFractionDigits: minDecimals,
+        maximumFractionDigits: safeMaxDecimals,
+        roundingMode: "halfExpand",
+    });
+};
+/** PUBLIC HELPER FUNCTIONS for calculations */
+/**
+ * Multiplies a bigint with a decimal number, taking into account the decimal places.
+ *
+ * @param bigint - The bigint value to multiply.
+ * @param number - The decimal number to multiply with.
+ * @returns The result of the multiplication as a bigint.
+ */
+export const multiplyBigIntWithDecimal = (bigint, number) => {
+    const numberString = number.toString();
+    const scientificMatch = /^1e-(\d+)$/.exec(numberString);
+    // Ensure we can correctly deal with scientific number expression
+    if (scientificMatch) {
+        const exponent = parseInt(scientificMatch[1], 10);
+        const scale = BigInt(10 ** exponent);
+        return (bigint * 1n) / scale;
+    }
+    const decimalsPart = number.toString().split(".")[1];
+    const decimalsCount = decimalsPart ? decimalsPart.length : 0;
+    if (!decimalsCount)
+        return bigint * BigInt(number);
+    const scale = BigInt(10 ** decimalsCount);
+    const scaledNumber = BigInt(Math.round(number * Number(scale)));
+    return (bigint * scaledNumber) / scale;
+};
+/**
+ * Converts a fixed-point number to another fixed-point number with a different decimal precision.
+ * @param args The arguments for the conversion.
+ *  - amount: required, the fixed-point number to convert.
+ *  - decimals: required, the current decimal precision of the number.
+ *  - targetDecimals: required, the target decimal precision for the conversion.
+ * @returns The converted fixed-point number.
+ */
+export const convertDecimals = ({ amount, decimals, targetDecimals, }) => {
+    if (decimals >= targetDecimals) {
+        return amount / 10n ** BigInt(decimals - targetDecimals);
+    }
+    return amount * 10n ** BigInt(targetDecimals - decimals);
+};
+/** Helper functions for input components */
+/**
+ * Trims decimal places to a specified precision - NO ROUNDING!
+ * @param value The value to trim
+ * @param precision The number of decimal places to keep
+ * @returns The trimmed value
+ */
+export const trimDecimals = (value, precision) => {
+    const [integerPart, decimalPart = ""] = value.split(".");
+    return decimalPart.length > precision
+        ? `${integerPart}.${decimalPart.slice(0, precision)}`
+        : value;
+};
+/**
+ * Trims integer part to a specified length - NO ROUNDING!
+ * @param value The value to trim
+ * @param precision The number of integer places to keep
+ * @returns The trimmed value
+ * @deprecated just compare the value to the max allowed value in the input component
+ */
+export const trimBeforeDecimals = (value, precision) => {
+    const [integerPart, decimalPart = ""] = value.split(".");
+    return integerPart.length > precision
+        ? `${integerPart.slice(0, precision)}.${decimalPart}`
+        : value;
+};
+/**
+ * Normalizes a decimal number input by removing invalid characters and preventing multiple dots.
+ * @param value The value to normalize
+ * @returns The normalized value
+ */
+export const normalizeDecimalNumber = (value) => value.replace(/[^0-9.]/g, "").replace(/\.(?=.*\.)/g, ""); // Remove all dots except the first one
+/**
+ * CONVERSION FUNCTIONS
+ * These functions convert between floating-point numbers and big integers as well as
+ * provide human-readable formats.
+ *
+ * They are used to ensure that numbers are correctly formatted for display and calculations
+ * and should be used in the UI and business logic to ensure correct number formatting.
+ */
+/** Basic conversion bigint <-> float  */
+/**
+ * Converts a floating-point number to a big integer representation.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the floating-point number to convert.
+ *   - decimals: optional, the number of decimal places to consider.
+ * @returns The big integer representation of the floating-point number.
+ */
+export const floatToBigInt = ({ amount, decimals = 18, }) => {
+    const parsedAmount = amount.toString();
+    const fixedPointAmount = parseToFixedPointNumber(parsedAmount);
+    if (typeof fixedPointAmount === "undefined") {
+        return 0n;
+    }
+    const bigIntAmount = convertDecimals({
+        amount: fixedPointAmount.amount,
+        decimals: fixedPointAmount.decimals,
+        targetDecimals: decimals,
+    });
+    return bigIntAmount;
+};
+/**
+ * Converts a big integer representation to a floating-point number.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the big integer representation to convert.
+ *   - decimals: optional, the number of decimal places to consider.
+ *   - desiredDecimals: optional, the desired number of decimal places for the output.
+ * @returns The floating-point representation of the big integer.
+ */
+export const bigIntToFloat = ({ amount, decimals = 18, desiredDecimals = decimals, }) => {
+    let isNegative = false;
+    let normalizedAmount = amount;
+    if (amount < 0n) {
+        normalizedAmount = -amount;
+        isNegative = true;
+    }
+    const desiredDecimalsAmount = normalizedAmount / 10n ** BigInt(Math.max(0, decimals - desiredDecimals));
+    // Desired decimals amount with additional decimal to check if number
+    // should be rounded up
+    const desiredDecimalsAmountWithAdditionalDecimal = normalizedAmount /
+        10n ** BigInt(Math.max(0, decimals - desiredDecimals - 1));
+    // We are getting the first value that has been cut off
+    const firstDecimalAfterCutOff = desiredDecimalsAmountWithAdditionalDecimal
+        .toString()
+        .at(-1);
+    // Padding amount when its length is smaller than desired
+    const parsedDesiredAmount = desiredDecimalsAmount
+        .toString()
+        .padStart(desiredDecimals + 1, "0");
+    const integersPart = parsedDesiredAmount.slice(0, -desiredDecimals);
+    const decimalsPart = parsedDesiredAmount.slice(-desiredDecimals);
+    // If number is above or equal to 5 we should round up the number
+    const shouldIncreaseDecimalsPart = Number(firstDecimalAfterCutOff) >= 5 && desiredDecimals !== decimals;
+    // If above is true we add 1 to the decimals value and convert it back to string
+    const adjustedDecimalsPart = shouldIncreaseDecimalsPart
+        ? (Number(decimalsPart) + 1).toString().padStart(desiredDecimals, "0")
+        : decimalsPart;
+    // Determining whether integer part needs to be increased due to rounding up
+    const shouldIncreaseIntegerPart = (decimalsPart === "0" && adjustedDecimalsPart !== decimalsPart) ||
+        adjustedDecimalsPart.length > decimalsPart.length;
+    // If above is true we add 1 to the integers value and convert it back to string
+    // and set first value of decimals part to 0
+    const adjustedIntegersPart = shouldIncreaseIntegerPart
+        ? (Number(integersPart) + 1).toString()
+        : integersPart;
+    const decimalsPartAfterIntegersAdjustments = shouldIncreaseIntegerPart
+        ? `0${adjustedDecimalsPart.slice(1)}`
+        : adjustedDecimalsPart;
+    // Inserting "." to separate integers part from decimal part
+    const desiredAmount = [
+        ...adjustedIntegersPart,
+        ".",
+        ...decimalsPartAfterIntegersAdjustments,
+    ].join("");
+    // Remove trailing zeros and the trailing decimal point (if exists)
+    const trimmedDesiredAmount = desiredAmount.replace(/(?:\.0*|(\.\d+?)0+)$/, "$1");
+    return isNegative ? `-${trimmedDesiredAmount}` : trimmedDesiredAmount;
+};
+/**
+ * Helpers for setting correct arguments and getting unified human-readable
+ * formats across the app with _toHumanReadableFormat functions.
+ */
+export const amountAsUSD = (args) => ({
+    desiredDecimals: 2,
+    minDecimals: 2,
+    ...args,
+});
+export const amountAsToken = (args) => ({
+    desiredDecimals: FRIENDLY_DECIMALS_AMOUNT,
+    minDecimals: 0,
+    ...args,
+});
+export const amountAsMusd = (args) => ({
+    desiredDecimals: 2,
+    minDecimals: 2,
+    decimals: 18, // MUSD has 18 decimals
+    ...args,
+});
+export const amountAsMats = (args) => ({
+    desiredDecimals: 0,
+    minDecimals: 0,
+    ...args,
+});
+/**
+ * Converts a floating-point number to a human-readable format - with thousands
+ * separators and specified decimal places.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the floating-point number to convert.
+ *   - desiredDecimals: optional, the desired number of decimal places for the output.
+ *   - minDecimals: optional, the minimum number of decimal places.
+ * @returns The human-readable format of the floating-point number.
+ */
+export const floatToHumanReadableFormat = ({ amount, desiredDecimals = 2, // treat is as an USD amount by default
+minDecimals = 0, }) => separateThousandsWithComma(amount, minDecimals, desiredDecimals);
+export const bigIntToHumanReadableFormat = ({ amount, decimals = 18, desiredDecimals = FRIENDLY_DECIMALS_AMOUNT, // treat is as a token by default
+minDecimals = 0, }) => {
+    let isNegative = false;
+    let normalizedAmount = amount;
+    let adjustedDesiredDecimals = desiredDecimals;
+    if (minDecimals > desiredDecimals) {
+        adjustedDesiredDecimals = minDecimals;
+    }
+    if (normalizedAmount < 0n) {
+        normalizedAmount = -normalizedAmount;
+        isNegative = true;
+    }
+    const trimmedDesiredAmount = bigIntToFloat({
+        amount: normalizedAmount,
+        decimals,
+        desiredDecimals: adjustedDesiredDecimals,
+    });
+    if (trimmedDesiredAmount === "0" && normalizedAmount !== 0n) {
+        const decimalsString = "1".padStart(adjustedDesiredDecimals, "0");
+        return `<0.${decimalsString}`;
+    }
+    const desiredValue = isNegative
+        ? `-${trimmedDesiredAmount}`
+        : trimmedDesiredAmount;
+    return floatToHumanReadableFormat({
+        amount: desiredValue,
+        desiredDecimals: adjustedDesiredDecimals,
+        minDecimals,
+    });
+};
+//# sourceMappingURL=number2.js.map

package/dist/src/utils/number2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number2.js","sourceRoot":"","sources":["../../../src/utils/number2.ts"],"names":[],"mappings":"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"}

package/package.json

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

package/src/components/Dropdown/Root/AccountBalance.tsx

@@ -19,6 +19,7 @@ export default function AccountBalance(props: AccountBalanceProps) {
     data: tokensBalancesData,
     isError: isTokensBalancesError,
     isPending: isTokensBalancesDataPending,
+    error: tokensBalancesError,
   } = useTokensBalances({
     queryOptions: {
       refetchInterval: nativeBalanceRefetchInterval,
@@ -28,6 +29,7 @@ export default function AccountBalance(props: AccountBalanceProps) {
     data: borrowData,
     isError: isBorrowDataError,
     isPending: isBorrowDataPending,
+    error: borrowDataError,
   } = useBorrowData()
 
   if (isTokensBalancesDataPending || isBorrowDataPending) {
@@ -35,6 +37,11 @@ export default function AccountBalance(props: AccountBalanceProps) {
   }
 
   if (isTokensBalancesError || isBorrowDataError) {
+    console.log("isTokensBalancesError: ", isTokensBalancesError)
+    console.log("tokensBalancesError: ", tokensBalancesError)
+    console.log("isBorrowDataError: ", isBorrowDataError)
+    console.log("borrowDataError: ", borrowDataError)
+
     return (
       <AccountError
         padding={`${theme.sizing.scale500} ${theme.sizing.scale800}`}

package/src/utils/number2.ts

@@ -0,0 +1,419 @@
+// Matches floating point numbers with optional thousands separators
+export const FLOATING_POINT_REGEX = /^[^0-9]*([0-9,]+)(?:\.([0-9]*))?$/
+const FRIENDLY_DECIMALS_AMOUNT = 6
+
+type FixedPointNumber = {
+  amount: bigint
+  decimals: number
+}
+
+/**
+ * HELPER FUNCTIONS
+ * These functions are used to convert between floating-point numbers and fixed-point numbers.
+ * They handle parsing, conversion, and formatting of numbers with specific decimal places.
+ * They shouldn't be used directly in the UI or business logic.
+ */
+
+/**
+ * Parses a floating-point string into a fixed-point number representation.
+ * @param floatingPointString The floating-point string to parse.
+ * @returns The fixed-point number representation or undefined if parsing fails.
+ */
+const parseToFixedPointNumber = (
+  floatingPointString: string,
+): FixedPointNumber | undefined => {
+  if (!floatingPointString.match(FLOATING_POINT_REGEX)) {
+    return undefined
+  }
+
+  const [whole, decimals, ...extra] = floatingPointString.split(".")
+
+  // Only one `.` supported.
+  if (extra.length > 0) {
+    return undefined
+  }
+
+  const noThousandsSeparatorWhole = whole.replace(",", "")
+  const setDecimals = decimals ?? ""
+
+  try {
+    return {
+      amount: BigInt([noThousandsSeparatorWhole, setDecimals].join("")),
+      decimals: setDecimals.length,
+    }
+  } catch (error) {
+    return undefined
+  }
+}
+
+/**
+ * Separates thousands in a number with commas.
+ * @param value The value to format.
+ * @param minDecimals The minimum number of decimal places.
+ * @param maxDecimals The maximum number of decimal places.
+ * @returns The formatted value with thousands separators.
+ */
+const separateThousandsWithComma = (
+  value: number | bigint | string,
+  minDecimals = 0,
+  maxDecimals = 2,
+): string => {
+  let adjustedValue = value
+  let adjustedMaxDecimals = maxDecimals
+
+  // If passed value is not numeric we should return 0
+  if (Number.isNaN(+value.toString())) {
+    adjustedValue = 0
+  }
+
+  if (typeof adjustedValue === "string") {
+    adjustedValue = +adjustedValue
+  }
+
+  if (minDecimals > maxDecimals) {
+    adjustedMaxDecimals = minDecimals
+  }
+
+  // Ensure maximumFractionDigits is within allowed range [0, 20]
+  const safeMaxDecimals = Math.max(0, Math.min(adjustedMaxDecimals, 20))
+
+  // @ts-expect-error - `maximumFractionDigits` wants to get number less than 21,
+  // but as the tokens have 18 decimals have, we can safely pass a parameter
+  return adjustedValue.toLocaleString("en-US", {
+    minimumFractionDigits: minDecimals,
+    maximumFractionDigits: safeMaxDecimals,
+    roundingMode: "halfExpand",
+  })
+}
+
+/** PUBLIC HELPER FUNCTIONS for calculations */
+
+/**
+ * Multiplies a bigint with a decimal number, taking into account the decimal places.
+ *
+ * @param bigint - The bigint value to multiply.
+ * @param number - The decimal number to multiply with.
+ * @returns The result of the multiplication as a bigint.
+ */
+export const multiplyBigIntWithDecimal = (
+  bigint: bigint,
+  number: number,
+): bigint => {
+  const numberString = number.toString()
+  const scientificMatch = /^1e-(\d+)$/.exec(numberString)
+
+  // Ensure we can correctly deal with scientific number expression
+  if (scientificMatch) {
+    const exponent = parseInt(scientificMatch[1], 10)
+    const scale = BigInt(10 ** exponent)
+
+    return (bigint * 1n) / scale
+  }
+
+  const decimalsPart = number.toString().split(".")[1]
+  const decimalsCount = decimalsPart ? decimalsPart.length : 0
+
+  if (!decimalsCount) return bigint * BigInt(number)
+
+  const scale = BigInt(10 ** decimalsCount)
+  const scaledNumber = BigInt(Math.round(number * Number(scale)))
+
+  return (bigint * scaledNumber) / scale
+}
+
+/**
+ * Converts a fixed-point number to another fixed-point number with a different decimal precision.
+ * @param args The arguments for the conversion.
+ *  - amount: required, the fixed-point number to convert.
+ *  - decimals: required, the current decimal precision of the number.
+ *  - targetDecimals: required, the target decimal precision for the conversion.
+ * @returns The converted fixed-point number.
+ */
+export const convertDecimals = ({
+  amount,
+  decimals,
+  targetDecimals,
+}: {
+  amount: bigint
+  decimals: number
+  targetDecimals: number
+}): bigint => {
+  if (decimals >= targetDecimals) {
+    return amount / 10n ** BigInt(decimals - targetDecimals)
+  }
+
+  return amount * 10n ** BigInt(targetDecimals - decimals)
+}
+
+/** Helper functions for input components */
+
+/**
+ * Trims decimal places to a specified precision - NO ROUNDING!
+ * @param value The value to trim
+ * @param precision The number of decimal places to keep
+ * @returns The trimmed value
+ */
+export const trimDecimals = (value: string, precision: number): string => {
+  const [integerPart, decimalPart = ""] = value.split(".")
+  return decimalPart.length > precision
+    ? `${integerPart}.${decimalPart.slice(0, precision)}`
+    : value
+}
+
+/**
+ * Trims integer part to a specified length - NO ROUNDING!
+ * @param value The value to trim
+ * @param precision The number of integer places to keep
+ * @returns The trimmed value
+ * @deprecated just compare the value to the max allowed value in the input component
+ */
+export const trimBeforeDecimals = (
+  value: string,
+  precision: number,
+): string => {
+  const [integerPart, decimalPart = ""] = value.split(".")
+
+  return integerPart.length > precision
+    ? `${integerPart.slice(0, precision)}.${decimalPart}`
+    : value
+}
+
+/**
+ * Normalizes a decimal number input by removing invalid characters and preventing multiple dots.
+ * @param value The value to normalize
+ * @returns The normalized value
+ */
+export const normalizeDecimalNumber = (value: string) =>
+  value.replace(/[^0-9.]/g, "").replace(/\.(?=.*\.)/g, "") // Remove all dots except the first one
+
+/**
+ * CONVERSION FUNCTIONS
+ * These functions convert between floating-point numbers and big integers as well as
+ * provide human-readable formats.
+ *
+ * They are used to ensure that numbers are correctly formatted for display and calculations
+ * and should be used in the UI and business logic to ensure correct number formatting.
+ */
+
+/** Basic conversion bigint <-> float  */
+
+/**
+ * Converts a floating-point number to a big integer representation.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the floating-point number to convert.
+ *   - decimals: optional, the number of decimal places to consider.
+ * @returns The big integer representation of the floating-point number.
+ */
+export const floatToBigInt = ({
+  amount,
+  decimals = 18,
+}: {
+  amount: string | number
+  decimals?: number
+}): bigint => {
+  const parsedAmount = amount.toString()
+  const fixedPointAmount = parseToFixedPointNumber(parsedAmount)
+
+  if (typeof fixedPointAmount === "undefined") {
+    return 0n
+  }
+
+  const bigIntAmount = convertDecimals({
+    amount: fixedPointAmount.amount,
+    decimals: fixedPointAmount.decimals,
+    targetDecimals: decimals,
+  })
+
+  return bigIntAmount
+}
+
+/**
+ * Converts a big integer representation to a floating-point number.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the big integer representation to convert.
+ *   - decimals: optional, the number of decimal places to consider.
+ *   - desiredDecimals: optional, the desired number of decimal places for the output.
+ * @returns The floating-point representation of the big integer.
+ */
+export const bigIntToFloat = ({
+  amount,
+  decimals = 18,
+  desiredDecimals = decimals,
+}: {
+  amount: bigint
+  decimals?: number
+  desiredDecimals?: number
+}): string => {
+  let isNegative = false
+  let normalizedAmount = amount
+
+  if (amount < 0n) {
+    normalizedAmount = -amount
+    isNegative = true
+  }
+
+  const desiredDecimalsAmount =
+    normalizedAmount / 10n ** BigInt(Math.max(0, decimals - desiredDecimals))
+
+  // Desired decimals amount with additional decimal to check if number
+  // should be rounded up
+  const desiredDecimalsAmountWithAdditionalDecimal =
+    normalizedAmount /
+    10n ** BigInt(Math.max(0, decimals - desiredDecimals - 1))
+
+  // We are getting the first value that has been cut off
+  const firstDecimalAfterCutOff = desiredDecimalsAmountWithAdditionalDecimal
+    .toString()
+    .at(-1)
+
+  // Padding amount when its length is smaller than desired
+  const parsedDesiredAmount = desiredDecimalsAmount
+    .toString()
+    .padStart(desiredDecimals + 1, "0")
+
+  const integersPart = parsedDesiredAmount.slice(0, -desiredDecimals)
+  const decimalsPart = parsedDesiredAmount.slice(-desiredDecimals)
+
+  // If number is above or equal to 5 we should round up the number
+  const shouldIncreaseDecimalsPart =
+    Number(firstDecimalAfterCutOff) >= 5 && desiredDecimals !== decimals
+
+  // If above is true we add 1 to the decimals value and convert it back to string
+  const adjustedDecimalsPart = shouldIncreaseDecimalsPart
+    ? (Number(decimalsPart) + 1).toString().padStart(desiredDecimals, "0")
+    : decimalsPart
+
+  // Determining whether integer part needs to be increased due to rounding up
+  const shouldIncreaseIntegerPart =
+    (decimalsPart === "0" && adjustedDecimalsPart !== decimalsPart) ||
+    adjustedDecimalsPart.length > decimalsPart.length
+
+  // If above is true we add 1 to the integers value and convert it back to string
+  // and set first value of decimals part to 0
+  const adjustedIntegersPart = shouldIncreaseIntegerPart
+    ? (Number(integersPart) + 1).toString()
+    : integersPart
+
+  const decimalsPartAfterIntegersAdjustments = shouldIncreaseIntegerPart
+    ? `0${adjustedDecimalsPart.slice(1)}`
+    : adjustedDecimalsPart
+
+  // Inserting "." to separate integers part from decimal part
+  const desiredAmount = [
+    ...adjustedIntegersPart,
+    ".",
+    ...decimalsPartAfterIntegersAdjustments,
+  ].join("")
+
+  // Remove trailing zeros and the trailing decimal point (if exists)
+  const trimmedDesiredAmount = desiredAmount.replace(
+    /(?:\.0*|(\.\d+?)0+)$/,
+    "$1",
+  )
+
+  return isNegative ? `-${trimmedDesiredAmount}` : trimmedDesiredAmount
+}
+
+/**  Human-readable formats */
+
+type AmountAsHumanReadableArguments<T extends number | string | bigint> = {
+  amount: T
+  desiredDecimals?: number
+  minDecimals?: number
+  decimals?: number
+}
+
+/**
+ * Helpers for setting correct arguments and getting unified human-readable
+ * formats across the app with _toHumanReadableFormat functions.
+ */
+
+export const amountAsUSD = <T extends number | string | bigint>(
+  args: AmountAsHumanReadableArguments<T>,
+): AmountAsHumanReadableArguments<T> => ({
+  desiredDecimals: 2,
+  minDecimals: 2,
+  ...args,
+})
+
+export const amountAsToken = <T extends number | string | bigint>(
+  args: AmountAsHumanReadableArguments<T>,
+): AmountAsHumanReadableArguments<T> => ({
+  desiredDecimals: FRIENDLY_DECIMALS_AMOUNT,
+  minDecimals: 0,
+  ...args,
+})
+
+export const amountAsMusd = <T extends number | string | bigint>(
+  args: AmountAsHumanReadableArguments<T>,
+): AmountAsHumanReadableArguments<T> => ({
+  desiredDecimals: 2,
+  minDecimals: 2,
+  decimals: 18, // MUSD has 18 decimals
+  ...args,
+})
+
+export const amountAsMats = <T extends number | string | bigint>(
+  args: AmountAsHumanReadableArguments<T>,
+): AmountAsHumanReadableArguments<T> => ({
+  desiredDecimals: 0,
+  minDecimals: 0,
+  ...args,
+})
+
+/**
+ * Converts a floating-point number to a human-readable format - with thousands
+ * separators and specified decimal places.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the floating-point number to convert.
+ *   - desiredDecimals: optional, the desired number of decimal places for the output.
+ *   - minDecimals: optional, the minimum number of decimal places.
+ * @returns The human-readable format of the floating-point number.
+ */
+export const floatToHumanReadableFormat = ({
+  amount,
+  desiredDecimals = 2, // treat is as an USD amount by default
+  minDecimals = 0,
+}: AmountAsHumanReadableArguments<number | string>): string =>
+  separateThousandsWithComma(amount, minDecimals, desiredDecimals)
+
+export const bigIntToHumanReadableFormat = ({
+  amount,
+  decimals = 18,
+  desiredDecimals = FRIENDLY_DECIMALS_AMOUNT, // treat is as a token by default
+  minDecimals = 0,
+}: AmountAsHumanReadableArguments<bigint>): string => {
+  let isNegative = false
+  let normalizedAmount = amount
+  let adjustedDesiredDecimals = desiredDecimals
+
+  if (minDecimals > desiredDecimals) {
+    adjustedDesiredDecimals = minDecimals
+  }
+
+  if (normalizedAmount < 0n) {
+    normalizedAmount = -normalizedAmount
+    isNegative = true
+  }
+
+  const trimmedDesiredAmount = bigIntToFloat({
+    amount: normalizedAmount,
+    decimals,
+    desiredDecimals: adjustedDesiredDecimals,
+  })
+
+  if (trimmedDesiredAmount === "0" && normalizedAmount !== 0n) {
+    const decimalsString = "1".padStart(adjustedDesiredDecimals, "0")
+    return `<0.${decimalsString}`
+  }
+
+  const desiredValue = isNegative
+    ? `-${trimmedDesiredAmount}`
+    : trimmedDesiredAmount
+
+  return floatToHumanReadableFormat({
+    amount: desiredValue,
+    desiredDecimals: adjustedDesiredDecimals,
+    minDecimals,
+  })
+}