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

package/dist/types/model/positions.schema.d.ts

@@ -255,6 +255,15 @@ declare const poolPositionSchema: z.ZodObject<{
     }, z.core.$strip>], "kind">>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * {@link BorrowRateBreakdown}
+ **/
+declare const borrowRateBreakdownSchema: z.ZodObject<{
+  total: z.ZodNumber;
+  totalOnDebt: z.ZodNumber;
+  base: z.ZodNumber;
+  quotas: z.ZodRecord<z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>, z.ZodNumber>;
+}, z.core.$strip>;
 /**
  * {@link StrategyPosition}
  **/
@@ -323,6 +332,14 @@ declare const strategyPositionSchema: z.ZodObject<{
     }, z.core.$strip>;
   }, z.core.$strip>;
   healthFactor: z.ZodNumber;
+  borrowRate: z.ZodOptional<z.ZodObject<{
+    total: z.ZodNumber;
+    totalOnDebt: z.ZodNumber;
+    base: z.ZodNumber;
+    quotas: z.ZodRecord<z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>, z.ZodNumber>;
+  }, z.core.$strip>>;
+  timeToLiquidation: z.ZodOptional<z.ZodNullable<z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>>>;
+  liquidationPrice: z.ZodOptional<z.ZodNullable<z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>>>;
   pnl: z.ZodOptional<z.ZodObject<{
     organic: z.ZodObject<{
       value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
@@ -568,6 +585,14 @@ declare const positionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
   }, z.core.$strip>;
   healthFactor: z.ZodNumber;
+  borrowRate: z.ZodOptional<z.ZodObject<{
+    total: z.ZodNumber;
+    totalOnDebt: z.ZodNumber;
+    base: z.ZodNumber;
+    quotas: z.ZodRecord<z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>, z.ZodNumber>;
+  }, z.core.$strip>>;
+  timeToLiquidation: z.ZodOptional<z.ZodNullable<z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>>>;
+  liquidationPrice: z.ZodOptional<z.ZodNullable<z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>>>;
   pnl: z.ZodOptional<z.ZodObject<{
     organic: z.ZodObject<{
       value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
@@ -755,5 +780,107 @@ declare const positionKeySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   creditAccount: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
   kind: z.ZodLiteral<"strategy">;
 }, z.core.$strip>], "kind">;
+/**
+ * {@link PositionsTotals}
+ **/
+declare const positionsTotalsSchema: z.ZodObject<{
+  currentYield: z.ZodNullable<z.ZodObject<{
+    totalApy: z.ZodOptional<z.ZodNumber>;
+    organicApy: z.ZodNumber;
+    rewards: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      kind: z.ZodLiteral<"token">;
+      token: z.ZodObject<{
+        chainId: z.ZodNumber;
+        address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+        symbol: z.ZodString;
+        name: z.ZodString;
+        decimals: z.ZodNumber;
+        assetType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+      }, z.core.$strip>;
+      supplyApr: z.ZodOptional<z.ZodNumber>;
+      borrowApr: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+      kind: z.ZodLiteral<"point">;
+      points: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        multiplier: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>], "kind">>>;
+  }, z.core.$strip>>;
+  pnl: z.ZodNullable<z.ZodObject<{
+    organic: z.ZodObject<{
+      value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
+      valueUsd: z.ZodNullable<z.ZodNumber>;
+      token: z.ZodObject<{
+        chainId: z.ZodNumber;
+        address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+        symbol: z.ZodString;
+        name: z.ZodString;
+        decimals: z.ZodNumber;
+        assetType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+      }, z.core.$strip>;
+    }, z.core.$strip>;
+    total: z.ZodObject<{
+      value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
+      valueUsd: z.ZodNullable<z.ZodNumber>;
+      token: z.ZodObject<{
+        chainId: z.ZodNumber;
+        address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+        symbol: z.ZodString;
+        name: z.ZodString;
+        decimals: z.ZodNumber;
+        assetType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+      }, z.core.$strip>;
+    }, z.core.$strip>;
+    rewards: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
+      valueUsd: z.ZodNullable<z.ZodNumber>;
+      token: z.ZodObject<{
+        chainId: z.ZodNumber;
+        address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+        symbol: z.ZodString;
+        name: z.ZodString;
+        decimals: z.ZodNumber;
+        assetType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+      }, z.core.$strip>;
+      kind: z.ZodLiteral<"token">;
+    }, z.core.$strip>, z.ZodObject<{
+      kind: z.ZodLiteral<"point">;
+      points: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        multiplier: z.ZodNullable<z.ZodNumber>;
+        value: z.ZodNumber;
+      }, z.core.$strip>>;
+    }, z.core.$strip>], "kind">>;
+  }, z.core.$strip>>;
+  netValueUsd: z.ZodNullable<z.ZodNumber>;
+  claimableUsd: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * {@link PositionTransactionKind}
+ **/
+declare const positionTransactionKindSchema: z.ZodUnion<readonly [z.ZodLiteral<"open">, z.ZodLiteral<"deposit">, z.ZodLiteral<"withdraw">, z.ZodLiteral<"adjustLeverage">, z.ZodLiteral<"addCollateral">, z.ZodLiteral<"withdrawCollateral">, z.ZodLiteral<"liquidation">]>;
+/**
+ * {@link PositionTransaction}
+ **/
+declare const positionTransactionSchema: z.ZodObject<{
+  txHash: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+  timestamp: z.ZodNumber;
+  kind: z.ZodUnion<readonly [z.ZodLiteral<"open">, z.ZodLiteral<"deposit">, z.ZodLiteral<"withdraw">, z.ZodLiteral<"adjustLeverage">, z.ZodLiteral<"addCollateral">, z.ZodLiteral<"withdrawCollateral">, z.ZodLiteral<"liquidation">]>;
+  assets: z.ZodArray<z.ZodObject<{
+    value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
+    valueUsd: z.ZodNullable<z.ZodNumber>;
+    token: z.ZodObject<{
+      chainId: z.ZodNumber;
+      address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+      symbol: z.ZodString;
+      name: z.ZodString;
+      decimals: z.ZodNumber;
+      assetType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+    }, z.core.$strip>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
 //#endregion
-export { pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenRewardsPnLSchema };
+export { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenRewardsPnLSchema };

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

@@ -1,7 +1,8 @@
 import { ILogger } from "../sdk/types/logger.js";
+import { ChainId } from "../model/primitives.js";
 import { DataResponse } from "../model/response.js";
 import "../model/index.js";
-import { NamespaceOptions } from "./types.js";
+import { EnsureFreshChains, NamespaceOptions } from "./types.js";
 import { EntityMerger, ListMerger } from "./utils/types.js";
 import "./utils/index.js";
 //#region src/new-sdk/AbstractNamespace.d.ts
@@ -17,6 +18,11 @@ interface MergedQuery<Onchain, Offchain, T> {
   fromChain: (source: Onchain) => Promise<DataResponse<T>>;
   fromBackend: (source: Offchain) => Promise<DataResponse<T>>;
   merge: ListMerger<T> | EntityMerger<T>;
+  /**
+   * Chains the on-chain leg touches, so only they are revalidated before it;
+   * omitted when the read fans out to every chain.
+   **/
+  chainIds?: readonly ChainId[];
 }
 /**
  * Base class of every {@link GearboxSDK} namespace: holds the two source
@@ -33,9 +39,16 @@ declare abstract class AbstractNamespace<Onchain, Offchain> {
    **/
   protected readonly maxOffchainLagSeconds: number;
   protected readonly logger?: ILogger;
+  /**
+   * The SDK's loading policy, awaited before every on-chain leg: attached, and
+   * the touched chains no older than the SDK allows.
+   **/
+  protected readonly ensureFresh?: EnsureFreshChains;
   protected constructor(name: string, onchain: Onchain | undefined, offchain: Offchain | undefined, options: NamespaceOptions);
   /**
-   * The on-chain source namespace on its own. Throws
+   * The on-chain source namespace on its own — every read of it attaches and
+   * revalidates like a merged read does, so a consumer showing the two sources
+   * separately still gets the SDK's loading policy. Throws
    * {@link SourceUnavailableError} in `offchain` mode.
    **/
   get onchain(): Onchain;

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

@@ -1,11 +1,16 @@
 import { NetworkType } from "../sdk/chain/chains.js";
 import "../sdk/index.js";
-import { GearboxSDKOptions, Mode, OffchainByMode, OnchainByMode } from "./types.js";
+import { GearboxSDKOptions, Mode, NoticesByMode, OffchainByMode, OnchainByMode } from "./types.js";
 import { Opportunities } from "./opportunities/types.js";
 import "./opportunities/index.js";
 import { Positions } from "./positions/types.js";
 import "./positions/index.js";
 //#region src/new-sdk/GearboxSDK.d.ts
+/**
+ * Default {@link GearboxSDKOptions.maxStateAgeSeconds}: the fastest poll an
+ * app runs, so a 30 s tick sees state no older than itself.
+ **/
+declare const DEFAULT_MAX_STATE_AGE = 30;
 /**
  * Entry point over both sources of Gearbox data: the chain and the Gearbox
  * backend. The {@link Mode} is fixed at construction and decides which methods
@@ -43,6 +48,13 @@ declare class GearboxSDK<const M extends Mode = Mode> {
    * Namespace for the positions a wallet holds.
    **/
   readonly positions: Positions<M>;
+  /**
+   * The banners the backend attaches to a pool opportunity or a strategy
+   * position, see {@link Notice}. Top-level because the subject is either
+   * kind of entity, so neither namespace owns it. Backend-only, hence gated
+   * by mode like every other backend read: absent in `onchain` mode.
+   **/
+  readonly notices: NoticesByMode[M];
   constructor(options: GearboxSDKOptions<M>);
   /**
    * Attaches the on-chain SDK when this instance owns one; a no-op in `offchain`
@@ -66,4 +78,4 @@ declare class GearboxSDK<const M extends Mode = Mode> {
   get offchain(): OffchainByMode[M];
 }
 //#endregion
-export { GearboxSDK };
+export { DEFAULT_MAX_STATE_AGE, GearboxSDK };

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

@@ -0,0 +1,108 @@
+import { ChainId } from "../../model/primitives.js";
+import { Asset } from "../../sdk/base/types.js";
+import "../../model/index.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 "../simulate/types.js";
+import { ChainOf } from "../simulate/SimulateApi.js";
+import "../simulate/index.js";
+import { Address } from "viem";
+//#region src/new-sdk/execute/ExecuteApi.d.ts
+/**
+ * A pool deposit, withdrawal or redemption, as
+ * {@link OpportunitiesSimulate.deposit} / {@link OpportunitiesSimulate.withdraw}
+ * / {@link OpportunitiesSimulate.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 OpportunitiesSimulate.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
+ * simulate 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 `simulate`
+ * 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 simulate 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,21 @@
-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 { AddCollateralParams, AdjustLeverageParams, DelayedSimulate, DelayedStrategySimulate, DepositStrategyParams, FinishDelayedParams, LpParams, LpRedeemParams, LpSimulate, OpenStrategyParams, OpenStrategySimulate, OpportunitiesSimulate, PoolInput, PositionInput, RepayStrategyParams, SimulateOptions, StrategyInput, StrategyRoutesSimulate, StrategySimulate, WithdrawCollateralParams, WithdrawStrategyParams } from "./simulate/types.js";
+import { ChainOf, SimulateApi } from "./simulate/SimulateApi.js";
+import "./simulate/index.js";
+import { AccountPrepareRequest, ExecuteApi, OpenPrepareRequest, OpportunitiesExecute, PoolPrepareRequest, PrepareRequest } from "./execute/ExecuteApi.js";
+import "./execute/index.js";
 import { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesMerged, 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 { PositionsNamespace } from "./positions/PositionsNamespace.js";
 import "./positions/index.js";
-import { GearboxSDK } from "./GearboxSDK.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 +24,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, DelayedSimulate, DelayedStrategySimulate, DepositStrategyParams, EnsureFreshChains, type EntityMerger, ExecuteApi, type FilterResult, FinishDelayedParams, GearboxSDK, GearboxSDKOptions, type ListMerger, LpParams, LpRedeemParams, LpSimulate, type MergeListResult, MergedQuery, MissingSourceError, Mode, NamespaceOptions, NoSourceServedError, NoticesByMode, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, OpenPrepareRequest, OpenStrategyParams, OpenStrategySimulate, Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesExecute, OpportunitiesMerged, OpportunitiesNamespace, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunitiesSimulate, OpportunityMergers, PlainMultichainSDKOptions, PoolInput, PoolPrepareRequest, PositionInput, PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsMerged, PositionsNamespace, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly, PrepareRequest, RepayStrategyParams, SimulateApi, SimulateOptions, SourceChainMismatchError, SourceUnavailableError, StrategyInput, StrategyRoutesSimulate, StrategySimulate, WithdrawCollateralParams, WithdrawStrategyParams, assertSameChains, everyChainFailed, filterResponse, mergeChainList, mergeChainOne };

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 { OpportunitiesSimulate } from "../simulate/types.js";
+import "../simulate/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.simulate}
+   **/
+  get simulate(): OpportunitiesSimulate;
+  /**
+   * {@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/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 { OpportunitiesSimulate } from "../simulate/types.js";
+import "../simulate/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 simulate: OpportunitiesSimulate;
+  /**
+   * The transaction a simulate result stands for, see
+   * {@link OpportunitiesExecute.buildTx}. Absent in `offchain` mode for the
+   * same reason as {@link simulate}: it encodes against live chain state.
+   **/
+  execute: OpportunitiesExecute;
+}
 /**
  * Which reads the `opportunities` namespace has in each mode. A widened mode
  * offers what every mode has, i.e. {@link OpportunitiesBase} alone.

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/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.