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

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

@@ -1,61 +1,8 @@
 import type { Address } from "viem";
-import type { OnchainSDK, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements } from "../../sdk/index.js";
-/**
- * Extension point that ties each prerequisite kind to its detail payload.
- *
- * IMPORTANT: only add prerequisites that are *actionable by the transaction
- * sender* (the LP provider or borrower). A valid prerequisite is one the user
- * can resolve themselves before retrying, e.g. approve a token (`allowance`)
- * or perform offchain KYC verification.
- *
- * Do NOT add protocol- or admin-level state the user cannot change.
- */
-export interface PrerequisiteDetailMap {
-    /** ERC-20 allowance from `owner` to `spender` must cover `required`. */
-    allowance: {
-        token: Address;
-        owner: Address;
-        spender: Address;
-        required: bigint;
-        /** On-chain allowance read; only present when the read succeeded. */
-        actual?: bigint;
-    };
-    /** ERC-20 balance of `owner` must cover `required`. */
-    balance: {
-        token: Address;
-        owner: Address;
-        required: bigint;
-        /** On-chain balance read; only present when the read succeeded. */
-        actual?: bigint;
-    };
-    /**
-     * RWA (e.g. Securitize) open-account requirements: off-chain token
-     * registration and/or EIP-712 signatures the borrower must provide before
-     * opening a credit account in an RWA market.
-     */
-    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];
+import type { OnchainSDK } from "../../sdk/index.js";
+import type { AllowanceResult } from "./AllowancePrerequisite.js";
+import type { BalanceResult } from "./BalancePrerequisite.js";
+import type { RWAOpenRequirementsResult } from "./RWAOpenRequirementsPrerequisite.js";
 /** Failure of the underlying on-chain read (revert, decode error, RPC error). */
 export interface PrerequisiteError {
     /** Decoded revert reason / error name, human-readable. */
@@ -63,32 +10,27 @@ export interface PrerequisiteError {
     /** Original error, kept for debugging. */
     cause?: unknown;
 }
-export interface PrerequisiteBase<K extends PrerequisiteKind> {
-    id: string;
-    kind: K;
-    title: string;
-    detail: PrerequisiteDetail<K>;
-}
 /**
  * Outcome of verifying a single prerequisite: either the read succeeded (a
  * `satisfied` boolean) or it reverted/failed (an `error` with the revert
- * reason). The two variants are mutually exclusive.
+ * reason).
  */
-export type PrerequisiteResult<K extends PrerequisiteKind = PrerequisiteKind> = PrerequisiteBase<K> & ({
+export type PrerequisiteOutcome = {
     satisfied: boolean;
     error?: undefined;
 } | {
     satisfied?: undefined;
     error: PrerequisiteError;
-});
+};
 /**
- * Discriminated union over every prerequisite kind. Switching on `kind`
- * narrows `detail` to the matching payload, so React components can render
- * kind-specific details with full type safety.
+ * Discriminated union over every prerequisite kind
+ *
+ * Only add prerequisites that are actionable by tx sender.
+ * A valid prerequisite is one the user can resolve themselves before retrying,
+ * e.g. approve a token (`allowance`) or perform offchain KYC verification.
  */
-export type AnyPrerequisiteResult = {
-    [K in PrerequisiteKind]: PrerequisiteResult<K>;
-}[PrerequisiteKind];
+export type PrerequisiteResult = AllowanceResult | BalanceResult | RWAOpenRequirementsResult;
+export type PrerequisiteKind = PrerequisiteResult["kind"];
 /** Shared inputs for building and verifying prerequisites. */
 export interface PrerequisiteContext {
     sdk: OnchainSDK;

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

@@ -1,5 +1,6 @@
+import { type SdkWithAdapters } from "../../plugins/adapters/index.js";
 import { type Asset, AssetsMap, type PluginsMap } from "../../sdk/index.js";
-import type { InnerOperation, SdkWithAdapters } from "../parse/index.js";
+import type { InnerOperation } from "../parse/index.js";
 /**
  * Running state threaded through a credit-facade multicall by
  * {@link applyInnerOperations}. Seeded by the caller:
@@ -51,9 +52,15 @@ export declare function makeInnerOperationsState(): InnerOperationsState;
  * exact deltas for explicit facade calls, exact leftovers for diff-style
  * adapter calls inside `storeExpectedBalances`/`compareBalances` brackets and
  * enforced minimums for bracket targets. Adapter calls outside a bracket are
- * ignored: nothing enforces their outcome on-chain (e.g. reward claims and RWA
- * wrap/unwrap calls emitted by `CreditAccountsServiceV310`), so their
- * guaranteed balance change is zero.
+ * ignored: nothing enforces their outcome on-chain (e.g. reward claims), so
+ * their guaranteed balance change is zero.
+ *
+ * The exception is RWA wrap/unwrap calls emitted by
+ * `CreditAccountsServiceV310`: out-of-bracket ERC4626 adapter calls whose
+ * share token is an RWA underlying. Their outcome is essential to the preview
+ * (the conversion between the market underlying and its asset); RWA
+ * underlyings always convert 1-to-1 with their vault asset, so the conversion
+ * is applied directly, see {@link applyRWAWrapUnwrap}.
  *
  * @throws On malformed `storeExpectedBalances`/`compareBalances` brackets and
  * on bracketed calls to non-adapter targets.

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

@@ -0,0 +1,13 @@
+import { type Hex } from "viem";
+import type { ERC4626AdapterContract } from "../../plugins/adapters/index.js";
+import type { AssetsMap } from "../../sdk/index.js";
+/**
+ * Applies an RWA wrap/unwrap adapter call (ERC4626 `deposit`/`redeem` and
+ * their diff variants, as emitted by `CreditAccountsServiceV310`) to the
+ * running credit-account balances.
+ *
+ * RWA underlyings always convert 1-to-1 with their vault asset, so the
+ * counterpart amount equals the input amount and no on-chain preview read is
+ * needed.
+ */
+export declare function applyRWAWrapUnwrap(adapter: ERC4626AdapterContract, calldata: Hex, balances: AssetsMap): void;

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

@@ -2,6 +2,6 @@ export * from "./applyInnerOperations.js";
 export * from "./detectCloseOrRepay.js";
 export * from "./errors.js";
 export * from "./previewAdjustCreditAccount.js";
-export * from "./previewCloseOrRepay.js";
+export * from "./previewCloseOrRepayCreditAccount.js";
 export * from "./previewOperation.js";
 export * from "./types.js";

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

@@ -1,6 +1,7 @@
 import { type PluginsMap } from "../../sdk/index.js";
 import type { MulticallOperation, RWAMulticallOperation } from "../parse/index.js";
-import type { AdjustCreditAccountPreview, PreviewOperationInput, PreviewOperationOptions } from "./types.js";
+import type { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
+import type { AdjustCreditAccountPreview } from "./types.js";
 /**
  * Previews a `multicall`/`botMulticall` operation on an existing credit
  * account: fetches the account's pre-state (unless provided via options),

package/dist/types/preview/preview/{previewCloseOrRepay.d.ts → previewCloseOrRepayCreditAccount.d.ts}

@@ -1,10 +1,11 @@
 import { type PluginsMap } from "../../sdk/index.js";
 import type { CloseCreditAccountOperation, MulticallOperation, RWAMulticallOperation } from "../parse/index.js";
-import type { OperationPreview, PreviewOperationInput, PreviewOperationOptions } from "./types.js";
+import type { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
+import type { OperationPreview } 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>;
+export declare function previewCloseOrRepayCreditAccount<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,5 @@
 import { type PluginsMap } from "../../sdk/index.js";
 import type { OpenCreditAccountOperation, RWAOpenCreditAccountOperation } from "../parse/index.js";
-import type { OpenCreditAccountPreview, PreviewOperationInput } from "./types.js";
+import type { PreviewOperationInput } from "../types.js";
+import type { OpenCreditAccountPreview } from "./types.js";
 export declare function previewOpenCreditAccount<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: OpenCreditAccountOperation | RWAOpenCreditAccountOperation): OpenCreditAccountPreview;

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

@@ -1,5 +1,6 @@
 import type { PluginsMap } from "../../sdk/index.js";
-import type { OperationPreview, PreviewOperationInput, PreviewOperationOptions } from "./types.js";
+import type { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
+import type { OperationPreview } from "./types.js";
 /**
  * Previews a raw operation calldata: decodes it into a typed operation and
  * assembles an operation-specific, human-displayable preview.

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

@@ -1,5 +1,5 @@
 import type { PluginsMap } from "../../sdk/index.js";
 import type { PoolOperation } from "../parse/index.js";
-import { type OperationSimulationOptions } from "../simulate/index.js";
-import type { PoolOperationPreview, PreviewOperationInput } from "./types.js";
-export declare function previewPoolOperation<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: PoolOperation, options?: OperationSimulationOptions): Promise<PoolOperationPreview>;
+import type { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
+import type { PoolOperationPreview } from "./types.js";
+export declare function previewPoolOperation<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: PoolOperation, options?: PreviewOperationOptions): Promise<PoolOperationPreview>;

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

@@ -1,57 +1,6 @@
-import type { Address, Hex } from "viem";
-import type { Asset, CreditAccountData, PluginsMap } from "../../sdk/index.js";
-import type { PoolOperationType, SdkWithAdapters } from "../parse/index.js";
-import type { OperationSimulationOptions } from "../simulate/index.js";
-/**
- * Input of {@link previewOperation}: the raw operation calldata plus the
- * already-attached SDK
- */
-export interface PreviewOperationInput<P extends PluginsMap = PluginsMap> {
-    /**
-     * Already-attached SDK; chain, RPC and block are baked in at attach time.
-     * Must be created with the adapters plugin (enforced at compile time) so
-     * adapter contracts resolve during multicall classification.
-     */
-    sdk: SdkWithAdapters<P>;
-    /**
-     * Contract address that was called
-     */
-    to: Address;
-    /**
-     * Raw calldata of the operation
-     */
-    calldata: Hex;
-    /**
-     * Transaction sender
-     */
-    sender: Address;
-    /**
-     * Transaction `msg.value`
-     **/
-    value?: bigint;
-}
-/**
- * Options of {@link previewOperation}, extending the simulation options with
- * preview-specific inputs.
- */
-export interface PreviewOperationOptions extends OperationSimulationOptions {
-    /**
-     * Pre-fetched state of the credit account being adjusted. When omitted,
-     * multicall/botMulticall previews fetch it via
-     * `sdk.accounts.getCreditAccountData` (one compressor read). Ignored by
-     * other operation kinds.
-     */
-    creditAccount?: CreditAccountData;
-}
-/**
- * A token amount that may require an additional async call (e.g. an ERC4626
- * preview read) to determine. When that call fails, only the token address and
- * the error are returned.
- */
-export type PreviewedAsset = Asset | {
-    token: Address;
-    error: Error;
-};
+import type { Address } from "viem";
+import type { Asset } from "../../sdk/index.js";
+import type { PoolOperationType } from "../parse/index.js";
 export interface PoolOperationPreview {
     operation: PoolOperationType;
     /**
@@ -65,10 +14,9 @@ export interface PoolOperationPreview {
      *
      * For mint/withdraw the amount of tokenIn cannot be determined from
      * transaction calldata alone and requires an additional async call
-     * (previewMint/previewWithdraw). In case of error only the token address is
-     * returned.
+     * (previewMint/previewWithdraw).
      */
-    tokenIn: PreviewedAsset;
+    tokenIn: Asset;
     /**
      * Token that goes from pool to user
      * In case of deposit, pool shares (diesel token) for direct deposit or zapper token out
@@ -76,10 +24,9 @@ export interface PoolOperationPreview {
      *
      * For deposit/redeem the amount of tokenOut cannot be determined from
      * transaction calldata alone and requires an additional async call
-     * (previewDeposit/previewRedeem). In case of error only the token address is
-     * returned.
+     * (previewDeposit/previewRedeem).
      */
-    tokenOut: PreviewedAsset;
+    tokenOut: Asset;
 }
 export interface OpenCreditAccountPreview {
     operation: "OpenCreditAccount" | "RWAOpenCreditAccount";

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

@@ -1,10 +1,7 @@
 export type { SimulationError, SimulationFlowFailure, SimulationFlowSource, } from "./errors.js";
 export { PreviewSimulationError } from "./errors.js";
-export type { SimulateFacadeOperationInput } from "./simulateFacadeOperation.js";
 export { simulateFacadeOperation } from "./simulateFacadeOperation.js";
-export type { SimulateOperationInput } from "./simulateOperation.js";
 export { simulateOperation } from "./simulateOperation.js";
 export { simulatePoolOperation } from "./simulatePoolOperation.js";
-export type { SimulateRWAOperationInput } from "./simulateRWAOperation.js";
 export { simulateRWAOperation } from "./simulateRWAOperation.js";
-export type { OperationSimulationOptions, PoolOperationSimulation, PoolOperationSimulationInput, PoolOperationSimulationResult, } from "./types.js";
+export type { PoolOperationSimulationResult, SimulationInput, } from "./types.js";

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

@@ -1,17 +1,6 @@
-import type { Address, Hex } from "viem";
-import type { OnchainSDK } from "../../sdk/index.js";
 import type { OuterFacadeOperation } from "../parse/index.js";
-import type { OperationSimulationOptions, PoolOperationSimulation } from "./types.js";
-export interface SimulateFacadeOperationInput {
-    /** Only `client`/`networkType` are used, so any OnchainSDK works. */
-    sdk: OnchainSDK;
-    /** Parsed credit-facade operation to simulate. */
-    operation: OuterFacadeOperation;
-    /** Target contract the calldata is sent to (the credit facade). */
-    to: Address;
-    /** Raw credit-facade calldata to simulate. */
-    calldata: Hex;
-}
+import type { PreviewOperationOptions } from "../types.js";
+import type { PoolOperationSimulationResult, SimulationInput } from "./types.js";
 /**
  * Simulates a credit-facade operation.
  *
@@ -20,4 +9,4 @@ export interface SimulateFacadeOperationInput {
  * signature mirrors {@link simulatePoolOperation} so the
  * {@link simulateOperation} wrapper can delegate uniformly once implemented.
  */
-export declare function simulateFacadeOperation(_input: SimulateFacadeOperationInput, _options?: OperationSimulationOptions): Promise<PoolOperationSimulation>;
+export declare function simulateFacadeOperation(_input: SimulationInput<OuterFacadeOperation>, _options?: PreviewOperationOptions): Promise<PoolOperationSimulationResult>;

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

@@ -1,18 +1,6 @@
-import type { Address, Hex } from "viem";
-import type { OnchainSDK } from "../../sdk/index.js";
-import { type Operation } from "../parse/index.js";
-import type { OperationSimulationOptions, PoolOperationSimulation } from "./types.js";
-export interface SimulateOperationInput {
-    /** Gearbox SDK instance. */
-    sdk: OnchainSDK;
-    /** Parsed pool or credit account operation */
-    operation: Operation;
-    /** Target contract the calldata is sent to. */
-    to: Address;
-    /** Raw operation calldata to simulate. */
-    calldata: Hex;
-}
+import type { PreviewOperationOptions } from "../types.js";
+import type { PoolOperationSimulationResult, SimulationInput } from "./types.js";
 /**
- * Simulates a parsed pool or credit account operation {@link Operation}
+ * Simulates a parsed pool or credit account operation
  */
-export declare function simulateOperation(input: SimulateOperationInput, options?: OperationSimulationOptions): Promise<PoolOperationSimulation>;
+export declare function simulateOperation(input: SimulationInput, options?: PreviewOperationOptions): Promise<PoolOperationSimulationResult>;

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

@@ -1,7 +1,11 @@
-import type { OperationSimulationOptions, PoolOperationSimulation, PoolOperationSimulationInput } from "./types.js";
+import type { PoolOperation } from "../parse/index.js";
+import type { PreviewOperationOptions } from "../types.js";
+import type { PoolOperationSimulationResult, SimulationInput } from "./types.js";
 /**
  * Simulates a pool deposit/mint/withdraw/redeem (direct or zapper-routed) and
- * returns the resulting token amounts going in and out, or a decoded failure.
+ * returns the resulting token amounts going in and out. Throws a
+ * {@link PreviewSimulationError} with the decoded revert when the preview read
+ * fails.
  *
  * Performs the matching preview read (the pool's ERC4626
  * `previewDeposit`/`previewMint`/`previewWithdraw`/`previewRedeem`, or the
@@ -11,4 +15,4 @@ import type { OperationSimulationOptions, PoolOperationSimulation, PoolOperation
  * It does not execute the calldata, so it ignores balance/allowance
  * prerequisites (preview reads succeed regardless).
  */
-export declare function simulatePoolOperation(input: PoolOperationSimulationInput, options?: OperationSimulationOptions): Promise<PoolOperationSimulation>;
+export declare function simulatePoolOperation(input: SimulationInput<PoolOperation>, options?: PreviewOperationOptions): Promise<PoolOperationSimulationResult>;

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

@@ -1,17 +1,6 @@
-import type { Address, Hex } from "viem";
-import type { OnchainSDK } from "../../sdk/index.js";
 import type { RWAOperation } from "../parse/index.js";
-import type { OperationSimulationOptions, PoolOperationSimulation } from "./types.js";
-export interface SimulateRWAOperationInput {
-    /** Only `client`/`networkType` are used, so any OnchainSDK works. */
-    sdk: OnchainSDK;
-    /** Parsed RWA-factory operation to simulate. */
-    operation: RWAOperation;
-    /** Target contract the calldata is sent to (the RWA factory). */
-    to: Address;
-    /** Raw RWA-factory calldata to simulate. */
-    calldata: Hex;
-}
+import type { PreviewOperationOptions } from "../types.js";
+import type { PoolOperationSimulationResult, SimulationInput } from "./types.js";
 /**
  * Simulates an RWA-factory operation.
  *
@@ -20,4 +9,4 @@ export interface SimulateRWAOperationInput {
  * not cover. The signature mirrors {@link simulatePoolOperation} so the
  * {@link simulateOperation} wrapper can delegate uniformly once implemented.
  */
-export declare function simulateRWAOperation(_input: SimulateRWAOperationInput, _options?: OperationSimulationOptions): Promise<PoolOperationSimulation>;
+export declare function simulateRWAOperation(_input: SimulationInput<RWAOperation>, _options?: PreviewOperationOptions): Promise<PoolOperationSimulationResult>;

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

@@ -1,31 +1,25 @@
 import type { Address, Hex } from "viem";
 import type { OnchainSDK } from "../../sdk/index.js";
-import type { ILogger } from "../../sdk/types/logger.js";
-import type { PoolOperation } from "../parse/index.js";
-import type { PreviewSimulationError } from "./errors.js";
-export interface PoolOperationSimulationInput {
+import type { Operation } from "../parse/index.js";
+/**
+ * Input of the simulation functions, generic over the parsed operation kind
+ * so each specialized simulation narrows `operation` while sharing the same
+ * shape.
+ */
+export interface SimulationInput<Op extends Operation = Operation> {
     /** Only `client`/`networkType` are used, so any OnchainSDK works. */
     sdk: OnchainSDK;
-    /** Parsed operation, used to resolve the underlying and pool tokens. */
-    operation: PoolOperation;
-    /** Target contract the calldata is sent to (the pool). */
+    /** Parsed operation to simulate. */
+    operation: Op;
+    /** Target contract the calldata is sent to. */
     to: Address;
-    /** Raw deposit/mint/withdraw/redeem calldata to simulate. */
+    /** Raw operation calldata to simulate. */
     calldata: Hex;
 }
-export interface OperationSimulationOptions {
-    /** Block to simulate at; defaults to latest. */
-    blockNumber?: bigint;
-    /**
-     * Optional logger.
-     **/
-    logger?: ILogger;
-}
 /**
- * Successful simulation of a pool operation: the amounts of tokens going in
+ * Result of simulating a pool operation: the amounts of tokens going in
  * and out. One side comes from calldata, the other from the matching ERC4626
- * preview read. This is the success payload of {@link PoolOperationSimulation}
- * without the `status` discriminant.
+ * preview read.
  */
 export interface PoolOperationSimulationResult {
     /**
@@ -39,14 +33,3 @@ export interface PoolOperationSimulationResult {
      **/
     amountOut: bigint;
 }
-/**
- * Outcome of simulating a pool operation. On success it carries a
- * {@link PoolOperationSimulationResult}; on failure it carries a
- * {@link PreviewSimulationError}.
- */
-export type PoolOperationSimulation = ({
-    status: "success";
-} & PoolOperationSimulationResult) | {
-    status: "failure";
-    error: PreviewSimulationError;
-};

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

@@ -0,0 +1,52 @@
+import type { Address, Hex } from "viem";
+import type { SdkWithAdapters } from "../plugins/adapters/index.js";
+import type { CreditAccountData, PluginsMap } from "../sdk/index.js";
+import type { ILogger } from "../sdk/types/logger.js";
+/**
+ * Raw-calldata operation input shared by `parseOperationCalldata`,
+ * `previewOperation` and `checkPrerequisites`.
+ */
+export interface PreviewOperationInput<P extends PluginsMap = PluginsMap> {
+    /**
+     * Already-attached SDK; chain, RPC and block are baked in at attach time.
+     * Must be created with the adapters plugin (enforced at compile time) so
+     * adapter contracts resolve during multicall classification.
+     */
+    sdk: SdkWithAdapters<P>;
+    /**
+     * Contract address that was called
+     */
+    to: Address;
+    /**
+     * Raw calldata of the operation
+     */
+    calldata: Hex;
+    /**
+     * Transaction sender
+     */
+    sender: Address;
+    /**
+     * Transaction `msg.value`, required for native-token zapper deposits.
+     **/
+    value?: bigint;
+}
+/**
+ * Options shared by the preview, simulation and prerequisite-check flows.
+ * Each flow uses the subset it needs and ignores the rest.
+ */
+export interface PreviewOperationOptions {
+    /**
+     * Block to read/simulate at; defaults to latest. Only set for testnet
+     * forks.
+     */
+    blockNumber?: bigint;
+    /**
+     * Optional logger.
+     **/
+    logger?: ILogger;
+    /**
+     * @internal
+     * Credit account state for testing purposes
+     */
+    creditAccount?: CreditAccountData;
+}

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

@@ -6,7 +6,7 @@ import type { RWAOpenAccountRequirements } from "../market/rwa/index.js";
 import type { OnchainSDK } from "../OnchainSDK.js";
 import type { RouterCASlice } from "../router/index.js";
 import type { MultiCall, RawTx } from "../types/index.js";
-import type { AccountToCheck, AddCollateralProps, AssembleCaOperationsProps, AssembleCaUpdateCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, ChangeDeptProps, ClaimDelayedProps, ClaimFarmRewardsProps, CloseCreditAccountProps, CloseCreditAccountResult, CreditAccountOperationResult, CreditAccountTokensSlice, CreditManagerOperationResult, DefaultPartialLiquidationParams, ExecuteSwapProps, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsOptions, GetOpenAccountRequirementsProps, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, ICreditAccountsService, OpenCAProps, PartiallyLiquidateProps, PreviewDelayedWithdrawalProps, PreviewDelayedWithdrawalResult, RepayAndLiquidateCreditAccountProps, RepayCreditAccountProps, Rewards, SetBotProps, StartDelayedWithdrawalProps, UpdateQuotasProps, WithdrawCollateralProps } from "./types.js";
+import type { AccountToCheck, AddCollateralProps, AssembleCaOperationsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, ChangeDeptProps, ClaimDelayedProps, ClaimFarmRewardsProps, CloseCreditAccountProps, CloseCreditAccountResult, CreditAccountOperationResult, CreditAccountTokensSlice, CreditManagerOperationResult, DefaultPartialLiquidationParams, ExecuteSwapProps, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsOptions, GetOpenAccountRequirementsProps, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, ICreditAccountsService, OpenCAProps, PartiallyLiquidateProps, PreviewDelayedWithdrawalProps, PreviewDelayedWithdrawalResult, RepayAndLiquidateCreditAccountProps, RepayCreditAccountProps, Rewards, SetBotProps, StartDelayedWithdrawalProps, UpdateQuotasProps, WithdrawCollateralProps } from "./types.js";
 /**
  * Options for configuring the credit account service.
  **/
@@ -222,11 +222,6 @@ export declare class CreditAccountsServiceV310 extends SDKConstruct implements I
      * {@inheritDoc ICreditAccountsService.assembleCaOperations}
      */
     assembleCaOperations({ operations, creditFacade, withdrawTo, }: AssembleCaOperationsProps): MultiCall[];
-    /**
-     * {@inheritDoc ICreditAccountsService.assembleCaUpdateCalls}
-     * @deprecated Prefer {@link CreditAccountsServiceV310.assembleCaOperations}.
-     */
-    assembleCaUpdateCalls({ operations, routerCallGroups, creditFacade, withdrawTo, creditAccount, underlyingToken, }: AssembleCaUpdateCallsProps): MultiCall[];
     /**
      * {@inheritDoc ICreditAccountsService.executeCaUpdate}
      */

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

@@ -708,64 +708,10 @@ export type GetApprovalAddressProps = {
     creditManager: Address;
     creditAccount: Address;
 };
-/**
- * A single step in a generic credit account update operation chain.
- *
- * Used by {@link ICreditAccountsService.assembleCaUpdateCalls} to build the
- * underlying credit facade multicall calls.
- *
- * @deprecated Prefer {@link EncodableCreditAccountOperation} with
- * {@link ICreditAccountsService.assembleCaOperations}. Close stays on dedicated
- * assemblers / this deprecated path only.
- */
-export type CreditAccountUpdateOperation = {
-    type: "increaseDebt";
-    amount: bigint;
-} | {
-    type: "decreaseDebt";
-    amount: bigint;
-} | {
-    type: "addCollateral";
-    token: Address;
-    amount: bigint;
-} | {
-    type: "withdrawCollateral";
-    token: Address;
-    amount: bigint;
-} | {
-    type: "swap";
-} | {
-    type: "changeQuota";
-    quotaIncrease: Array<Asset>;
-    quotaDecrease: Array<Asset>;
-} | {
-    type: "closeCreditAccount";
-};
-/**
- * Input for {@link ICreditAccountsService.assembleCaUpdateCalls}.
- *
- * @deprecated Prefer {@link AssembleCaOperationsProps} /
- * {@link ICreditAccountsService.assembleCaOperations}.
- */
-export type AssembleCaUpdateCallsProps = {
-    operations: Array<CreditAccountUpdateOperation>;
-    /** One group per swap leg (in order), or a single group for the close path. */
-    routerCallGroups: Array<Array<MultiCall>>;
-    creditFacade: Address;
-    withdrawTo: Address;
-    creditAccount: {
-        debt: bigint;
-        assets: Array<Asset>;
-        initialQuotas: Record<Address, {
-            quota: bigint;
-        }>;
-    };
-    underlyingToken: Address;
-};
 /**
  * An enriched credit-account operation ready for encoding.
  * Each op carries everything needed to build facade / adapter multicalls —
- * swap and wrap attach concrete `calls` (no external routerCallGroups).
+ * swap / wrap / unwrap attach concrete `calls` (no external routerCallGroups).
  *
  * Used by {@link ICreditAccountsService.assembleCaOperations}. Does not include
  * close / repay (use dedicated assemblers).
@@ -790,6 +736,9 @@ export type EncodableCreditAccountOperation = {
 } | {
     type: "wrapRwaCollateral";
     calls: Array<MultiCall>;
+} | {
+    type: "unwrapRwaCollateral";
+    calls: Array<MultiCall>;
 } | {
     type: "changeQuota";
     quotaIncrease: Array<Asset>;
@@ -1050,15 +999,6 @@ export interface ICreditAccountsService extends Construct {
      * @returns Array of facade / adapter multicall calls (without price feed updates)
      */
     assembleCaOperations(props: AssembleCaOperationsProps): Array<MultiCall>;
-    /**
-     * Builds the credit facade multicall calls for a chain of update operations.
-     *
-     * @param props - Operation chain, router call groups and account context
-     * @returns Array of facade multicall calls (without price feed updates)
-     * @deprecated Prefer {@link ICreditAccountsService.assembleCaOperations}. Close
-     * remains on this method / dedicated close assembler only.
-     */
-    assembleCaUpdateCalls(props: AssembleCaUpdateCallsProps): Array<MultiCall>;
     /**
      * Executes a credit account update: prepends price feed updates and builds the raw
      * multicall transaction. Uses the RWA factory when applicable.