@gearbox-protocol/sdk 14.12.0-next.1 → 14.12.0-next.10

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

@@ -0,0 +1,177 @@
+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;
+};
+export interface PoolOperationPreview {
+    operation: PoolOperationType;
+    /**
+     * Pool address
+     */
+    pool: Address;
+    /**
+     * Token that goes from user to pool
+     * In case of deposit, underlying for direct deposit, zapper input for zapper-routed deposit
+     * In case of withdraw, pool shares (diesel token) for direct withdraw or zapper token out
+     *
+     * 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.
+     */
+    tokenIn: PreviewedAsset;
+    /**
+     * Token that goes from pool to user
+     * In case of deposit, pool shares (diesel token) for direct deposit or zapper token out
+     * In case of withdraw, underlying for direct withdraw or zapper token in
+     *
+     * 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.
+     */
+    tokenOut: PreviewedAsset;
+}
+export interface OpenCreditAccountPreview {
+    operation: "OpenCreditAccount" | "SecuritizeOpenCreditAccount";
+    /**
+     * Credit manager the account is opened in
+     */
+    creditManager: Address;
+    /**
+     * Target token of strategy: the first quoted token, with its balance taken
+     * from `assets`. Undefined when nothing is quoted.
+     */
+    target?: Asset;
+    /**
+     * Tokens that were added as collateral during account opening.
+     *
+     * 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).
+     */
+    collateral: Asset[];
+    /**
+     * Sum of collateral tokens in underlying
+     */
+    collateralValue: bigint;
+    /**
+     * Borrowed amount in underlying
+     */
+    debt: bigint;
+    /**
+     * Desired quotas
+     */
+    quotas: Asset[];
+    /**
+     * Minimum amount of assets on credit account after it's opened,
+     * as estimated by router
+     */
+    assets: Asset[];
+}
+export interface AdjustCreditAccountPreview {
+    operation: "AdjustCreditAccount";
+    /**
+     * Credit manager the account is opened in
+     */
+    creditManager: Address;
+    /**
+     * Credit account that is being adjusted
+     */
+    creditAccount: Address;
+    /**
+     * Tokens that were added as collateral during account opening.
+     *
+     * 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 that were withdrawn as collateral during account adjustment.
+     */
+    collateralWithdrawn: Asset[];
+    /**
+     * Sum of collateral tokens in underlying
+     */
+    totalValue: bigint;
+    /**
+     * Borrowed amount in underlying
+     */
+    debt: bigint;
+    /**
+     * Debt after minus debt before
+     */
+    debtChange: bigint;
+    /**
+     * Desired quotas
+     */
+    quotas: Asset[];
+    /**
+     * Quotas after minus quotas before
+     */
+    quotasChange: Asset[];
+    /**
+     * Minimum amount of assets on credit account after the operation,
+     * as estimated by router
+     */
+    assets: Asset[];
+    /**
+     * Assets after minus assets before
+     */
+    assetsChange: Asset[];
+}
+/**
+ * Result of previewing a raw operation calldata: currently pool operations and
+ * credit account opening are supported.
+ */
+export type OperationPreview = PoolOperationPreview | OpenCreditAccountPreview | AdjustCreditAccountPreview;

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

@@ -0,0 +1,20 @@
+import type { Address } from "viem";
+import { type Asset } from "../../sdk/index.js";
+/**
+ * Represents the transaction's attached native value as a `NATIVE_ADDRESS`
+ * entry in the collateral list.
+ *
+ * The credit facade wraps `msg.value` into WETH before `AddCollateral(WETH)`
+ * pulls it, so the WETH collateral amount already includes the attached native
+ * value. This helper splits the WETH entry back: the native amount is shown as
+ * `NATIVE_ADDRESS` and the WETH entry is reduced accordingly (dropped when it
+ * reaches zero). Other entries are preserved.
+ *
+ * @param collateral - Collateral assets as declared by the multicall.
+ * @param nativeAmount - Transaction `msg.value`.
+ * @param wethToken - Wrapped native token address.
+ * @returns Collateral with the native amount unwrapped from the WETH entry.
+ * @throws InvalidTransactionValueError when `nativeAmount` is positive but the
+ * WETH collateral is missing or smaller than it.
+ */
+export declare function unwrapNativeCollateral(collateral: Asset[], nativeAmount: bigint, wethToken: Address): Asset[];

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

@@ -1,17 +1,14 @@
 import { BaseError, type Hex } from "viem";
 /** Which simulation flow produced a failure. */
-export type SimulationFlowSource = "eth_simulateV1" | "multicall" | "unknown";
+export type SimulationFlowSource = "multicall" | "unknown";
 /** A single flow failure with its decoded revert detail. */
 export interface SimulationFlowFailure {
     source: SimulationFlowSource;
     detail: SimulationError;
 }
 /**
- * Error returned by the pool simulation when all attempted flows fail.
- *
- * On a single-flow failure it wraps that flow's decoded revert reason; when both
- * the `eth_simulateV1` and multicall flows fail, it carries the details of both
- * (see {@link failures}).
+ * Error returned by the pool simulation when it fails. It wraps the flow's
+ * decoded revert reason (see {@link failures}).
  */
 export declare class PreviewSimulationError extends BaseError {
     name: string;
@@ -24,8 +21,6 @@ export declare class PreviewSimulationError extends BaseError {
  * Pass-through when it already is one; otherwise decodes it under `source`.
  */
 export declare function asPreviewSimulationError(reason: unknown, source: SimulationFlowSource): PreviewSimulationError;
-/** Merges several {@link PreviewSimulationError}s into one carrying all failures. */
-export declare function combinePreviewSimulationErrors(...errors: (PreviewSimulationError | undefined)[]): PreviewSimulationError;
 /** Decoded revert of the simulated transaction. */
 export interface SimulationError {
     /** Human-readable revert reason / error name. */
@@ -33,17 +28,16 @@ export interface SimulationError {
     /** Original error, kept for debugging. */
     cause?: unknown;
 }
-/** Per-call slice of a `simulateCalls` failure we need to decode. */
+/** Per-call slice of a multicall failure we need to decode. */
 export interface SimulationRevert {
     error?: Error;
     /** Raw revert return data, when present. */
     data?: Hex;
 }
 /**
- * Decodes a simulated transaction revert into a {@link SimulationError}.
+ * Decodes a simulated call revert into a {@link SimulationError}.
  *
- * The simulated call is raw calldata (no ABI), so viem cannot decode the revert
- * itself. We first try to decode the raw return bytes against the SDK's
+ * We first try to decode any raw return bytes against the SDK's
  * {@link errorAbis} (Gearbox protocol exceptions plus standard ERC-20 custom
  * errors); failing that, we walk viem's error chain for a
  * {@link ContractFunctionRevertedError} (covers `Error(string)` / `Panic`).

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

@@ -1,4 +1,3 @@
-export { ETH_SIMULATE_V1_NETWORKS } from "./constants.js";
 export type { SimulationError, SimulationFlowFailure, SimulationFlowSource, } from "./errors.js";
 export { PreviewSimulationError } from "./errors.js";
 export type { SimulateFacadeOperationInput } from "./simulateFacadeOperation.js";
@@ -6,4 +5,6 @@ export { simulateFacadeOperation } from "./simulateFacadeOperation.js";
 export type { SimulateOperationInput } from "./simulateOperation.js";
 export { simulateOperation } from "./simulateOperation.js";
 export { simulatePoolOperation } from "./simulatePoolOperation.js";
-export type { AddressBalanceChanges, OperationSimulationOptions, PoolOperationSimulation, PoolOperationSimulationInput, PoolOperationSimulationResult, TokenBalanceChange, } from "./types.js";
+export type { SimulateRWAOperationInput } from "./simulateRWAOperation.js";
+export { simulateRWAOperation } from "./simulateRWAOperation.js";
+export type { OperationSimulationOptions, PoolOperationSimulation, PoolOperationSimulationInput, PoolOperationSimulationResult, } from "./types.js";

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

@@ -11,8 +11,6 @@ export interface SimulateFacadeOperationInput {
     to: Address;
     /** Raw credit-facade calldata to simulate. */
     calldata: Hex;
-    /** Wallet whose balance changes and transfers we track. */
-    wallet: Address;
 }
 /**
  * Simulates a credit-facade operation.

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

@@ -11,8 +11,6 @@ export interface SimulateOperationInput {
     to: Address;
     /** Raw operation calldata to simulate. */
     calldata: Hex;
-    /** Wallet whose balance changes and transfers we track. */
-    wallet: Address;
 }
 /**
  * Simulates a parsed pool or credit account operation {@link Operation}

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

@@ -1,8 +1,14 @@
 import type { OperationSimulationOptions, PoolOperationSimulation, PoolOperationSimulationInput } from "./types.js";
 /**
- * Simulates a pool deposit/mint/withdraw/redeem and returns the resulting
- * balance changes (and, when available, ERC-20 transfers), or a decoded failure.
+ * 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.
  *
- * @throws {@link PreviewSimulationError} when the simulation fails.
+ * Performs the matching preview read (the pool's ERC4626
+ * `previewDeposit`/`previewMint`/`previewWithdraw`/`previewRedeem`, or the
+ * zapper's `previewDeposit`/`previewRedeem`) to convert the calldata-known
+ * amount into its counterpart. It works on every network the SDK supports.
+ *
+ * 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>;

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

@@ -0,0 +1,23 @@
+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;
+}
+/**
+ * Simulates an RWA-factory operation.
+ *
+ * Not yet implemented: like credit-facade simulation, it requires
+ * multicall-aware balance/transfer accounting that the pool simulation does
+ * 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>;

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

@@ -1,27 +1,8 @@
 import type { Address, Hex } from "viem";
 import type { OnchainSDK } from "../../sdk/index.js";
 import type { ILogger } from "../../sdk/types/logger.js";
-import type { PoolOperation, TokenTransfer } from "../parse/index.js";
+import type { PoolOperation } from "../parse/index.js";
 import type { PreviewSimulationError } from "./errors.js";
-/**
- * Change in an address's balance of a single token over the simulated call.
- * `delta` is `after - before` (negative when the address spent the token).
- */
-export interface TokenBalanceChange {
-    token: Address;
-    before: bigint;
-    after: bigint;
-    delta: bigint;
-}
-/**
- * Balance changes for a single watched address (e.g. the wallet or the
- * operation recipient). Keyed purely by address; UI labeling is resolved
- * separately by the presentation layer.
- */
-export interface AddressBalanceChanges {
-    address: Address;
-    changes: TokenBalanceChange[];
-}
 export interface PoolOperationSimulationInput {
     /** Only `client`/`networkType` are used, so any OnchainSDK works. */
     sdk: OnchainSDK;
@@ -31,40 +12,32 @@ export interface PoolOperationSimulationInput {
     to: Address;
     /** Raw deposit/mint/withdraw/redeem calldata to simulate. */
     calldata: Hex;
-    /** Wallet whose balance changes and transfers we track. */
-    wallet: Address;
 }
 export interface OperationSimulationOptions {
     /** Block to simulate at; defaults to latest. */
     blockNumber?: bigint;
-    /**
-     * Whether to run the `eth_simulateV1` flow (preferred, recovers transfers).
-     * When `undefined`, defaults to whether the SDK's network is in
-     * {@link ETH_SIMULATE_V1_NETWORKS}.
-     */
-    useSimulateV1?: boolean;
     /**
      * Optional logger.
      **/
     logger?: ILogger;
 }
 /**
- * Successful simulation of a pool operation: the balance changes grouped by
- * watched address and, when available, the wallet-filtered ERC-20 transfers.
- * This is the success payload of {@link PoolOperationSimulation} without the
- * `status` discriminant.
+ * Successful simulation of 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.
  */
 export interface PoolOperationSimulationResult {
     /**
-     * Balance changes grouped by watched address (wallet, recipient, owner).
+     * Amount of tokens going from the user to the pool (underlying or zapper
+     * input token for deposit/mint, pool shares for withdraw/redeem).
      **/
-    balanceChanges: AddressBalanceChanges[];
+    amountIn: bigint;
     /**
-     * ERC-20 transfers involving the watched addresses.
-     *
-     * NOTE: transfers are **not guaranteed** to be returned.
-     */
-    transfers?: TokenTransfer[];
+     * Amount of tokens going from the pool to the user (pool shares or zapper
+     * output token for deposit/mint, underlying for withdraw/redeem).
+     **/
+    amountOut: bigint;
 }
 /**
  * Outcome of simulating a pool operation. On success it carries a

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

@@ -55,6 +55,11 @@ export interface MultichainAttachOptions {
      * Options for Pyth price-feed updates (shared cache across chains).
      **/
     pyth?: PythOptions;
+    /**
+     * When `true`, automatically load zappers after markets are loaded during
+     * attach on every chain.
+     **/
+    loadZappers?: boolean;
 }
 /**
  * Options for {@link MultichainSDK.hydrate}.

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

@@ -117,6 +117,10 @@ export interface AttachOptions {
      * Options for Pyth price-feed updates.
      **/
     pyth?: PythOptions;
+    /**
+     * When `true`, automatically call {@link MarketRegister.loadZappers} during attach.
+     **/
+    loadZappers?: boolean;
 }
 /**
  * Options accepted by {@link OnchainSDK.hydrate}.

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

@@ -4,7 +4,7 @@ import { SDKConstruct } from "../base/index.js";
 import { type PriceUpdate } from "../market/index.js";
 import type { RWAOpenAccountRequirements } from "../market/rwa/index.js";
 import type { OnchainSDK } from "../OnchainSDK.js";
-import { type RouterCASlice } from "../router/index.js";
+import type { RouterCASlice } from "../router/index.js";
 import type { MultiCall, RawTx } from "../types/index.js";
 import type { AccountToCheck, AddCollateralProps, AssembleCaUpdateCallsProps, 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";
 /**

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

@@ -1,11 +1,11 @@
 import type { Address, ContractFunctionArgs, GetContractReturnType, Hex, PublicClient } from "viem";
 import type { creditAccountCompressorAbi } from "../../abi/compressors/creditAccountCompressor.js";
 import type { iWithdrawalCompressorV310Abi } from "../../abi/IWithdrawalCompressorV310.js";
-import type { ConnectedBotData, Construct, CreditAccountData } from "../base/index.js";
+import type { Asset, ConnectedBotData, Construct, CreditAccountData } from "../base/index.js";
 import type { CreditSuite, PriceUpdate, RWAOperationParams } from "../market/index.js";
 import type { RWAOpenAccountRequirements } from "../market/rwa/index.js";
 import type { OnchainSDK } from "../OnchainSDK.js";
-import type { Asset, RouterCASlice, RouterCloseResult } from "../router/index.js";
+import type { RouterCASlice, RouterCloseResult } from "../router/index.js";
 import type { MultiCall, RawTx } from "../types/index.js";
 /**
  * @internal

package/dist/types/sdk/base/BaseContract.d.ts

@@ -151,7 +151,7 @@ export declare class BaseContract<abi extends Abi | readonly unknown[]> extends
      * @param strict - propagated from parseFunctionDataV2 for recursive parsing
      */
     protected parseFunctionParamsV2(params: DecodeFunctionDataReturnType<abi>, _strict?: boolean): Record<string, unknown>;
-    protected wrapParseCallV2(functionName: string, rawArgs: Record<string, unknown>): ParsedCallV2;
+    protected wrapParseCallV2(functionName: string, calldata: Hex, rawArgs: Record<string, unknown>): ParsedCallV2;
     /**
      * Creates a raw transaction for a function in this contract
      * @param parameters

package/dist/types/sdk/base/TokensMeta.d.ts

@@ -1,5 +1,5 @@
 import type { Address, Chain, PublicClient, Transport } from "viem";
-import type { Asset } from "../router/index.js";
+import type { Asset } from "../index.js";
 import type { ILogger } from "../types/logger.js";
 import { AddressMap } from "../utils/index.js";
 import type { PhantomTokenMeta, RWATokenMeta, TokenMetaData } from "./token-types.js";

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

@@ -87,6 +87,20 @@ export interface TokenInfo {
      **/
     success: boolean;
 }
+/**
+ * A token address paired with a balance, used throughout the SDK to
+ * represent holdings, collateral inputs, and leftover targets.
+ **/
+export interface Asset {
+    /**
+     * ERC-20 token address.
+     **/
+    token: Address;
+    /**
+     * Token amount in the token's native decimals.
+     **/
+    balance: bigint;
+}
 /**
  * Compile-time assertion: `U` must be assignable to `T`.
  *
@@ -337,6 +351,10 @@ export interface ParsedCallV2 {
      * For unknown selectors: `"unknown function 0x1a2b3c4d"`
      */
     functionName: string;
+    /**
+     * Raw ABI-encoded calldata this call was parsed from.
+     **/
+    calldata: Hex;
     /**
      * Named arguments with their original types (bigint, Address, etc.).
      **/

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

@@ -1,7 +1,7 @@
 import type { Address } from "viem";
 import type { MarketData, MarketFilter } from "../base/index.js";
 import type { OnchainSDK } from "../OnchainSDK.js";
-import type { MarketStateHuman } from "../types/index.js";
+import type { MarketStateHuman, ZapperStateHuman } from "../types/index.js";
 import { AddressMap } from "../utils/index.js";
 import { type DelegatedMulticall } from "../utils/viem/index.js";
 import type { CreditSuite } from "./credit/index.js";
@@ -9,7 +9,18 @@ import { MarketConfiguratorContract } from "./MarketConfiguratorContract.js";
 import { MarketSuite } from "./MarketSuite.js";
 import type { IPriceOracleContract } from "./oracle/index.js";
 import type { PoolSuite } from "./pool/index.js";
+import type { ZapperData } from "./types.js";
 import { ZapperRegister } from "./ZapperRegister.js";
+/** @internal */
+export interface MarketRegistryState {
+    markets: MarketData[];
+    zappers?: ZapperData[];
+}
+/** @internal */
+export interface MarketRegistryStateHuman {
+    markets: MarketStateHuman[];
+    zappers?: ZapperStateHuman[];
+}
 /**
  * Central registry of all Gearbox markets on the current chain.
  *
@@ -29,7 +40,7 @@ export declare class MarketRegister extends ZapperRegister {
      * bypassing on-chain reads.
      * @param state - Array of market data snapshots.
      **/
-    hydrate(state: MarketData[]): void;
+    hydrate({ markets, zappers }: MarketRegistryState): void;
     /**
      * @internal
      * Returns delegated multicalls for loading all markets from the on-chain
@@ -57,14 +68,12 @@ export declare class MarketRegister extends ZapperRegister {
     /**
      * Serializable snapshot of all loaded markets, suitable for hydration.
      **/
-    get state(): MarketData[];
+    get state(): MarketRegistryState;
     /**
      * Returns a human-readable snapshot of all markets.
      * @param raw - When `true`, includes raw/unformatted values.
      **/
-    stateHuman(raw?: boolean): {
-        markets: MarketStateHuman[];
-    };
+    stateHuman(raw?: boolean): MarketRegistryStateHuman;
     /**
      * All pool suites across loaded markets.
      **/

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

@@ -1,17 +1,38 @@
 import type { Address } from "viem";
 import { SDKConstruct } from "../base/index.js";
+import type { ZapperStateHuman } from "../types/index.js";
 import { AddressMap } from "../utils/index.js";
-import { type Zapper } from "./zapper/index.js";
+import type { ZapperData } from "./types.js";
+import { type IZapperContract } from "./zapper/index.js";
 export declare class ZapperRegister extends SDKConstruct {
     #private;
     /**
      * Load zappers for all pools using periphery compressor, adds hardcoded zappers
      */
     loadZappers(force?: boolean): Promise<void>;
-    get zappers(): AddressMap<Zapper[]>;
-    poolZappers(pool: Address): Zapper[];
+    /**
+     * Serializable snapshot of all loaded zappers, suitable for hydration.
+     * Returns `undefined` when zappers were never loaded (i.e. `loadZappers` was
+     * not called), so the not-loaded state round-trips cleanly.
+     **/
+    protected get zappersState(): ZapperData[] | undefined;
+    /**
+     * Restores zapper state from a previously serialized snapshot,
+     * bypassing on-chain reads.
+     * @param state - Array of zapper data snapshots, or `undefined` when zappers
+     *   were not loaded in the snapshot (leaves the registry in the not-loaded state).
+     **/
+    protected hydrateZappers(state?: ZapperData[]): void;
+    /**
+     * Returns a human-readable snapshot of all loaded zappers.
+     * Returns `undefined` when zappers were never loaded.
+     * @param raw - When `true`, includes raw/unformatted values.
+     **/
+    protected zappersStateHuman(_?: boolean): ZapperStateHuman[] | undefined;
+    get zappers(): AddressMap<IZapperContract[]>;
+    poolZappers(pool: Address): IZapperContract[];
     /**
      * Can return multiple zappers if there are multiple zappers for the same tokenIn and tokenOut
      */
-    getZapper(pool: Address, tokenIn: Address, tokenOut: Address): Array<Zapper> | undefined;
+    getZapper(pool: Address, tokenIn: Address, tokenOut: Address): Array<IZapperContract> | undefined;
 }

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

@@ -1,4 +1,4 @@
-import { type Address } from "viem";
+import { type Address, type DecodeFunctionDataReturnType } from "viem";
 import type { GetOpenAccountRequirementsProps } from "../../../accounts/types.js";
 import { BaseContract } from "../../../base/index.js";
 import type { OnchainSDK } from "../../../OnchainSDK.js";
@@ -463,10 +463,15 @@ export declare class SecuritizeRWAFactory extends BaseContract<abi> implements I
     readonly dsTokens: DStokenData[];
     readonly contractType = "RWA_FACTORY::SECURITIZE";
     constructor(sdk: OnchainSDK, data: RWAFactoryData);
+    protected parseFunctionParamsV2(params: DecodeFunctionDataReturnType<abi>, strict?: boolean): Record<string, unknown>;
     /**
      * {@inheritDoc IRWAFactory.decodeInvestorData}
      */
     decodeInvestorData(data: RWACompressorInvestorData): SecuritizeInvestorData;
+    /**
+     * {@inheritDoc IRWAFactory.getTokens}
+     */
+    getTokens(): Address[];
     /**
      * {@inheritDoc IRWAFactory.getInvestor}
      */