@gearbox-protocol/sdk 14.12.0-next.8 → 14.12.0-test.1

package/dist/cjs/sdk/accounts/withdrawal-compressor/intent-codec.js

@@ -0,0 +1,121 @@
+"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 intent_codec_exports = {};
+__export(intent_codec_exports, {
+  DELAYED_INTENT_TYPES: () => DELAYED_INTENT_TYPES,
+  DELAYED_INTENT_VERSION: () => DELAYED_INTENT_VERSION,
+  decodeDelayedIntent: () => decodeDelayedIntent,
+  encodeDelayedIntent: () => encodeDelayedIntent
+});
+module.exports = __toCommonJS(intent_codec_exports);
+var import_viem = require("viem");
+const DELAYED_INTENT_VERSION = 2;
+const DELAYED_INTENT_TYPES = {
+  INCREASE_LEVERAGE: 1,
+  DEPOSIT: 2,
+  DEPOSIT_AND_INCREASE_LEVERAGE: 3,
+  WITHDRAW_COLLATERAL: 4,
+  CLOSE_ACCOUNT: 5,
+  ADD_COLLATERAL: 6,
+  DECREASE_LEVERAGE: 7
+};
+const HEADER_PARAMS = [
+  { type: "uint8", name: "version" },
+  { type: "uint8", name: "intentType" }
+];
+const TO_PARAMS = [...HEADER_PARAMS, { type: "address", name: "to" }];
+const WITHDRAW_COLLATERAL_PARAMS = [
+  ...TO_PARAMS,
+  { type: "address", name: "withdrawToken" },
+  { type: "uint256", name: "withdrawAmount" },
+  { type: "address", name: "sourceToken" },
+  { type: "uint256", name: "debtRepaid" }
+];
+function encodeDelayedIntent(intent) {
+  const version = DELAYED_INTENT_VERSION;
+  const intentType = DELAYED_INTENT_TYPES[intent.type];
+  switch (intent.type) {
+    case "INCREASE_LEVERAGE":
+    case "CLOSE_ACCOUNT":
+      return (0, import_viem.encodeAbiParameters)(TO_PARAMS, [version, intentType, intent.to]);
+    case "WITHDRAW_COLLATERAL":
+      return (0, import_viem.encodeAbiParameters)(WITHDRAW_COLLATERAL_PARAMS, [
+        version,
+        intentType,
+        intent.to,
+        intent.withdrawToken,
+        intent.withdrawAmount,
+        intent.sourceToken,
+        intent.debtRepaid
+      ]);
+    case "DEPOSIT":
+    case "DEPOSIT_AND_INCREASE_LEVERAGE":
+    case "ADD_COLLATERAL":
+    case "DECREASE_LEVERAGE":
+      return (0, import_viem.encodeAbiParameters)(HEADER_PARAMS, [version, intentType]);
+    default: {
+      const t = intent;
+      throw new Error(`unknown delayed intent: ${JSON.stringify(t)}`);
+    }
+  }
+}
+function decodeDelayedIntent(data) {
+  const [version, intentType] = (0, import_viem.decodeAbiParameters)(HEADER_PARAMS, data);
+  if (version !== DELAYED_INTENT_VERSION) {
+    throw new Error(`unsupported delayed intent version: ${version}`);
+  }
+  switch (intentType) {
+    case DELAYED_INTENT_TYPES.INCREASE_LEVERAGE: {
+      const [, , to] = (0, import_viem.decodeAbiParameters)(TO_PARAMS, data);
+      return { type: "INCREASE_LEVERAGE", to };
+    }
+    case DELAYED_INTENT_TYPES.DEPOSIT:
+      return { type: "DEPOSIT" };
+    case DELAYED_INTENT_TYPES.DEPOSIT_AND_INCREASE_LEVERAGE:
+      return { type: "DEPOSIT_AND_INCREASE_LEVERAGE" };
+    case DELAYED_INTENT_TYPES.WITHDRAW_COLLATERAL: {
+      const [, , to, withdrawToken, withdrawAmount, sourceToken, debtRepaid] = (0, import_viem.decodeAbiParameters)(WITHDRAW_COLLATERAL_PARAMS, data);
+      return {
+        type: "WITHDRAW_COLLATERAL",
+        to,
+        withdrawToken,
+        withdrawAmount,
+        sourceToken,
+        debtRepaid
+      };
+    }
+    case DELAYED_INTENT_TYPES.CLOSE_ACCOUNT: {
+      const [, , to] = (0, import_viem.decodeAbiParameters)(TO_PARAMS, data);
+      return { type: "CLOSE_ACCOUNT", to };
+    }
+    case DELAYED_INTENT_TYPES.ADD_COLLATERAL:
+      return { type: "ADD_COLLATERAL" };
+    case DELAYED_INTENT_TYPES.DECREASE_LEVERAGE:
+      return { type: "DECREASE_LEVERAGE" };
+    default:
+      throw new Error(`unknown delayed intent type: ${intentType}`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DELAYED_INTENT_TYPES,
+  DELAYED_INTENT_VERSION,
+  decodeDelayedIntent,
+  encodeDelayedIntent
+});

package/dist/cjs/sdk/accounts/withdrawal-compressor/types.js

@@ -0,0 +1,36 @@
+"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 types_exports = {};
+__export(types_exports, {
+  toWithdrawalStatus: () => toWithdrawalStatus
+});
+module.exports = __toCommonJS(types_exports);
+const WITHDRAWAL_STATUSES = [
+  "NULL",
+  "PENDING",
+  "CLAIMABLE",
+  "CLAIMED"
+];
+function toWithdrawalStatus(status) {
+  return WITHDRAWAL_STATUSES[status] ?? "NULL";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  toWithdrawalStatus
+});

package/dist/cjs/sdk/base/BaseContract.js

@@ -244,6 +244,7 @@ class BaseContract extends import_Construct.Construct {
       const functionName = (0, import_utils.getFunctionSignature)(this.abi, calldata);
       return this.wrapParseCallV2(
         functionName,
+        calldata,
         this.parseFunctionParamsV2(decoded, strict)
       );
     } catch (e) {
@@ -257,7 +258,7 @@ class BaseContract extends import_Construct.Construct {
       this.logger?.warn(e);
       const selector = calldata.slice(0, 10);
       const data = `0x${calldata.slice(10)}`;
-      return this.wrapParseCallV2(`unknown function ${selector}`, {
+      return this.wrapParseCallV2(`unknown function ${selector}`, calldata, {
         _data: data
       });
     }
@@ -270,7 +271,7 @@ class BaseContract extends import_Construct.Construct {
   parseFunctionParamsV2(params, _strict) {
     return (0, import_utils.functionArgsToRecord)(this.abi, params.functionName, params.args);
   }
-  wrapParseCallV2(functionName, rawArgs) {
+  wrapParseCallV2(functionName, calldata, rawArgs) {
     return {
       chainId: this.chainId,
       target: this.address,
@@ -278,6 +279,7 @@ class BaseContract extends import_Construct.Construct {
       label: this.labelAddress(this.address, true),
       version: this.version,
       functionName,
+      calldata,
       rawArgs
     };
   }

package/dist/cjs/sdk/base/ChainContractsRegister.js

@@ -184,6 +184,7 @@ class ChainContractsRegister {
       label: this.labelAddress(address, true),
       version: 0,
       functionName: `unknown function ${selector}`,
+      calldata,
       rawArgs: { _data: data }
     };
   }

package/dist/cjs/sdk/constants/address-provider.js

@@ -43,6 +43,7 @@ __export(address_provider_exports, {
   AP_PRICE_FEED_COMPRESSOR: () => AP_PRICE_FEED_COMPRESSOR,
   AP_PRICE_FEED_STORE: () => AP_PRICE_FEED_STORE,
   AP_PRICE_ORACLE: () => AP_PRICE_ORACLE,
+  AP_REDEMPTION_LOGGER: () => AP_REDEMPTION_LOGGER,
   AP_REWARDS_COMPRESSOR: () => AP_REWARDS_COMPRESSOR,
   AP_ROUTER: () => AP_ROUTER,
   AP_RWA_COMPRESSOR: () => AP_RWA_COMPRESSOR,
@@ -89,6 +90,7 @@ const AP_WETH_TOKEN = "WETH_TOKEN";
 const AP_ZAPPER_REGISTER = "ZAPPER_REGISTER";
 const AP_ZERO_PRICE_FEED = "ZERO_PRICE_FEED";
 const AP_RWA_COMPRESSOR = "GLOBAL::RWA_COMPRESSOR";
+const AP_REDEMPTION_LOGGER = "LOCAL::REDEMPTION_LOGGER";
 const ADDRESS_PROVIDER_V310 = "0xF7f0a609BfAb9a0A98786951ef10e5FE26cC1E38";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -117,6 +119,7 @@ const ADDRESS_PROVIDER_V310 = "0xF7f0a609BfAb9a0A98786951ef10e5FE26cC1E38";
   AP_PRICE_FEED_COMPRESSOR,
   AP_PRICE_FEED_STORE,
   AP_PRICE_ORACLE,
+  AP_REDEMPTION_LOGGER,
   AP_REWARDS_COMPRESSOR,
   AP_ROUTER,
   AP_RWA_COMPRESSOR,

package/dist/cjs/sdk/market/credit/CreditFacadeV310BaseContract.js

@@ -22,7 +22,6 @@ __export(CreditFacadeV310BaseContract_exports, {
   creditFacadeV310Abi: () => abi
 });
 module.exports = __toCommonJS(CreditFacadeV310BaseContract_exports);
-var import_viem = require("viem");
 var import_generated = require("../../../abi/310/generated.js");
 var import_iPausable = require("../../../abi/iPausable.js");
 var import_base = require("../../base/index.js");
@@ -35,36 +34,6 @@ class CreditFacadeV310BaseContract extends import_base.BaseContract {
   constructor(options, args) {
     super(options, { ...args, abi });
   }
-  /**
-   * Decodes entry-point calldata with the facade ABI and returns the untouched
-   * inner multicall structs (targets with still-ABI-encoded `callData`).
-   *
-   * Unlike {@link ChainContractsRegister.parseMultiCallV2}, the inner calls are
-   * not decoded, so callers can re-decode them with a specific contract's ABI.
-   *
-   * @throws When the calldata cannot be decoded or the function has no inner
-   * multicall argument.
-   */
-  extractRawInnerCalls(calldata) {
-    const decoded = (0, import_viem.decodeFunctionData)({ abi: this.abi, data: calldata });
-    switch (decoded.functionName) {
-      case "openCreditAccount":
-      case "closeCreditAccount":
-      case "botMulticall":
-      case "multicall": {
-        const [, calls] = decoded.args;
-        return [...calls];
-      }
-      case "liquidateCreditAccount": {
-        const [, , calls] = decoded.args;
-        return [...calls];
-      }
-      default:
-        throw new Error(
-          `function ${decoded.functionName} on ${this.name} has no inner multicall`
-        );
-    }
-  }
   parseFunctionParamsV2(params, strict) {
     switch (params.functionName) {
       case "openCreditAccount": {

package/dist/cjs/sdk/market/rwa/securitize/SecuritizeRWAFactory.js

@@ -70,31 +70,6 @@ class SecuritizeRWAFactory extends import_base.BaseContract {
       operators: [...t.operators]
     }));
   }
-  /**
-   * Decodes entry-point calldata with the factory ABI and returns the
-   * untouched inner multicall structs (targets with still-ABI-encoded
-   * `callData`).
-   *
-   * Unlike {@link ChainContractsRegister.parseMultiCallV2}, the inner calls are
-   * not decoded, so callers can re-decode them with a specific contract's ABI.
-   *
-   * @throws When the calldata cannot be decoded or the function has no inner
-   * multicall argument.
-   */
-  extractRawInnerCalls(calldata) {
-    const decoded = (0, import_viem.decodeFunctionData)({ abi: this.abi, data: calldata });
-    switch (decoded.functionName) {
-      case "openCreditAccount":
-      case "multicall": {
-        const [, calls] = decoded.args;
-        return [...calls];
-      }
-      default:
-        throw new Error(
-          `function ${decoded.functionName} on ${this.name} has no inner multicall`
-        );
-    }
-  }
   parseFunctionParamsV2(params, strict) {
     switch (params.functionName) {
       case "openCreditAccount": {
@@ -214,8 +189,8 @@ class SecuritizeRWAFactory extends import_base.BaseContract {
   /**
    * {@inheritDoc IRWAFactory.multicall}
    */
-  multicall(creditAccount, calls, options) {
-    const { tokensToRegister = [], signaturesToCache = [] } = options ?? {};
+  multicall(creditAccount, calls, args) {
+    const { tokensToRegister = [], signaturesToCache = [] } = args ?? {};
     return this.createRawTx({
       functionName: "multicall",
       args: [creditAccount, calls, tokensToRegister, signaturesToCache]
@@ -245,11 +220,33 @@ class SecuritizeRWAFactory extends import_base.BaseContract {
       requiredSignatures
     };
   }
+  /**
+   * {@inheritDoc IRWAFactory.getMissingRequirements}
+   *
+   * A required signature is omitted when `providedArgs.signaturesToCache`
+   * already carries a signature for the same token: the transaction caches it
+   * on-chain as part of the operation.
+   */
+  getMissingRequirements(requirements, providedArgs) {
+    const providedTokens = new import_utils.AddressSet(
+      (providedArgs?.signaturesToCache ?? []).map((s) => s.token)
+    );
+    const requiredSignatures = requirements.requiredSignatures.filter(
+      (message) => !providedTokens.has(message.message.token)
+    );
+    if (requiredSignatures.length === 0) {
+      return void 0;
+    }
+    return {
+      type: import_constants.RWA_FACTORY_SECURITIZE,
+      requiredSignatures
+    };
+  }
   /**
    * {@inheritDoc IRWAFactory.openCreditAccount}
    */
-  openCreditAccount(creditManager, calls, options) {
-    const { tokensToRegister = [], signaturesToCache = [] } = options ?? {};
+  openCreditAccount(creditManager, calls, args) {
+    const { tokensToRegister = [], signaturesToCache = [] } = args ?? {};
     return this.createRawTx({
       functionName: "openCreditAccount",
       args: [creditManager, calls, tokensToRegister, signaturesToCache]

package/dist/cjs/sdk/router/AbstractRouterContract.js

@@ -41,15 +41,15 @@ class AbstractRouterContract extends import_base.BaseContract {
       options.debtOnly
     );
     const { leftoverBalances, expectedBalances, tokensToClaim } = b;
-    const expected = new import_utils.AddressMap();
-    const leftover = new import_utils.AddressMap();
+    const expected = new import_utils.AssetsMap();
+    const leftover = new import_utils.AssetsMap();
     for (const token of cm.collateralTokens) {
-      const actual = expectedBalances.get(token)?.balance || 0n;
-      expected.upsert(token, { token, balance: actual > 10n ? actual : 0n });
-      leftover.upsert(token, {
+      const actual = expectedBalances.get(token) || 0n;
+      expected.upsert(token, actual > 10n ? actual : 0n);
+      leftover.upsert(
         token,
-        balance: (0, import_helpers.limitLeftover)(leftoverBalances.get(token)?.balance || 1n, token) ?? 1n
-      });
+        (0, import_helpers.limitLeftover)(leftoverBalances.get(token) || 1n, token) ?? 1n
+      );
     }
     return {
       expectedBalances: expected,
@@ -58,8 +58,8 @@ class AbstractRouterContract extends import_base.BaseContract {
     };
   }
   getDefaultExpectedAndLeftover(ca, keepAssets, debtOnly) {
-    const expectedBalances = new import_utils.AddressMap();
-    const leftoverBalances = new import_utils.AddressMap();
+    const expectedBalances = new import_utils.AssetsMap();
+    const leftoverBalances = new import_utils.AssetsMap();
     const keepAssetsSet = new import_utils.AddressSet(keepAssets);
     if (debtOnly) {
       const result = this.getLeftoversAfterBuyingDebt(ca, keepAssetsSet);
@@ -71,23 +71,23 @@ class AbstractRouterContract extends import_base.BaseContract {
     }
     for (const { token, balance, mask } of ca.tokens) {
       const isEnabled = (mask & ca.enabledTokensMask) !== 0n;
-      expectedBalances.upsert(token, { token, balance });
+      expectedBalances.upsert(token, balance);
       if (keepAssetsSet.has(token) || !isEnabled || (0, import_utils.isDust)({
         sdk: this.sdk,
         token,
         balance,
         creditManager: ca.creditManager
       })) {
-        leftoverBalances.upsert(token, {
+        leftoverBalances.upsert(
           token,
-          balance: (0, import_helpers.limitLeftover)(balance, token) ?? balance
-        });
+          (0, import_helpers.limitLeftover)(balance, token) ?? balance
+        );
       }
     }
     return {
       expectedBalances,
       leftoverBalances,
-      tokensToClaim: new import_utils.AddressMap()
+      tokensToClaim: new import_utils.AssetsMap()
     };
   }
   /**
@@ -100,16 +100,13 @@ class AbstractRouterContract extends import_base.BaseContract {
     const { priceOracle } = this.sdk.marketRegister.findByCreditManager(
       ca.creditManager
     );
-    const expectedBalances = new import_utils.AddressMap();
-    const leftoverBalances = new import_utils.AddressMap();
+    const expectedBalances = new import_utils.AssetsMap();
+    const leftoverBalances = new import_utils.AssetsMap();
     const usdBalances = [];
     for (const { token, balance, mask } of ca.tokens) {
       const isEnabled = (mask & ca.enabledTokensMask) !== 0n;
-      expectedBalances.upsert(token, { token, balance });
-      leftoverBalances.upsert(token, {
-        token,
-        balance: (0, import_helpers.limitLeftover)(balance, token) ?? balance
-      });
+      expectedBalances.upsert(token, balance);
+      leftoverBalances.upsert(token, (0, import_helpers.limitLeftover)(balance, token) ?? balance);
       if (isEnabled && !keepAssets.has(token)) {
         usdBalances.push({
           token,
@@ -139,15 +136,12 @@ class AbstractRouterContract extends import_base.BaseContract {
     if (tokenAmount === 0n) {
       return void 0;
     }
-    let leftoverBalance = leftoverBalances.get(highestToken.token)?.balance ?? 0n;
+    let leftoverBalance = leftoverBalances.get(highestToken.token) ?? 0n;
     leftoverBalance -= tokenAmount;
     if (leftoverBalance < 0n) {
       return void 0;
     }
-    leftoverBalances.upsert(highestToken.token, {
-      token: highestToken.token,
-      balance: leftoverBalance
-    });
+    leftoverBalances.upsert(highestToken.token, leftoverBalance);
     const tokenAmountStr = this.sdk.tokensMeta.formatBN(
       highestToken.token,
       tokenAmount,
@@ -160,7 +154,7 @@ class AbstractRouterContract extends import_base.BaseContract {
     return {
       expectedBalances,
       leftoverBalances,
-      tokensToClaim: new import_utils.AddressMap()
+      tokensToClaim: new import_utils.AssetsMap()
     };
   }
   safeConvertToUSD(priceOracle, token, balance) {

package/dist/cjs/sdk/router/RouterV310Contract.js

@@ -23,14 +23,13 @@ __export(RouterV310Contract_exports, {
 module.exports = __toCommonJS(RouterV310Contract_exports);
 var import_viem = require("viem");
 var import_gearboxRouter = require("../../abi/router/gearboxRouter.js");
-var import_AddressMap = require("../utils/AddressMap.js");
 var import_formatter = require("../utils/formatter.js");
 var import_utils = require("../utils/index.js");
 var import_AbstractRouterContract = require("./AbstractRouterContract.js");
 var import_helpers = require("./helpers.js");
 const abi = import_gearboxRouter.gearboxRouterAbi;
 class RouterV310Contract extends import_AbstractRouterContract.AbstractRouterContract {
-  #numSplits = new import_AddressMap.AddressMap();
+  #numSplits = new import_utils.AddressMap();
   #defaultNumSplits = 4n;
   constructor(sdk, address, version) {
     super(sdk, {
@@ -94,8 +93,8 @@ class RouterV310Contract extends import_AbstractRouterContract.AbstractRouterCon
       slippage
     } = props;
     const [expectedMap, leftoverMap] = [
-      (0, import_helpers.balancesMap)(expectedBalances),
-      (0, import_helpers.balancesMap)(leftoverBalances)
+      new import_utils.AssetsMap(expectedBalances),
+      new import_utils.AssetsMap(leftoverBalances)
     ];
     const getNumSplits = this.#numSplitsGetter(cm, expectedBalances);
     const tData = cm.collateralTokens.map(
@@ -180,22 +179,22 @@ class RouterV310Contract extends import_AbstractRouterContract.AbstractRouterCon
     } = props;
     const { expectedBalances, leftoverBalances, tokensToClaim } = this.getExpectedAndLeftover(ca, cm, {
       balances: balances ? {
-        expectedBalances: (0, import_helpers.assetsMap)(balances.expectedBalances),
-        leftoverBalances: (0, import_helpers.assetsMap)(balances.leftoverBalances),
-        tokensToClaim: (0, import_helpers.assetsMap)(balances.tokensToClaim || [])
+        expectedBalances: new import_utils.AssetsMap(balances.expectedBalances),
+        leftoverBalances: new import_utils.AssetsMap(balances.leftoverBalances),
+        tokensToClaim: new import_utils.AssetsMap(balances.tokensToClaim || [])
       } : void 0,
       keepAssets: balances ? void 0 : keepAssets,
       debtOnly
     });
-    const getNumSplits = this.#numSplitsGetter(cm, expectedBalances.values());
+    const getNumSplits = this.#numSplitsGetter(cm, expectedBalances.toAssets());
     const tData = [];
     for (const token of cm.collateralTokens) {
       tData.push({
         token,
-        balance: expectedBalances.get(token)?.balance || 0n,
-        leftoverBalance: (0, import_helpers.limitLeftover)(leftoverBalances.get(token)?.balance, token) ?? 0n,
+        balance: expectedBalances.get(token) || 0n,
+        leftoverBalance: (0, import_helpers.limitLeftover)(leftoverBalances.get(token), token) ?? 0n,
         numSplits: getNumSplits(token),
-        claimRewards: !!tokensToClaim.get(token)
+        claimRewards: tokensToClaim.has(token)
       });
     }
     this.logger?.debug(
@@ -278,7 +277,7 @@ class RouterV310Contract extends import_AbstractRouterContract.AbstractRouterCon
       })),
       "balances in usd"
     );
-    const map = new import_AddressMap.AddressMap(
+    const map = new import_utils.AddressMap(
       inUSD.map(({ token }, i) => [
         token,
         i === 0 ? this.#defaultNumSplits : 1n

package/dist/cjs/sdk/router/helpers.js

@@ -19,14 +19,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var helpers_exports = {};
 __export(helpers_exports, {
   assetsMap: () => assetsMap,
-  balancesMap: () => balancesMap,
   limitLeftover: () => limitLeftover
 });
 module.exports = __toCommonJS(helpers_exports);
 var import_utils = require("../utils/index.js");
-function balancesMap(assets) {
-  return new import_utils.AddressMap(assets.map(({ token, balance }) => [token, balance]));
-}
 function assetsMap(assets) {
   return new import_utils.AddressMap(assets.map((a) => [a.token, a]));
 }
@@ -42,6 +38,5 @@ function limitLeftover(balance, token) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   assetsMap,
-  balancesMap,
   limitLeftover
 });

package/dist/cjs/sdk/utils/AddressMap.js

@@ -136,6 +136,12 @@ class AddressMap {
   keys() {
     return Array.from(this.#map.keys());
   }
+  /**
+   * Returns an unfrozen shallow copy of the map.
+   **/
+  clone() {
+    return new AddressMap(this.entries(), this.name);
+  }
   /**
    * Converts the map to a plain `Record<Address, T>` object.
    **/

package/dist/cjs/sdk/utils/AddressSet.js

@@ -38,6 +38,13 @@ class AddressSet extends Set {
   has(value) {
     return super.has((0, import_viem.getAddress)(value));
   }
+  difference(other) {
+    const result = new AddressSet(this.keys());
+    for (const key of other) {
+      result.delete((0, import_viem.getAddress)(key));
+    }
+    return result;
+  }
   /**
    * Returns all addresses as an array.
    **/

package/dist/cjs/sdk/utils/AssetsMap.js

@@ -0,0 +1,97 @@
+"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 AssetsMap_exports = {};
+__export(AssetsMap_exports, {
+  AssetsMap: () => AssetsMap
+});
+module.exports = __toCommonJS(AssetsMap_exports);
+var import_AddressMap = require("./AddressMap.js");
+class AssetsMap extends import_AddressMap.AddressMap {
+  /**
+   * @param entries - Optional initial entries as `[address, balance]` tuples or {@link Asset} objects.
+   * @param name - Optional label used in error messages when a lookup fails.
+   */
+  constructor(entries, name) {
+    super(
+      entries?.map((e) => Array.isArray(e) ? e : [e.token, e.balance]),
+      name
+    );
+  }
+  /**
+   * Looks up a token balance, treating a missing key as `0n`.
+   */
+  getOrZero(address) {
+    return this.get(address) ?? 0n;
+  }
+  /**
+   * Adds `amount` to the token balance, treating a missing key as `0n`.
+   */
+  inc(address, amount) {
+    this.upsert(address, this.getOrZero(address) + amount);
+  }
+  /**
+   * Subtracts `amount` from the token balance, treating a missing key as `0n`.
+   */
+  dec(address, amount) {
+    this.inc(address, -amount);
+  }
+  /**
+   * Per-token difference `this - before`, non-zero entries only.
+   *
+   * Assumes this map's keys are a superset of `before`'s keys; tokens present
+   * only in `before` are not reported.
+   */
+  difference(before) {
+    const result = new AssetsMap();
+    for (const [token, balance] of this.entries()) {
+      const change = balance - before.getOrZero(token);
+      if (change !== 0n) {
+        result.upsert(token, change);
+      }
+    }
+    return result;
+  }
+  /**
+   * Sums `fn` over all entries.
+   */
+  sum(fn) {
+    return this.entries().reduce(
+      (acc, [token, balance]) => acc + fn(token, balance),
+      0n
+    );
+  }
+  /**
+   * Converts the map to an array of {@link Asset} objects.
+   * @param minBalance - If provided, keeps only entries with a balance
+   * strictly greater than this threshold (e.g. `1n` to filter out dust).
+   */
+  toAssets(minBalance) {
+    const abs = (balance) => balance > 0n ? balance : -balance;
+    return this.entries().filter(
+      ([, balance]) => minBalance === void 0 || abs(balance) > minBalance
+    ).map(([token, balance]) => ({ token, balance }));
+  }
+  clone() {
+    return new AssetsMap(this.entries(), this.name);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AssetsMap
+});