@gearbox-protocol/sdk 13.0.0-next.9 → 13.0.1

package/dist/cjs/abi/310/iLinearInterestRateModelV310.js

@@ -0,0 +1,92 @@
+"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 iLinearInterestRateModelV310_exports = {};
+__export(iLinearInterestRateModelV310_exports, {
+  iLinearInterestRateModelV310Abi: () => iLinearInterestRateModelV310Abi
+});
+module.exports = __toCommonJS(iLinearInterestRateModelV310_exports);
+const iLinearInterestRateModelV310Abi = [
+  {
+    type: "function",
+    name: "availableToBorrow",
+    inputs: [
+      { name: "expectedLiquidity", type: "uint256", internalType: "uint256" },
+      { name: "availableLiquidity", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "calcBorrowRate",
+    inputs: [
+      { name: "expectedLiquidity", type: "uint256", internalType: "uint256" },
+      { name: "availableLiquidity", type: "uint256", internalType: "uint256" },
+      { name: "checkOptimalBorrowing", type: "bool", internalType: "bool" }
+    ],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "contractType",
+    inputs: [],
+    outputs: [{ name: "", type: "bytes32", internalType: "bytes32" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getModelParameters",
+    inputs: [],
+    outputs: [
+      { name: "U_1", type: "uint16", internalType: "uint16" },
+      { name: "U_2", type: "uint16", internalType: "uint16" },
+      { name: "R_base", type: "uint16", internalType: "uint16" },
+      { name: "R_slope1", type: "uint16", internalType: "uint16" },
+      { name: "R_slope2", type: "uint16", internalType: "uint16" },
+      { name: "R_slope3", type: "uint16", internalType: "uint16" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "isBorrowingMoreU2Forbidden",
+    inputs: [],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "serialize",
+    inputs: [],
+    outputs: [{ name: "serializedData", type: "bytes", internalType: "bytes" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "version",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  }
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  iLinearInterestRateModelV310Abi
+});

package/dist/cjs/abi/errors.js

@@ -19,12 +19,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var errors_exports = {};
 __export(errors_exports, {
   errorAbis: () => errorAbis,
-  iExceptionsV300Abi: () => iExceptionsV300Abi,
   iExceptionsV310Abi: () => iExceptionsV310Abi,
   iPartialLiquidationBotV310ErrorsAbi: () => iPartialLiquidationBotV310ErrorsAbi,
   iRedstoneErrorsAbi: () => iRedstoneErrorsAbi,
   iRedstonePriceFeedExceptionsAbi: () => iRedstonePriceFeedExceptionsAbi,
-  iRouterErrorsV300Abi: () => iRouterErrorsV300Abi,
   iRouterErrorsV310Abi: () => iRouterErrorsV310Abi,
   ilpPriceFeedExceptionsAbi: () => ilpPriceFeedExceptionsAbi
 });
@@ -43,35 +41,6 @@ const ilpPriceFeedExceptionsAbi = [
   { type: "error", inputs: [], name: "UpdateBoundsBeforeCooldownException" },
   { type: "error", inputs: [], name: "UpdateBoundsNotAllowedException" }
 ];
-const iRouterErrorsV300Abi = [
-  {
-    type: "error",
-    inputs: [
-      { name: "tokenIn", internalType: "address", type: "address" },
-      { name: "tokenOut", internalType: "address", type: "address" }
-    ],
-    name: "PathNotFoundException"
-  },
-  {
-    type: "error",
-    inputs: [
-      { name: "ttIn", internalType: "uint8", type: "uint8" },
-      { name: "tokenOut", internalType: "address", type: "address" }
-    ],
-    name: "PathNotFoundExceptionTyped"
-  },
-  {
-    type: "error",
-    inputs: [{ name: "tokenOut", internalType: "address", type: "address" }],
-    name: "PathToTargetNotFound"
-  },
-  { type: "error", inputs: [], name: "UnsupportedAdapterType" },
-  {
-    type: "error",
-    inputs: [{ name: "", internalType: "address", type: "address" }],
-    name: "UnsupportedRouterComponent"
-  }
-];
 const iRouterErrorsV310Abi = [
   {
     type: "error",
@@ -101,116 +70,6 @@ const iRouterErrorsV310Abi = [
     inputs: [{ name: "", type: "address", internalType: "address" }]
   }
 ];
-const iExceptionsV300Abi = [
-  { type: "error", inputs: [], name: "ActiveCreditAccountNotSetException" },
-  { type: "error", inputs: [], name: "ActiveCreditAccountOverridenException" },
-  { type: "error", inputs: [], name: "AdapterIsNotRegisteredException" },
-  {
-    type: "error",
-    inputs: [{ name: "", internalType: "address", type: "address" }],
-    name: "AddressIsNotContractException"
-  },
-  { type: "error", inputs: [], name: "AddressNotFoundException" },
-  { type: "error", inputs: [], name: "AllowanceFailedException" },
-  { type: "error", inputs: [], name: "AmountCantBeZeroException" },
-  { type: "error", inputs: [], name: "BalanceLessThanExpectedException" },
-  { type: "error", inputs: [], name: "BorrowAmountOutOfLimitsException" },
-  { type: "error", inputs: [], name: "BorrowedBlockLimitException" },
-  { type: "error", inputs: [], name: "BorrowingMoreThanU2ForbiddenException" },
-  { type: "error", inputs: [], name: "CallerNotAccountFactoryException" },
-  { type: "error", inputs: [], name: "CallerNotAdapterException" },
-  { type: "error", inputs: [], name: "CallerNotConfiguratorException" },
-  { type: "error", inputs: [], name: "CallerNotControllerException" },
-  { type: "error", inputs: [], name: "CallerNotCreditAccountOwnerException" },
-  { type: "error", inputs: [], name: "CallerNotCreditFacadeException" },
-  { type: "error", inputs: [], name: "CallerNotCreditManagerException" },
-  { type: "error", inputs: [], name: "CallerNotExecutorException" },
-  { type: "error", inputs: [], name: "CallerNotGaugeException" },
-  { type: "error", inputs: [], name: "CallerNotMigratorException" },
-  { type: "error", inputs: [], name: "CallerNotPausableAdminException" },
-  { type: "error", inputs: [], name: "CallerNotPoolQuotaKeeperException" },
-  { type: "error", inputs: [], name: "CallerNotUnpausableAdminException" },
-  { type: "error", inputs: [], name: "CallerNotVetoAdminException" },
-  { type: "error", inputs: [], name: "CallerNotVoterException" },
-  { type: "error", inputs: [], name: "CloseAccountWithEnabledTokensException" },
-  { type: "error", inputs: [], name: "CloseAccountWithNonZeroDebtException" },
-  { type: "error", inputs: [], name: "CreditAccountDoesNotExistException" },
-  { type: "error", inputs: [], name: "CreditAccountIsInUseException" },
-  { type: "error", inputs: [], name: "CreditAccountNotLiquidatableException" },
-  { type: "error", inputs: [], name: "CreditManagerCantBorrowException" },
-  { type: "error", inputs: [], name: "CustomHealthFactorTooLowException" },
-  { type: "error", inputs: [], name: "DebtToZeroWithActiveQuotasException" },
-  { type: "error", inputs: [], name: "DebtUpdatedTwiceInOneBlockException" },
-  { type: "error", inputs: [], name: "ExpectedBalancesAlreadySetException" },
-  { type: "error", inputs: [], name: "ExpectedBalancesNotSetException" },
-  { type: "error", inputs: [], name: "ForbiddenInWhitelistedModeException" },
-  {
-    type: "error",
-    inputs: [],
-    name: "ForbiddenTokenBalanceIncreasedException"
-  },
-  { type: "error", inputs: [], name: "ForbiddenTokenEnabledException" },
-  { type: "error", inputs: [], name: "ForbiddenTokensException" },
-  { type: "error", inputs: [], name: "IncompatibleContractException" },
-  { type: "error", inputs: [], name: "IncompatibleCreditManagerException" },
-  { type: "error", inputs: [], name: "IncompatiblePoolQuotaKeeperException" },
-  { type: "error", inputs: [], name: "IncompatibleSuccessorException" },
-  { type: "error", inputs: [], name: "IncorrectExpirationDateException" },
-  { type: "error", inputs: [], name: "IncorrectLimitsException" },
-  { type: "error", inputs: [], name: "IncorrectLiquidationThresholdException" },
-  { type: "error", inputs: [], name: "IncorrectParameterException" },
-  { type: "error", inputs: [], name: "IncorrectPriceException" },
-  { type: "error", inputs: [], name: "IncorrectPriceFeedException" },
-  { type: "error", inputs: [], name: "IncorrectTokenContractException" },
-  { type: "error", inputs: [], name: "InsufficientBalanceException" },
-  { type: "error", inputs: [], name: "InsufficientRemainingFundsException" },
-  { type: "error", inputs: [], name: "InsufficientVotesException" },
-  { type: "error", inputs: [], name: "InvalidBotException" },
-  { type: "error", inputs: [], name: "InvalidCollateralHintException" },
-  {
-    type: "error",
-    inputs: [],
-    name: "MasterCreditAccountAlreadyDeployedException"
-  },
-  {
-    type: "error",
-    inputs: [{ name: "permission", internalType: "uint256", type: "uint256" }],
-    name: "NoPermissionException"
-  },
-  { type: "error", inputs: [], name: "NotAllowedAfterExpirationException" },
-  { type: "error", inputs: [], name: "NotAllowedWhenNotExpirableException" },
-  { type: "error", inputs: [], name: "NotApprovedBotException" },
-  { type: "error", inputs: [], name: "NotEnoughCollateralException" },
-  { type: "error", inputs: [], name: "NotImplementedException" },
-  { type: "error", inputs: [], name: "ParameterChangedAfterQueuedTxException" },
-  { type: "error", inputs: [], name: "ParameterChecksFailedException" },
-  { type: "error", inputs: [], name: "PriceFeedDoesNotExistException" },
-  { type: "error", inputs: [], name: "QuotaIsOutOfBoundsException" },
-  { type: "error", inputs: [], name: "ReceiveIsNotAllowedException" },
-  { type: "error", inputs: [], name: "RegisteredCreditManagerOnlyException" },
-  { type: "error", inputs: [], name: "RegisteredPoolOnlyException" },
-  {
-    type: "error",
-    inputs: [],
-    name: "RemainingTokenBalanceIncreasedException"
-  },
-  { type: "error", inputs: [], name: "StalePriceException" },
-  { type: "error", inputs: [], name: "TargetContractNotAllowedException" },
-  { type: "error", inputs: [], name: "TokenAlreadyAddedException" },
-  { type: "error", inputs: [], name: "TokenIsNotQuotedException" },
-  { type: "error", inputs: [], name: "TokenNotAllowedException" },
-  { type: "error", inputs: [], name: "TooManyEnabledTokensException" },
-  { type: "error", inputs: [], name: "TooManyTokensException" },
-  { type: "error", inputs: [], name: "TxExecutedOutsideTimeWindowException" },
-  { type: "error", inputs: [], name: "TxExecutionRevertedException" },
-  { type: "error", inputs: [], name: "TxNotQueuedException" },
-  { type: "error", inputs: [], name: "UnexpectedPermissionsException" },
-  { type: "error", inputs: [], name: "UnknownMethodException" },
-  { type: "error", inputs: [], name: "UpdateQuotaOnZeroDebtAccountException" },
-  { type: "error", inputs: [], name: "ValueOutOfRangeException" },
-  { type: "error", inputs: [], name: "VotingContractNotAllowedException" },
-  { type: "error", inputs: [], name: "ZeroAddressException" }
-];
 const iRedstoneErrorsAbi = [
   { type: "error", inputs: [], name: "CalldataMustHaveValidPayload" },
   { type: "error", inputs: [], name: "CalldataOverOrUnderFlow" },
@@ -407,24 +266,20 @@ const iPartialLiquidationBotV310ErrorsAbi = [
   { type: "error", name: "UnderlyingNotLiquidatableException", inputs: [] }
 ];
 const errorAbis = [
-  ...iExceptionsV300Abi,
   ...iExceptionsV310Abi,
   ...iRedstonePriceFeedExceptionsAbi,
   ...iRedstoneErrorsAbi,
   ...ilpPriceFeedExceptionsAbi,
-  ...iRouterErrorsV300Abi,
   ...iRouterErrorsV310Abi,
   ...iPartialLiquidationBotV310ErrorsAbi
 ];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   errorAbis,
-  iExceptionsV300Abi,
   iExceptionsV310Abi,
   iPartialLiquidationBotV310ErrorsAbi,
   iRedstoneErrorsAbi,
   iRedstonePriceFeedExceptionsAbi,
-  iRouterErrorsV300Abi,
   iRouterErrorsV310Abi,
   ilpPriceFeedExceptionsAbi
 });

package/dist/cjs/abi/iPriceFeed.js

@@ -0,0 +1,84 @@
+"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 iPriceFeed_exports = {};
+__export(iPriceFeed_exports, {
+  iPriceFeedAbi: () => iPriceFeedAbi
+});
+module.exports = __toCommonJS(iPriceFeed_exports);
+const iPriceFeedAbi = [
+  {
+    type: "function",
+    name: "contractType",
+    inputs: [],
+    outputs: [{ name: "", type: "bytes32", internalType: "bytes32" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "decimals",
+    inputs: [],
+    outputs: [{ name: "", type: "uint8", internalType: "uint8" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "description",
+    inputs: [],
+    outputs: [{ name: "", type: "string", internalType: "string" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "latestRoundData",
+    inputs: [],
+    outputs: [
+      { name: "", type: "uint80", internalType: "uint80" },
+      { name: "answer", type: "int256", internalType: "int256" },
+      { name: "", type: "uint256", internalType: "uint256" },
+      { name: "updatedAt", type: "uint256", internalType: "uint256" },
+      { name: "", type: "uint80", internalType: "uint80" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "serialize",
+    inputs: [],
+    outputs: [{ name: "serializedData", type: "bytes", internalType: "bytes" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "skipPriceCheck",
+    inputs: [],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "version",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  }
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  iPriceFeedAbi
+});

package/dist/cjs/{sdk/sdk-gov-legacy/oracles → common-utils}/index.js

@@ -13,10 +13,10 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var oracles_exports = {};
-module.exports = __toCommonJS(oracles_exports);
-__reExport(oracles_exports, require("./PriceFeedType.js"), module.exports);
+var common_utils_exports = {};
+module.exports = __toCommonJS(common_utils_exports);
+__reExport(common_utils_exports, require("./utils/index.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ...require("./PriceFeedType.js")
+  ...require("./utils/index.js")
 });

package/dist/cjs/common-utils/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

package/dist/cjs/common-utils/utils/assetsMath.js

@@ -0,0 +1,216 @@
+"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 assetsMath_exports = {};
+__export(assetsMath_exports, {
+  AssetUtils: () => AssetUtils
+});
+module.exports = __toCommonJS(assetsMath_exports);
+var import_bigintMath = require("./bigintMath.js");
+var import_sort = require("./creditAccount/sort.js");
+var import_priceMath = require("./priceMath.js");
+class AssetUtils {
+  constructor() {
+  }
+  /**
+   * Selects the next candidate token to add to a selected-asset list.
+   *
+   * Flow:
+   * 1) Removes tokens already present in `selectedAssets`
+   * 2) Builds balances for the remaining allowed tokens
+   * 3) Sorts the balances using `CreditAccountDataUtils.sortBalances`
+   * 4) Returns the highest-priority token address, if any
+   *
+   * Addresses are normalized to lowercase for matching.
+   *
+   * @returns The next token address to select, or `undefined` if no candidates remain.
+   */
+  static nextAsset({
+    allowedTokens,
+    selectedAssets,
+    balances,
+    tokensList,
+    prices = {}
+  }) {
+    const selectedRecord = selectedAssets.reduce(
+      (acc, { token }) => {
+        acc[token.toLowerCase()] = true;
+        return acc;
+      },
+      {}
+    );
+    const notSelected = allowedTokens.filter((allowedToken) => {
+      const alreadySelected = selectedRecord[allowedToken.toLowerCase()];
+      return !alreadySelected;
+    });
+    const sorted = (0, import_sort.sortBalances)(
+      AssetUtils.getBalances(notSelected, balances),
+      prices,
+      tokensList
+    );
+    const [address] = sorted[0] || [];
+    return address;
+  }
+  /**
+   * Builds a normalized balance record for a specific token subset.
+   *
+   * Missing balances are defaulted to `0n`.
+   *
+   * @param allowedTokens Tokens to include in the output record.
+   * @param externalBalances Source balances keyed by lowercase address.
+   * @returns A record that contains only `allowedTokens`.
+   */
+  static getBalances(allowedTokens, externalBalances) {
+    return allowedTokens.reduce((acc, address) => {
+      const addressLc = address.toLowerCase();
+      acc[addressLc] = externalBalances[addressLc] || 0n;
+      return acc;
+    }, {});
+  }
+  /**
+   * Converts an asset array into a token-address keyed record.
+   *
+   * If duplicate token addresses are present, the last occurrence wins.
+   *
+   * @param a Source asset list.
+   * @returns Record keyed by `asset.token`.
+   */
+  static constructAssetRecord(a) {
+    const record = a.reduce((acc, asset) => {
+      acc[asset.token] = asset;
+      return acc;
+    }, {});
+    return record;
+  }
+  /**
+   * Creates a reusable wrapper function that merges "unwrapped" and "wrapped"
+   * token balances into the wrapped token representation.
+   *
+   * The returned function:
+   * - converts non-negative unwrapped balance into wrapped units by price
+   * - adds the converted amount to the wrapped token balance
+   * - removes the unwrapped token from the result list
+   * - leaves input untouched when no unwrapped token is present
+   *
+   * @returns A function producing `[assets, convertedUnwrapped, originalWrapped]`.
+   */
+  static memoWrap = (unwrappedAddress, wrappedAddress, prices, tokensList) => function wrap(assets) {
+    const assetsRecord = AssetUtils.constructAssetRecord(assets);
+    const unwrapped = assetsRecord[unwrappedAddress];
+    const wrapped = assetsRecord[wrappedAddress];
+    const { balance: wrappedAmount = 0n } = wrapped || {};
+    if (unwrapped) {
+      const { balance: unwrappedAmount = 0n } = unwrapped || {};
+      const unwrappedToken = tokensList[unwrappedAddress];
+      const unwrappedPrice = prices[unwrappedAddress] || 0n;
+      const wrappedToken = tokensList[wrappedAddress];
+      const wrappedPrice = prices[wrappedAddress] || 0n;
+      const unwrappedInWrapped = import_priceMath.PriceUtils.convertByPrice(
+        import_priceMath.PriceUtils.calcTotalPrice(
+          unwrappedPrice,
+          import_bigintMath.BigIntMath.max(0n, unwrappedAmount),
+          unwrappedToken.decimals
+        ),
+        {
+          price: wrappedPrice,
+          decimals: wrappedToken.decimals
+        }
+      );
+      assetsRecord[wrappedAddress] = {
+        token: wrappedAddress,
+        balance: import_bigintMath.BigIntMath.max(0n, wrappedAmount) + unwrappedInWrapped
+      };
+      delete assetsRecord[unwrappedAddress];
+      return [Object.values(assetsRecord), unwrappedInWrapped, wrappedAmount];
+    }
+    return [Object.values(assetsRecord), 0n, wrappedAmount];
+  };
+  /**
+   * Adds balances from the second asset list into the first list.
+   *
+   * Behavior:
+   * - balances are clamped to non-negative before summation
+   * - tokens found only in `b` are created in the output
+   * - existing asset metadata is preserved from `a` when possible
+   *
+   * @param a Base asset list.
+   * @param b Asset deltas to add.
+   * @returns A merged list containing assets from both inputs.
+   */
+  static sumAssets(a, b) {
+    const aRecord = AssetUtils.constructAssetRecord(a);
+    const resRecord = b.reduce((acc, bAsset) => {
+      const aAsset = acc[bAsset.token];
+      const { balance: amount = 0n } = aAsset || {};
+      const amountSum = import_bigintMath.BigIntMath.max(0n, bAsset.balance) + import_bigintMath.BigIntMath.max(0n, amount);
+      const aOrB = aAsset || bAsset;
+      acc[bAsset.token] = {
+        ...aOrB,
+        balance: amountSum
+      };
+      return acc;
+    }, aRecord);
+    return Object.values(resRecord);
+  }
+  /**
+   * Adds balances from the second list to matching assets in the first list.
+   *
+   * Behavior:
+   * - balances are clamped to non-negative before summation
+   * - only assets already present in `a` are returned
+   * - no new token entries are created
+   *
+   * @param a Base asset list.
+   * @param b Asset deltas keyed by token.
+   * @returns Updated version of `a` with adjusted balances.
+   */
+  static addBalances(a, b) {
+    const bRecord = AssetUtils.constructAssetRecord(b);
+    return a.map((asset) => {
+      const bAsset = bRecord[asset.token];
+      const { balance: bAmount = 0n } = bAsset || {};
+      const amountSum = import_bigintMath.BigIntMath.max(0n, asset.balance) + import_bigintMath.BigIntMath.max(0n, bAmount);
+      return { ...asset, balance: amountSum };
+    });
+  }
+  /**
+   * Subtracts balances in the second list from matching assets in the first list.
+   *
+   * Behavior:
+   * - both operands are clamped to non-negative before subtraction
+   * - output balances are clamped to non-negative after subtraction
+   * - only assets already present in `a` are returned
+   *
+   * @param a Base asset list.
+   * @param b Asset amounts to subtract by token.
+   * @returns Updated `a` list with non-negative post-subtraction balances.
+   */
+  static subAssets(a, b) {
+    const bRecord = AssetUtils.constructAssetRecord(b);
+    return a.map((asset) => {
+      const bAsset = bRecord[asset.token];
+      const { balance: bAmount = 0n } = bAsset || {};
+      const amountSub = import_bigintMath.BigIntMath.max(0n, asset.balance) - import_bigintMath.BigIntMath.max(0n, bAmount);
+      return { ...asset, balance: import_bigintMath.BigIntMath.max(0n, amountSub) };
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AssetUtils
+});

package/dist/cjs/common-utils/utils/bigintMath.js

@@ -0,0 +1,65 @@
+"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 bigintMath_exports = {};
+__export(bigintMath_exports, {
+  BigIntMath: () => BigIntMath
+});
+module.exports = __toCommonJS(bigintMath_exports);
+class BigIntMath {
+  constructor() {
+  }
+  /**
+   * Returns the absolute (non-negative) value of a bigint.
+   *
+   * @param x Input value.
+   * @returns `x` when `x` is already non-negative, otherwise `-x`.
+   */
+  static abs = (x) => x < 0n ? -x : x;
+  /**
+   * Returns the greater of two bigint values.
+   *
+   * @param a First candidate value.
+   * @param b Second candidate value.
+   * @returns The larger value between `a` and `b`.
+   */
+  static max = (a, b) => a > b ? a : b;
+  /**
+   * Returns the smaller of two bigint values.
+   *
+   * @param a First candidate value.
+   * @param b Second candidate value.
+   * @returns The smaller value between `a` and `b`.
+   */
+  static min = (a, b) => a < b ? a : b;
+  /**
+   * Returns the negative form of a bigint if it is currently positive.
+   *
+   * Useful when a value should be represented as an outflow/debit:
+   * - positive values become negative
+   * - zero and negative values are returned unchanged
+   *
+   * @param a Input value.
+   * @returns A non-positive bigint representation of `a`.
+   */
+  static neg = (a) => a > 0 ? a * -1n : a;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BigIntMath
+});