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

package/dist/types/preview/prerequisites/RWAOpenRequirementsPrerequisite.d.ts

@@ -1,14 +1,21 @@
-import type { Address, ContractFunctionParameters } from "viem";
-import type { RWAOpenAccountRequirements } from "../../sdk/index.js";
+import type { Address } from "viem";
+import type { RWAOperationArgs } from "../../sdk/index.js";
 import { Prerequisite } from "./Prerequisite.js";
-import type { PrerequisiteDetail, PrerequisiteResult } from "./types.js";
+import type { PrerequisiteContext, PrerequisiteDetail, PrerequisiteResult } from "./types.js";
 export interface RWAOpenRequirementsPrerequisiteProps {
-    /** Requirements already resolved via `sdk.accounts.getOpenAccountRequirements`. */
-    requirements: RWAOpenAccountRequirements;
-    /** RWA token (e.g. Securitize DSToken) the requirements were computed for. */
+    /** RWA token (e.g. Securitize DSToken) to check the requirements for. */
     token: Address;
-    /** RWA factory that produced the requirements. */
+    /** Credit manager of the RWA market. */
+    creditManager: Address;
+    /** RWA factory that gates the token. */
     factory: Address;
+    /**
+     * Factory-specific registration params already carried by the transaction
+     * calldata. Passed through to the factory's `getMissingRequirements`: e.g.
+     * signatures provided here need not be signed again, since the transaction
+     * itself caches them on-chain.
+     */
+    providedArgs?: RWAOperationArgs;
     title?: string;
     id?: string;
 }
@@ -16,12 +23,13 @@ export interface RWAOpenRequirementsPrerequisiteProps {
  * Checks that the borrower has fulfilled the RWA factory's open-account
  * requirements (issuer-side token registration, EIP-712 signatures).
  *
- * Unlike `allowance`/`balance`, the requirements cannot be derived from plain
- * ERC-20 multicall reads: they come from an async compressor read performed by
- * `sdk.accounts.getOpenAccountRequirements`. The prerequisite is therefore
- * *pre-resolved*: it is constructed with the requirements already computed,
- * contributes no calls to the verification multicall, and `resolve` only
- * interprets the stored payload.
+ * The requirements are fetched at verify time via
+ * `sdk.accounts.getOpenAccountRequirements`, so re-running verification picks
+ * up off-chain progress (the borrower registering on the issuer's website or
+ * signing the factory's message) without rebuilding the prerequisites. The
+ * unfulfilled subset is computed by the factory itself
+ * (`IRWAFactory.getMissingRequirements`) and exposed on the result's
+ * `detail.missing`; the full requirements are kept on `detail.requirements`.
  */
 export declare class RWAOpenRequirementsPrerequisite extends Prerequisite<"rwaOpenRequirements"> {
     #private;
@@ -30,7 +38,5 @@ export declare class RWAOpenRequirementsPrerequisite extends Prerequisite<"rwaOp
     get kind(): "rwaOpenRequirements";
     get title(): string;
     get detail(): PrerequisiteDetail<"rwaOpenRequirements">;
-    /** Pre-resolved: no on-chain reads to contribute. */
-    calls(): ContractFunctionParameters[];
-    resolve(): PrerequisiteResult<"rwaOpenRequirements">;
+    protected check(ctx: PrerequisiteContext): Promise<PrerequisiteResult<"rwaOpenRequirements">>;
 }

package/dist/types/preview/prerequisites/buildCollateralPrerequisites.d.ts

@@ -0,0 +1,14 @@
+import { type GetApprovalAddressProps } from "../../sdk/index.js";
+import type { InnerOperation } from "../parse/index.js";
+import type { AnyPrerequisite } from "./Prerequisite.js";
+import type { PrerequisiteContext } from "./types.js";
+/**
+ * For every `addCollateral` inside a multicall, requires the wallet to approve
+ * and hold the collateral token for the collateral spender.
+ *
+ * The approval spender is resolved via {@link OnchainSDK.accounts.getApprovalAddress}:
+ * the credit manager for classic markets, but a per-investor "special wallet"
+ * for RWA markets. The resolution happens at build time because the spender is
+ * part of the prerequisite's identity and UI detail.
+ */
+export declare function buildCollateralPrerequisites(spenderOptions: GetApprovalAddressProps, multicall: InnerOperation[], ctx: PrerequisiteContext): Promise<AnyPrerequisite[]>;

package/dist/types/preview/prerequisites/buildPartialLiquidationPrerequisites.d.ts

@@ -0,0 +1,8 @@
+import type { PartialLiquidationOperation } from "../parse/index.js";
+import type { AnyPrerequisite } from "./Prerequisite.js";
+import type { PrerequisiteContext } from "./types.js";
+/**
+ * Partial liquidation pulls the repaid underlying from the liquidator: they
+ * must have approved it to the credit manager and hold enough of it.
+ */
+export declare function buildPartialLiquidationPrerequisites(tx: PartialLiquidationOperation, ctx: PrerequisiteContext): AnyPrerequisite[];

package/dist/types/preview/prerequisites/buildPoolPrerequisites.d.ts

@@ -0,0 +1,8 @@
+import { type Address } from "viem";
+import type { PoolOperation } from "../parse/index.js";
+import type { AnyPrerequisite } from "./Prerequisite.js";
+/**
+ * Prerequisites for ERC4626 pool operations (deposit, mint, withdraw, redeem),
+ * either direct or zapper-routed.
+ */
+export declare function buildPoolPrerequisites(tx: PoolOperation, wallet: Address): AnyPrerequisite[];

package/dist/types/preview/prerequisites/buildRWAPrerequisites.d.ts

@@ -0,0 +1,21 @@
+import type { Address } from "viem";
+import { type RWAOperationArgs } from "../../sdk/index.js";
+import type { InnerOperation } from "../parse/index.js";
+import type { AnyPrerequisite } from "./Prerequisite.js";
+import type { PrerequisiteContext } from "./types.js";
+/**
+ * For RWA-factory open-account operations (e.g. `RWAOpenCreditAccount`),
+ * builds a prerequisite per RWA token the multicall touches; each one checks
+ * the factory's open-account requirements (issuer-side token registration,
+ * EIP-712 signatures) at verify time.
+ *
+ * The `providedArgs` params are the registration values decoded from the
+ * transaction calldata itself: signatures already included there satisfy the
+ * signature requirement, so a fully built transaction is not reported as
+ * missing signatures. In the template flow they are empty and the verified
+ * result's `detail.missing` describes what is still unfulfilled; acting on it
+ * (signing, rebuilding calldata) is up to the consumer.
+ *
+ * Returns nothing for non-RWA markets.
+ */
+export declare function buildRWAPrerequisites(multicall: InnerOperation[], creditManager: Address, providedArgs: RWAOperationArgs, ctx: PrerequisiteContext): AnyPrerequisite[];

package/dist/types/preview/prerequisites/checkPrerequisites.d.ts

@@ -0,0 +1,27 @@
+import type { PluginsMap } from "../../sdk/index.js";
+import { type ParseOperationCalldataInput } from "../parse/parseOperationCalldata.js";
+import type { AnyPrerequisiteResult } from "./types.js";
+/**
+ * Input of {@link checkPrerequisites}: the same raw-calldata input as the
+ * internal calldata parser, plus an optional block to read at.
+ */
+export type CheckPrerequisitesInput<P extends PluginsMap = PluginsMap> = ParseOperationCalldataInput<P> & {
+    /** Block to read at; defaults to latest. Only set for testnet forks. */
+    blockNumber?: bigint;
+};
+/**
+ * Derives and verifies the on-chain prerequisites for an operation given its
+ * raw calldata: the conditions that must hold for the call not to revert and
+ * that we can verify with the SDK (token approvals, wallet balances, RWA
+ * open-account requirements).
+ *
+ * Each prerequisite performs its own reads and resolves into an
+ * {@link AnyPrerequisiteResult} (`satisfied` or `error`).
+ *
+ * Only *sender-actionable* prerequisites belong here: conditions the LP
+ * provider or borrower can fix themselves before retrying (e.g. approve a
+ * token, top up a balance, sign the RWA factory's messages). Non-actionable
+ * protocol/admin state (e.g. pool is paused) is intentionally out of scope,
+ * since the user cannot resolve it.
+ */
+export declare function checkPrerequisites<P extends PluginsMap>(input: CheckPrerequisitesInput<P>): Promise<AnyPrerequisiteResult[]>;

package/dist/types/preview/prerequisites/helpers.d.ts

@@ -0,0 +1,15 @@
+import type { Address } from "viem";
+import type { AnyPrerequisite } from "./Prerequisite.js";
+export interface AllowanceAndBalanceProps {
+    token: Address;
+    owner: Address;
+    spender: Address;
+    required: bigint;
+    allowanceTitle: string;
+    balanceTitle: string;
+}
+/**
+ * The most common prerequisite pair: `owner` must have approved `spender` for
+ * `required` of `token` and must hold at least that much of it.
+ */
+export declare function allowanceAndBalance(props: AllowanceAndBalanceProps): AnyPrerequisite[];

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

@@ -1,8 +1,6 @@
 export * from "./AllowancePrerequisite.js";
 export * from "./BalancePrerequisite.js";
-export * from "./buildPrerequisites.js";
+export * from "./checkPrerequisites.js";
 export * from "./Prerequisite.js";
-export * from "./prepareAction.js";
 export * from "./RWAOpenRequirementsPrerequisite.js";
-export * from "./runPrerequisites.js";
 export * from "./types.js";

package/dist/types/preview/prerequisites/types.d.ts

@@ -1,5 +1,5 @@
 import type { Address } from "viem";
-import type { OnchainSDK, RWAOpenAccountRequirements } from "../../sdk/index.js";
+import type { OnchainSDK, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements } from "../../sdk/index.js";
 /**
  * Extension point that ties each prerequisite kind to its detail payload.
  *
@@ -33,7 +33,26 @@ export interface PrerequisiteDetailMap {
      * registration and/or EIP-712 signatures the borrower must provide before
      * opening a credit account in an RWA market.
      */
-    rwaOpenRequirements: RWAOpenAccountRequirements;
+    rwaOpenRequirements: {
+        /** RWA token (e.g. Securitize DSToken) the requirements are checked for. */
+        token: Address;
+        /** Credit manager of the RWA market. */
+        creditManager: Address;
+        /** RWA factory that gates the token. */
+        factory: Address;
+        /**
+         * Full requirements fetched at verify time via
+         * `sdk.accounts.getOpenAccountRequirements`; only present when the read
+         * succeeded and the factory gates the token.
+         */
+        requirements?: RWAOpenAccountRequirements;
+        /**
+         * Subset of `requirements` still unfulfilled, computed by the RWA
+         * factory at verify time (`IRWAFactory.getMissingRequirements`);
+         * `undefined` when everything is satisfied.
+         */
+        missing?: RWAMissingOpenAccountRequirements;
+    };
 }
 export type PrerequisiteKind = keyof PrerequisiteDetailMap;
 export type PrerequisiteDetail<K extends PrerequisiteKind = PrerequisiteKind> = PrerequisiteDetailMap[K];

package/dist/types/preview/preview/detectCloseOrRepay.d.ts

@@ -0,0 +1,18 @@
+import type { Address } from "viem";
+import type { InnerOperation } from "../parse/index.js";
+/**
+ * Detects whether a credit-facade multicall fully closes or repays the
+ * account.
+ *
+ * Note that closing/repaying an account whose debt is already zero emits no
+ * `decreaseDebt` call at all and is not detected (previews as an adjustment).
+ */
+export declare function isCloseOrRepay(multicall: InnerOperation[]): boolean;
+/**
+ * Distinguishes a closure from a repayment by how collateral leaves the
+ * account:
+ * - close swaps all assets into underlying and withdraws only the underlying
+ * - repay returns collateral in-kind: it adds collateral from the wallet to
+ *   cover the debt and/or withdraws non-underlying tokens.
+ */
+export declare function classifyCloseOrRepay(multicall: InnerOperation[], underlying: Address): "close" | "repay";

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

@@ -1,5 +1,7 @@
 export * from "./applyInnerOperations.js";
+export * from "./detectCloseOrRepay.js";
 export * from "./errors.js";
 export * from "./previewAdjustCreditAccount.js";
+export * from "./previewCloseOrRepay.js";
 export * from "./previewOperation.js";
 export * from "./types.js";

package/dist/types/preview/preview/previewAdjustCreditAccount.d.ts

@@ -1,5 +1,5 @@
 import { type PluginsMap } from "../../sdk/index.js";
-import type { MulticallOperation, SecuritizeMulticallOperation } from "../parse/index.js";
+import type { MulticallOperation, RWAMulticallOperation } from "../parse/index.js";
 import type { AdjustCreditAccountPreview, PreviewOperationInput, PreviewOperationOptions } from "./types.js";
 /**
  * Previews a `multicall`/`botMulticall` operation on an existing credit
@@ -8,4 +8,4 @@ import type { AdjustCreditAccountPreview, PreviewOperationInput, PreviewOperatio
  * minimal guaranteed post-state alongside the changes relative to the
  * pre-state.
  */
-export declare function previewAdjustCreditAccount<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: MulticallOperation | SecuritizeMulticallOperation, options?: PreviewOperationOptions): Promise<AdjustCreditAccountPreview>;
+export declare function previewAdjustCreditAccount<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: MulticallOperation | RWAMulticallOperation, options?: PreviewOperationOptions): Promise<AdjustCreditAccountPreview>;

package/dist/types/preview/preview/previewCloseOrRepay.d.ts

@@ -0,0 +1,10 @@
+import { type PluginsMap } from "../../sdk/index.js";
+import type { CloseCreditAccountOperation, MulticallOperation, RWAMulticallOperation } from "../parse/index.js";
+import type { OperationPreview, PreviewOperationInput, PreviewOperationOptions } from "./types.js";
+/**
+ * Any parsed operation that fully closes or repays a credit account: the
+ * facade `closeCreditAccount` entry point (permanent closure) or a plain
+ * multicall detected by `isCloseOrRepay` (zero-debt closure/repay).
+ */
+export type CloseOrRepayOperation = CloseCreditAccountOperation | MulticallOperation | RWAMulticallOperation;
+export declare function previewCloseOrRepay<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: CloseOrRepayOperation, permanent: boolean, options?: PreviewOperationOptions): Promise<OperationPreview>;

package/dist/types/preview/preview/previewOpenCreditAccount.d.ts

@@ -1,4 +1,4 @@
 import { type PluginsMap } from "../../sdk/index.js";
-import type { OpenCreditAccountOperation, SecuritizeOpenCreditAccountOperation } from "../parse/index.js";
+import type { OpenCreditAccountOperation, RWAOpenCreditAccountOperation } from "../parse/index.js";
 import type { OpenCreditAccountPreview, PreviewOperationInput } from "./types.js";
-export declare function previewOpenCreditAccount<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: OpenCreditAccountOperation | SecuritizeOpenCreditAccountOperation): OpenCreditAccountPreview;
+export declare function previewOpenCreditAccount<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: OpenCreditAccountOperation | RWAOpenCreditAccountOperation): OpenCreditAccountPreview;

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

@@ -82,7 +82,7 @@ export interface PoolOperationPreview {
     tokenOut: PreviewedAsset;
 }
 export interface OpenCreditAccountPreview {
-    operation: "OpenCreditAccount" | "SecuritizeOpenCreditAccount";
+    operation: "OpenCreditAccount" | "RWAOpenCreditAccount";
     /**
      * Credit manager the account is opened in
      */
@@ -170,8 +170,65 @@ export interface AdjustCreditAccountPreview {
      */
     assetsChange: Asset[];
 }
+export interface CloseCreditAccountPreview {
+    operation: "CloseCreditAccount";
+    /**
+     * True when the account is closed permanently (facade `closeCreditAccount`
+     * entry point), false when the debt is zeroed but the account stays open
+     * (plain multicall).
+     */
+    permanent: boolean;
+    /**
+     * Credit manager the account belongs to
+     */
+    creditManager: Address;
+    /**
+     * Credit account that is being closed
+     */
+    creditAccount: Address;
+    /**
+     * Underlying withdrawn to the user: minimal guaranteed amount, from the
+     * multicall replay (all collateral is swapped into underlying before
+     * withdrawal)
+     */
+    receivedAmount: bigint;
+}
+export interface RepayCreditAccountPreview {
+    operation: "RepayCreditAccount";
+    /**
+     * True when the account is closed permanently (facade `closeCreditAccount`
+     * entry point), false when the debt is zeroed but the account stays open
+     * (plain multicall).
+     */
+    permanent: boolean;
+    /**
+     * Credit manager the account belongs to
+     */
+    creditManager: Address;
+    /**
+     * Credit account that is being repaid
+     */
+    creditAccount: Address;
+    /**
+     * Tokens added from the wallet to cover the debt (`addCollateral` calls).
+     *
+     * When the transaction has native value attached, it is represented as a
+     * `NATIVE_ADDRESS` entry, with the wrapped native token amount reduced
+     * accordingly (omitted entirely when it reaches zero).
+     */
+    collateralAdded: Asset[];
+    /**
+     * Tokens returned to the user in-kind (`withdrawCollateral` calls, with the
+     * MAX_UINT256 sentinel resolved against replayed balances)
+     */
+    collateralWithdrawn: Asset[];
+    /**
+     * Total debt repaid: principal + accrued interest + fees, in underlying
+     */
+    debtRepaid: bigint;
+}
 /**
  * Result of previewing a raw operation calldata: currently pool operations and
- * credit account opening are supported.
+ * credit account opening, adjustment, closure and repayment are supported.
  */
-export type OperationPreview = PoolOperationPreview | OpenCreditAccountPreview | AdjustCreditAccountPreview;
+export type OperationPreview = PoolOperationPreview | OpenCreditAccountPreview | AdjustCreditAccountPreview | CloseCreditAccountPreview | RepayCreditAccountPreview;

package/dist/types/sdk/accounts/types.d.ts

@@ -2,7 +2,7 @@ import type { Address, ContractFunctionArgs, GetContractReturnType, Hex, PublicC
 import type { creditAccountCompressorAbi } from "../../abi/compressors/creditAccountCompressor.js";
 import type { iWithdrawalCompressorV310Abi } from "../../abi/IWithdrawalCompressorV310.js";
 import type { Asset, ConnectedBotData, Construct, CreditAccountData } from "../base/index.js";
-import type { CreditSuite, PriceUpdate, RWAOperationParams } from "../market/index.js";
+import type { CreditSuite, PriceUpdate, RWAOperationArgs } from "../market/index.js";
 import type { RWAOpenAccountRequirements } from "../market/rwa/index.js";
 import type { OnchainSDK } from "../OnchainSDK.js";
 import type { RouterCASlice, RouterCloseResult } from "../router/index.js";
@@ -467,11 +467,11 @@ export interface OpenCAProps extends PrepareUpdateQuotasProps {
      * RWA options to open credit account with, required for RWA factories
      * First we ask for getOpenAccountRequirements,
      * then perform necessary actions (e.g. for Securitize, convert requiredSignatures to signaturesToCache)
-     * to produce RWAOperationParams
+     * to produce RWAOperationArgs
      * If getOpenAccountRequirements returned undefined, we need to pass undefined here too;
      * It means that no RWA actions are required (e.g. when we open second credit account)
      */
-    rwaOptions?: RWAOperationParams;
+    rwaOptions?: RWAOperationArgs;
 }
 export interface ChangeDeptProps {
     /**

package/dist/types/sdk/market/rwa/securitize/SecuritizeRWAFactory.d.ts

@@ -6,7 +6,7 @@ import type { MultiCall, RawTx } from "../../../types/index.js";
 import type { IRWAFactory, RWACompressorInvestorData, RWAFactoryData } from "../types.js";
 import { RWA_FACTORY_SECURITIZE } from "./constants.js";
 import { SecuritizeDegenNFT } from "./SecuritizeDegenNFT.js";
-import { type DStokenData, type SecuritizeInvestorData, type SecuritizeOpenAccountRequirements, type SecuritizeOperationParams, type SecuritizeRWAFactoryStateHuman } from "./types.js";
+import { type DStokenData, type SecuritizeInvestorData, type SecuritizeMissingOpenAccountRequirements, type SecuritizeOpenAccountRequirements, type SecuritizeOperationArgs, type SecuritizeRWAFactoryStateHuman } from "./types.js";
 declare const abi: readonly [{
     readonly type: "function";
     readonly name: "contractType";
@@ -493,15 +493,23 @@ export declare class SecuritizeRWAFactory extends BaseContract<abi> implements I
     /**
      * {@inheritDoc IRWAFactory.multicall}
      */
-    multicall(creditAccount: Address, calls: MultiCall[], options?: SecuritizeOperationParams): RawTx;
+    multicall(creditAccount: Address, calls: MultiCall[], args?: SecuritizeOperationArgs): RawTx;
     /**
      * {@inheritDoc IRWAFactory.getOpenAccountRequirements}
      */
     getOpenAccountRequirements(investor: Address, props: GetOpenAccountRequirementsProps): Promise<SecuritizeOpenAccountRequirements | undefined>;
+    /**
+     * {@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: SecuritizeOpenAccountRequirements, providedArgs?: SecuritizeOperationArgs): SecuritizeMissingOpenAccountRequirements | undefined;
     /**
      * {@inheritDoc IRWAFactory.openCreditAccount}
      */
-    openCreditAccount(creditManager: Address, calls: MultiCall[], options?: SecuritizeOperationParams): RawTx;
+    openCreditAccount(creditManager: Address, calls: MultiCall[], args?: SecuritizeOperationArgs): RawTx;
     stateHuman(_raw?: boolean): SecuritizeRWAFactoryStateHuman;
 }
 export {};

package/dist/types/sdk/market/rwa/securitize/types.d.ts

@@ -120,16 +120,32 @@ export interface SecuritizeRWAFactoryStateHuman extends BaseContractStateHuman {
     }[];
 }
 /**
- * Factory-specific parameters for {@link SecuritizeRWAFactory.multicall}
+ * Factory-specific args for {@link SecuritizeRWAFactory.multicall}
  * and {@link SecuritizeRWAFactory.openCreditAccount}.
  **/
-export interface SecuritizeOperationParams {
+export interface SecuritizeOperationArgs {
     type: typeof RWA_FACTORY_SECURITIZE;
     /** DSToken addresses to register for this operation. */
     tokensToRegister: Address[];
     /** Cached EIP-712 registration signatures to store on-chain. */
     signaturesToCache: SecuritizeRegisterMessage[];
 }
+/**
+ * Subset of {@link SecuritizeOpenAccountRequirements} still unfulfilled given
+ * the params already carried by the transaction calldata. Returned by
+ * `SecuritizeRWAFactory.getMissingRequirements`; `undefined` there means the
+ * requirements are satisfied.
+ **/
+export interface SecuritizeMissingOpenAccountRequirements {
+    type: typeof RWA_FACTORY_SECURITIZE;
+    /**
+     * EIP-712 messages the investor still has to sign (not covered by
+     * calldata-provided signatures). Once signed, they become the
+     * `signaturesToCache` arg of the factory's `openCreditAccount`/`multicall`
+     * calls (see {@link SecuritizeOperationArgs}).
+     */
+    requiredSignatures: SecuritizeRegisterVaultMessage[];
+}
 export interface SecuritizeOpenAccountRequirements {
     type: typeof RWA_FACTORY_SECURITIZE;
     /**

package/dist/types/sdk/market/rwa/types.d.ts

@@ -4,7 +4,7 @@ import type { iRWACompressorAbi } from "../../../abi/rwa/iRWACompressor.js";
 import type { GetOpenAccountRequirementsProps } from "../../accounts/types.js";
 import type { IBaseContract, Unarray } from "../../base/index.js";
 import type { MultiCall, RawTx } from "../../types/index.js";
-import type { SecuritizeInvestorData, SecuritizeOpenAccountRequirements, SecuritizeOperationParams, SecuritizeRWAFactoryStateHuman } from "./securitize/index.js";
+import type { SecuritizeInvestorData, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRWAFactoryStateHuman } from "./securitize/index.js";
 import { RWA_FACTORY_SECURITIZE } from "./securitize/index.js";
 /**
  * Discriminated union of all known RWA factory contract type strings.
@@ -25,8 +25,9 @@ interface RWAFactoryTypeMap {
     [RWA_FACTORY_SECURITIZE]: {
         investorData: SecuritizeInvestorData;
         openAccountRequirements: SecuritizeOpenAccountRequirements;
+        missingOpenAccountRequirements: SecuritizeMissingOpenAccountRequirements;
         stateHuman: SecuritizeRWAFactoryStateHuman;
-        operationParams: SecuritizeOperationParams;
+        operationArgs: SecuritizeOperationArgs;
     };
 }
 /**
@@ -39,11 +40,17 @@ export type RWAInvestorData<T extends RWAFactoryType = RWAFactoryType> = RWAFact
  * Can be discriminated by type
  **/
 export type RWAOpenAccountRequirements<T extends RWAFactoryType = RWAFactoryType> = RWAFactoryTypeMap[T]["openAccountRequirements"];
+/**
+ * Subset of {@link RWAOpenAccountRequirements} that is still unfulfilled,
+ * defaults to union of all factory types.
+ * Can be discriminated by type
+ **/
+export type RWAMissingOpenAccountRequirements<T extends RWAFactoryType = RWAFactoryType> = RWAFactoryTypeMap[T]["missingOpenAccountRequirements"];
 /**
  * Open credit account/Multicall extra params type for a RWA factory, defaults to union of all factory types
  * Can be discriminated by type
  **/
-export type RWAOperationParams<T extends RWAFactoryType = RWAFactoryType> = RWAFactoryTypeMap[T]["operationParams"];
+export type RWAOperationArgs<T extends RWAFactoryType = RWAFactoryType> = RWAFactoryTypeMap[T]["operationArgs"];
 /**
  * Raw return type of `RWACompressor.getRWAMarketsData`.
  **/
@@ -142,10 +149,10 @@ export interface IRWAFactory<T extends RWAFactoryType = RWAFactoryType> extends
      *
      * @param creditAccount - credit account address
      * @param calls - calls to perform
-     * @param options - factory-specific parameters (e.g. tokens to
-     *   register, signatures to cache). Undefined value means that no RWA actions are required
+     * @param args - factory-specific args (e.g. tokens to register, signatures to cache).
+     *   Undefined value means that no RWA actions are required
      **/
-    multicall(creditAccount: Address, calls: MultiCall[], options?: RWAOperationParams<T>): RawTx;
+    multicall(creditAccount: Address, calls: MultiCall[], args?: RWAOperationArgs<T>): RawTx;
     /**
      * Checks if the user can open a credit account with this factory.
      * @param investor - investor address
@@ -154,17 +161,27 @@ export interface IRWAFactory<T extends RWAFactoryType = RWAFactoryType> extends
      *   user can open a credit account without any further actions
      **/
     getOpenAccountRequirements(investor: Address, props: GetOpenAccountRequirementsProps): Promise<RWAOpenAccountRequirements<T> | undefined>;
+    /**
+     * Computes the subset of `requirements` still unfulfilled, given the
+     * factory-specific params already carried by the transaction calldata.
+     *
+     * @param requirements - requirements fetched via {@link getOpenAccountRequirements}
+     * @param providedArgs - params decoded from the transaction calldata, if
+     *   any; e.g. signatures already included there need not be signed again
+     * @returns the missing requirements, or `undefined` when everything is
+     *   satisfied
+     **/
+    getMissingRequirements(requirements: RWAOpenAccountRequirements<T>, providedArgs?: RWAOperationArgs<T>): RWAMissingOpenAccountRequirements<T> | undefined;
     /**
      * Creates a raw transaction to open a credit account.
      * Similar to {@link CreditFacadeV310Contract.openCreditAccount}.
      *
      * @param creditManager - credit manager address
      * @param calls - initial calls to perform
-     * @param options - factory-specific parameters (e.g. tokens to
-     *   register, signatures to cache).
+     * @param args - factory-specific args (e.g. tokens to register, signatures to cache).
      * Undefined value means that no RWA actions are required (e.g. when we open second credit account)
      **/
-    openCreditAccount(creditManager: Address, calls: MultiCall[], options?: RWAOperationParams<T>): RawTx;
+    openCreditAccount(creditManager: Address, calls: MultiCall[], args?: RWAOperationArgs<T>): RawTx;
 }
 /**
  * Narrows any contract to an {@link IRWAFactory}.

package/dist/types/sdk/utils/AddressSet.d.ts

@@ -13,6 +13,7 @@ export declare class AddressSet extends Set<Address> {
     add(value: Address): this;
     delete(value: Address): boolean;
     has(value: Address): boolean;
+    difference<U>(other: ReadonlySetLike<U>): AddressSet;
     /**
      * Returns all addresses as an array.
      **/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "14.12.0-next.12",
+  "version": "14.12.0-next.13",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {