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

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

@@ -1,21 +1,26 @@
-import { type Address, type ContractFunctionParameters } from "viem";
-import { type MulticallCallResult, Prerequisite } from "./Prerequisite.js";
-import type { PrerequisiteDetail, PrerequisiteResult } from "./types.js";
-export interface BalancePrerequisiteProps {
+import { type Address } from "viem";
+import { Prerequisite } from "./Prerequisite.js";
+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;
 }
-/** Checks that `owner` holds an ERC-20 balance >= `required`. */
-export declare class BalancePrerequisite extends Prerequisite<"balance"> {
+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 {
     #private;
-    constructor(props: BalancePrerequisiteProps);
-    get id(): string;
-    get kind(): "balance";
-    get title(): string;
-    get detail(): PrerequisiteDetail<"balance">;
-    calls(): ContractFunctionParameters[];
-    resolve(slice: MulticallCallResult[]): 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,60 +1,23 @@
-import { type ContractFunctionParameters } from "viem";
-import type { PrerequisiteContext, PrerequisiteDetail, PrerequisiteError, PrerequisiteKind, PrerequisiteResult } from "./types.js";
+import type { PrerequisiteContext, PrerequisiteError, PrerequisiteResult } from "./types.js";
 /**
- * One entry of a viem `multicall({ allowFailure: true })` response: either a
- * decoded `result` or the `error` that the call reverted with.
+ * 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 type MulticallCallResult = {
-    status: "success";
-    result: unknown;
-    error?: undefined;
-} | {
-    status: "failure";
-    result?: undefined;
-    error: Error;
-};
-/**
- * Decodes an unknown error into a {@link PrerequisiteError} with a
- * human-readable revert reason. Mirrors the SDK's `extractCallError`: walk the
- * viem error chain for a {@link ContractFunctionRevertedError} and use its
- * `errorName`, otherwise fall back to the error's short message / name.
- */
-export declare function toPrerequisiteError(cause: unknown): PrerequisiteError;
-/**
- * A single verifiable prerequisite for a transaction. Subclasses describe the
- * on-chain reads they need ({@link calls}) and how to turn the multicall slice
- * into a {@link PrerequisiteResult} ({@link resolve}).
- *
- * Identity (`id`, `kind`, `title`) and build-time `detail` are exposed as
- * read-only accessors; subclasses back them with private fields. The shared
- * {@link satisfiedResult}/{@link errorResult} helpers are `protected` so each
- * subclass builds results consistently.
- *
- * The same instance can be verified standalone via {@link verify} or batched
- * together with others by `verifyPrerequisites`.
- */
-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>;
-    /** Contract reads this check needs (usually one). */
-    abstract calls(ctx: PrerequisiteContext): ContractFunctionParameters[];
-    /** Maps this check's slice of the multicall response into a result. */
-    abstract resolve(slice: MulticallCallResult[]): PrerequisiteResult<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>;
     /**
-     * Verifies this prerequisite on its own using an `allowFailure` multicall.
-     * Prefer `verifyPrerequisites` to batch several checks into one round-trip.
+     * Performs the reads this prerequisite needs and maps them into a result.
+     * May throw on read failure; {@link verify} converts throws into `error`
+     * results.
      */
-    verify(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 decoded read error. */
-    protected errorResult(error: PrerequisiteError): 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,36 +1,51 @@
-import type { Address, ContractFunctionParameters } from "viem";
-import type { RWAOpenAccountRequirements } from "../../sdk/index.js";
+import type { Address } from "viem";
+import type { RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs } from "../../sdk/index.js";
 import { Prerequisite } from "./Prerequisite.js";
-import type { 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. */
+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;
-    /** RWA factory that produced the requirements. */
+    /** Credit manager of the RWA market. */
+    creditManager: Address;
+    /** RWA factory that gates the token. */
     factory: Address;
-    title?: string;
-    id?: string;
+    /**
+     * 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 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).
  *
- * 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"> {
+export declare class RWAOpenRequirementsPrerequisite extends Prerequisite {
     #private;
-    constructor(props: RWAOpenRequirementsPrerequisiteProps);
-    get id(): string;
-    get kind(): "rwaOpenRequirements";
-    get title(): string;
-    get detail(): PrerequisiteDetail<"rwaOpenRequirements">;
-    /** Pre-resolved: no on-chain reads to contribute. */
-    calls(): ContractFunctionParameters[];
-    resolve(): 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

@@ -0,0 +1,15 @@
+import { type GetApprovalAddressProps } from "../../sdk/index.js";
+import type { InnerOperation } from "../parse/index.js";
+import type { Prerequisite } 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<Prerequisite[]>;

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

@@ -0,0 +1,8 @@
+import type { PartialLiquidationOperation } from "../parse/index.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): Prerequisite[];

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 { 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): Prerequisite[];

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 { Prerequisite } 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): Prerequisite[];

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

@@ -0,0 +1,19 @@
+import type { PluginsMap } from "../../sdk/index.js";
+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 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, 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: PreviewOperationInput<P>, options?: PreviewOperationOptions): Promise<PrerequisiteResult[]>;

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

@@ -0,0 +1,7 @@
+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: Omit<AllowanceDetail, "actual">): Prerequisite[];

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,42 +1,8 @@
 import type { Address } from "viem";
-import type { OnchainSDK, 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: RWAOpenAccountRequirements;
-}
-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. */
@@ -44,37 +10,40 @@ 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;
-    /** Address whose balances/allowances are checked (the tx sender). */
+    /**
+     * Address whose balances/allowances are checked (the tx sender).
+     **/
     wallet: Address;
-    /** Block to read at; defaults to latest. Only set for testnet forks. */
+    /**
+     * Block to read at; defaults to latest. Only set for testnet forks.
+     **/
     blockNumber?: bigint;
+    /**
+     * Transaction `msg.value`
+     **/
+    value: bigint;
 }

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

@@ -0,0 +1,83 @@
+import type { Address } from "viem";
+import { AssetsMap, type CreditAccountData } from "../../sdk/index.js";
+/**
+ * Constructor properties of {@link CreditAccountState}.
+ */
+export interface CreditAccountStateProps {
+    creditAccount: Address;
+    creditManager: Address;
+    underlying: Address;
+    balances?: AssetsMap;
+    quotas?: AssetsMap;
+    debt?: bigint;
+    totalDebt?: bigint;
+}
+/**
+ * A snapshot of a credit account's economic state (balances, quotas, debt)
+ * as used by operation previews, together with the account's identity.
+ *
+ * Used both as the pre-state seed of a multicall replay and as the running
+ * post-state mutated by it; changes are derived by diffing two snapshots.
+ */
+export declare class CreditAccountState {
+    creditAccount: Address;
+    creditManager: Address;
+    /**
+     * Credit manager underlying
+     */
+    underlying: Address;
+    /**
+     * Per-token balances
+     */
+    balances: AssetsMap;
+    /**
+     * Per-token quotas
+     */
+    quotas: AssetsMap;
+    /**
+     * Debt principal
+     */
+    debt: bigint;
+    /**
+     * Total debt: principal + accrued interest + accrued fees.
+     * `decreaseDebt` amounts operate on total debt (interest and fees are
+     * repaid before principal), so principal alone is not enough to resolve
+     * either the underlying balance decrement or the final principal.
+     */
+    totalDebt: bigint;
+    constructor(props: CreditAccountStateProps);
+    /**
+     * The account-opening seed: everything zero/empty. The account doesn't
+     * exist yet at preview time, so `creditAccount` is the zero address;
+     * opening previews take identity from the parsed operation instead.
+     */
+    static beforeOpen(creditManager: Address, underlying: Address): CreditAccountState;
+    /**
+     * Pre-state of an existing account from its on-chain data, with dust
+     * balances and quotas (≤ 1 wei) filtered out.
+     */
+    static fromCreditAccountData(ca: CreditAccountData): CreditAccountState;
+    clone(): CreditAccountState;
+    /**
+     * Borrows `amount` of underlying: debt, total debt and the underlying
+     * balance all increase by it.
+     */
+    increaseDebt(amount: bigint): void;
+    /**
+     * Repays up to `amount` of underlying against the debt, clamped to the
+     * total debt (the facade never repays more than is owed). Interest and
+     * fees are repaid before principal (CreditLogic.calcDecrease), so
+     * principal only decreases once total debt drops below it. The underlying
+     * balance decreases by the repaid amount.
+     *
+     * @returns The actually repaid (post-clamp) amount.
+     */
+    repay(amount: bigint): bigint;
+    /**
+     * Applies a relative `updateQuota` change to the token's quota:
+     * `MIN_INT96` is the facade "disable quota" sentinel and zeroes it, other
+     * changes are added with the result clamped at zero (quotas cannot go
+     * negative on-chain).
+     */
+    updateQuota(token: Address, change: bigint): void;
+}

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/buildDelayedPreview.d.ts

@@ -0,0 +1,47 @@
+import { type Address } from "viem";
+import type { CreditAccountState } from "./CreditAccountState.js";
+import type { DetectedDelayedOperation } from "./detectDelayedOperation.js";
+import { type InstantOperationPreview } from "./types.js";
+/**
+ * Oracle conversion, injected so unit tests don't need a market
+ */
+export type ConvertFn = (token: Address, to: Address, amount: bigint) => bigint;
+/**
+ * Builds the best-effort preview of the account state after the detected
+ * delayed withdrawal is claimed and its intent (if any) is resumed.
+ *
+ * Pure function: reads the post-instant account state, never mutates it and
+ * performs no network access. Swaps that the resume flow would route through
+ * the router are estimated with the injected oracle conversion; tokens the
+ * oracle cannot price contribute nothing and set a non-fatal
+ * `ERROR_UNPRICEABLE_TOKEN` error on the preview.
+ *
+ * Common claim step (all intents): the phantom token is burned (balance and
+ * quota zeroed) and the claim token is credited with the same amount 1:1.
+ *
+ * Intent-specific resume:
+ * - `CLOSE_ACCOUNT`: everything is swapped into the underlying, the debt is
+ *   fully repaid and the rest is withdrawn to the user as `receivedToken`
+ *   (the unwrapped underlying for RWA markets, converting 1:1 with the
+ *   underlying; the underlying itself otherwise).
+ * - `DECREASE_LEVERAGE`: the claimed amount is swapped into the underlying
+ *   and used to decrease the debt.
+ * - `WITHDRAW_COLLATERAL`: the recorded amount of the recorded token is
+ *   withdrawn to the user, the rest of the claimed amount decreases the debt.
+ * - other intents and `intent: undefined`: claim-only, the post-claim swap
+ *   target is not recoverable from the intent.
+ *
+ * The changes (`debtChange`, `quotasChange`, `assetsChange`) are reported
+ * relative to the account state before the whole transaction, not the
+ * post-instant-part state: to the user the delayed preview answers "where will
+ * the account end up compared to now", so the transient phantom token
+ * (minted by the instant part, burned by the claim) nets out to nothing.
+ *
+ * @param afterInstant - Account state after the instant part of the
+ * transaction.
+ * @param before - Account state before the transaction (the diff base).
+ * @param receivedToken - Token the `CLOSE_ACCOUNT` resume withdraws to the
+ * user: the unwrapped underlying (vault asset) for RWA markets, the
+ * underlying itself otherwise.
+ */
+export declare function buildDelayedPreview(afterInstant: CreditAccountState, before: CreditAccountState, detected: DetectedDelayedOperation, convert: ConvertFn, receivedToken: Address): InstantOperationPreview;

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

@@ -0,0 +1,20 @@
+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 an exit token and withdraws only exit
+ *   tokens: the underlying or, on RWA markets, the unwrapped RWA underlying
+ *   (the ERC4626 vault asset)
+ * - repay returns collateral in-kind: it adds collateral from the wallet to
+ *   cover the debt and/or withdraws non-exit tokens.
+ */
+export declare function classifyCloseOrRepay(multicall: InnerOperation[], exitTokens: Address[]): "close" | "repay";

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

@@ -0,0 +1,45 @@
+import type { Address } from "viem";
+import { type SdkWithAdapters } from "../../plugins/adapters/index.js";
+import type { DelayedIntent, PluginsMap } from "../../sdk/index.js";
+import type { InnerOperation } from "../parse/index.js";
+/**
+ * A delayed-withdrawal claim detected in a credit-facade multicall,
+ * produced by `detectDelayedClaim`.
+ */
+export interface DetectedDelayedClaim {
+    /**
+     * Adapter the claim call is addressed to
+     */
+    adapter: Address;
+    /**
+     * Redeemer contract the withdrawal is claimed from. Transactions built by
+     * the withdrawal compressor always claim from a single redeemer, so when
+     * the adapter method accepts multiple redeemers, only the first one is
+     * reported.
+     */
+    redeemer: Address;
+}
+/**
+ * Scans a credit-facade multicall for a delayed-withdrawal claim call.
+ *
+ * @param sdk - SDK with the adapters plugin attached.
+ * @param multicall - Parsed inner operations of the multicall.
+ * @returns The detected claim, or `undefined` when the multicall contains no
+ * delayed-withdrawal claim call.
+ */
+export declare function detectDelayedClaim<P extends PluginsMap>(sdk: SdkWithAdapters<P>, multicall: InnerOperation[]): DetectedDelayedClaim | undefined;
+/**
+ * Resolves the delayed intent of the withdrawal a multicall claims: detects
+ * the claim call and reads the recorded intent of the claimed redeemer from
+ * the `RedemptionLogger` contract.
+ *
+ * @param sdk - SDK with the adapters plugin attached.
+ * @param multicall - Parsed inner operations of the multicall.
+ * @param blockNumber - Optional block number to read the log at.
+ * @returns The decoded intent, or `undefined` when the multicall claims
+ * nothing, the redemption logger is not deployed, or the log carries no
+ * intent.
+ * @throws InvalidDelayedIntentError when the logged `extraData` is non-empty
+ * but cannot be decoded as a `DelayedIntent`.
+ */
+export declare function resolveDelayedClaimIntent<P extends PluginsMap>(sdk: SdkWithAdapters<P>, multicall: InnerOperation[], blockNumber?: bigint): Promise<DelayedIntent | undefined>;