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

package/dist/types/plugins/adapters/types.d.ts

@@ -1,55 +1,47 @@
 import type { AbiParameter, Address } from "viem";
+import type { OnchainSDK, PluginsMap } from "../../sdk/index.js";
 import type { BaseContractStateHuman } from "../../sdk/types/state-human.js";
+import type { AdaptersPlugin } from "./AdaptersPlugin.js";
 export type VersionedAbi = Record<number, readonly AbiParameter[]>;
-export type AdapterContractType = "ADAPTER::ACCOUNT_MIGRATOR" | "ADAPTER::BALANCER_V3_ROUTER" | "ADAPTER::BALANCER_V3_WRAPPER" | "ADAPTER::BALANCER_VAULT" | "ADAPTER::CAMELOT_V3_ROUTER" | "ADAPTER::CURVE_STABLE_NG" | "ADAPTER::CURVE_V1_2ASSETS" | "ADAPTER::CURVE_V1_3ASSETS" | "ADAPTER::CURVE_V1_4ASSETS" | "ADAPTER::CURVE_V1_STECRV_POOL" | "ADAPTER::CURVE_V1_WRAPPER" | "ADAPTER::CVX_V1_BASE_REWARD_POOL" | "ADAPTER::CVX_V1_BOOSTER" | "ADAPTER::DAI_USDS_EXCHANGE" | "ADAPTER::EQUALIZER_ROUTER" | "ADAPTER::ERC4626_VAULT" | "ADAPTER::ERC4626_VAULT_REFERRAL" | "ADAPTER::FLUID_DEX" | "ADAPTER::INFINIFI_GATEWAY" | "ADAPTER::INFINIFI_UNWINDING" | "ADAPTER::INFRARED_VAULT" | "ADAPTER::KELP_DEPOSIT_POOL" | "ADAPTER::KELP_WITHDRAWAL" | "ADAPTER::KODIAK_ISLAND_GATEWAY" | "ADAPTER::LIDO_V1" | "ADAPTER::LIDO_WSTETH_V1" | "ADAPTER::MELLOW_CLAIMER" | "ADAPTER::MELLOW_DVV" | "ADAPTER::MELLOW_ERC4626_VAULT" | "ADAPTER::MELLOW_LRT_VAULT" | "ADAPTER::MELLOW_WRAPPER" | "ADAPTER::MELLOW_DEPOSIT_QUEUE_QUEUE" | "ADAPTER::MELLOW_REDEEM_QUEUE_QUEUE" | "ADAPTER::MIDAS_ISSUANCE_VAULT" | "ADAPTER::MIDAS_REDEMPTION_VAULT" | "ADAPTER::PENDLE_ROUTER" | "ADAPTER::SECURITIZE_ONRAMP" | "ADAPTER::SECURITIZE_REDEMPTION" | "ADAPTER::SECURITIZE_SWAP" | "ADAPTER::STAKING_REWARDS" | "ADAPTER::TRADER_JOE_ROUTER" | "ADAPTER::UNISWAP_V2_ROUTER" | "ADAPTER::UNISWAP_V3_ROUTER" | "ADAPTER::UNISWAP_V4_GATEWAY" | "ADAPTER::UPSHIFT_VAULT" | "ADAPTER::VELODROME_V2_ROUTER" | "ADAPTER::YEARN_V2";
+export type AdapterContractType = "ADAPTER::ACCOUNT_MIGRATOR" | "ADAPTER::BALANCER_V3_ROUTER" | "ADAPTER::BALANCER_V3_WRAPPER" | "ADAPTER::CAMELOT_V3_ROUTER" | "ADAPTER::CURVE_STABLE_NG" | "ADAPTER::CURVE_V1_2ASSETS" | "ADAPTER::CURVE_V1_3ASSETS" | "ADAPTER::CURVE_V1_4ASSETS" | "ADAPTER::CURVE_V1_STECRV_POOL" | "ADAPTER::CVX_V1_BASE_REWARD_POOL" | "ADAPTER::CVX_V1_BOOSTER" | "ADAPTER::DAI_USDS_EXCHANGE" | "ADAPTER::ERC4626_VAULT" | "ADAPTER::ERC4626_VAULT_REFERRAL" | "ADAPTER::FLUID_DEX" | "ADAPTER::INFINIFI_GATEWAY" | "ADAPTER::INFINIFI_UNWINDING" | "ADAPTER::KELP_DEPOSIT_POOL" | "ADAPTER::KELP_WITHDRAWAL" | "ADAPTER::LIDO_V1" | "ADAPTER::LIDO_WSTETH_V1" | "ADAPTER::MELLOW_CLAIMER" | "ADAPTER::MELLOW_DVV" | "ADAPTER::MELLOW_ERC4626_VAULT" | "ADAPTER::MELLOW_WRAPPER" | "ADAPTER::MIDAS_ISSUANCE_VAULT" | "ADAPTER::MIDAS_REDEMPTION_VAULT" | "ADAPTER::PENDLE_ROUTER" | "ADAPTER::SECURITIZE_ONRAMP" | "ADAPTER::SECURITIZE_REDEMPTION" | "ADAPTER::STAKING_REWARDS" | "ADAPTER::TRADERJOE_ROUTER" | "ADAPTER::UNISWAP_V2_ROUTER" | "ADAPTER::UNISWAP_V3_ROUTER" | "ADAPTER::UNISWAP_V4_GATEWAY" | "ADAPTER::UPSHIFT_VAULT" | "ADAPTER::VELODROME_V2_ROUTER";
 export declare enum AdapterType {
     ACCOUNT_MIGRATOR = "ACCOUNT_MIGRATOR",
     BALANCER_V3_ROUTER = "BALANCER_V3_ROUTER",
     BALANCER_V3_WRAPPER = "BALANCER_V3_WRAPPER",
-    BALANCER_VAULT = "BALANCER_VAULT",
     CAMELOT_V3_ROUTER = "CAMELOT_V3_ROUTER",
     CURVE_STABLE_NG = "CURVE_STABLE_NG",
     CURVE_V1_2ASSETS = "CURVE_V1_2ASSETS",
     CURVE_V1_3ASSETS = "CURVE_V1_3ASSETS",
     CURVE_V1_4ASSETS = "CURVE_V1_4ASSETS",
     CURVE_V1_STECRV_POOL = "CURVE_V1_STECRV_POOL",
-    CURVE_V1_WRAPPER = "CURVE_V1_WRAPPER",
     CVX_V1_BASE_REWARD_POOL = "CVX_V1_BASE_REWARD_POOL",
     CVX_V1_BOOSTER = "CVX_V1_BOOSTER",
     DAI_USDS_EXCHANGE = "DAI_USDS_EXCHANGE",
-    EQUALIZER_ROUTER = "EQUALIZER_ROUTER",
     ERC4626_VAULT = "ERC4626_VAULT",
     ERC4626_VAULT_REFERRAL = "ERC4626_VAULT_REFERRAL",
     FLUID_DEX = "FLUID_DEX",
     INFINIFI_GATEWAY = "INFINIFI_GATEWAY",
     INFINIFI_UNWINDING = "INFINIFI_UNWINDING",
-    INFRARED_VAULT = "INFRARED_VAULT",
     KELP_DEPOSIT_POOL = "KELP_DEPOSIT_POOL",
     KELP_WITHDRAWAL = "KELP_WITHDRAWAL",
-    KODIAK_ISLAND_GATEWAY = "KODIAK_ISLAND_GATEWAY",
     LIDO_V1 = "LIDO_V1",
     LIDO_WSTETH_V1 = "LIDO_WSTETH_V1",
     MELLOW_CLAIMER = "MELLOW_CLAIMER",
     MELLOW_DVV = "MELLOW_DVV",
     MELLOW_ERC4626_VAULT = "MELLOW_ERC4626_VAULT",
-    MELLOW_LRT_VAULT = "MELLOW_LRT_VAULT",
     MELLOW_WRAPPER = "MELLOW_WRAPPER",
-    MELLOW_DEPOSIT_QUEUE = "MELLOW_DEPOSIT_QUEUE",
-    MELLOW_REDEEM_QUEUE = "MELLOW_REDEEM_QUEUE",
     MIDAS_ISSUANCE_VAULT = "MIDAS_ISSUANCE_VAULT",
     MIDAS_REDEMPTION_VAULT = "MIDAS_REDEMPTION_VAULT",
     PENDLE_ROUTER = "PENDLE_ROUTER",
     SECURITIZE_ONRAMP = "SECURITIZE_ONRAMP",
     SECURITIZE_REDEMPTION = "SECURITIZE_REDEMPTION",
-    SECURITIZE_SWAP = "SECURITIZE_SWAP",
     STAKING_REWARDS = "STAKING_REWARDS",
-    TRADER_JOE_ROUTER = "TRADER_JOE_ROUTER",
+    TRADERJOE_ROUTER = "TRADERJOE_ROUTER",
     UNISWAP_V2_ROUTER = "UNISWAP_V2_ROUTER",
     UNISWAP_V3_ROUTER = "UNISWAP_V3_ROUTER",
     UNISWAP_V4_GATEWAY = "UNISWAP_V4_GATEWAY",
     UPSHIFT_VAULT = "UPSHIFT_VAULT",
-    VELODROME_V2_ROUTER = "VELODROME_V2_ROUTER",
-    YEARN_V2 = "YEARN_V2"
+    VELODROME_V2_ROUTER = "VELODROME_V2_ROUTER"
 }
 /**
  * Diff-call semantics of a diff-style adapter call: the call spends the
@@ -85,3 +77,18 @@ export interface AdapterProtocolOperation {
      */
     functionArgs: Record<string, unknown>;
 }
+/**
+ * True when the plugin map `P` contains the {@link AdaptersPlugin} under any key
+ */
+export type HasAdaptersPlugin<P extends PluginsMap> = Extract<P[keyof P], AdaptersPlugin> extends never ? false : true;
+/**
+ * Compile-time guard for the adapters plugin
+ */
+export type RequireAdaptersPlugin<P extends PluginsMap> = HasAdaptersPlugin<P> extends true ? unknown : {
+    "OnchainSDK must be created with the AdaptersPlugin": never;
+};
+/**
+ * {@link OnchainSDK} whose plugin map is guaranteed at compile time to include
+ * the {@link AdaptersPlugin}.
+ */
+export type SdkWithAdapters<P extends PluginsMap = PluginsMap> = OnchainSDK<P> & RequireAdaptersPlugin<P>;

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

@@ -1,3 +1,5 @@
+export * from "./parse/index.js";
 export * from "./prerequisites/index.js";
 export * from "./preview/index.js";
 export * from "./trace/index.js";
+export * from "./types.js";

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

@@ -1,12 +1,6 @@
 import { type Hex } from "viem";
 import type { CreditFacadeV310Contract, OnchainSDK } from "../../sdk/index.js";
 import type { OuterFacadeOperation } from "./types.js";
-export interface ParseFacadeOperationCalldataProps {
-    sdk: OnchainSDK;
-    /** Resolved credit facade contract for the transaction target. */
-    facade: CreditFacadeV310Contract;
-    calldata: Hex;
-}
 /**
  * Decodes a credit-facade entry-point call into the matching
  * {@link OuterFacadeOperation}.
@@ -15,5 +9,10 @@ export interface ParseFacadeOperationCalldataProps {
  * of the base `preview` operation: those values are only known once the
  * transaction is mined and are added in `history` mode. `creditAccount` is
  * `zeroAddress` for `openCreditAccount` (the address is assigned on-chain).
+ *
+ * @param sdk - The SDK instance.
+ * @param facade - The credit facade contract.
+ * @param calldata - The calldata to parse.
+ * @returns The parsed operation.
  */
-export declare function parseFacadeOperationCalldata(props: ParseFacadeOperationCalldataProps): OuterFacadeOperation;
+export declare function parseFacadeOperationCalldata(sdk: OnchainSDK, facade: CreditFacadeV310Contract, calldata: Hex): OuterFacadeOperation;

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

@@ -1,23 +1,10 @@
-import type { Address, Hex } from "viem";
 import { type PluginsMap } from "../../sdk/index.js";
-import type { Operation, SdkWithAdapters } from "./types.js";
-export interface ParseOperationCalldataInput<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>;
-    to: Address;
-    calldata: Hex;
-    /** Transaction sender, contextual only. */
-    sender: Address;
-    /** Transaction `msg.value`, required for native-token zapper deposits. */
-    value?: bigint;
-}
+import type { PreviewOperationInput } from "../types.js";
+import type { Operation } from "./types.js";
 /**
  * Decodes raw operation calldata into an {@link Operation}.
  *
- * Support parsing of pool operations (including via zappers) and credit facade operations.
+ * Support parsing of pool operations (including via zappers),
+ * credit facade operations and RWA factory operations.
  */
-export declare function parseOperationCalldata<P extends PluginsMap>(input: ParseOperationCalldataInput<P>): Operation;
+export declare function parseOperationCalldata<P extends PluginsMap>(input: PreviewOperationInput<P>): Operation;

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

@@ -1,17 +1,12 @@
 import type { Hex } from "viem";
 import type { OnchainSDK, PoolV310Contract } from "../../sdk/index.js";
 import type { PoolOperation } from "./types.js";
-export interface ParsePoolOperationCalldataProps {
-    sdk: OnchainSDK;
-    /** Resolved pool contract for the transaction target. */
-    pool: PoolV310Contract;
-    calldata: Hex;
-}
 /**
- * Decodes ERC4626 pool calldata into a {@link PoolOperation}. Supports every
- * deposit/mint/withdraw/redeem variant of `IPoolV3` (and the `IERC4626` base it
- * extends): `deposit`/`depositWithReferral`, `mint`/`mintWithReferral`,
- * `withdraw` and `redeem`. Any other selector throws
- * {@link UnsupportedPoolFunctionError}.
+ * Decodes pool calldata into a {@link PoolOperation}.
+ *
+ * @param sdk - The SDK instance.
+ * @param pool - The pool contract.
+ * @param calldata - The calldata to parse.
+ * @returns The parsed operation.
  */
-export declare function parsePoolOperationCalldata(props: ParsePoolOperationCalldataProps): PoolOperation;
+export declare function parsePoolOperationCalldata(sdk: OnchainSDK, pool: PoolV310Contract, calldata: Hex): PoolOperation;

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

@@ -1,22 +1,13 @@
 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.
+ * @param sdk - The SDK instance.
+ * @param factory - The RWA factory contract.
+ * @param calldata - The calldata to parse.
+ * @returns The parsed operation.
  */
-export declare function parseRWAFactoryOperationCalldata(props: ParseRWAFactoryOperationCalldataProps): RWAOperation;
+export declare function parseRWAFactoryOperationCalldata(sdk: OnchainSDK, factory: IRWAFactory, calldata: Hex): RWAOperation;

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

@@ -1,5 +1,3 @@
-import type { AdaptersPlugin } from "../../plugins/adapters/index.js";
-import type { OnchainSDK, PluginsMap } from "../../sdk/index.js";
 import type { OuterFacadeOperation } from "./types-facades.js";
 import type { PoolOperation } from "./types-pools.js";
 import type { RWAOperation } from "./types-rwa.js";
@@ -7,29 +5,6 @@ export * from "./types-adapters.js";
 export * from "./types-facades.js";
 export * from "./types-pools.js";
 export * from "./types-rwa.js";
-/**
- * True when the plugin map `P` contains the {@link AdaptersPlugin} under any
- * key. Matched nominally (the plugin's private fields make it non-structural),
- * so unrelated plugins never satisfy it.
- */
-export type HasAdaptersPlugin<P extends PluginsMap> = Extract<P[keyof P], AdaptersPlugin> extends never ? false : true;
-/**
- * Compile-time guard for the adapters plugin. Resolves to a no-op (`unknown`)
- * when `P` includes the {@link AdaptersPlugin}, otherwise to an error-shaped
- * type that makes the surrounding call fail to type-check.
- *
- * Intended to be intersected with a function argument so callers must pass an
- * SDK whose adapter contracts are registered (required for multicall
- * classification).
- */
-export type RequireAdaptersPlugin<P extends PluginsMap> = HasAdaptersPlugin<P> extends true ? unknown : {
-    "OnchainSDK must be created with the AdaptersPlugin": never;
-};
-/**
- * {@link OnchainSDK} whose plugin map is guaranteed at compile time to include
- * the {@link AdaptersPlugin}.
- */
-export type SdkWithAdapters<P extends PluginsMap = PluginsMap> = OnchainSDK<P> & RequireAdaptersPlugin<P>;
 /**
  * Result of decoding a single raw operation calldata: a pool deposit/redeem,
  * one of the credit-facade operations, or an RWA-factory operation.

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

@@ -1,21 +1,23 @@
 import { type Address } from "viem";
 import { Prerequisite } from "./Prerequisite.js";
-import type { PrerequisiteContext, PrerequisiteDetail, PrerequisiteResult } from "./types.js";
-export interface AllowancePrerequisiteProps {
+import type { PrerequisiteContext, PrerequisiteError, PrerequisiteOutcome } from "./types.js";
+/** ERC-20 allowance from `owner` to `spender` must cover `required`. */
+export interface AllowanceDetail {
     token: Address;
     owner: Address;
     spender: Address;
     required: bigint;
-    title?: string;
-    id?: string;
+    /** On-chain allowance read; only present when the read succeeded. */
+    actual?: bigint;
 }
+export type AllowanceResult = PrerequisiteOutcome & {
+    kind: "allowance";
+    detail: AllowanceDetail;
+};
 /** Checks that `owner` granted `spender` an ERC-20 allowance >= `required`. */
-export declare class AllowancePrerequisite extends Prerequisite<"allowance"> {
+export declare class AllowancePrerequisite extends Prerequisite {
     #private;
-    constructor(props: AllowancePrerequisiteProps);
-    get id(): string;
-    get kind(): "allowance";
-    get title(): string;
-    get detail(): PrerequisiteDetail<"allowance">;
-    protected check(ctx: PrerequisiteContext): Promise<PrerequisiteResult<"allowance">>;
+    constructor(detail: Omit<AllowanceDetail, "actual">);
+    protected check(ctx: PrerequisiteContext): Promise<AllowanceResult>;
+    protected errorResult(error: PrerequisiteError): AllowanceResult;
 }

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

@@ -1,24 +1,26 @@
 import { type Address } from "viem";
 import { Prerequisite } from "./Prerequisite.js";
-import type { PrerequisiteContext, PrerequisiteDetail, PrerequisiteResult } from "./types.js";
-export interface BalancePrerequisiteProps {
+import type { PrerequisiteContext, PrerequisiteError, PrerequisiteOutcome } from "./types.js";
+/** ERC-20 balance of `owner` must cover `required`. */
+export interface BalanceDetail {
     token: Address;
     owner: Address;
     required: bigint;
-    title?: string;
-    id?: string;
+    /** On-chain balance read; only present when the read succeeded. */
+    actual?: bigint;
 }
+export type BalanceResult = PrerequisiteOutcome & {
+    kind: "balance";
+    detail: BalanceDetail;
+};
 /**
  * Checks that `owner` holds a token balance >= `required`. The token is read
  * as an ERC-20, except for the native pseudo-address ({@link NATIVE_ADDRESS},
  * e.g. ETH-zapper deposits) whose balance is read via `getBalance`.
  */
-export declare class BalancePrerequisite extends Prerequisite<"balance"> {
+export declare class BalancePrerequisite extends Prerequisite {
     #private;
-    constructor(props: BalancePrerequisiteProps);
-    get id(): string;
-    get kind(): "balance";
-    get title(): string;
-    get detail(): PrerequisiteDetail<"balance">;
-    protected check(ctx: PrerequisiteContext): Promise<PrerequisiteResult<"balance">>;
+    constructor(detail: Omit<BalanceDetail, "actual">);
+    protected check(ctx: PrerequisiteContext): Promise<BalanceResult>;
+    protected errorResult(error: PrerequisiteError): BalanceResult;
 }

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

@@ -1,36 +1,23 @@
-import type { PrerequisiteContext, PrerequisiteDetail, PrerequisiteKind, PrerequisiteResult } from "./types.js";
+import type { PrerequisiteContext, PrerequisiteError, PrerequisiteResult } from "./types.js";
 /**
  * A single verifiable prerequisite for a transaction. Subclasses implement
  * {@link check} to perform whatever async reads they need (an ERC-20
  * `readContract`, a compressor call, ...) and map the outcome into a
  * {@link PrerequisiteResult}.
- *
  */
-export declare abstract class Prerequisite<K extends PrerequisiteKind> {
-    /** Stable identifier, used as a React key and for deduplication. */
-    abstract get id(): string;
-    /** Discriminant tying this check to its detail payload. */
-    abstract get kind(): K;
-    /** Human-readable label shown in the UI. */
-    abstract get title(): string;
-    /** Inputs known before reading the chain (no `actual` yet). */
-    abstract get detail(): PrerequisiteDetail<K>;
+export declare abstract class Prerequisite {
     /**
      * Verifies this prerequisite. Never rejects: any error thrown by
      * {@link check} (revert, RPC/network failure, compressor error) is
      * normalized into an `error` result.
      */
-    verify(ctx: PrerequisiteContext): Promise<PrerequisiteResult<K>>;
+    verify(ctx: PrerequisiteContext): Promise<PrerequisiteResult>;
     /**
      * Performs the reads this prerequisite needs and maps them into a result.
      * May throw on read failure; {@link verify} converts throws into `error`
      * results.
      */
-    protected abstract check(ctx: PrerequisiteContext): Promise<PrerequisiteResult<K>>;
-    /** Builds a successful result; `detail` carries the on-chain `actual`. */
-    protected satisfiedResult(satisfied: boolean, detail: PrerequisiteDetail<K>): PrerequisiteResult<K>;
-    /** Builds a failed result from a raw read error (normalized internally). */
-    protected errorResult(cause: unknown): PrerequisiteResult<K>;
+    protected abstract check(ctx: PrerequisiteContext): Promise<PrerequisiteResult>;
+    /** Builds this prerequisite's failed result from a normalized read error. */
+    protected abstract errorResult(error: PrerequisiteError): PrerequisiteResult;
 }
-/** Any prerequisite regardless of its kind, used for heterogeneous lists. */
-export type AnyPrerequisite = Prerequisite<PrerequisiteKind>;

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

@@ -1,24 +1,36 @@
 import type { Address } from "viem";
-import type { RWAOperationArgs } from "../../sdk/index.js";
+import type { RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs } from "../../sdk/index.js";
 import { Prerequisite } from "./Prerequisite.js";
-import type { PrerequisiteContext, PrerequisiteDetail, PrerequisiteResult } from "./types.js";
-export interface RWAOpenRequirementsPrerequisiteProps {
-    /** RWA token (e.g. Securitize DSToken) to check the requirements for. */
+import type { PrerequisiteContext, PrerequisiteError, PrerequisiteOutcome } from "./types.js";
+/**
+ * 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.
+ */
+export interface RWAOpenRequirementsDetail {
+    /** 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;
     /**
-     * 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.
+     * 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.
      */
-    providedArgs?: RWAOperationArgs;
-    title?: string;
-    id?: string;
+    missing?: RWAMissingOpenAccountRequirements;
 }
+export type RWAOpenRequirementsResult = PrerequisiteOutcome & {
+    kind: "rwaOpenRequirements";
+    detail: RWAOpenRequirementsDetail;
+};
 /**
  * Checks that the borrower has fulfilled the RWA factory's open-account
  * requirements (issuer-side token registration, EIP-712 signatures).
@@ -31,12 +43,9 @@ export interface RWAOpenRequirementsPrerequisiteProps {
  * (`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"> {
+export declare class RWAOpenRequirementsPrerequisite extends Prerequisite {
     #private;
-    constructor(props: RWAOpenRequirementsPrerequisiteProps);
-    get id(): string;
-    get kind(): "rwaOpenRequirements";
-    get title(): string;
-    get detail(): PrerequisiteDetail<"rwaOpenRequirements">;
-    protected check(ctx: PrerequisiteContext): Promise<PrerequisiteResult<"rwaOpenRequirements">>;
+    constructor(detail: Omit<RWAOpenRequirementsDetail, "requirements" | "missing">, providedArgs?: RWAOperationArgs);
+    protected check(ctx: PrerequisiteContext): Promise<RWAOpenRequirementsResult>;
+    protected errorResult(error: PrerequisiteError): RWAOpenRequirementsResult;
 }

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

@@ -1,6 +1,6 @@
 import { type GetApprovalAddressProps } from "../../sdk/index.js";
 import type { InnerOperation } from "../parse/index.js";
-import type { AnyPrerequisite } from "./Prerequisite.js";
+import type { Prerequisite } from "./Prerequisite.js";
 import type { PrerequisiteContext } from "./types.js";
 /**
  * For every `addCollateral` inside a multicall, requires the wallet to approve
@@ -11,4 +11,4 @@ import type { PrerequisiteContext } from "./types.js";
  * 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[]>;
+export declare function buildCollateralPrerequisites(spenderOptions: GetApprovalAddressProps, multicall: InnerOperation[], ctx: PrerequisiteContext): Promise<Prerequisite[]>;

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

@@ -1,8 +1,8 @@
 import type { PartialLiquidationOperation } from "../parse/index.js";
-import type { AnyPrerequisite } from "./Prerequisite.js";
+import type { Prerequisite } 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[];
+export declare function buildPartialLiquidationPrerequisites(tx: PartialLiquidationOperation, ctx: PrerequisiteContext): Prerequisite[];

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

@@ -1,8 +1,8 @@
 import { type Address } from "viem";
 import type { PoolOperation } from "../parse/index.js";
-import type { AnyPrerequisite } from "./Prerequisite.js";
+import type { Prerequisite } 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[];
+export declare function buildPoolPrerequisites(tx: PoolOperation, wallet: Address): Prerequisite[];

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

@@ -1,7 +1,7 @@
 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 { Prerequisite } from "./Prerequisite.js";
 import type { PrerequisiteContext } from "./types.js";
 /**
  * For RWA-factory open-account operations (e.g. `RWAOpenCreditAccount`),
@@ -18,4 +18,4 @@ import type { PrerequisiteContext } from "./types.js";
  *
  * Returns nothing for non-RWA markets.
  */
-export declare function buildRWAPrerequisites(multicall: InnerOperation[], creditManager: Address, providedArgs: RWAOperationArgs, ctx: PrerequisiteContext): AnyPrerequisite[];
+export declare function buildRWAPrerequisites(multicall: InnerOperation[], creditManager: Address, providedArgs: RWAOperationArgs, ctx: PrerequisiteContext): Prerequisite[];

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

@@ -1,27 +1,19 @@
 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;
-};
+import type { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
+import type { PrerequisiteResult } from "./types.js";
 /**
  * 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`).
+ * Each prerequisite performs its own reads and resolves into a
+ * {@link PrerequisiteResult} (`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.
+ * token, 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[]>;
+export declare function checkPrerequisites<P extends PluginsMap>(input: PreviewOperationInput<P>, options?: PreviewOperationOptions): Promise<PrerequisiteResult[]>;

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

@@ -1,15 +1,7 @@
-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;
-}
+import { type AllowanceDetail } from "./AllowancePrerequisite.js";
+import type { Prerequisite } from "./Prerequisite.js";
 /**
  * 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[];
+export declare function allowanceAndBalance(props: Omit<AllowanceDetail, "actual">): Prerequisite[];