@gearbox-protocol/sdk 15.1.0-next.2 → 15.1.0-next.21

package/dist/types/new-sdk/execute/ExecuteApi.d.ts

@@ -0,0 +1,108 @@
+import { ChainId } from "../../model/primitives.js";
+import "../../model/index.js";
+import { Asset } from "../../sdk/base/types.js";
+import { SecuritizeRegisterMessage } from "../../sdk/market/rwa/securitize/types.js";
+import { RawTx } from "../../sdk/types/transactions.js";
+import "../../sdk/index.js";
+import { LpSimulate, OpenStrategySimulate, StrategySimulate } from "../prepare/types.js";
+import { ChainOf } from "../prepare/PrepareApi.js";
+import "../prepare/index.js";
+import { Address } from "viem";
+//#region src/new-sdk/execute/ExecuteApi.d.ts
+/**
+ * A pool deposit, withdrawal or redemption, as
+ * {@link OpportunitiesPrepare.deposit} / {@link OpportunitiesPrepare.withdraw}
+ * / {@link OpportunitiesPrepare.redeem} priced it. The simulation carries the
+ * tokens on both sides and the zapper, so nothing else is needed to encode
+ * the call.
+ **/
+interface PoolPrepareRequest {
+  kind: "pool";
+  chainId: ChainId;
+  pool: Address;
+  wallet: Address;
+  op: "deposit" | "withdraw" | "redeem";
+  sim: Extract<LpSimulate, {
+    ok: true;
+  }>;
+}
+/**
+ * Opening a new position, from a viable
+ * {@link OpportunitiesPrepare.openNewStrategy} result. The preview values
+ * collateral in underlying only, so the wallet's actual collateral assets and
+ * the native value to attach come from the caller.
+ **/
+interface OpenPrepareRequest {
+  kind: "open";
+  chainId: ChainId;
+  creditManager: Address;
+  wallet: Address;
+  sim: Extract<OpenStrategySimulate, {
+    ok: true;
+  }>;
+  /** What leaves the wallet, token by token. */
+  collateral: Asset[];
+  /** Native value to attach when paying a wrapped-native market in the coin. */
+  ethAmount: bigint;
+  /**
+   * Token the position ends up in. RWA markets resolve their open
+   * requirements against it; omitting it skips the RWA check entirely.
+   **/
+  targetToken?: Address;
+  /**
+   * EIP-712 registration signatures the wallet already signed this session,
+   * attached as `signaturesToCache` when the market is RWA-gated.
+   **/
+  signaturesToCache?: SecuritizeRegisterMessage[];
+}
+/**
+ * Any of the five operations on an existing account, from a viable
+ * {@link StrategySimulate}: the facade multicall is the simulation's `calls`.
+ **/
+interface AccountPrepareRequest {
+  kind: "account";
+  chainId: ChainId;
+  creditAccount: Address;
+  wallet: Address;
+  sim: Extract<StrategySimulate, {
+    ok: true;
+  }>;
+}
+/**
+ * What {@link OpportunitiesExecute.buildTx} turns into a transaction: a
+ * `prepare` result plus the few facts about the wallet the simulation does not
+ * carry.
+ **/
+type PrepareRequest = PoolPrepareRequest | OpenPrepareRequest | AccountPrepareRequest;
+/**
+ * The write side of the opportunities namespace: turns what `prepare`
+ * answered into the transaction to sign. Sending, and whatever the wallet has
+ * to do first (allowances, permits, RWA signatures), stays with the caller —
+ * `checkPrerequisites` reports the former on the built transaction.
+ **/
+interface OpportunitiesExecute {
+  /**
+   * The transaction to sign, from a `prepare` result. No second round of math:
+   * `account` requests submit the simulation's own multicall, `open` requests
+   * hand the preview's router path and quotas to `openCA`, `pool` requests
+   * encode the deposit / redeem the simulation priced.
+   *
+   * @throws on a simulation that is not `ok`; when a `pool` request names a
+   * route the pool has no metadata for, or one the pool does not accept a
+   * transaction for (RWA on-demand deposits)
+   **/
+  buildTx(request: PrepareRequest): Promise<RawTx>;
+}
+/**
+ * {@inheritDoc OpportunitiesExecute}
+ **/
+declare class ExecuteApi implements OpportunitiesExecute {
+  #private;
+  constructor(chainOf: ChainOf);
+  /**
+   * {@inheritDoc OpportunitiesExecute.buildTx}
+   **/
+  buildTx(request: PrepareRequest): Promise<RawTx>;
+}
+//#endregion
+export { AccountPrepareRequest, ExecuteApi, OpenPrepareRequest, OpportunitiesExecute, PoolPrepareRequest, PrepareRequest };

package/dist/types/new-sdk/execute/index.d.ts

@@ -0,0 +1,2 @@
+import { AccountPrepareRequest, ExecuteApi, OpenPrepareRequest, OpportunitiesExecute, PoolPrepareRequest, PrepareRequest } from "./ExecuteApi.js";
+export { AccountPrepareRequest, ExecuteApi, OpenPrepareRequest, OpportunitiesExecute, PoolPrepareRequest, PrepareRequest };

package/dist/types/new-sdk/index.d.ts

@@ -1,17 +1,27 @@
-import { GearboxSDKOptions, Mode, NamespaceOptions, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, PlainMultichainSDKOptions } from "./types.js";
+import { EnsureFreshChains, GearboxSDKOptions, Mode, NamespaceOptions, NoticesByMode, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, PlainMultichainSDKOptions } from "./types.js";
 import { EntityMerger, FilterResult, ListMerger, MergeListResult } from "./utils/types.js";
 import { filterResponse } from "./utils/filterResponse.js";
-import { HistoryReader } from "./utils/history.js";
 import { DEFAULT_MAX_OFFCHAIN_LAG, mergeChainList, mergeChainOne } from "./utils/mergeChains.js";
 import "./utils/index.js";
 import { AbstractNamespace, MergedQuery } from "./AbstractNamespace.js";
-import { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesMerged, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers } from "./opportunities/types.js";
+import { Liquidations, LiquidationsByMode } from "./liquidations/types.js";
+import { LiquidationsNamespace } from "./liquidations/LiquidationsNamespace.js";
+import "./liquidations/index.js";
+import { AddCollateralParams, AdjustLeverageParams, DelayedStrategySimulate, DepositStrategyParams, FinalizeParams, LpParams, LpRedeemParams, LpSimulate, OpenStrategyParams, OpenStrategySimulate, OpportunitiesPrepare, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyRoutesSimulate, StrategySimulate, WithdrawCollateralParams, WithdrawStrategyParams } from "./prepare/types.js";
+import { ChainOf, PrepareApi } from "./prepare/PrepareApi.js";
+import "./prepare/index.js";
+import { AccountPrepareRequest, ExecuteApi, OpenPrepareRequest, OpportunitiesExecute, PoolPrepareRequest, PrepareRequest } from "./execute/ExecuteApi.js";
+import "./execute/index.js";
+import { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers } from "./opportunities/types.js";
 import { OpportunitiesNamespace } from "./opportunities/OpportunitiesNamespace.js";
 import "./opportunities/index.js";
-import { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsMerged, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly } from "./positions/types.js";
+import { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly } from "./positions/types.js";
 import { PositionsNamespace } from "./positions/PositionsNamespace.js";
 import "./positions/index.js";
-import { GearboxSDK } from "./GearboxSDK.js";
+import { Preview, PreviewByMode } from "./preview/types.js";
+import { PreviewNamespace } from "./preview/PreviewNamespace.js";
+import "./preview/index.js";
+import { DEFAULT_MAX_STATE_AGE, GearboxSDK } from "./GearboxSDK.js";
 import { AllSourcesFailedError } from "./errors/AllSourcesFailedError.js";
 import { MissingSourceError } from "./errors/MissingSourceError.js";
 import { NoSourceServedError } from "./errors/NoSourceServedError.js";
@@ -20,4 +30,4 @@ import { SourceUnavailableError } from "./errors/SourceUnavailableError.js";
 import { assertSameChains } from "./errors/assertSameChains.js";
 import { everyChainFailed } from "./errors/everyChainFailed.js";
 import "./errors/index.js";
-export { AbstractNamespace, AllSourcesFailedError, ChainRef, DEFAULT_MAX_OFFCHAIN_LAG, type EntityMerger, type FilterResult, GearboxSDK, GearboxSDKOptions, HistoryReader, type ListMerger, type MergeListResult, MergedQuery, MissingSourceError, Mode, NamespaceOptions, NoSourceServedError, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesMerged, OpportunitiesNamespace, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers, PlainMultichainSDKOptions, PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsMerged, PositionsNamespace, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly, SourceChainMismatchError, SourceUnavailableError, assertSameChains, everyChainFailed, filterResponse, mergeChainList, mergeChainOne };
+export { AbstractNamespace, AccountPrepareRequest, AddCollateralParams, AdjustLeverageParams, AllSourcesFailedError, ChainOf, ChainRef, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, DelayedStrategySimulate, DepositStrategyParams, EnsureFreshChains, type EntityMerger, ExecuteApi, type FilterResult, FinalizeParams, GearboxSDK, GearboxSDKOptions, Liquidations, LiquidationsByMode, LiquidationsNamespace, type ListMerger, LpParams, LpRedeemParams, LpSimulate, type MergeListResult, MergedQuery, MissingSourceError, Mode, NamespaceOptions, NoSourceServedError, NoticesByMode, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, OpenPrepareRequest, OpenStrategyParams, OpenStrategySimulate, Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesExecute, OpportunitiesNamespace, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunitiesPrepare, OpportunityMergers, PlainMultichainSDKOptions, PoolInput, PoolPrepareRequest, PositionInput, PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsNamespace, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly, PrepareApi, PrepareOptions, PrepareRequest, Preview, PreviewByMode, PreviewNamespace, RepayStrategyParams, SourceChainMismatchError, SourceUnavailableError, StrategyInput, StrategyRoutesSimulate, StrategySimulate, WithdrawCollateralParams, WithdrawStrategyParams, assertSameChains, everyChainFailed, filterResponse, mergeChainList, mergeChainOne };

package/dist/types/new-sdk/liquidations/LiquidationsNamespace.d.ts

@@ -0,0 +1,35 @@
+import { TxCall } from "../../model/primitives.js";
+import { LiquidatableAccount, LiquidationDetails, LiquidationPosition } from "../../model/liquidations.js";
+import { DataResponse } from "../../model/response.js";
+import "../../model/index.js";
+import { MultichainSDK } from "../../sdk/MultichainSDK.js";
+import { BuildLiquidationTxProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationPositionsProps } from "../../sdk/accounts/liquidations/types.js";
+import "../../sdk/index.js";
+import { NamespaceOptions } from "../types.js";
+import { Liquidations } from "./types.js";
+//#region src/new-sdk/liquidations/LiquidationsNamespace.d.ts
+/**
+ * {@inheritDoc Liquidations}
+ **/
+declare class LiquidationsNamespace implements Liquidations {
+  #private;
+  constructor(onchain: MultichainSDK, options: NamespaceOptions);
+  /**
+   * {@inheritDoc Liquidations.getLiquidatableAccounts}
+   **/
+  getLiquidatableAccounts(props?: GetLiquidatableAccountsProps<true>): Promise<DataResponse<LiquidatableAccount[]>>;
+  /**
+   * {@inheritDoc Liquidations.getLiquidationDetails}
+   **/
+  getLiquidationDetails(props: GetLiquidationDetailsProps<true>): Promise<DataResponse<LiquidationDetails>>;
+  /**
+   * {@inheritDoc Liquidations.buildLiquidationTx}
+   **/
+  buildLiquidationTx(props: BuildLiquidationTxProps<true>): Promise<DataResponse<TxCall>>;
+  /**
+   * {@inheritDoc Liquidations.getLiquidationPositions}
+   **/
+  getLiquidationPositions(props: GetLiquidationPositionsProps<true>): Promise<DataResponse<LiquidationPosition[]>>;
+}
+//#endregion
+export { LiquidationsNamespace };

package/dist/types/new-sdk/liquidations/index.d.ts

@@ -0,0 +1,3 @@
+import { Liquidations, LiquidationsByMode } from "./types.js";
+import { LiquidationsNamespace } from "./LiquidationsNamespace.js";
+export { Liquidations, LiquidationsByMode, LiquidationsNamespace };

package/dist/types/new-sdk/liquidations/types.d.ts

@@ -0,0 +1,46 @@
+import { TxCall } from "../../model/primitives.js";
+import { LiquidatableAccount, LiquidationDetails, LiquidationPosition } from "../../model/liquidations.js";
+import { DataResponse } from "../../model/response.js";
+import "../../model/index.js";
+import { BuildLiquidationTxProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationPositionsProps } from "../../sdk/accounts/liquidations/types.js";
+import "../../sdk/index.js";
+//#region src/new-sdk/liquidations/types.d.ts
+/**
+ * On-chain discovery of liquidatable credit accounts and delayed-withdrawal
+ * positions a liquidator wallet holds.
+ **/
+interface Liquidations {
+  /**
+   * All liquidatable credit accounts: health factor below 1 plus accounts of
+   * expired credit managers with outstanding debt. Optionally narrowed.
+   **/
+  getLiquidatableAccounts(props?: GetLiquidatableAccountsProps<true>): Promise<DataResponse<LiquidatableAccount[]>>;
+  /**
+   * Detailed view of one liquidatable credit account, including the assets the
+   * liquidator receives. Throws when the chain cannot answer.
+   **/
+  getLiquidationDetails(props: GetLiquidationDetailsProps<true>): Promise<DataResponse<LiquidationDetails>>;
+  /**
+   * Transaction that fully liquidates a credit account. The reported block is
+   * the one the transaction was built against.
+   **/
+  buildLiquidationTx(props: BuildLiquidationTxProps<true>): Promise<DataResponse<TxCall>>;
+  /**
+   * Delayed-withdrawal positions (redemption receipts) owned by a liquidator
+   * wallet, optionally scoped to some of the SDK's chains.
+   **/
+  getLiquidationPositions(props: GetLiquidationPositionsProps<true>): Promise<DataResponse<LiquidationPosition[]>>;
+}
+/**
+ * `sdk.liquidations` per mode: an on-chain read, absent when the SDK reads no
+ * chain.
+ *
+ * @internal
+ **/
+interface LiquidationsByMode {
+  onchain: Liquidations;
+  offchain: undefined;
+  both: Liquidations;
+}
+//#endregion
+export { Liquidations, LiquidationsByMode };

package/dist/types/new-sdk/opportunities/OpportunitiesNamespace.d.ts

@@ -1,5 +1,5 @@
+import { ChartBundle, ChartRange, PoolOpportunityChartMetric, StrategyOpportunityChartMetric } from "../../model/charts.js";
 import { Opportunity, OpportunityFilter, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef } from "../../model/opportunities.js";
-import { PoolHistoryMetric, StrategyHistoryMetric } from "../../model/history.js";
 import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { MultichainSDK } from "../../sdk/MultichainSDK.js";
@@ -8,21 +8,33 @@ import { GearboxAPI } from "../../offchain/GearboxAPI.js";
 import "../../offchain/index.js";
 import { NamespaceOptions } from "../types.js";
 import { FilterResult } from "../utils/types.js";
-import { HistoryReader } from "../utils/history.js";
 import "../utils/index.js";
 import { AbstractNamespace } from "../AbstractNamespace.js";
-import { OpportunitiesBase, OpportunitiesOffchainOnly, OpportunityMergers } from "./types.js";
+import { OpportunitiesPrepare } from "../prepare/types.js";
+import "../prepare/index.js";
+import { OpportunitiesExecute } from "../execute/ExecuteApi.js";
+import "../execute/index.js";
+import { OpportunitiesBase, OpportunitiesOffchainOnly, OpportunitiesOnchainOnly, OpportunityMergers } from "./types.js";
 //#region src/new-sdk/opportunities/OpportunitiesNamespace.d.ts
 /**
  * The `opportunities` namespace of a {@link GearboxSDK}, see
  * {@link OpportunitiesByMode} for what each mode offers.
  **/
-declare class OpportunitiesNamespace extends AbstractNamespace<MultichainSDK["opportunities"], GearboxAPI["opportunities"]> implements OpportunitiesBase, OpportunitiesOffchainOnly {
+declare class OpportunitiesNamespace extends AbstractNamespace<MultichainSDK["opportunities"], GearboxAPI["opportunities"]> implements OpportunitiesBase, OpportunitiesOffchainOnly, OpportunitiesOnchainOnly {
+  #private;
   /**
    * {@inheritDoc OpportunitiesBase.merge}
    **/
   readonly merge: OpportunityMergers;
   constructor(onchain: MultichainSDK | undefined, offchain: GearboxAPI | undefined, options: NamespaceOptions);
+  /**
+   * {@inheritDoc OpportunitiesOnchainOnly.prepare}
+   **/
+  get prepare(): OpportunitiesPrepare;
+  /**
+   * {@inheritDoc OpportunitiesOnchainOnly.execute}
+   **/
+  get execute(): OpportunitiesExecute;
   /**
    * {@inheritDoc OpportunitiesBase.list}
    **/
@@ -40,10 +52,10 @@ declare class OpportunitiesNamespace extends AbstractNamespace<MultichainSDK["op
    **/
   filter<R extends DataResponse<Opportunity[]> | undefined>(response: R, filter?: OpportunityFilter): FilterResult<R, Opportunity>;
   /**
-   * {@inheritDoc OpportunitiesOffchainOnly.history}
+   * {@inheritDoc OpportunitiesOffchainOnly.charts}
    **/
-  history(key: PoolOpportunityRef): HistoryReader<PoolHistoryMetric>;
-  history(key: StrategyOpportunityRef): HistoryReader<StrategyHistoryMetric>;
+  charts<const Metrics extends readonly PoolOpportunityChartMetric[]>(key: PoolOpportunityRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
+  charts<const Metrics extends readonly StrategyOpportunityChartMetric[]>(key: StrategyOpportunityRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
 }
 //#endregion
 export { OpportunitiesNamespace };

package/dist/types/new-sdk/opportunities/index.d.ts

@@ -1,3 +1,3 @@
-import { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesMerged, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers } from "./types.js";
+import { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers } from "./types.js";
 import { OpportunitiesNamespace } from "./OpportunitiesNamespace.js";
-export { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesMerged, OpportunitiesNamespace, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers };
+export { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesNamespace, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers };

package/dist/types/new-sdk/opportunities/types.d.ts

@@ -1,5 +1,5 @@
+import { ChartBundle, ChartRange, PoolOpportunityChartMetric, StrategyOpportunityChartMetric } from "../../model/charts.js";
 import { Opportunity, OpportunityFilter, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef } from "../../model/opportunities.js";
-import { PoolHistoryMetric, StrategyHistoryMetric } from "../../model/history.js";
 import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { MultichainOpportunitiesService } from "../../sdk/opportunities/MultichainOpportunitiesService.js";
@@ -8,8 +8,11 @@ import { OffchainOpportunities } from "../../offchain/opportunities/OffchainOppo
 import "../../offchain/index.js";
 import { Mode } from "../types.js";
 import { EntityMerger, FilterResult, ListMerger } from "../utils/types.js";
-import { HistoryReader } from "../utils/history.js";
 import "../utils/index.js";
+import { OpportunitiesPrepare } from "../prepare/types.js";
+import "../prepare/index.js";
+import { OpportunitiesExecute } from "../execute/ExecuteApi.js";
+import "../execute/index.js";
 //#region src/new-sdk/opportunities/types.d.ts
 /**
  * What the `opportunities` namespace offers in every mode.
@@ -56,17 +59,35 @@ interface OpportunitiesBase {
  **/
 interface OpportunitiesOffchainOnly {
   /**
-   * Historical charts of one opportunity, one metric and one range at a time:
-   * `history(key).chart("depositApy", "1m")`. The key's kind decides which
-   * metrics exist, so asking a pool for a strategy series does not compile.
+   * Historical charts of one opportunity, one series per metric on a shared
+   * axis: `charts(key, ["depositApy", "borrowApy"], "1m")`.
+   *
+   * The key's kind decides which metrics exist, so asking a pool for a strategy
+   * chart does not compile, and the bundle is keyed by exactly the metrics
+   * named — one of them is a bundle of one, not a different call.
    **/
-  history(key: PoolOpportunityRef): HistoryReader<PoolHistoryMetric>;
-  history(key: StrategyOpportunityRef): HistoryReader<StrategyHistoryMetric>;
+  charts<const Metrics extends readonly PoolOpportunityChartMetric[]>(key: PoolOpportunityRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
+  charts<const Metrics extends readonly StrategyOpportunityChartMetric[]>(key: StrategyOpportunityRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
 }
 /**
- * Reads only the chain can answer. Empty for now.
+ * Reads only the chain can answer.
  **/
-interface OpportunitiesOnchainOnly {}
+interface OpportunitiesOnchainOnly {
+  /**
+   * Simulations of what a deposit, withdrawal or leverage change would do.
+   *
+   * Absent in `offchain` mode: every one of them reads live account and pool
+   * state, and the strategy flows additionally need the pathfinder for real swap
+   * paths, so there is nothing the backend could answer with.
+   **/
+  readonly prepare: OpportunitiesPrepare;
+  /**
+   * The transaction a prepared operation stands for, see
+   * {@link OpportunitiesExecute.buildTx}. Absent in `offchain` mode for the
+   * same reason as {@link prepare}: it encodes against live chain state.
+   **/
+  readonly execute: OpportunitiesExecute;
+}
 /**
  * Which reads the `opportunities` namespace has in each mode. A widened mode
  * offers what every mode has, i.e. {@link OpportunitiesBase} alone.
@@ -82,20 +103,13 @@ interface OpportunitiesOffchainBranch {
 }
 /**
  * Merge policy of each read, exposed so that a consumer reading the two
- * branches itself combines them exactly as `both` mode would: a chain is served
- * by the backend when it is fresh enough, and by the chain otherwise.
+ * branches itself combines them exactly as `both` mode would.
  **/
 interface OpportunityMergers {
   list: ListMerger<Opportunity[]>;
   pool: EntityMerger<PoolOpportunityDetail>;
   strategy: EntityMerger<StrategyOpportunityDetail>;
 }
-/**
- * Merging, which only exists where there are two sources to merge.
- **/
-interface OpportunitiesMerged {
-  readonly merge: OpportunityMergers;
-}
 /**
  * Which methods the `opportunities` namespace has in each mode.
  **/
@@ -109,4 +123,4 @@ interface OpportunitiesByMode {
  **/
 type Opportunities<M extends Mode = Mode> = OpportunitiesByMode[M];
 //#endregion
-export { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesMerged, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers };
+export { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers };

package/dist/types/new-sdk/positions/PositionsNamespace.d.ts

@@ -1,5 +1,5 @@
+import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
 import { PoolPositionRef, Position, PositionFilter, StrategyPositionRef } from "../../model/positions.js";
-import { PoolPositionHistoryMetric, StrategyPositionHistoryMetric } from "../../model/history.js";
 import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { MultichainSDK } from "../../sdk/MultichainSDK.js";
@@ -8,7 +8,6 @@ import { GearboxAPI } from "../../offchain/GearboxAPI.js";
 import "../../offchain/index.js";
 import { NamespaceOptions } from "../types.js";
 import { FilterResult } from "../utils/types.js";
-import { HistoryReader } from "../utils/history.js";
 import "../utils/index.js";
 import { AbstractNamespace } from "../AbstractNamespace.js";
 import { PositionMergers, PositionsBase, PositionsOffchainOnly } from "./types.js";
@@ -33,10 +32,10 @@ declare class PositionsNamespace extends AbstractNamespace<MultichainSDK["positi
    **/
   filter<R extends DataResponse<Position[]> | undefined>(response: R, filter?: PositionFilter): FilterResult<R, Position>;
   /**
-   * {@inheritDoc PositionsOffchainOnly.history}
+   * {@inheritDoc PositionsOffchainOnly.charts}
    **/
-  history(key: PoolPositionRef): HistoryReader<PoolPositionHistoryMetric>;
-  history(key: StrategyPositionRef): HistoryReader<StrategyPositionHistoryMetric>;
+  charts<const Metrics extends readonly PoolPositionChartMetric[]>(key: PoolPositionRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
+  charts<const Metrics extends readonly StrategyPositionChartMetric[]>(key: StrategyPositionRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
 }
 //#endregion
 export { PositionsNamespace };

package/dist/types/new-sdk/positions/index.d.ts

@@ -1,3 +1,3 @@
-import { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsMerged, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly } from "./types.js";
+import { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly } from "./types.js";
 import { PositionsNamespace } from "./PositionsNamespace.js";
-export { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsMerged, PositionsNamespace, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly };
+export { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsNamespace, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly };

package/dist/types/new-sdk/positions/mergePositionList.d.ts

@@ -0,0 +1,19 @@
+import { Position } from "../../model/positions.js";
+import { DataResponse } from "../../model/response.js";
+import "../../model/index.js";
+import { MergeListResult } from "../utils/types.js";
+//#region src/new-sdk/positions/mergePositionList.d.ts
+/**
+ * Merges two position lists under the same per-chain freshness rule as
+ * {@link mergeChainList}, then overlays the backend's `targetCollateral` and
+ * `name` onto every strategy row the backend has — even when that chain was
+ * served from on-chain data because the backend was stale.
+ *
+ * The chain resolves `targetCollateral` from a per-account override or the
+ * credit manager's single target token. The backend's historical value is
+ * still preferred when it has the row. `name` is derived from that collateral,
+ * so it follows the same override.
+ **/
+declare function mergePositionList<Onchain extends DataResponse<Position[]> | undefined, Offchain extends DataResponse<Position[]> | undefined>(onchain: Onchain, offchain: Offchain, maxLagSeconds?: number): MergeListResult<Onchain, Offchain, Position[]>;
+//#endregion
+export { mergePositionList };

package/dist/types/new-sdk/positions/types.d.ts

@@ -1,5 +1,5 @@
+import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
 import { PoolPositionRef, Position, PositionFilter, StrategyPositionRef } from "../../model/positions.js";
-import { PoolPositionHistoryMetric, StrategyPositionHistoryMetric } from "../../model/history.js";
 import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { MultichainPositionsService } from "../../sdk/positions/MultichainPositionsService.js";
@@ -8,7 +8,6 @@ import { OffchainPositions } from "../../offchain/positions/OffchainPositions.js
 import "../../offchain/index.js";
 import { Mode } from "../types.js";
 import { FilterResult, ListMerger } from "../utils/types.js";
-import { HistoryReader } from "../utils/history.js";
 import "../utils/index.js";
 import { Address } from "viem";
 //#region src/new-sdk/positions/types.d.ts
@@ -50,14 +49,15 @@ interface PositionsBase {
  **/
 interface PositionsOffchainOnly {
   /**
-   * Historical charts of one position, one metric and one range at a time:
-   * `history(key).chart("netApy", "1m")`. The key's kind decides which metrics
-   * exist, so asking a pool position for a strategy series does not compile.
-   * Liquidation positions have no charts: a delayed withdrawal is a single
-   * event rather than a series.
+   * Historical charts of one position, one series per metric on a shared axis:
+   * `charts(key, ["value", "apy"], "1m")`.
+   *
+   * The key's kind decides which metrics exist, so asking a pool position for a
+   * strategy chart does not compile. Liquidation positions have no charts: a
+   * delayed withdrawal is a single event rather than a series.
    **/
-  history(key: PoolPositionRef): HistoryReader<PoolPositionHistoryMetric>;
-  history(key: StrategyPositionRef): HistoryReader<StrategyPositionHistoryMetric>;
+  charts<const Metrics extends readonly PoolPositionChartMetric[]>(key: PoolPositionRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
+  charts<const Metrics extends readonly StrategyPositionChartMetric[]>(key: StrategyPositionRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
 }
 /**
  * Reads only the chain can answer. Empty for now.
@@ -78,18 +78,11 @@ interface PositionsOffchainBranch {
 }
 /**
  * Merge policy of each read, exposed so that a consumer reading the two
- * branches itself combines them exactly as `both` mode would: a chain is served
- * by the backend when it is fresh enough, and by the chain otherwise.
+ * branches itself combines them exactly as `both` mode would.
  **/
 interface PositionMergers {
   list: ListMerger<Position[]>;
 }
-/**
- * Merging, which only exists where there are two sources to merge.
- **/
-interface PositionsMerged {
-  readonly merge: PositionMergers;
-}
 /**
  * Which methods the `positions` namespace has in each mode.
  **/
@@ -103,4 +96,4 @@ interface PositionsByMode {
  **/
 type Positions<M extends Mode = Mode> = PositionsByMode[M];
 //#endregion
-export { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsMerged, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly };
+export { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly };

package/dist/types/new-sdk/prepare/PrepareApi.d.ts

@@ -0,0 +1,90 @@
+import { ChainId } from "../../model/primitives.js";
+import { DataResponse } from "../../model/response.js";
+import "../../model/index.js";
+import { OnchainSDK } from "../../sdk/OnchainSDK.js";
+import { MultichainSDK } from "../../sdk/MultichainSDK.js";
+import { ChainQueryOneProps, MultichainConstruct } from "../../sdk/base/MultichainConstruct.js";
+import "../../sdk/index.js";
+import { EnsureFreshChains } from "../types.js";
+import { AddCollateralParams, AdjustLeverageParams, DepositStrategyParams, FinalizeParams, LpParams, LpRedeemParams, LpSimulate, OpenStrategyParams, OpenStrategySimulate, OpportunitiesPrepare, PoolInput, PositionInput, RepayStrategyParams, StrategyInput, StrategyRoutesSimulate, StrategySimulate, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
+//#region src/new-sdk/prepare/PrepareApi.d.ts
+/**
+ * The chain's SDK, resolved on the spot.
+ *
+ * The LP simulations need it synchronously, because they only do arithmetic on
+ * loaded state and have nothing to await; the execute namespace resolves its
+ * chain the same way.
+ **/
+type ChainOf = (chainId: ChainId) => OnchainSDK;
+/**
+ * {@inheritDoc OpportunitiesPrepare}
+ *
+ * Holds no state of its own: it owns the mapping from the public,
+ * read-model-shaped request to the engine's intent, and nothing else. All
+ * protocol knowledge stays in `CreditAccountOperationsService` and
+ * `PoolService`.
+ *
+ * A simulation names one chain, so it reads through
+ * {@link MultichainConstruct.queryChain}: there is no second source to fall back
+ * to, hence a chain the SDK does not cover, or one that fails the read, throws
+ * rather than answering with empty metadata.
+ **/
+declare class PrepareApi extends MultichainConstruct implements OpportunitiesPrepare {
+  #private;
+  constructor(sdk: MultichainSDK, ensureFresh?: EnsureFreshChains);
+  protected queryChain<T>(props: ChainQueryOneProps<T>): Promise<DataResponse<T>>;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.finalize}
+   **/
+  finalize(position: PositionInput, params: FinalizeParams): Promise<DataResponse<StrategySimulate>>;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.deposit}
+   **/
+  deposit(pool: PoolInput, params: LpParams): LpSimulate;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.withdraw}
+   **/
+  withdraw(pool: PoolInput, params: LpParams): LpSimulate;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.redeem}
+   **/
+  redeem(pool: PoolInput, params: LpRedeemParams): LpSimulate;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.openNewStrategy}
+   **/
+  openNewStrategy(strategy: StrategyInput, params: OpenStrategyParams): Promise<DataResponse<OpenStrategySimulate>>;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.depositStrategy}
+   **/
+  depositStrategy(position: PositionInput, params: DepositStrategyParams): Promise<DataResponse<StrategySimulate>>;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.withdrawStrategy}
+   **/
+  withdrawStrategy(position: PositionInput, params: WithdrawStrategyParams): Promise<DataResponse<StrategyRoutesSimulate>>;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.maxWithdraw}
+   **/
+  maxWithdraw(position: PositionInput): Promise<DataResponse<bigint>>;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.repayStrategy}
+   **/
+  repayStrategy(position: PositionInput, params: RepayStrategyParams): Promise<DataResponse<StrategySimulate>>;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.maxRepay}
+   **/
+  maxRepay(position: PositionInput): Promise<DataResponse<bigint>>;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.adjustLeverage}
+   **/
+  adjustLeverage(position: PositionInput, params: AdjustLeverageParams): Promise<DataResponse<StrategyRoutesSimulate>>;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.addCollateral}
+   **/
+  addCollateral(position: PositionInput, params: AddCollateralParams): Promise<DataResponse<StrategySimulate>>;
+  /**
+   * {@inheritDoc OpportunitiesPrepare.withdrawCollateral}
+   **/
+  withdrawCollateral(position: PositionInput, params: WithdrawCollateralParams): Promise<DataResponse<StrategySimulate>>;
+}
+//#endregion
+export { ChainOf, PrepareApi };

package/dist/types/new-sdk/prepare/index.d.ts

@@ -0,0 +1,3 @@
+import { AddCollateralParams, AdjustLeverageParams, DelayedStrategySimulate, DepositStrategyParams, FinalizeParams, LpParams, LpRedeemParams, LpSimulate, OpenStrategyParams, OpenStrategySimulate, OpportunitiesPrepare, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyRoutesSimulate, StrategySimulate, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
+import { ChainOf, PrepareApi } from "./PrepareApi.js";
+export { AddCollateralParams, AdjustLeverageParams, ChainOf, DelayedStrategySimulate, DepositStrategyParams, FinalizeParams, LpParams, LpRedeemParams, LpSimulate, OpenStrategyParams, OpenStrategySimulate, OpportunitiesPrepare, PoolInput, PositionInput, PrepareApi, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyRoutesSimulate, StrategySimulate, WithdrawCollateralParams, WithdrawStrategyParams };