@gearbox-protocol/sdk 14.12.0-next.2 → 14.12.0-next.4

package/dist/esm/preview/parse/parseOperationCalldata.js

@@ -1,11 +1,13 @@
 import {
   CreditFacadeV310Contract,
+  isRWAFactory,
   PoolV310Contract,
   ZapperContract
 } from "../../sdk/index.js";
 import { UnsupportedTargetError } from "./errors.js";
 import { parseFacadeOperationCalldata } from "./parseFacadeOperationCalldata.js";
 import { parsePoolOperationCalldata } from "./parsePoolOperationCalldata.js";
+import { parseRWAFactoryOperationCalldata } from "./parseRWAFactoryOperationCalldata.js";
 function parseOperationCalldata(input) {
   const { sdk, to, calldata, value, sender } = input;
   const contract = sdk.getContract(to);
@@ -48,6 +50,13 @@ function parseOperationCalldata(input) {
       calldata
     });
   }
+  if (contract && isRWAFactory(contract)) {
+    return parseRWAFactoryOperationCalldata({
+      sdk,
+      factory: contract,
+      calldata
+    });
+  }
   throw new UnsupportedTargetError(to);
 }
 export {

package/dist/esm/preview/parse/parseRWAFactoryOperationCalldata.js

@@ -0,0 +1,89 @@
+import { AbstractAdapterContract } from "../../plugins/adapters/index.js";
+import {
+  CreditFacadeV310Contract,
+  hexEq,
+  isRWAFactory,
+  RWA_FACTORY_SECURITIZE
+} from "../../sdk/index.js";
+import { classifyInnerOperations } from "./classifyInnerOperations.js";
+import { extractExpectedBalanceChanges } from "./extractExpectedBalanceChanges.js";
+function parseRWAFactoryOperationCalldata(props) {
+  const { contractType, address } = props.factory;
+  if (isRWAFactory(props.factory, RWA_FACTORY_SECURITIZE)) {
+    return parseSecuritizeOperationCalldata(props);
+  }
+  throw new Error(
+    `unsupported RWA factory type "${contractType}" on ${address}`
+  );
+}
+function parseSecuritizeOperationCalldata(props) {
+  const { sdk, factory, calldata } = props;
+  const parsed = sdk.parseFunctionDataV2(factory.address, calldata);
+  const functionName = parsed.functionName.split("(")[0];
+  const { rawArgs } = parsed;
+  const innerCalls = rawArgs.calls ?? [];
+  const tokensToRegister = [
+    ...rawArgs.tokensToRegister ?? []
+  ];
+  const signaturesToCache = [
+    ...rawArgs.signaturesToCache ?? []
+  ];
+  const suite = functionName === "openCreditAccount" ? sdk.marketRegister.findCreditManager(rawArgs.creditManager) : resolveSuiteForMulticall(sdk, factory, innerCalls);
+  const metadata = {
+    factory: factory.address,
+    creditManager: suite.creditManager.address,
+    creditFacade: suite.creditFacade.address
+  };
+  const multicall = classifyInnerOperations(innerCalls, {
+    sdk,
+    underlying: suite.underlying
+  });
+  const expectedBalanceChanges = extractExpectedBalanceChanges(innerCalls);
+  switch (functionName) {
+    case "openCreditAccount":
+      return {
+        ...metadata,
+        operation: "SecuritizeOpenCreditAccount",
+        multicall,
+        expectedBalanceChanges,
+        tokensToRegister,
+        signaturesToCache
+      };
+    case "multicall":
+      return {
+        ...metadata,
+        operation: "SecuritizeMulticall",
+        creditAccount: rawArgs.creditAccount,
+        multicall,
+        expectedBalanceChanges,
+        tokensToRegister,
+        signaturesToCache
+      };
+    default:
+      throw new Error(
+        `unsupported RWA factory function "${parsed.functionName}" on ${factory.address}`
+      );
+  }
+}
+function resolveSuiteForMulticall(sdk, factory, innerCalls) {
+  for (const call of innerCalls) {
+    const contract = sdk.getContract(call.target);
+    if (contract instanceof CreditFacadeV310Contract) {
+      const suite = sdk.marketRegister.creditManagers.find(
+        (cm) => hexEq(cm.creditFacade.address, call.target)
+      );
+      if (suite) {
+        return suite;
+      }
+    }
+    if (contract instanceof AbstractAdapterContract) {
+      return sdk.marketRegister.findCreditManager(contract.creditManager);
+    }
+  }
+  throw new Error(
+    `cannot resolve credit manager for RWA factory multicall on ${factory.address}`
+  );
+}
+export {
+  parseRWAFactoryOperationCalldata
+};

package/dist/esm/preview/parse/types.js

@@ -1,9 +1,14 @@
 export * from "./types-adapters.js";
 export * from "./types-facades.js";
 export * from "./types-pools.js";
+export * from "./types-rwa.js";
 function isPoolOperation(tx) {
   return tx.operation === "Deposit" || tx.operation === "Mint" || tx.operation === "Withdraw" || tx.operation === "Redeem";
 }
+function isRWAOperation(tx) {
+  return tx.operation === "SecuritizeOpenCreditAccount" || tx.operation === "SecuritizeMulticall";
+}
 export {
-  isPoolOperation
+  isPoolOperation,
+  isRWAOperation
 };

package/dist/esm/preview/prerequisites/AllowancePrerequisite.js

@@ -4,14 +4,14 @@ import {
   toPrerequisiteError
 } from "./Prerequisite.js";
 class AllowancePrerequisite extends Prerequisite {
-  _id;
-  _title;
-  _detail;
+  #id;
+  #title;
+  #detail;
   constructor(props) {
     super();
-    this._id = props.id ?? `allowance:${props.token}:${props.owner}:${props.spender}`;
-    this._title = props.title ?? "Token approval";
-    this._detail = {
+    this.#id = props.id ?? `allowance:${props.token}:${props.owner}:${props.spender}`;
+    this.#title = props.title ?? "Token approval";
+    this.#detail = {
       token: props.token,
       owner: props.owner,
       spender: props.spender,
@@ -19,24 +19,24 @@ class AllowancePrerequisite extends Prerequisite {
     };
   }
   get id() {
-    return this._id;
+    return this.#id;
   }
   get kind() {
     return "allowance";
   }
   get title() {
-    return this._title;
+    return this.#title;
   }
   get detail() {
-    return this._detail;
+    return this.#detail;
   }
   calls() {
     return [
       {
-        address: this._detail.token,
+        address: this.#detail.token,
         abi: erc20Abi,
         functionName: "allowance",
-        args: [this._detail.owner, this._detail.spender]
+        args: [this.#detail.owner, this.#detail.spender]
       }
     ];
   }
@@ -46,8 +46,8 @@ class AllowancePrerequisite extends Prerequisite {
       return this.errorResult(toPrerequisiteError(res?.error));
     }
     const actual = res.result;
-    return this.satisfiedResult(actual >= this._detail.required, {
-      ...this._detail,
+    return this.satisfiedResult(actual >= this.#detail.required, {
+      ...this.#detail,
       actual
     });
   }

package/dist/esm/preview/prerequisites/BalancePrerequisite.js

@@ -4,38 +4,38 @@ import {
   toPrerequisiteError
 } from "./Prerequisite.js";
 class BalancePrerequisite extends Prerequisite {
-  _id;
-  _title;
-  _detail;
+  #id;
+  #title;
+  #detail;
   constructor(props) {
     super();
-    this._id = props.id ?? `balance:${props.token}:${props.owner}`;
-    this._title = props.title ?? "Sufficient balance";
-    this._detail = {
+    this.#id = props.id ?? `balance:${props.token}:${props.owner}`;
+    this.#title = props.title ?? "Sufficient balance";
+    this.#detail = {
       token: props.token,
       owner: props.owner,
       required: props.required
     };
   }
   get id() {
-    return this._id;
+    return this.#id;
   }
   get kind() {
     return "balance";
   }
   get title() {
-    return this._title;
+    return this.#title;
   }
   get detail() {
-    return this._detail;
+    return this.#detail;
   }
   calls() {
     return [
       {
-        address: this._detail.token,
+        address: this.#detail.token,
         abi: erc20Abi,
         functionName: "balanceOf",
-        args: [this._detail.owner]
+        args: [this.#detail.owner]
       }
     ];
   }
@@ -45,8 +45,8 @@ class BalancePrerequisite extends Prerequisite {
       return this.errorResult(toPrerequisiteError(res?.error));
     }
     const actual = res.result;
-    return this.satisfiedResult(actual >= this._detail.required, {
-      ...this._detail,
+    return this.satisfiedResult(actual >= this.#detail.required, {
+      ...this.#detail,
       actual
     });
   }

package/dist/esm/preview/prerequisites/RWAOpenRequirementsPrerequisite.js

@@ -0,0 +1,42 @@
+import { Prerequisite } from "./Prerequisite.js";
+class RWAOpenRequirementsPrerequisite extends Prerequisite {
+  #id;
+  #title;
+  #detail;
+  constructor(props) {
+    super();
+    this.#id = props.id ?? `rwaOpenRequirements:${props.factory}:${props.token}`;
+    this.#title = props.title ?? "RWA account requirements fulfilled";
+    this.#detail = props.requirements;
+  }
+  get id() {
+    return this.#id;
+  }
+  get kind() {
+    return "rwaOpenRequirements";
+  }
+  get title() {
+    return this.#title;
+  }
+  get detail() {
+    return this.#detail;
+  }
+  /** Pre-resolved: no on-chain reads to contribute. */
+  calls() {
+    return [];
+  }
+  resolve() {
+    return this.satisfiedResult(this.#satisfied(), this.#detail);
+  }
+  /**
+   * Satisfied when the borrower has nothing left to do: no tokens pending
+   * issuer-side registration and no messages left to sign.
+   */
+  #satisfied() {
+    const { securitizeTokensToRegister, requiredSignatures } = this.#detail;
+    return securitizeTokensToRegister.length === 0 && requiredSignatures.length === 0;
+  }
+}
+export {
+  RWAOpenRequirementsPrerequisite
+};

package/dist/esm/preview/prerequisites/buildPrerequisites.js

@@ -1,7 +1,11 @@
 import { isAddressEqual } from "viem";
+import {
+  AddressSet
+} from "../../sdk/index.js";
 import { AllowancePrerequisite } from "./AllowancePrerequisite.js";
 import { BalancePrerequisite } from "./BalancePrerequisite.js";
-function buildPrerequisites(tx, ctx) {
+import { RWAOpenRequirementsPrerequisite } from "./RWAOpenRequirementsPrerequisite.js";
+async function buildPrerequisites(tx, ctx) {
   const { wallet } = ctx;
   switch (tx.operation) {
     // Deposit and Mint both pull the underlying from the caller into the pool;
@@ -127,7 +131,37 @@ function buildPrerequisites(tx, ctx) {
     case "OpenCreditAccount":
     case "CloseCreditAccount":
     case "LiquidateCreditAccount":
-      return collateralPrerequisites(tx.multicall, tx.creditManager, wallet);
+      return collateralPrerequisites(
+        tx.operation === "OpenCreditAccount" ? { creditManager: tx.creditManager, borrower: wallet } : {
+          creditManager: tx.creditManager,
+          creditAccount: tx.creditAccount
+        },
+        tx.multicall,
+        ctx
+      );
+    // RWA-factory operations: same collateral checks as facade operations,
+    // plus (for opening) the factory's open-account requirements. The parsed
+    // operation carries template (empty) `tokensToRegister`/`signaturesToCache`;
+    // the prerequisite detail provides the real values.
+    case "SecuritizeOpenCreditAccount":
+      return [
+        ...await collateralPrerequisites(
+          { creditManager: tx.creditManager, borrower: wallet },
+          tx.multicall,
+          ctx
+        ),
+        ...await rwaOpenRequirementsPrerequisites(
+          tx.multicall,
+          tx.creditManager,
+          ctx
+        )
+      ];
+    case "SecuritizeMulticall":
+      return collateralPrerequisites(
+        { creditManager: tx.creditManager, creditAccount: tx.creditAccount },
+        tx.multicall,
+        ctx
+      );
     case "PartiallyLiquidateCreditAccount": {
       const underlying = underlyingOf(ctx.sdk, tx.creditManager);
       if (!underlying || tx.repaidAmount === 0n) {
@@ -153,7 +187,8 @@ function buildPrerequisites(tx, ctx) {
       return [];
   }
 }
-function collateralPrerequisites(multicall, creditManager, wallet) {
+async function collateralPrerequisites(spenderOptions, multicall, ctx) {
+  const { sdk, wallet } = ctx;
   const required = /* @__PURE__ */ new Map();
   for (const op of multicall) {
     if (op.operation !== "AddCollateral" || op.amount === 0n) {
@@ -166,15 +201,19 @@ function collateralPrerequisites(multicall, creditManager, wallet) {
       amount: (existing?.amount ?? 0n) + op.amount
     });
   }
+  if (required.size === 0) {
+    return [];
+  }
+  const spender = await sdk.accounts.getApprovalAddress(spenderOptions);
   const prereqs = [];
   for (const { token, amount } of required.values()) {
     prereqs.push(
       new AllowancePrerequisite({
         token,
         owner: wallet,
-        spender: creditManager,
+        spender,
         required: amount,
-        title: "Collateral approved to credit manager"
+        title: "Collateral approved"
       }),
       new BalancePrerequisite({
         token,
@@ -186,6 +225,41 @@ function collateralPrerequisites(multicall, creditManager, wallet) {
   }
   return prereqs;
 }
+async function rwaOpenRequirementsPrerequisites(multicall, creditManager, ctx) {
+  const { sdk, wallet } = ctx;
+  const { rwaFactory } = sdk.marketRegister.findByCreditManager(creditManager);
+  if (!rwaFactory) {
+    return [];
+  }
+  const rwaTokens = new AddressSet(rwaFactory.getTokens());
+  const candidates = new 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;
+    }
+    const requirements = await sdk.accounts.getOpenAccountRequirements(
+      wallet,
+      creditManager,
+      { tokenOutAddress: token }
+    );
+    if (requirements) {
+      prereqs.push(
+        new RWAOpenRequirementsPrerequisite({
+          requirements,
+          token,
+          factory: rwaFactory.address
+        })
+      );
+    }
+  }
+  return prereqs;
+}
 function underlyingOf(sdk, creditManager) {
   const suite = sdk.marketRegister.creditManagers.find(
     (cm) => isAddressEqual(cm.creditManager.address, creditManager)

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

@@ -3,5 +3,6 @@ export * from "./BalancePrerequisite.js";
 export * from "./buildPrerequisites.js";
 export * from "./Prerequisite.js";
 export * from "./prepareAction.js";
+export * from "./RWAOpenRequirementsPrerequisite.js";
 export * from "./runPrerequisites.js";
 export * from "./types.js";

package/dist/esm/preview/simulate/index.js

@@ -2,9 +2,11 @@ import { PreviewSimulationError } from "./errors.js";
 import { simulateFacadeOperation } from "./simulateFacadeOperation.js";
 import { simulateOperation } from "./simulateOperation.js";
 import { simulatePoolOperation } from "./simulatePoolOperation.js";
+import { simulateRWAOperation } from "./simulateRWAOperation.js";
 export {
   PreviewSimulationError,
   simulateFacadeOperation,
   simulateOperation,
-  simulatePoolOperation
+  simulatePoolOperation,
+  simulateRWAOperation
 };

package/dist/esm/preview/simulate/simulateOperation.js

@@ -1,11 +1,18 @@
-import { isPoolOperation } from "../parse/index.js";
+import {
+  isPoolOperation,
+  isRWAOperation
+} from "../parse/index.js";
 import { simulateFacadeOperation } from "./simulateFacadeOperation.js";
 import { simulatePoolOperation } from "./simulatePoolOperation.js";
+import { simulateRWAOperation } from "./simulateRWAOperation.js";
 async function simulateOperation(input, options) {
   const { operation } = input;
   if (isPoolOperation(operation)) {
     return simulatePoolOperation({ ...input, operation }, options);
   }
+  if (isRWAOperation(operation)) {
+    return simulateRWAOperation({ ...input, operation }, options);
+  }
   return simulateFacadeOperation({ ...input, operation }, options);
 }
 export {

package/dist/esm/preview/simulate/simulateRWAOperation.js

@@ -0,0 +1,6 @@
+async function simulateRWAOperation(_input, _options) {
+  throw new Error("not yet implemented");
+}
+export {
+  simulateRWAOperation
+};

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

@@ -1,4 +1,6 @@
-import { decodeAbiParameters } from "viem";
+import {
+  decodeAbiParameters
+} from "viem";
 import { iSecuritizeRWAFactoryAbi } from "../../../../abi/rwa/iSecuritizeRWAFactory.js";
 import { BaseContract } from "../../../base/index.js";
 import { AddressMap, AddressSet } from "../../../utils/index.js";
@@ -49,6 +51,30 @@ class SecuritizeRWAFactory extends BaseContract {
       operators: [...t.operators]
     }));
   }
+  parseFunctionParamsV2(params, strict) {
+    switch (params.functionName) {
+      case "openCreditAccount": {
+        const [creditManager, calls, tokensToRegister, signaturesToCache] = params.args;
+        return {
+          creditManager,
+          calls: this.register.parseMultiCallV2([...calls], strict),
+          tokensToRegister,
+          signaturesToCache
+        };
+      }
+      case "multicall": {
+        const [creditAccount, calls, tokensToRegister, signaturesToCache] = params.args;
+        return {
+          creditAccount,
+          calls: this.register.parseMultiCallV2([...calls], strict),
+          tokensToRegister,
+          signaturesToCache
+        };
+      }
+      default:
+        return super.parseFunctionParamsV2(params, strict);
+    }
+  }
   /**
    * {@inheritDoc IRWAFactory.decodeInvestorData}
    */
@@ -104,6 +130,12 @@ class SecuritizeRWAFactory extends BaseContract {
       })
     };
   }
+  /**
+   * {@inheritDoc IRWAFactory.getTokens}
+   */
+  getTokens() {
+    return this.dsTokens.map((t) => t.address);
+  }
   /**
    * {@inheritDoc IRWAFactory.getInvestor}
    */

package/dist/esm/sdk/market/rwa/types.js

@@ -1,7 +1,10 @@
 import { RWA_FACTORY_SECURITIZE } from "./securitize/index.js";
 const RWA_FACTORY_TYPES = [RWA_FACTORY_SECURITIZE];
-function isRWAFactory(factory, type) {
-  return factory.contractType === type;
+function isRWAFactory(contract, type) {
+  if (type) {
+    return contract.contractType === type;
+  }
+  return contract.contractType.startsWith("RWA_FACTORY::");
 }
 export {
   RWA_FACTORY_TYPES,

package/dist/types/preview/parse/classifyInnerOperations.d.ts

@@ -7,8 +7,6 @@ export interface ClassifyInnerOperationsProps {
     underlying: Address;
 }
 /**
- * Calldata-only counterpart of the SDK's `classifyMulticallOperations`.
- *
  * Maps each inner multicall entry to an {@link InnerOperation}:
  * - adapter and unknown targets become a pure-descriptor `Execute`
  *   {@link AdapterOperation};

package/dist/types/preview/parse/index.d.ts

@@ -4,4 +4,5 @@ export * from "./extractExpectedBalanceChanges.js";
 export * from "./parseFacadeOperationCalldata.js";
 export * from "./parseOperationCalldata.js";
 export * from "./parsePoolOperationCalldata.js";
+export * from "./parseRWAFactoryOperationCalldata.js";
 export * from "./types.js";

package/dist/types/preview/parse/parseRWAFactoryOperationCalldata.d.ts

@@ -0,0 +1,22 @@
+import type { Hex } from "viem";
+import { type IRWAFactory, type OnchainSDK } from "../../sdk/index.js";
+import type { RWAOperation } from "./types-rwa.js";
+export interface ParseRWAFactoryOperationCalldataProps {
+    sdk: OnchainSDK;
+    /** Resolved RWA factory contract for the transaction target. */
+    factory: IRWAFactory;
+    calldata: Hex;
+}
+/**
+ * Decodes a RWA-factory entry-point call into the matching
+ * {@link RWAOperation}.
+ *
+ * RWA credit accounts are opened and managed through the market's RWA factory
+ * (see `CreditAccountsServiceV310`) rather than the credit facade, but the
+ * inner `calls` share the credit-facade multicall shape, so classification is
+ * identical to {@link parseFacadeOperationCalldata}.
+ *
+ * Dispatches on the factory's contract type; supporting a new factory type
+ * requires a new branch here plus new operation types in `types-rwa.ts`.
+ */
+export declare function parseRWAFactoryOperationCalldata(props: ParseRWAFactoryOperationCalldataProps): RWAOperation;

package/dist/types/preview/parse/types-rwa.d.ts

@@ -0,0 +1,60 @@
+import type { Address } from "viem";
+import type { SecuritizeRegisterMessage } from "../../sdk/index.js";
+import type { ExpectedBalanceChange, InnerOperation } from "./types-facades.js";
+/**
+ * Metadata shared by all RWA factory operations. RWA credit accounts are
+ * opened and managed through the market's RWA factory rather than the credit
+ * facade, but the inner `calls` still target the facade/adapters, so the
+ * credit suite is known.
+ */
+export interface RWAOperationMetadata {
+    /** RWA factory contract the transaction is sent to. */
+    factory: Address;
+    creditManager: Address;
+    creditFacade: Address;
+}
+export interface SecuritizeOpenCreditAccountOperation<Ext extends object = {}> extends RWAOperationMetadata {
+    operation: "SecuritizeOpenCreditAccount";
+    multicall: InnerOperation<Ext>[];
+    /**
+     * Potential balance changes declared by a router-generated
+     * `storeExpectedBalances`/`compareBalances` pair, or `undefined` when the
+     * multicall is not router-shaped. See {@link ExpectedBalanceChange}.
+     */
+    expectedBalanceChanges?: ExpectedBalanceChange[];
+    /**
+     * DSToken addresses to register, decoded from calldata. Empty in the
+     * template flow, where the real value comes from the factory's open-account
+     * requirements.
+     */
+    tokensToRegister: Address[];
+    /**
+     * EIP-712 registration signatures to store on-chain, decoded from calldata.
+     * Empty in the template flow.
+     */
+    signaturesToCache: SecuritizeRegisterMessage[];
+}
+/**
+ * `SecuritizeRWAFactory.multicall` call: like the facade's `multicall`, plus
+ * the factory-specific registration args.
+ */
+export interface SecuritizeMulticallOperation<Ext extends object = {}> extends RWAOperationMetadata {
+    operation: "SecuritizeMulticall";
+    creditAccount: Address;
+    multicall: InnerOperation<Ext>[];
+    /**
+     * Potential balance changes declared by a router-generated
+     * `storeExpectedBalances`/`compareBalances` pair, or `undefined` when the
+     * multicall is not router-shaped. See {@link ExpectedBalanceChange}.
+     */
+    expectedBalanceChanges?: ExpectedBalanceChange[];
+    /** DSToken addresses to register, decoded from calldata. */
+    tokensToRegister: Address[];
+    /** EIP-712 registration signatures to store on-chain, decoded from calldata. */
+    signaturesToCache: SecuritizeRegisterMessage[];
+}
+/**
+ * Discriminated union of all RWA factory operation types. Extend it when
+ * adding support for a new RWA factory type.
+ */
+export type RWAOperation<Ext extends object = {}> = SecuritizeOpenCreditAccountOperation<Ext> | SecuritizeMulticallOperation<Ext>;