@nadohq/shared 0.53.0 → 0.54.0

package/dist/{decimalAdjustment-DD7Q2eMZ.d.cts → decimalAdjustment-DCwilVOA.d.cts}

@@ -9,25 +9,27 @@ declare const NADO_PRODUCT_DECIMALS = 18;
 /**
  * Determines the result type after adjusting decimals based on the input type `T`.
  *
- * - If `T` is `undefined`, the result is `undefined`.
+ * - If `T` is `null` or `undefined`, the result preserves that value.
  * - If `T` is a `number`, the result is a `number`.
  * - Otherwise, the result is a `BigNumber`.
  */
-type AdjustDecimalsResult<T extends BigNumberish | undefined> = T extends undefined ? undefined : T extends number ? number : BigNumber;
+type AdjustDecimalsResult<T extends BigNumberish | null | undefined> = T extends null | undefined ? T : T extends number ? number : BigNumber;
 /**
  * Adds the specified # of decimals to the number. For example, value = 1, decimals = 2, returns 100.
  *
- * @param value can be undefined for better developer experience. If undefined, returns undefined.
+ * @param value can be null or undefined; either is returned unchanged.
  * @param decimals number of decimal places to add, defaults to 18, which is the standard within Nado
+ * @returns The adjusted number or BigNumber, preserving null and undefined inputs.
  */
-declare function addDecimals<T extends BigNumberish | undefined>(value: T, decimals?: number): AdjustDecimalsResult<T>;
+declare function addDecimals<T extends BigNumberish | null | undefined>(value: T, decimals?: number): AdjustDecimalsResult<T>;
 /**
  * Removes the specified # of decimals from the number. For example, value = 100, decimals = 2, returns 1.
  *
- * @param value can be undefined for better developer experience. If undefined, returns undefined.
+ * @param value can be null or undefined; either is returned unchanged.
  * @param decimals number of decimal places to remove, defaults to 18, which is the standard within Nado
+ * @returns The adjusted number or BigNumber, preserving null and undefined inputs.
  */
-declare function removeDecimals<T extends BigNumberish | undefined>(value: T, decimals?: number): AdjustDecimalsResult<T>;
+declare function removeDecimals<T extends BigNumberish | null | undefined>(value: T, decimals?: number): AdjustDecimalsResult<T>;
 //#endregion
 export { addDecimals as n, removeDecimals as r, NADO_PRODUCT_DECIMALS as t };
-//# sourceMappingURL=decimalAdjustment-DD7Q2eMZ.d.cts.map
+//# sourceMappingURL=decimalAdjustment-DCwilVOA.d.cts.map

package/dist/decimalAdjustment-DCwilVOA.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimalAdjustment-DCwilVOA.d.cts","names":[],"sources":["../src/utils/math/src/utils/math/decimalAdjustment.ts"],"mappings":";;;;;;AAMA;cAAa,qBAAA;;;AAAqB;AAAM;;;;KASnC,oBAAA,WAA+B,YAAA,uBAClC,CAAA,4BAA6B,CAAA,GAAI,CAAA,2BAA4B,SAAA;;;;;;;;iBAS/C,WAAA,WAAsB,YAAA,oBAAA,CACpC,KAAA,EAAO,CAAA,EACP,QAAA,YACC,oBAAA,CAAqB,CAAA;;;;;AAZgD;AASxE;;iBAyBgB,cAAA,WAAyB,YAAA,oBAAA,CACvC,KAAA,EAAO,CAAA,EACP,QAAA,YACC,oBAAA,CAAqB,CAAA"}

package/dist/{decimalAdjustment-DU0dlRcS.d.ts → decimalAdjustment-pLqKqD8x.d.ts}

@@ -9,25 +9,27 @@ declare const NADO_PRODUCT_DECIMALS = 18;
 /**
  * Determines the result type after adjusting decimals based on the input type `T`.
  *
- * - If `T` is `undefined`, the result is `undefined`.
+ * - If `T` is `null` or `undefined`, the result preserves that value.
  * - If `T` is a `number`, the result is a `number`.
  * - Otherwise, the result is a `BigNumber`.
  */
-type AdjustDecimalsResult<T extends BigNumberish | undefined> = T extends undefined ? undefined : T extends number ? number : BigNumber;
+type AdjustDecimalsResult<T extends BigNumberish | null | undefined> = T extends null | undefined ? T : T extends number ? number : BigNumber;
 /**
  * Adds the specified # of decimals to the number. For example, value = 1, decimals = 2, returns 100.
  *
- * @param value can be undefined for better developer experience. If undefined, returns undefined.
+ * @param value can be null or undefined; either is returned unchanged.
  * @param decimals number of decimal places to add, defaults to 18, which is the standard within Nado
+ * @returns The adjusted number or BigNumber, preserving null and undefined inputs.
  */
-declare function addDecimals<T extends BigNumberish | undefined>(value: T, decimals?: number): AdjustDecimalsResult<T>;
+declare function addDecimals<T extends BigNumberish | null | undefined>(value: T, decimals?: number): AdjustDecimalsResult<T>;
 /**
  * Removes the specified # of decimals from the number. For example, value = 100, decimals = 2, returns 1.
  *
- * @param value can be undefined for better developer experience. If undefined, returns undefined.
+ * @param value can be null or undefined; either is returned unchanged.
  * @param decimals number of decimal places to remove, defaults to 18, which is the standard within Nado
+ * @returns The adjusted number or BigNumber, preserving null and undefined inputs.
  */
-declare function removeDecimals<T extends BigNumberish | undefined>(value: T, decimals?: number): AdjustDecimalsResult<T>;
+declare function removeDecimals<T extends BigNumberish | null | undefined>(value: T, decimals?: number): AdjustDecimalsResult<T>;
 //#endregion
 export { addDecimals as n, removeDecimals as r, NADO_PRODUCT_DECIMALS as t };
-//# sourceMappingURL=decimalAdjustment-DU0dlRcS.d.ts.map
+//# sourceMappingURL=decimalAdjustment-pLqKqD8x.d.ts.map

package/dist/decimalAdjustment-pLqKqD8x.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimalAdjustment-pLqKqD8x.d.ts","names":[],"sources":["../src/utils/math/src/utils/math/decimalAdjustment.ts"],"mappings":";;;;;;AAMA;cAAa,qBAAA;;;AAAqB;AAAM;;;;KASnC,oBAAA,WAA+B,YAAA,uBAClC,CAAA,4BAA6B,CAAA,GAAI,CAAA,2BAA4B,SAAA;;;;;;;;iBAS/C,WAAA,WAAsB,YAAA,oBAAA,CACpC,KAAA,EAAO,CAAA,EACP,QAAA,YACC,oBAAA,CAAqB,CAAA;;;;;AAZgD;AASxE;;iBAyBgB,cAAA,WAAyB,YAAA,oBAAA,CACvC,KAAA,EAAO,CAAA,EACP,QAAA,YACC,oBAAA,CAAqB,CAAA"}

package/dist/index.d.cts

@@ -21,7 +21,7 @@ import { n as WithContract, r as WithContracts, t as NadoContracts } from "./nad
 import { n as toBigNumber, t as BigNumberish } from "./bigNumber-BqgJEjFs.cjs";
 import { t as BigNumbers } from "./BigNumbers-Dky57CpC.cjs";
 import { t as clampBigNumber } from "./clamp-D9lICt7X.cjs";
-import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "./decimalAdjustment-DD7Q2eMZ.cjs";
+import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "./decimalAdjustment-DCwilVOA.cjs";
 import { t as sumBigNumberBy } from "./sumBigNumberBy-BvDeov4-.cjs";
 import { t as toBigInt } from "./toBigInt-BDiOjNl-.cjs";
 import { t as toIntegerString } from "./toIntegerString-BUESqiY1.cjs";

package/dist/index.d.ts

@@ -21,7 +21,7 @@ import { n as WithContract, r as WithContracts, t as NadoContracts } from "./nad
 import { n as toBigNumber, t as BigNumberish } from "./bigNumber-BqgJEjFs.js";
 import { t as BigNumbers } from "./BigNumbers-Dky57CpC.js";
 import { t as clampBigNumber } from "./clamp-D9lICt7X.js";
-import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "./decimalAdjustment-DU0dlRcS.js";
+import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "./decimalAdjustment-pLqKqD8x.js";
 import { t as sumBigNumberBy } from "./sumBigNumberBy-BvDeov4-.js";
 import { t as toBigInt } from "./toBigInt-CBRk3mgz.js";
 import { t as toIntegerString } from "./toIntegerString-CyhOUxbE.js";

package/dist/utils/index.d.cts

@@ -1,7 +1,7 @@
 import { n as toBigNumber, t as BigNumberish } from "../bigNumber-BqgJEjFs.cjs";
 import { t as BigNumbers } from "../BigNumbers-Dky57CpC.cjs";
 import { t as clampBigNumber } from "../clamp-D9lICt7X.cjs";
-import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../decimalAdjustment-DD7Q2eMZ.cjs";
+import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../decimalAdjustment-DCwilVOA.cjs";
 import { t as sumBigNumberBy } from "../sumBigNumberBy-BvDeov4-.cjs";
 import { t as toBigInt } from "../toBigInt-BDiOjNl-.cjs";
 import { t as toIntegerString } from "../toIntegerString-BUESqiY1.cjs";

package/dist/utils/index.d.ts

@@ -1,7 +1,7 @@
 import { n as toBigNumber, t as BigNumberish } from "../bigNumber-BqgJEjFs.js";
 import { t as BigNumbers } from "../BigNumbers-Dky57CpC.js";
 import { t as clampBigNumber } from "../clamp-D9lICt7X.js";
-import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../decimalAdjustment-DU0dlRcS.js";
+import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../decimalAdjustment-pLqKqD8x.js";
 import { t as sumBigNumberBy } from "../sumBigNumberBy-BvDeov4-.js";
 import { t as toBigInt } from "../toBigInt-CBRk3mgz.js";
 import { t as toIntegerString } from "../toIntegerString-CyhOUxbE.js";

package/dist/utils/math/decimalAdjustment.cjs

@@ -8,12 +8,13 @@ const NADO_PRODUCT_DECIMALS = 18;
 /**
 * Adds the specified # of decimals to the number. For example, value = 1, decimals = 2, returns 100.
 *
-* @param value can be undefined for better developer experience. If undefined, returns undefined.
+* @param value can be null or undefined; either is returned unchanged.
 * @param decimals number of decimal places to add, defaults to 18, which is the standard within Nado
+* @returns The adjusted number or BigNumber, preserving null and undefined inputs.
 */
 function addDecimals(value, decimals = 18) {
 	const getResult = () => {
-		if (value == null) return;
+		if (value == null) return value;
 		const adjustedValue = require_utils_math_bigNumber.toBigNumber(value).multipliedBy(require_utils_math_bigNumber.toBigNumber(10).pow(decimals));
 		return typeof value === "number" ? adjustedValue.toNumber() : adjustedValue;
 	};
@@ -22,12 +23,13 @@ function addDecimals(value, decimals = 18) {
 /**
 * Removes the specified # of decimals from the number. For example, value = 100, decimals = 2, returns 1.
 *
-* @param value can be undefined for better developer experience. If undefined, returns undefined.
+* @param value can be null or undefined; either is returned unchanged.
 * @param decimals number of decimal places to remove, defaults to 18, which is the standard within Nado
+* @returns The adjusted number or BigNumber, preserving null and undefined inputs.
 */
 function removeDecimals(value, decimals = 18) {
 	const getResult = () => {
-		if (value == null) return;
+		if (value == null) return value;
 		const adjustedValue = require_utils_math_bigNumber.toBigNumber(value).dividedBy(require_utils_math_bigNumber.toBigNumber(10).pow(decimals));
 		return typeof value === "number" ? adjustedValue.toNumber() : adjustedValue;
 	};

package/dist/utils/math/decimalAdjustment.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"decimalAdjustment.cjs","names":["toBigNumber"],"sources":["../../../src/utils/math/decimalAdjustment.ts"],"sourcesContent":["import BigNumber from 'bignumber.js';\nimport { BigNumberish, toBigNumber } from './bigNumber';\n\n/**\n * All Nado balances have 18 decimals. Ex. 1e18 = 1.0\n */\nexport const NADO_PRODUCT_DECIMALS = 18;\n\n/**\n * Determines the result type after adjusting decimals based on the input type `T`.\n *\n * - If `T` is `undefined`, the result is `undefined`.\n * - If `T` is a `number`, the result is a `number`.\n * - Otherwise, the result is a `BigNumber`.\n */\ntype AdjustDecimalsResult<T extends BigNumberish | undefined> =\n  T extends undefined ? undefined : T extends number ? number : BigNumber;\n\n/**\n * Adds the specified # of decimals to the number. For example, value = 1, decimals = 2, returns 100.\n *\n * @param value can be undefined for better developer experience. If undefined, returns undefined.\n * @param decimals number of decimal places to add, defaults to 18, which is the standard within Nado\n */\n\nexport function addDecimals<T extends BigNumberish | undefined>(\n  value: T,\n  decimals: number = NADO_PRODUCT_DECIMALS,\n): AdjustDecimalsResult<T> {\n  const getResult = () => {\n    if (value == null) {\n      return undefined;\n    }\n\n    const adjustedValue = toBigNumber(value).multipliedBy(\n      toBigNumber(10).pow(decimals),\n    );\n    return typeof value === 'number' ? adjustedValue.toNumber() : adjustedValue;\n  };\n\n  return getResult() as AdjustDecimalsResult<T>;\n}\n\n/**\n * Removes the specified # of decimals from the number. For example, value = 100, decimals = 2, returns 1.\n *\n * @param value can be undefined for better developer experience. If undefined, returns undefined.\n * @param decimals number of decimal places to remove, defaults to 18, which is the standard within Nado\n */\nexport function removeDecimals<T extends BigNumberish | undefined>(\n  value: T,\n  decimals: number = NADO_PRODUCT_DECIMALS,\n): AdjustDecimalsResult<T> {\n  const getResult = () => {\n    if (value == null) {\n      return undefined;\n    }\n\n    const adjustedValue = toBigNumber(value).dividedBy(\n      toBigNumber(10).pow(decimals),\n    );\n    return typeof value === 'number' ? adjustedValue.toNumber() : adjustedValue;\n  };\n\n  return getResult() as AdjustDecimalsResult<T>;\n}\n"],"mappings":";;;;;;AAMA,MAAa,wBAAwB;;;;;;;AAmBrC,SAAgB,YACd,OACA,WAAA,IACyB;CACzB,MAAM,kBAAkB;EACtB,IAAI,SAAS,MACX;EAGF,MAAM,gBAAgBA,6BAAAA,YAAY,KAAK,EAAE,aACvCA,6BAAAA,YAAY,EAAE,EAAE,IAAI,QAAQ,CAC9B;EACA,OAAO,OAAO,UAAU,WAAW,cAAc,SAAS,IAAI;CAChE;CAEA,OAAO,UAAU;AACnB;;;;;;;AAQA,SAAgB,eACd,OACA,WAAA,IACyB;CACzB,MAAM,kBAAkB;EACtB,IAAI,SAAS,MACX;EAGF,MAAM,gBAAgBA,6BAAAA,YAAY,KAAK,EAAE,UACvCA,6BAAAA,YAAY,EAAE,EAAE,IAAI,QAAQ,CAC9B;EACA,OAAO,OAAO,UAAU,WAAW,cAAc,SAAS,IAAI;CAChE;CAEA,OAAO,UAAU;AACnB"}
+{"version":3,"file":"decimalAdjustment.cjs","names":["toBigNumber"],"sources":["../../../src/utils/math/decimalAdjustment.ts"],"sourcesContent":["import BigNumber from 'bignumber.js';\nimport { BigNumberish, toBigNumber } from './bigNumber';\n\n/**\n * All Nado balances have 18 decimals. Ex. 1e18 = 1.0\n */\nexport const NADO_PRODUCT_DECIMALS = 18;\n\n/**\n * Determines the result type after adjusting decimals based on the input type `T`.\n *\n * - If `T` is `null` or `undefined`, the result preserves that value.\n * - If `T` is a `number`, the result is a `number`.\n * - Otherwise, the result is a `BigNumber`.\n */\ntype AdjustDecimalsResult<T extends BigNumberish | null | undefined> =\n  T extends null | undefined ? T : T extends number ? number : BigNumber;\n\n/**\n * Adds the specified # of decimals to the number. For example, value = 1, decimals = 2, returns 100.\n *\n * @param value can be null or undefined; either is returned unchanged.\n * @param decimals number of decimal places to add, defaults to 18, which is the standard within Nado\n * @returns The adjusted number or BigNumber, preserving null and undefined inputs.\n */\nexport function addDecimals<T extends BigNumberish | null | undefined>(\n  value: T,\n  decimals: number = NADO_PRODUCT_DECIMALS,\n): AdjustDecimalsResult<T> {\n  const getResult = () => {\n    if (value == null) {\n      return value;\n    }\n\n    const adjustedValue = toBigNumber(value).multipliedBy(\n      toBigNumber(10).pow(decimals),\n    );\n    return typeof value === 'number' ? adjustedValue.toNumber() : adjustedValue;\n  };\n\n  return getResult() as AdjustDecimalsResult<T>;\n}\n\n/**\n * Removes the specified # of decimals from the number. For example, value = 100, decimals = 2, returns 1.\n *\n * @param value can be null or undefined; either is returned unchanged.\n * @param decimals number of decimal places to remove, defaults to 18, which is the standard within Nado\n * @returns The adjusted number or BigNumber, preserving null and undefined inputs.\n */\nexport function removeDecimals<T extends BigNumberish | null | undefined>(\n  value: T,\n  decimals: number = NADO_PRODUCT_DECIMALS,\n): AdjustDecimalsResult<T> {\n  const getResult = () => {\n    if (value == null) {\n      return value;\n    }\n\n    const adjustedValue = toBigNumber(value).dividedBy(\n      toBigNumber(10).pow(decimals),\n    );\n    return typeof value === 'number' ? adjustedValue.toNumber() : adjustedValue;\n  };\n\n  return getResult() as AdjustDecimalsResult<T>;\n}\n"],"mappings":";;;;;;AAMA,MAAa,wBAAwB;;;;;;;;AAmBrC,SAAgB,YACd,OACA,WAAA,IACyB;CACzB,MAAM,kBAAkB;EACtB,IAAI,SAAS,MACX,OAAO;EAGT,MAAM,gBAAgBA,6BAAAA,YAAY,KAAK,EAAE,aACvCA,6BAAAA,YAAY,EAAE,EAAE,IAAI,QAAQ,CAC9B;EACA,OAAO,OAAO,UAAU,WAAW,cAAc,SAAS,IAAI;CAChE;CAEA,OAAO,UAAU;AACnB;;;;;;;;AASA,SAAgB,eACd,OACA,WAAA,IACyB;CACzB,MAAM,kBAAkB;EACtB,IAAI,SAAS,MACX,OAAO;EAGT,MAAM,gBAAgBA,6BAAAA,YAAY,KAAK,EAAE,UACvCA,6BAAAA,YAAY,EAAE,EAAE,IAAI,QAAQ,CAC9B;EACA,OAAO,OAAO,UAAU,WAAW,cAAc,SAAS,IAAI;CAChE;CAEA,OAAO,UAAU;AACnB"}

package/dist/utils/math/decimalAdjustment.d.cts

@@ -1,2 +1,2 @@
-import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../../decimalAdjustment-DD7Q2eMZ.cjs";
+import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../../decimalAdjustment-DCwilVOA.cjs";
 export { NADO_PRODUCT_DECIMALS, addDecimals, removeDecimals };

package/dist/utils/math/decimalAdjustment.d.ts

@@ -1,2 +1,2 @@
-import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../../decimalAdjustment-DU0dlRcS.js";
+import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../../decimalAdjustment-pLqKqD8x.js";
 export { NADO_PRODUCT_DECIMALS, addDecimals, removeDecimals };

package/dist/utils/math/decimalAdjustment.js

@@ -7,12 +7,13 @@ const NADO_PRODUCT_DECIMALS = 18;
 /**
 * Adds the specified # of decimals to the number. For example, value = 1, decimals = 2, returns 100.
 *
-* @param value can be undefined for better developer experience. If undefined, returns undefined.
+* @param value can be null or undefined; either is returned unchanged.
 * @param decimals number of decimal places to add, defaults to 18, which is the standard within Nado
+* @returns The adjusted number or BigNumber, preserving null and undefined inputs.
 */
 function addDecimals(value, decimals = 18) {
 	const getResult = () => {
-		if (value == null) return;
+		if (value == null) return value;
 		const adjustedValue = toBigNumber(value).multipliedBy(toBigNumber(10).pow(decimals));
 		return typeof value === "number" ? adjustedValue.toNumber() : adjustedValue;
 	};
@@ -21,12 +22,13 @@ function addDecimals(value, decimals = 18) {
 /**
 * Removes the specified # of decimals from the number. For example, value = 100, decimals = 2, returns 1.
 *
-* @param value can be undefined for better developer experience. If undefined, returns undefined.
+* @param value can be null or undefined; either is returned unchanged.
 * @param decimals number of decimal places to remove, defaults to 18, which is the standard within Nado
+* @returns The adjusted number or BigNumber, preserving null and undefined inputs.
 */
 function removeDecimals(value, decimals = 18) {
 	const getResult = () => {
-		if (value == null) return;
+		if (value == null) return value;
 		const adjustedValue = toBigNumber(value).dividedBy(toBigNumber(10).pow(decimals));
 		return typeof value === "number" ? adjustedValue.toNumber() : adjustedValue;
 	};

package/dist/utils/math/decimalAdjustment.js.map

@@ -1 +1 @@
-{"version":3,"file":"decimalAdjustment.js","names":[],"sources":["../../../src/utils/math/decimalAdjustment.ts"],"sourcesContent":["import BigNumber from 'bignumber.js';\nimport { BigNumberish, toBigNumber } from './bigNumber';\n\n/**\n * All Nado balances have 18 decimals. Ex. 1e18 = 1.0\n */\nexport const NADO_PRODUCT_DECIMALS = 18;\n\n/**\n * Determines the result type after adjusting decimals based on the input type `T`.\n *\n * - If `T` is `undefined`, the result is `undefined`.\n * - If `T` is a `number`, the result is a `number`.\n * - Otherwise, the result is a `BigNumber`.\n */\ntype AdjustDecimalsResult<T extends BigNumberish | undefined> =\n  T extends undefined ? undefined : T extends number ? number : BigNumber;\n\n/**\n * Adds the specified # of decimals to the number. For example, value = 1, decimals = 2, returns 100.\n *\n * @param value can be undefined for better developer experience. If undefined, returns undefined.\n * @param decimals number of decimal places to add, defaults to 18, which is the standard within Nado\n */\n\nexport function addDecimals<T extends BigNumberish | undefined>(\n  value: T,\n  decimals: number = NADO_PRODUCT_DECIMALS,\n): AdjustDecimalsResult<T> {\n  const getResult = () => {\n    if (value == null) {\n      return undefined;\n    }\n\n    const adjustedValue = toBigNumber(value).multipliedBy(\n      toBigNumber(10).pow(decimals),\n    );\n    return typeof value === 'number' ? adjustedValue.toNumber() : adjustedValue;\n  };\n\n  return getResult() as AdjustDecimalsResult<T>;\n}\n\n/**\n * Removes the specified # of decimals from the number. For example, value = 100, decimals = 2, returns 1.\n *\n * @param value can be undefined for better developer experience. If undefined, returns undefined.\n * @param decimals number of decimal places to remove, defaults to 18, which is the standard within Nado\n */\nexport function removeDecimals<T extends BigNumberish | undefined>(\n  value: T,\n  decimals: number = NADO_PRODUCT_DECIMALS,\n): AdjustDecimalsResult<T> {\n  const getResult = () => {\n    if (value == null) {\n      return undefined;\n    }\n\n    const adjustedValue = toBigNumber(value).dividedBy(\n      toBigNumber(10).pow(decimals),\n    );\n    return typeof value === 'number' ? adjustedValue.toNumber() : adjustedValue;\n  };\n\n  return getResult() as AdjustDecimalsResult<T>;\n}\n"],"mappings":";;;;;AAMA,MAAa,wBAAwB;;;;;;;AAmBrC,SAAgB,YACd,OACA,WAAA,IACyB;CACzB,MAAM,kBAAkB;EACtB,IAAI,SAAS,MACX;EAGF,MAAM,gBAAgB,YAAY,KAAK,EAAE,aACvC,YAAY,EAAE,EAAE,IAAI,QAAQ,CAC9B;EACA,OAAO,OAAO,UAAU,WAAW,cAAc,SAAS,IAAI;CAChE;CAEA,OAAO,UAAU;AACnB;;;;;;;AAQA,SAAgB,eACd,OACA,WAAA,IACyB;CACzB,MAAM,kBAAkB;EACtB,IAAI,SAAS,MACX;EAGF,MAAM,gBAAgB,YAAY,KAAK,EAAE,UACvC,YAAY,EAAE,EAAE,IAAI,QAAQ,CAC9B;EACA,OAAO,OAAO,UAAU,WAAW,cAAc,SAAS,IAAI;CAChE;CAEA,OAAO,UAAU;AACnB"}
+{"version":3,"file":"decimalAdjustment.js","names":[],"sources":["../../../src/utils/math/decimalAdjustment.ts"],"sourcesContent":["import BigNumber from 'bignumber.js';\nimport { BigNumberish, toBigNumber } from './bigNumber';\n\n/**\n * All Nado balances have 18 decimals. Ex. 1e18 = 1.0\n */\nexport const NADO_PRODUCT_DECIMALS = 18;\n\n/**\n * Determines the result type after adjusting decimals based on the input type `T`.\n *\n * - If `T` is `null` or `undefined`, the result preserves that value.\n * - If `T` is a `number`, the result is a `number`.\n * - Otherwise, the result is a `BigNumber`.\n */\ntype AdjustDecimalsResult<T extends BigNumberish | null | undefined> =\n  T extends null | undefined ? T : T extends number ? number : BigNumber;\n\n/**\n * Adds the specified # of decimals to the number. For example, value = 1, decimals = 2, returns 100.\n *\n * @param value can be null or undefined; either is returned unchanged.\n * @param decimals number of decimal places to add, defaults to 18, which is the standard within Nado\n * @returns The adjusted number or BigNumber, preserving null and undefined inputs.\n */\nexport function addDecimals<T extends BigNumberish | null | undefined>(\n  value: T,\n  decimals: number = NADO_PRODUCT_DECIMALS,\n): AdjustDecimalsResult<T> {\n  const getResult = () => {\n    if (value == null) {\n      return value;\n    }\n\n    const adjustedValue = toBigNumber(value).multipliedBy(\n      toBigNumber(10).pow(decimals),\n    );\n    return typeof value === 'number' ? adjustedValue.toNumber() : adjustedValue;\n  };\n\n  return getResult() as AdjustDecimalsResult<T>;\n}\n\n/**\n * Removes the specified # of decimals from the number. For example, value = 100, decimals = 2, returns 1.\n *\n * @param value can be null or undefined; either is returned unchanged.\n * @param decimals number of decimal places to remove, defaults to 18, which is the standard within Nado\n * @returns The adjusted number or BigNumber, preserving null and undefined inputs.\n */\nexport function removeDecimals<T extends BigNumberish | null | undefined>(\n  value: T,\n  decimals: number = NADO_PRODUCT_DECIMALS,\n): AdjustDecimalsResult<T> {\n  const getResult = () => {\n    if (value == null) {\n      return value;\n    }\n\n    const adjustedValue = toBigNumber(value).dividedBy(\n      toBigNumber(10).pow(decimals),\n    );\n    return typeof value === 'number' ? adjustedValue.toNumber() : adjustedValue;\n  };\n\n  return getResult() as AdjustDecimalsResult<T>;\n}\n"],"mappings":";;;;;AAMA,MAAa,wBAAwB;;;;;;;;AAmBrC,SAAgB,YACd,OACA,WAAA,IACyB;CACzB,MAAM,kBAAkB;EACtB,IAAI,SAAS,MACX,OAAO;EAGT,MAAM,gBAAgB,YAAY,KAAK,EAAE,aACvC,YAAY,EAAE,EAAE,IAAI,QAAQ,CAC9B;EACA,OAAO,OAAO,UAAU,WAAW,cAAc,SAAS,IAAI;CAChE;CAEA,OAAO,UAAU;AACnB;;;;;;;;AASA,SAAgB,eACd,OACA,WAAA,IACyB;CACzB,MAAM,kBAAkB;EACtB,IAAI,SAAS,MACX,OAAO;EAGT,MAAM,gBAAgB,YAAY,KAAK,EAAE,UACvC,YAAY,EAAE,EAAE,IAAI,QAAQ,CAC9B;EACA,OAAO,OAAO,UAAU,WAAW,cAAc,SAAS,IAAI;CAChE;CAEA,OAAO,UAAU;AACnB"}

package/dist/utils/math/index.d.cts

@@ -1,7 +1,7 @@
 import { n as toBigNumber, t as BigNumberish } from "../../bigNumber-BqgJEjFs.cjs";
 import { t as BigNumbers } from "../../BigNumbers-Dky57CpC.cjs";
 import { t as clampBigNumber } from "../../clamp-D9lICt7X.cjs";
-import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../../decimalAdjustment-DD7Q2eMZ.cjs";
+import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../../decimalAdjustment-DCwilVOA.cjs";
 import { t as sumBigNumberBy } from "../../sumBigNumberBy-BvDeov4-.cjs";
 import { t as toBigInt } from "../../toBigInt-BDiOjNl-.cjs";
 import { t as toIntegerString } from "../../toIntegerString-BUESqiY1.cjs";

package/dist/utils/math/index.d.ts

@@ -1,7 +1,7 @@
 import { n as toBigNumber, t as BigNumberish } from "../../bigNumber-BqgJEjFs.js";
 import { t as BigNumbers } from "../../BigNumbers-Dky57CpC.js";
 import { t as clampBigNumber } from "../../clamp-D9lICt7X.js";
-import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../../decimalAdjustment-DU0dlRcS.js";
+import { n as addDecimals, r as removeDecimals, t as NADO_PRODUCT_DECIMALS } from "../../decimalAdjustment-pLqKqD8x.js";
 import { t as sumBigNumberBy } from "../../sumBigNumberBy-BvDeov4-.js";
 import { t as toBigInt } from "../../toBigInt-CBRk3mgz.js";
 import { t as toIntegerString } from "../../toIntegerString-CyhOUxbE.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadohq/shared",
-  "version": "0.53.0",
+  "version": "0.54.0",
   "type": "module",
   "sideEffects": false,
   "description": "Shared utilities, types, and contract helpers for Nado SDK",
@@ -52,5 +52,5 @@
     "bignumber.js": "11.1.1",
     "viem": "2.52.0"
   },
-  "gitHead": "94a4731d08230a234122e6d225b59208313d846f"
+  "gitHead": "83485ee66ad20b239387e271a2945386b39e824e"
 }

package/src/utils/math/decimalAdjustment.test.ts

@@ -0,0 +1,85 @@
+import { describe, expect, it } from '@jest/globals';
+import BigNumber from 'bignumber.js';
+import { addDecimals, removeDecimals } from './decimalAdjustment';
+
+describe('removeDecimals', () => {
+  it('preserves null and its return type', () => {
+    const result: null = removeDecimals(null);
+    expect(result).toBeNull();
+  });
+
+  it('preserves undefined and its return type', () => {
+    const result: undefined = removeDecimals(undefined);
+    expect(result).toBeUndefined();
+  });
+
+  it.each([0, 12345, -12345])(
+    'keeps numeric input %s as a number with custom decimals',
+    (value) => {
+      const result: number = removeDecimals(value, 2);
+      expect(result).toBe(value / 100);
+    },
+  );
+
+  it.each([
+    '12345678901234567890123',
+    12345678901234567890123n,
+    new BigNumber('12345678901234567890123'),
+  ])('preserves x18 precision for %s', (value) => {
+    const result: BigNumber = removeDecimals(value);
+    expect(result.toFixed()).toBe('12345.678901234567890123');
+  });
+
+  it('preserves the distinction between missing, null, and zero prices', () => {
+    const prices: Array<string | null | undefined> = [undefined, null, '0'];
+    const results: Array<BigNumber | null | undefined> = prices.map((price) =>
+      removeDecimals(price),
+    );
+    expect(results[0]).toBeUndefined();
+    expect(results[1]).toBeNull();
+    expect(results[2]?.isZero()).toBe(true);
+  });
+});
+
+describe('addDecimals', () => {
+  it('preserves null and its return type', () => {
+    const result: null = addDecimals(null);
+    expect(result).toBeNull();
+  });
+
+  it('preserves undefined and its return type', () => {
+    const result: undefined = addDecimals(undefined);
+    expect(result).toBeUndefined();
+  });
+
+  it.each([0, 1.25, -1.25])(
+    'keeps numeric input %s as a number with custom decimals',
+    (value) => {
+      const result: number = addDecimals(value, 2);
+      expect(result).toBe(value * 100);
+    },
+  );
+
+  it.each([
+    '12345.678901234567890123',
+    new BigNumber('12345.678901234567890123'),
+  ])('preserves precision when converting %s to x18 units', (value) => {
+    const result: BigNumber = addDecimals(value);
+    expect(result.toFixed()).toBe('12345678901234567890123');
+  });
+
+  it('scales bigint values without losing precision', () => {
+    const result: BigNumber = addDecimals(12345678901234567890123n, 2);
+    expect(result.toFixed()).toBe('1234567890123456789012300');
+  });
+
+  it('preserves the distinction between missing, null, and zero values', () => {
+    const values: Array<string | null | undefined> = [undefined, null, '0'];
+    const results: Array<BigNumber | null | undefined> = values.map((value) =>
+      addDecimals(value),
+    );
+    expect(results[0]).toBeUndefined();
+    expect(results[1]).toBeNull();
+    expect(results[2]?.isZero()).toBe(true);
+  });
+});

package/src/utils/math/decimalAdjustment.ts

@@ -9,27 +9,27 @@ export const NADO_PRODUCT_DECIMALS = 18;
 /**
  * Determines the result type after adjusting decimals based on the input type `T`.
  *
- * - If `T` is `undefined`, the result is `undefined`.
+ * - If `T` is `null` or `undefined`, the result preserves that value.
  * - If `T` is a `number`, the result is a `number`.
  * - Otherwise, the result is a `BigNumber`.
  */
-type AdjustDecimalsResult<T extends BigNumberish | undefined> =
-  T extends undefined ? undefined : T extends number ? number : BigNumber;
+type AdjustDecimalsResult<T extends BigNumberish | null | undefined> =
+  T extends null | undefined ? T : T extends number ? number : BigNumber;
 
 /**
  * Adds the specified # of decimals to the number. For example, value = 1, decimals = 2, returns 100.
  *
- * @param value can be undefined for better developer experience. If undefined, returns undefined.
+ * @param value can be null or undefined; either is returned unchanged.
  * @param decimals number of decimal places to add, defaults to 18, which is the standard within Nado
+ * @returns The adjusted number or BigNumber, preserving null and undefined inputs.
  */
-
-export function addDecimals<T extends BigNumberish | undefined>(
+export function addDecimals<T extends BigNumberish | null | undefined>(
   value: T,
   decimals: number = NADO_PRODUCT_DECIMALS,
 ): AdjustDecimalsResult<T> {
   const getResult = () => {
     if (value == null) {
-      return undefined;
+      return value;
     }
 
     const adjustedValue = toBigNumber(value).multipliedBy(
@@ -44,16 +44,17 @@ export function addDecimals<T extends BigNumberish | undefined>(
 /**
  * Removes the specified # of decimals from the number. For example, value = 100, decimals = 2, returns 1.
  *
- * @param value can be undefined for better developer experience. If undefined, returns undefined.
+ * @param value can be null or undefined; either is returned unchanged.
  * @param decimals number of decimal places to remove, defaults to 18, which is the standard within Nado
+ * @returns The adjusted number or BigNumber, preserving null and undefined inputs.
  */
-export function removeDecimals<T extends BigNumberish | undefined>(
+export function removeDecimals<T extends BigNumberish | null | undefined>(
   value: T,
   decimals: number = NADO_PRODUCT_DECIMALS,
 ): AdjustDecimalsResult<T> {
   const getResult = () => {
     if (value == null) {
-      return undefined;
+      return value;
     }
 
     const adjustedValue = toBigNumber(value).dividedBy(

package/dist/decimalAdjustment-DD7Q2eMZ.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decimalAdjustment-DD7Q2eMZ.d.cts","names":[],"sources":["../src/utils/math/src/utils/math/decimalAdjustment.ts"],"mappings":";;;;;;AAMA;cAAa,qBAAA;;;AAAqB;AAAM;;;;KASnC,oBAAA,WAA+B,YAAA,gBAClC,CAAA,iCAAkC,CAAA,2BAA4B,SAAA;;;;;;;iBAShD,WAAA,WAAsB,YAAA,aAAA,CACpC,KAAA,EAAO,CAAA,EACP,QAAA,YACC,oBAAA,CAAqB,CAAA;;;;AAZiD;AASzE;;iBAwBgB,cAAA,WAAyB,YAAA,aAAA,CACvC,KAAA,EAAO,CAAA,EACP,QAAA,YACC,oBAAA,CAAqB,CAAA"}

package/dist/decimalAdjustment-DU0dlRcS.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decimalAdjustment-DU0dlRcS.d.ts","names":[],"sources":["../src/utils/math/src/utils/math/decimalAdjustment.ts"],"mappings":";;;;;;AAMA;cAAa,qBAAA;;;AAAqB;AAAM;;;;KASnC,oBAAA,WAA+B,YAAA,gBAClC,CAAA,iCAAkC,CAAA,2BAA4B,SAAA;;;;;;;iBAShD,WAAA,WAAsB,YAAA,aAAA,CACpC,KAAA,EAAO,CAAA,EACP,QAAA,YACC,oBAAA,CAAqB,CAAA;;;;AAZiD;AASzE;;iBAwBgB,cAAA,WAAyB,YAAA,aAAA,CACvC,KAAA,EAAO,CAAA,EACP,QAAA,YACC,oBAAA,CAAqB,CAAA"}