@gearbox-protocol/sdk 14.12.0-next.12 → 14.12.0-next.14

package/dist/cjs/preview/prerequisites/buildPoolPrerequisites.js

@@ -0,0 +1,125 @@
+"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 buildPoolPrerequisites_exports = {};
+__export(buildPoolPrerequisites_exports, {
+  buildPoolPrerequisites: () => buildPoolPrerequisites
+});
+module.exports = __toCommonJS(buildPoolPrerequisites_exports);
+var import_viem = require("viem");
+var import_sdk = require("../../sdk/index.js");
+var import_AllowancePrerequisite = require("./AllowancePrerequisite.js");
+var import_BalancePrerequisite = require("./BalancePrerequisite.js");
+var import_helpers = require("./helpers.js");
+function buildPoolPrerequisites(tx, wallet) {
+  switch (tx.operation) {
+    // Deposit and Mint both pull the underlying from the caller into the pool;
+    // they only differ in which side (assets vs shares) the caller specifies.
+    // The exact underlying amount for Mint is resolved by the pool, so we can
+    // only require an allowance/balance against the known specified amount —
+    // here we approximate Mint by its shares amount (a lower bound on assets is
+    // not knowable from calldata alone).
+    case "Deposit":
+      if (tx.zapper) {
+        if ((0, import_viem.isAddressEqual)(tx.tokenIn, import_sdk.NATIVE_ADDRESS)) {
+          return [
+            new import_BalancePrerequisite.BalancePrerequisite({
+              token: tx.tokenIn,
+              owner: wallet,
+              required: tx.assets,
+              title: "Sufficient token balance"
+            })
+          ];
+        }
+        return (0, import_helpers.allowanceAndBalance)({
+          token: tx.tokenIn,
+          owner: wallet,
+          spender: tx.zapper,
+          required: tx.assets,
+          allowanceTitle: "Token approved to zapper",
+          balanceTitle: "Sufficient token balance"
+        });
+      }
+      return (0, import_helpers.allowanceAndBalance)({
+        token: tx.underlying,
+        owner: wallet,
+        spender: tx.pool,
+        required: tx.assets,
+        allowanceTitle: "Token approved to pool",
+        balanceTitle: "Sufficient token balance"
+      });
+    case "Mint":
+      return (0, import_helpers.allowanceAndBalance)({
+        token: tx.underlying,
+        owner: wallet,
+        spender: tx.pool,
+        required: tx.shares,
+        allowanceTitle: "Token approved to pool",
+        balanceTitle: "Sufficient token balance"
+      });
+    // Redeem and Withdraw both burn LP shares from `owner`; they only differ in
+    // which side (shares vs assets) the caller specifies.
+    case "Redeem":
+      if (tx.zapper) {
+        return [
+          new import_BalancePrerequisite.BalancePrerequisite({
+            token: tx.tokenIn,
+            owner: wallet,
+            required: tx.shares,
+            title: "Sufficient share token balance"
+          }),
+          new import_AllowancePrerequisite.AllowancePrerequisite({
+            token: tx.tokenIn,
+            owner: wallet,
+            spender: tx.zapper,
+            required: tx.shares,
+            title: "Share token approved to zapper"
+          })
+        ];
+      }
+      return lpSharePrerequisites(tx.pool, tx.owner, tx.shares, wallet);
+    case "Withdraw":
+      return lpSharePrerequisites(tx.pool, tx.owner, tx.assets, wallet);
+  }
+}
+function lpSharePrerequisites(pool, owner, required, wallet) {
+  const prereqs = [
+    new import_BalancePrerequisite.BalancePrerequisite({
+      token: pool,
+      owner,
+      required,
+      title: "Sufficient LP token balance"
+    })
+  ];
+  if (!(0, import_viem.isAddressEqual)(owner, wallet)) {
+    prereqs.push(
+      new import_AllowancePrerequisite.AllowancePrerequisite({
+        token: pool,
+        owner,
+        spender: wallet,
+        required,
+        title: "LP token approved to caller"
+      })
+    );
+  }
+  return prereqs;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildPoolPrerequisites
+});

package/dist/cjs/preview/prerequisites/buildRWAPrerequisites.js

@@ -0,0 +1,57 @@
+"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 buildRWAPrerequisites_exports = {};
+__export(buildRWAPrerequisites_exports, {
+  buildRWAPrerequisites: () => buildRWAPrerequisites
+});
+module.exports = __toCommonJS(buildRWAPrerequisites_exports);
+var import_sdk = require("../../sdk/index.js");
+var import_RWAOpenRequirementsPrerequisite = require("./RWAOpenRequirementsPrerequisite.js");
+function buildRWAPrerequisites(multicall, creditManager, providedArgs, ctx) {
+  const { rwaFactory } = ctx.sdk.marketRegister.findByCreditManager(creditManager);
+  if (!rwaFactory) {
+    return [];
+  }
+  const rwaTokens = new import_sdk.AddressSet(rwaFactory.getTokens());
+  const candidates = new import_sdk.AddressSet();
+  for (const op of multicall) {
+    if (op.operation === "AddCollateral" || op.operation === "UpdateQuota") {
+      candidates.add(op.token);
+    }
+  }
+  const prereqs = [];
+  for (const token of candidates) {
+    if (!rwaTokens.has(token)) {
+      continue;
+    }
+    prereqs.push(
+      new import_RWAOpenRequirementsPrerequisite.RWAOpenRequirementsPrerequisite({
+        token,
+        creditManager,
+        factory: rwaFactory.address,
+        providedArgs
+      })
+    );
+  }
+  return prereqs;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildRWAPrerequisites
+});

package/dist/cjs/preview/prerequisites/checkPrerequisites.js

@@ -0,0 +1,85 @@
+"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 checkPrerequisites_exports = {};
+__export(checkPrerequisites_exports, {
+  checkPrerequisites: () => checkPrerequisites
+});
+module.exports = __toCommonJS(checkPrerequisites_exports);
+var import_parseOperationCalldata = require("../parse/parseOperationCalldata.js");
+var import_buildCollateralPrerequisites = require("./buildCollateralPrerequisites.js");
+var import_buildPartialLiquidationPrerequisites = require("./buildPartialLiquidationPrerequisites.js");
+var import_buildPoolPrerequisites = require("./buildPoolPrerequisites.js");
+var import_buildRWAPrerequisites = require("./buildRWAPrerequisites.js");
+async function checkPrerequisites(input) {
+  const { sdk, sender: wallet, blockNumber } = input;
+  const tx = (0, import_parseOperationCalldata.parseOperationCalldata)(input);
+  const ctx = { sdk, wallet, blockNumber };
+  const prereqs = await buildPrerequisites(tx, ctx);
+  return Promise.all(
+    // Each prereq pairs its own kind with its detail, so the widened
+    // `verify` return is safe to narrow back to the discriminated union.
+    prereqs.map((p) => p.verify(ctx))
+  );
+}
+async function buildPrerequisites(tx, ctx) {
+  const { wallet } = ctx;
+  switch (tx.operation) {
+    case "Deposit":
+    case "Mint":
+    case "Redeem":
+    case "Withdraw":
+      return (0, import_buildPoolPrerequisites.buildPoolPrerequisites)(tx, wallet);
+    case "MultiCall":
+    case "BotMulticall":
+    case "OpenCreditAccount":
+    case "CloseCreditAccount":
+    case "LiquidateCreditAccount":
+      return (0, import_buildCollateralPrerequisites.buildCollateralPrerequisites)(
+        tx.operation === "OpenCreditAccount" ? { creditManager: tx.creditManager, borrower: wallet } : {
+          creditManager: tx.creditManager,
+          creditAccount: tx.creditAccount
+        },
+        tx.multicall,
+        ctx
+      );
+    case "RWAOpenCreditAccount":
+      return [
+        ...await (0, import_buildCollateralPrerequisites.buildCollateralPrerequisites)(
+          { creditManager: tx.creditManager, borrower: wallet },
+          tx.multicall,
+          ctx
+        ),
+        ...(0, import_buildRWAPrerequisites.buildRWAPrerequisites)(tx.multicall, tx.creditManager, tx.args, ctx)
+      ];
+    case "RWAMulticall":
+      return (0, import_buildCollateralPrerequisites.buildCollateralPrerequisites)(
+        { creditManager: tx.creditManager, creditAccount: tx.creditAccount },
+        tx.multicall,
+        ctx
+      );
+    case "PartiallyLiquidateCreditAccount":
+      return (0, import_buildPartialLiquidationPrerequisites.buildPartialLiquidationPrerequisites)(tx, ctx);
+    default:
+      return [];
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  checkPrerequisites
+});

package/dist/cjs/preview/prerequisites/helpers.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 helpers_exports = {};
+__export(helpers_exports, {
+  allowanceAndBalance: () => allowanceAndBalance
+});
+module.exports = __toCommonJS(helpers_exports);
+var import_AllowancePrerequisite = require("./AllowancePrerequisite.js");
+var import_BalancePrerequisite = require("./BalancePrerequisite.js");
+function allowanceAndBalance(props) {
+  const { token, owner, spender, required } = props;
+  return [
+    new import_AllowancePrerequisite.AllowancePrerequisite({
+      token,
+      owner,
+      spender,
+      required,
+      title: props.allowanceTitle
+    }),
+    new import_BalancePrerequisite.BalancePrerequisite({
+      token,
+      owner,
+      required,
+      title: props.balanceTitle
+    })
+  ];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  allowanceAndBalance
+});

package/dist/cjs/preview/prerequisites/index.js

@@ -17,20 +17,16 @@ var prerequisites_exports = {};
 module.exports = __toCommonJS(prerequisites_exports);
 __reExport(prerequisites_exports, require("./AllowancePrerequisite.js"), module.exports);
 __reExport(prerequisites_exports, require("./BalancePrerequisite.js"), module.exports);
-__reExport(prerequisites_exports, require("./buildPrerequisites.js"), module.exports);
+__reExport(prerequisites_exports, require("./checkPrerequisites.js"), module.exports);
 __reExport(prerequisites_exports, require("./Prerequisite.js"), module.exports);
-__reExport(prerequisites_exports, require("./prepareAction.js"), module.exports);
 __reExport(prerequisites_exports, require("./RWAOpenRequirementsPrerequisite.js"), module.exports);
-__reExport(prerequisites_exports, require("./runPrerequisites.js"), module.exports);
 __reExport(prerequisites_exports, require("./types.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./AllowancePrerequisite.js"),
   ...require("./BalancePrerequisite.js"),
-  ...require("./buildPrerequisites.js"),
+  ...require("./checkPrerequisites.js"),
   ...require("./Prerequisite.js"),
-  ...require("./prepareAction.js"),
   ...require("./RWAOpenRequirementsPrerequisite.js"),
-  ...require("./runPrerequisites.js"),
   ...require("./types.js")
 });

package/dist/cjs/preview/preview/detectCloseOrRepay.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 detectCloseOrRepay_exports = {};
+__export(detectCloseOrRepay_exports, {
+  classifyCloseOrRepay: () => classifyCloseOrRepay,
+  isCloseOrRepay: () => isCloseOrRepay
+});
+module.exports = __toCommonJS(detectCloseOrRepay_exports);
+var import_viem = require("viem");
+var import_sdk = require("../../sdk/index.js");
+function isCloseOrRepay(multicall) {
+  const repaysFullDebt = multicall.some(
+    (op) => op.operation === "DecreaseBorrowedAmount" && op.amount === import_sdk.MAX_UINT256
+  );
+  const withdrawsEverything = multicall.some(
+    (op) => op.operation === "WithdrawCollateral" && op.amount === import_sdk.MAX_UINT256
+  );
+  return repaysFullDebt && withdrawsEverything;
+}
+function classifyCloseOrRepay(multicall, underlying) {
+  for (const op of multicall) {
+    if (op.operation === "AddCollateral") {
+      return "repay";
+    }
+    if (op.operation === "WithdrawCollateral" && !(0, import_viem.isAddressEqual)(op.token, underlying)) {
+      return "repay";
+    }
+  }
+  return "close";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  classifyCloseOrRepay,
+  isCloseOrRepay
+});

package/dist/cjs/preview/preview/index.js

@@ -16,15 +16,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var preview_exports = {};
 module.exports = __toCommonJS(preview_exports);
 __reExport(preview_exports, require("./applyInnerOperations.js"), module.exports);
+__reExport(preview_exports, require("./detectCloseOrRepay.js"), module.exports);
 __reExport(preview_exports, require("./errors.js"), module.exports);
 __reExport(preview_exports, require("./previewAdjustCreditAccount.js"), module.exports);
+__reExport(preview_exports, require("./previewCloseOrRepay.js"), module.exports);
 __reExport(preview_exports, require("./previewOperation.js"), module.exports);
 __reExport(preview_exports, require("./types.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./applyInnerOperations.js"),
+  ...require("./detectCloseOrRepay.js"),
   ...require("./errors.js"),
   ...require("./previewAdjustCreditAccount.js"),
+  ...require("./previewCloseOrRepay.js"),
   ...require("./previewOperation.js"),
   ...require("./types.js")
 });

package/dist/cjs/preview/preview/previewCloseOrRepay.js

@@ -0,0 +1,94 @@
+"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 previewCloseOrRepay_exports = {};
+__export(previewCloseOrRepay_exports, {
+  previewCloseOrRepay: () => previewCloseOrRepay
+});
+module.exports = __toCommonJS(previewCloseOrRepay_exports);
+var import_sdk = require("../../sdk/index.js");
+var import_applyInnerOperations = require("./applyInnerOperations.js");
+var import_detectCloseOrRepay = require("./detectCloseOrRepay.js");
+var import_unwrapNativeCollateral = require("./unwrapNativeCollateral.js");
+async function previewCloseOrRepay(input, operation, permanent, options) {
+  const { sdk } = input;
+  const market = sdk.marketRegister.findByCreditManager(
+    operation.creditManager
+  );
+  const kind = (0, import_detectCloseOrRepay.classifyCloseOrRepay)(operation.multicall, market.underlying);
+  return kind === "close" ? previewCloseCreditAccount(input, operation, permanent, options) : previewRepayCreditAccount(input, operation, permanent, options);
+}
+async function previewCloseCreditAccount(input, operation, permanent, options) {
+  const { sdk } = input;
+  const market = sdk.marketRegister.findByCreditManager(
+    operation.creditManager
+  );
+  const { state } = await replayMulticall(sdk, operation, options);
+  return {
+    operation: "CloseCreditAccount",
+    permanent,
+    creditManager: operation.creditManager,
+    creditAccount: operation.creditAccount,
+    receivedAmount: state.collateralWithdrawn.getOrZero(market.underlying)
+  };
+}
+async function previewRepayCreditAccount(input, operation, permanent, options) {
+  const { sdk, value = 0n } = input;
+  const { ca, state } = await replayMulticall(sdk, operation, options);
+  const collateralAdded = (0, import_unwrapNativeCollateral.unwrapNativeCollateral)(
+    state.collateralAdded.toAssets(),
+    value,
+    sdk.addressProvider.getAddress(import_sdk.AP_WETH_TOKEN, import_sdk.NO_VERSION)
+  );
+  const initialTotalDebt = ca.debt + ca.accruedInterest + ca.accruedFees;
+  return {
+    operation: "RepayCreditAccount",
+    permanent,
+    creditManager: operation.creditManager,
+    creditAccount: operation.creditAccount,
+    collateralAdded,
+    debtRepaid: initialTotalDebt - state.totalDebt,
+    collateralWithdrawn: state.collateralWithdrawn.toAssets()
+  };
+}
+async function replayMulticall(sdk, operation, options) {
+  let ca = options?.creditAccount;
+  if (!ca) {
+    ca = await sdk.accounts.getCreditAccountData(
+      operation.creditAccount,
+      options?.blockNumber
+    );
+  }
+  if (!ca) {
+    throw new Error(`credit account ${operation.creditAccount} not found`);
+  }
+  const state = (0, import_applyInnerOperations.makeInnerOperationsState)();
+  for (const t of ca.tokens) {
+    if (t.balance > 1n) {
+      state.balances.upsert(t.token, t.balance);
+    }
+  }
+  state.debt = ca.debt;
+  state.totalDebt = ca.debt + ca.accruedInterest + ca.accruedFees;
+  (0, import_applyInnerOperations.applyInnerOperations)(sdk, operation.multicall, state);
+  return { ca, state };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  previewCloseOrRepay
+});

package/dist/cjs/preview/preview/previewOperation.js

@@ -22,8 +22,10 @@ __export(previewOperation_exports, {
 });
 module.exports = __toCommonJS(previewOperation_exports);
 var import_parse = require("../parse/index.js");
+var import_detectCloseOrRepay = require("./detectCloseOrRepay.js");
 var import_errors = require("./errors.js");
 var import_previewAdjustCreditAccount = require("./previewAdjustCreditAccount.js");
+var import_previewCloseOrRepay = require("./previewCloseOrRepay.js");
 var import_previewOpenCreditAccount = require("./previewOpenCreditAccount.js");
 var import_previewPoolOperation = require("./previewPoolOperation.js");
 async function previewOperation(input, options) {
@@ -31,10 +33,16 @@ async function previewOperation(input, options) {
   if ((0, import_parse.isPoolOperation)(operation)) {
     return (0, import_previewPoolOperation.previewPoolOperation)(input, operation, options);
   }
-  if (operation.operation === "OpenCreditAccount" || operation.operation === "SecuritizeOpenCreditAccount") {
+  if (operation.operation === "OpenCreditAccount" || operation.operation === "RWAOpenCreditAccount") {
     return (0, import_previewOpenCreditAccount.previewOpenCreditAccount)(input, operation);
   }
-  if (operation.operation === "MultiCall" || operation.operation === "BotMulticall" || operation.operation === "SecuritizeMulticall") {
+  if (operation.operation === "CloseCreditAccount") {
+    return (0, import_previewCloseOrRepay.previewCloseOrRepay)(input, operation, true, options);
+  }
+  if (operation.operation === "MultiCall" || operation.operation === "BotMulticall" || operation.operation === "RWAMulticall") {
+    if ((0, import_detectCloseOrRepay.isCloseOrRepay)(operation.multicall)) {
+      return (0, import_previewCloseOrRepay.previewCloseOrRepay)(input, operation, false, options);
+    }
     return (0, import_previewAdjustCreditAccount.previewAdjustCreditAccount)(input, operation, options);
   }
   throw new import_errors.UnsupportedOperationError(operation.operation);

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

@@ -189,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]
@@ -220,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/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.
    **/