@gearbox-protocol/sdk 14.10.1 → 14.10.2-next.1

package/dist/cjs/common-utils/utils/strategies/tokens/is-obtainable-token.spec.js

@@ -0,0 +1,162 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_test_utils = require("../../../test-utils/index.js");
+var import_is_usable_token = require("../../strategies/tokens/is-usable-token.js");
+var import_is_obtainable_token = require("./is-obtainable-token.js");
+import_vitest.vi.mock("../../utils/strategies/tokens/is-usable-token.js", async () => {
+  const actual = await import_vitest.vi.importActual(
+    "../../utils/strategies/tokens/is-usable-token.js"
+  );
+  return {
+    ...actual,
+    isUsableToken: import_vitest.vi.fn(
+      actual.isUsableToken
+    )
+  };
+});
+const mockIsUsableToken = import_vitest.vi.mocked(import_is_usable_token.isUsableToken);
+(0, import_vitest.describe)("isObtainableToken", () => {
+  const tokenAddr = "0xtoken";
+  (0, import_vitest.beforeEach)(async () => {
+    mockIsUsableToken.mockReset();
+    const actual = await import_vitest.vi.importActual(
+      "../../utils/strategies/tokens/is-usable-token.js"
+    );
+    mockIsUsableToken.mockImplementation(
+      actual.isUsableToken
+    );
+  });
+  (0, import_vitest.it)("returns true when usable, not delayed phantom, and quota has room", () => {
+    const cm = (0, import_test_utils.buildCreditManager)({
+      quotas: {
+        [tokenAddr]: {
+          token: tokenAddr,
+          rate: 0n,
+          limit: 100n,
+          totalQuoted: 0n,
+          isActive: true,
+          quotaIncreaseFee: 0n
+        }
+      },
+      isQuoted: import_vitest.vi.fn().mockReturnValue(true)
+    });
+    mockIsUsableToken.mockReturnValue(true);
+    const result = (0, import_is_obtainable_token.isObtainableToken)({
+      address: tokenAddr,
+      creditManager: {
+        quotas: cm.quotas,
+        isQuoted: cm.isQuoted.bind(cm),
+        forbiddenTokens: cm.forbiddenTokens,
+        liquidationThresholds: cm.liquidationThresholds,
+        supportedTokens: cm.supportedTokens
+      },
+      delayedPhantoms: {}
+    });
+    (0, import_vitest.expect)(cm.isQuoted).toHaveBeenCalledWith(tokenAddr);
+    (0, import_vitest.expect)(result).toBe(true);
+  });
+  (0, import_vitest.it)("returns true when usable, not delayed phantom, and not quoted", () => {
+    const cm = (0, import_test_utils.buildCreditManager)({
+      quotas: {},
+      isQuoted: import_vitest.vi.fn().mockReturnValue(false)
+    });
+    mockIsUsableToken.mockReturnValue(true);
+    const result = (0, import_is_obtainable_token.isObtainableToken)({
+      address: tokenAddr,
+      creditManager: {
+        quotas: cm.quotas,
+        isQuoted: cm.isQuoted.bind(cm),
+        forbiddenTokens: cm.forbiddenTokens,
+        liquidationThresholds: cm.liquidationThresholds,
+        supportedTokens: cm.supportedTokens
+      },
+      delayedPhantoms: {}
+    });
+    (0, import_vitest.expect)(cm.isQuoted).toHaveBeenCalledWith(tokenAddr);
+    (0, import_vitest.expect)(result).toBe(true);
+  });
+  (0, import_vitest.it)("returns false when isUsableToken is false", () => {
+    const cm = (0, import_test_utils.buildCreditManager)({
+      quotas: {
+        [tokenAddr]: {
+          token: tokenAddr,
+          rate: 0n,
+          limit: 100n,
+          totalQuoted: 0n,
+          isActive: true,
+          quotaIncreaseFee: 0n
+        }
+      },
+      isQuoted: import_vitest.vi.fn().mockReturnValue(true)
+    });
+    mockIsUsableToken.mockReturnValue(false);
+    const result = (0, import_is_obtainable_token.isObtainableToken)({
+      address: tokenAddr,
+      creditManager: {
+        quotas: cm.quotas,
+        isQuoted: cm.isQuoted.bind(cm),
+        forbiddenTokens: cm.forbiddenTokens,
+        liquidationThresholds: cm.liquidationThresholds,
+        supportedTokens: cm.supportedTokens
+      },
+      delayedPhantoms: {}
+    });
+    (0, import_vitest.expect)(result).toBe(false);
+  });
+  (0, import_vitest.it)("returns false when quotaLeft is zero or negative", () => {
+    const cm = (0, import_test_utils.buildCreditManager)({
+      quotas: {
+        [tokenAddr]: {
+          token: tokenAddr,
+          rate: 0n,
+          limit: 0n,
+          totalQuoted: 10n,
+          isActive: true,
+          quotaIncreaseFee: 0n
+        }
+      },
+      isQuoted: import_vitest.vi.fn().mockReturnValue(true)
+    });
+    mockIsUsableToken.mockReturnValue(true);
+    const result = (0, import_is_obtainable_token.isObtainableToken)({
+      address: tokenAddr,
+      creditManager: {
+        quotas: cm.quotas,
+        isQuoted: cm.isQuoted.bind(cm),
+        forbiddenTokens: cm.forbiddenTokens,
+        liquidationThresholds: cm.liquidationThresholds,
+        supportedTokens: cm.supportedTokens
+      },
+      delayedPhantoms: {}
+    });
+    (0, import_vitest.expect)(result).toBe(false);
+  });
+  (0, import_vitest.it)("returns false when token is delayed phantom", () => {
+    const cm = (0, import_test_utils.buildCreditManager)({
+      quotas: {
+        [tokenAddr]: {
+          token: tokenAddr,
+          rate: 0n,
+          limit: 100n,
+          totalQuoted: 0n,
+          isActive: true,
+          quotaIncreaseFee: 0n
+        }
+      },
+      isQuoted: import_vitest.vi.fn().mockReturnValue(true)
+    });
+    mockIsUsableToken.mockReturnValue(true);
+    const result = (0, import_is_obtainable_token.isObtainableToken)({
+      address: tokenAddr,
+      creditManager: {
+        quotas: cm.quotas,
+        isQuoted: cm.isQuoted.bind(cm),
+        forbiddenTokens: cm.forbiddenTokens,
+        liquidationThresholds: cm.liquidationThresholds,
+        supportedTokens: cm.supportedTokens
+      },
+      delayedPhantoms: { [tokenAddr]: true }
+    });
+    (0, import_vitest.expect)(result).toBe(false);
+  });
+});

package/dist/cjs/common-utils/utils/strategies/tokens/is-valid-extra-collateral-token.js

@@ -0,0 +1,51 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var is_valid_extra_collateral_token_exports = {};
+__export(is_valid_extra_collateral_token_exports, {
+  isValidExtraCollateralToken: () => isValidExtraCollateralToken
+});
+module.exports = __toCommonJS(is_valid_extra_collateral_token_exports);
+var import_is_forbidden_token = require("../../strategies/tokens/is-forbidden-token.js");
+function isValidExtraCollateralToken({
+  address,
+  extraCollateralConfigs,
+  prices,
+  creditManager,
+  tokensList,
+  delayedPhantoms,
+  zeroDebt
+}) {
+  if (!extraCollateralConfigs || extraCollateralConfigs.length === 0 || !prices || !creditManager)
+    return false;
+  if (creditManager && address === creditManager.underlyingToken) return true;
+  if (zeroDebt && creditManager) return false;
+  const forbidden = (0, import_is_forbidden_token.isForbiddenToken)({ address, creditManager });
+  const delayed = !!delayedPhantoms[address];
+  const { isPhantom = false } = tokensList[address] || {};
+  const isCMValid = extraCollateralConfigs.some((config) => {
+    const targetCM = typeof config === "string" ? creditManager.address : config.cm;
+    const price = prices?.[address] || 0n;
+    return targetCM === creditManager.address && price > 0n;
+  });
+  return !isPhantom && !forbidden && !delayed && isCMValid;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isValidExtraCollateralToken
+});

package/dist/cjs/common-utils/utils/strategies/tokens/wrap-token-address.js

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var wrap_token_address_exports = {};
+__export(wrap_token_address_exports, {
+  wrapTokenAddress: () => wrapTokenAddress
+});
+module.exports = __toCommonJS(wrap_token_address_exports);
+function wrapTokenAddress(tokenAddress, nativeTokenAddress, wrappedNativeTokenAddress) {
+  if (wrappedNativeTokenAddress && tokenAddress === nativeTokenAddress) {
+    return wrappedNativeTokenAddress;
+  }
+  return tokenAddress;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  wrapTokenAddress
+});

package/dist/cjs/common-utils/utils/strategies/tokens/wrap-token-address.spec.js

@@ -0,0 +1,13 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_wrap_token_address = require("./wrap-token-address.js");
+(0, import_vitest.describe)("wrapTokenAddress", () => {
+  const native = "0xeeee";
+  const wrapped = "0xweth";
+  (0, import_vitest.it)("returns wrapped when token matches native", () => {
+    (0, import_vitest.expect)((0, import_wrap_token_address.wrapTokenAddress)(native, native, wrapped)).toBe(wrapped);
+  });
+  (0, import_vitest.it)("returns token when it does not match native", () => {
+    (0, import_vitest.expect)((0, import_wrap_token_address.wrapTokenAddress)("0xother", native, wrapped)).toBe("0xother");
+  });
+});

package/dist/cjs/common-utils/utils/strategies/types/strategy-data.js

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var strategy_data_exports = {};
+module.exports = __toCommonJS(strategy_data_exports);

package/dist/cjs/common-utils/utils/strategies/types/strategy-earnings.js

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var strategy_earnings_exports = {};
+module.exports = __toCommonJS(strategy_earnings_exports);

package/dist/cjs/common-utils/utils/validation/is-zero-balance.js

@@ -0,0 +1,30 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var is_zero_balance_exports = {};
+__export(is_zero_balance_exports, {
+  isZeroBalance: () => isZeroBalance
+});
+module.exports = __toCommonJS(is_zero_balance_exports);
+function isZeroBalance(balance) {
+  return (balance ?? 0n) <= 10n;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isZeroBalance
+});

package/dist/cjs/common-utils/utils/validation/validate-balance.js

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var validate_balance_exports = {};
+__export(validate_balance_exports, {
+  validateBalance: () => validateBalance
+});
+module.exports = __toCommonJS(validate_balance_exports);
+var import_constants = require("../constants.js");
+var import_is_zero_balance = require("./is-zero-balance.js");
+function validateBalance({
+  amount,
+  tokenAddress,
+  maxAmount = 0n,
+  zeroCheck = true,
+  single
+}) {
+  const safeAddress = tokenAddress || import_constants.EMPTY_ADDRESS;
+  if (!safeAddress) return { message: "unknownToken", token: safeAddress };
+  if (maxAmount < amount)
+    return { message: "insufficientFunds", token: safeAddress };
+  if (zeroCheck && (0, import_is_zero_balance.isZeroBalance)(amount))
+    return {
+      message: single ? "enterAmount" : "zeroBalance",
+      token: safeAddress
+    };
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateBalance
+});

package/dist/cjs/common-utils/utils/validation/validate-balance.spec.js

@@ -0,0 +1,52 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_test_utils = require("../../test-utils/index.js");
+var import_validate_balance = require("./validate-balance.js");
+(0, import_vitest.describe)("validateBalance", () => {
+  (0, import_vitest.it)("returns null when all conditions are met", () => {
+    const result = (0, import_validate_balance.validateBalance)({
+      amount: 1000n,
+      tokenAddress: import_test_utils.mockToken1,
+      maxAmount: 2000n,
+      zeroCheck: true,
+      single: false
+    });
+    (0, import_vitest.expect)(result).toBeNull();
+  });
+  (0, import_vitest.it)("returns error when amount exceeds maxAmount", () => {
+    const result = (0, import_validate_balance.validateBalance)({
+      amount: 3000n,
+      tokenAddress: import_test_utils.mockToken1,
+      maxAmount: 2000n,
+      zeroCheck: true,
+      single: false
+    });
+    (0, import_vitest.expect)(result).toEqual({
+      message: "insufficientFunds",
+      token: import_test_utils.mockToken1
+    });
+  });
+  (0, import_vitest.it)("returns error when amount is too small with zeroCheck", () => {
+    const result = (0, import_validate_balance.validateBalance)({
+      amount: 5n,
+      tokenAddress: import_test_utils.mockToken1,
+      maxAmount: 2000n,
+      zeroCheck: true,
+      single: false
+    });
+    (0, import_vitest.expect)(result).toEqual({
+      message: "zeroBalance",
+      token: import_test_utils.mockToken1
+    });
+  });
+  (0, import_vitest.it)("returns null when zeroCheck is false and amount is small", () => {
+    const result = (0, import_validate_balance.validateBalance)({
+      amount: 5n,
+      tokenAddress: import_test_utils.mockToken1,
+      maxAmount: 2000n,
+      zeroCheck: false,
+      single: false
+    });
+    (0, import_vitest.expect)(result).toBeNull();
+  });
+});

package/dist/cjs/common-utils/utils/validation/validate-balances.js

@@ -0,0 +1,44 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var validate_balances_exports = {};
+__export(validate_balances_exports, {
+  validateBalances: () => validateBalances
+});
+module.exports = __toCommonJS(validate_balances_exports);
+var import_validate_balance = require("./validate-balance.js");
+function validateBalances({
+  balances,
+  assets,
+  zeroCheck = true
+}) {
+  for (const { token: tokenAddress, balance: amount } of assets) {
+    const e = (0, import_validate_balance.validateBalance)({
+      tokenAddress,
+      amount,
+      maxAmount: balances[(tokenAddress || "").toLowerCase()] || 0n,
+      zeroCheck
+    });
+    if (e !== null) return e;
+  }
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateBalances
+});

package/dist/cjs/common-utils/utils/validation/validate-balances.spec.js

@@ -0,0 +1,37 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_test_utils = require("../../test-utils/index.js");
+var import_validate_balances = require("./validate-balances.js");
+(0, import_vitest.describe)("validateBalances", () => {
+  (0, import_vitest.it)("returns null when all balances are valid", () => {
+    const result = (0, import_validate_balances.validateBalances)({
+      balances: {
+        [import_test_utils.mockToken1]: 2000n,
+        [import_test_utils.mockToken2]: 3000n
+      },
+      assets: [
+        { token: import_test_utils.mockToken1, balance: 1000n },
+        { token: import_test_utils.mockToken2, balance: 2000n }
+      ],
+      zeroCheck: true
+    });
+    (0, import_vitest.expect)(result).toBeNull();
+  });
+  (0, import_vitest.it)("returns error when any balance is invalid", () => {
+    const result = (0, import_validate_balances.validateBalances)({
+      balances: {
+        [import_test_utils.mockToken1]: 500n,
+        [import_test_utils.mockToken2]: 3000n
+      },
+      assets: [
+        { token: import_test_utils.mockToken1, balance: 1000n },
+        { token: import_test_utils.mockToken2, balance: 2000n }
+      ],
+      zeroCheck: true
+    });
+    (0, import_vitest.expect)(result).toEqual({
+      message: "insufficientFunds",
+      token: import_test_utils.mockToken1
+    });
+  });
+});

package/dist/cjs/common-utils/utils/validation/validate-credit-manager.js

@@ -0,0 +1,34 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var validate_credit_manager_exports = {};
+__export(validate_credit_manager_exports, {
+  validateCreditManager: () => validateCreditManager
+});
+module.exports = __toCommonJS(validate_credit_manager_exports);
+function validateCreditManager({
+  creditManager,
+  allowPausedCm
+}) {
+  if (creditManager.isPaused && !allowPausedCm) return { message: "paused" };
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateCreditManager
+});

package/dist/cjs/common-utils/utils/validation/validate-credit-manager.spec.js

@@ -0,0 +1,36 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_test_utils = require("../../test-utils/index.js");
+var import_validate_credit_manager = require("./validate-credit-manager.js");
+const mockCreditManager = (0, import_test_utils.buildCreditManager)({
+  isPaused: false
+});
+(0, import_vitest.describe)("validateCreditManager", () => {
+  (0, import_vitest.it)("returns null when credit manager is not paused", () => {
+    const result = (0, import_validate_credit_manager.validateCreditManager)({
+      creditManager: mockCreditManager,
+      allowPausedCm: false
+    });
+    (0, import_vitest.expect)(result).toBeNull();
+  });
+  (0, import_vitest.it)("returns null when credit manager is paused but allowed", () => {
+    const result = (0, import_validate_credit_manager.validateCreditManager)({
+      creditManager: (0, import_test_utils.buildCreditManager)({
+        ...mockCreditManager,
+        isPaused: true
+      }),
+      allowPausedCm: true
+    });
+    (0, import_vitest.expect)(result).toBeNull();
+  });
+  (0, import_vitest.it)("returns error when credit manager is paused and not allowed", () => {
+    const result = (0, import_validate_credit_manager.validateCreditManager)({
+      creditManager: (0, import_test_utils.buildCreditManager)({
+        ...mockCreditManager,
+        isPaused: true
+      }),
+      allowPausedCm: false
+    });
+    (0, import_vitest.expect)(result).toEqual({ message: "paused" });
+  });
+});

package/dist/cjs/common-utils/utils/validation/validate-hf.js

@@ -0,0 +1,38 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var validate_hf_exports = {};
+__export(validate_hf_exports, {
+  MIN_HF_LIMITED: () => MIN_HF_LIMITED,
+  validateHF: () => validateHF
+});
+module.exports = __toCommonJS(validate_hf_exports);
+const MIN_HF_LIMITED = 10100n;
+function validateHF({
+  hf,
+  hfCheck = true
+}) {
+  if (hfCheck && (hf === void 0 || hf <= MIN_HF_LIMITED))
+    return { message: "hfTooLow" };
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MIN_HF_LIMITED,
+  validateHF
+});

package/dist/cjs/common-utils/utils/validation/validate-hf.spec.js

@@ -0,0 +1,24 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_validate_hf = require("./validate-hf.js");
+(0, import_vitest.describe)("validateHF", () => {
+  (0, import_vitest.it)("returns null when HF is above minimum", () => {
+    const result = (0, import_validate_hf.validateHF)({ hf: 15e3 });
+    (0, import_vitest.expect)(result).toBeNull();
+  });
+  (0, import_vitest.it)("returns error when HF is undefined", () => {
+    const result = (0, import_validate_hf.validateHF)({ hf: void 0 });
+    (0, import_vitest.expect)(result).toEqual({ message: "hfTooLow" });
+  });
+  (0, import_vitest.it)("returns error when HF is too low", () => {
+    const result = (0, import_validate_hf.validateHF)({ hf: Number(import_validate_hf.MIN_HF_LIMITED) });
+    (0, import_vitest.expect)(result).toEqual({ message: "hfTooLow" });
+  });
+  (0, import_vitest.it)("returns null when hfCheck is false and HF is too low", () => {
+    const result = (0, import_validate_hf.validateHF)({
+      hf: Number(import_validate_hf.MIN_HF_LIMITED - 1n),
+      hfCheck: false
+    });
+    (0, import_vitest.expect)(result).toBeNull();
+  });
+});