@gearbox-protocol/sdk 16.0.0-next.9 → 16.1.0

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

@@ -1,26 +1,32 @@
-import { PreviewErrorDetails, PreviewErrorReason, PreviewRefusal } from "../onchain/accounts/intents/refusal.js";
-import { OperationState } from "../onchain/accounts/intents/types.js";
-import { EnsureFreshChains, GearboxSDKOptions, Mode, NamespaceOptions, NoticesByMode, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, PlainMultichainSDKOptions } from "./types.js";
+import { BorrowLimitBinding, IntentPreviewError, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewRefusal, raise, refuse } from "../onchain/validation/refusal.js";
+import { LeverageBand } from "../onchain/accounts/intents/leverage-band.js";
+import { OperationState, PathLossRate, WithdrawCeilings } from "../onchain/accounts/intents/types.js";
+import { IAnalytics, IAnalyticsByMode } from "./analytics/types.js";
+import { ILiquidations, ILiquidationsByMode } from "./liquidations/types.js";
+import { AccountFlowError, CreditAccountNotFoundError, DebtOutOfRangeError, ForbiddenTokenError, InsufficientCollateralError, InsufficientPoolLiquidityError, InsufficientSourceBalanceError, LeverageOutOfRangeError, MalformedTransactionError, MarketExpiredError, MarketPausedError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, OpenFlowError, PoolSunsetError, QuotaCountExceededError, QuotaLimitReachedError, RefusalErrors, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithRouteRefusals, WithdrawalInProgressError, creditAccountNotFound, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./prepare/errors.js";
+import { AddCollateralParams, AdjustLeverageParams, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithdrawCollateralParams, WithdrawStrategyParams } from "./prepare/types.js";
+import { ChainOf, PrepareApi } from "./prepare/PrepareApi.js";
+import "./prepare/index.js";
+import { AccountPrepareRequest, IOpportunitiesExecute, OpenPrepareRequest, PoolPrepareRequest, PrepareRequest } from "./execute/types.js";
+import { ExecuteApi } from "./execute/ExecuteApi.js";
+import "./execute/index.js";
 import { EntityMerger, FilterResult, ListMerger, MergeListResult } from "./utils/types.js";
 import { filterResponse } from "./utils/filterResponse.js";
 import { DEFAULT_MAX_OFFCHAIN_LAG, mergeChainList, mergeChainOne } from "./utils/mergeChains.js";
 import "./utils/index.js";
+import { IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunityMergers } from "./opportunities/types.js";
+import { IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly } from "./positions/types.js";
+import { IPreview, IPreviewByMode } from "./preview/types.js";
+import { EnsureFreshChains, GearboxSDKOptions, IGearboxSDK, INotices, INoticesByMode, Mode, NamespaceOptions, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, PlainMultichainSDKOptions } from "./types.js";
 import { AbstractNamespace, MergedQuery } from "./AbstractNamespace.js";
-import { Liquidations, LiquidationsByMode } from "./liquidations/types.js";
+import { AnalyticsNamespace } from "./analytics/AnalyticsNamespace.js";
+import "./analytics/index.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, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly } from "./positions/types.js";
 import { PositionsNamespace } from "./positions/PositionsNamespace.js";
 import "./positions/index.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";
@@ -32,4 +38,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, 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, type OperationState, 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, type PreviewErrorDetails, type PreviewErrorReason, PreviewNamespace, type PreviewRefusal, RepayStrategyParams, SourceChainMismatchError, SourceUnavailableError, StrategyInput, StrategyRoutesSimulate, StrategySimulate, WithdrawCollateralParams, WithdrawStrategyParams, assertSameChains, everyChainFailed, filterResponse, mergeChainList, mergeChainOne };
+export { AbstractNamespace, AccountFlowError, AccountPrepareRequest, AddCollateralParams, AdjustLeverageParams, AllSourcesFailedError, AnalyticsNamespace, BorrowLimitBinding, ChainOf, ChainRef, CreditAccountNotFoundError, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, DebtOutOfRangeError, DelayedStrategyResult, DepositStrategyParams, EnsureFreshChains, type EntityMerger, ExecuteApi, type FilterResult, FinalizeParams, FinalizeResult, ForbiddenTokenError, GearboxSDK, GearboxSDKOptions, IAnalytics, IAnalyticsByMode, IGearboxSDK, ILiquidations, ILiquidationsByMode, INotices, INoticesByMode, IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesExecute, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunitiesPrepare, IOpportunityMergers, IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly, IPreview, IPreviewByMode, InsufficientCollateralError, InsufficientPoolLiquidityError, InsufficientSourceBalanceError, IntentPreviewError, type LeverageBand, LeverageOutOfRangeError, LiquidationsNamespace, type ListMerger, LpParams, LpRedeemParams, LpResult, LpState, MalformedTransactionError, MarketExpiredError, MarketPausedError, type MergeListResult, MergedQuery, MissingSourceError, Mode, MultipleDelayedWithdrawalsError, NamespaceOptions, NoDelayedRouteError, NoRecordedIntentError, NoSourceServedError, NoStrategyTargetCollateralError, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, OpenFlowError, OpenPrepareRequest, OpenStrategyParams, OpenStrategyResult, type OperationState, OpportunitiesNamespace, type PathLossRate, PlainMultichainSDKOptions, PoolInput, PoolPrepareRequest, PoolSunsetError, PositionInput, PositionsNamespace, PrepareApi, PrepareOptions, PrepareRequest, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewNamespace, PreviewRefusal, QuotaCountExceededError, QuotaLimitReachedError, RefusalErrors, RepayStrategyParams, SourceChainMismatchError, SourceUnavailableError, StrategyInput, StrategyResult, StrategyRoutesResult, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithRouteRefusals, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, WithdrawalInProgressError, assertSameChains, creditAccountNotFound, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };

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

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

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

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

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

@@ -9,7 +9,7 @@ import "../../onchain/index.js";
  * On-chain discovery of liquidatable credit accounts and delayed-withdrawal
  * positions a liquidator wallet holds.
  **/
-interface Liquidations {
+interface ILiquidations {
   /**
    * All liquidatable credit accounts: health factor below 1 plus accounts of
    * expired credit managers with outstanding debt. Optionally narrowed.
@@ -34,13 +34,11 @@ interface Liquidations {
 /**
  * `sdk.liquidations` per mode: an on-chain read, absent when the SDK reads no
  * chain.
- *
- * @internal
  **/
-interface LiquidationsByMode {
-  onchain: Liquidations;
+interface ILiquidationsByMode {
+  onchain: ILiquidations;
   offchain: undefined;
-  both: Liquidations;
+  both: ILiquidations;
 }
 //#endregion
-export { Liquidations, LiquidationsByMode };
+export { ILiquidations, ILiquidationsByMode };

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

@@ -1,58 +1,62 @@
 import { ChartBundle, ChartRange, PoolOpportunityChartMetric, StrategyOpportunityChartMetric } from "../../model/charts.js";
-import { Opportunity, OpportunityFilter, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef } from "../../model/opportunities.js";
+import { Opportunity, OpportunityFilter, OpportunityTotals, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef } from "../../model/opportunities.js";
 import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { MultichainSDK } from "../../onchain/MultichainSDK.js";
 import "../../onchain/index.js";
 import { GearboxAPI } from "../../offchain/GearboxAPI.js";
 import "../../offchain/index.js";
-import { NamespaceOptions } from "../types.js";
+import { IOpportunitiesPrepare } from "../prepare/types.js";
+import "../prepare/index.js";
+import { IOpportunitiesExecute } from "../execute/types.js";
+import "../execute/index.js";
 import { FilterResult } from "../utils/types.js";
 import "../utils/index.js";
+import { IOpportunitiesBase, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunityMergers } from "./types.js";
+import { NamespaceOptions } from "../types.js";
 import { AbstractNamespace } from "../AbstractNamespace.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/sdk/opportunities/OpportunitiesNamespace.d.ts
 /**
  * The `opportunities` namespace of a {@link GearboxSDK}, see
- * {@link OpportunitiesByMode} for what each mode offers.
+ * {@link IOpportunitiesByMode} for what each mode offers.
  **/
-declare class OpportunitiesNamespace extends AbstractNamespace<MultichainSDK["opportunities"], GearboxAPI["opportunities"]> implements OpportunitiesBase, OpportunitiesOffchainOnly, OpportunitiesOnchainOnly {
+declare class OpportunitiesNamespace extends AbstractNamespace<MultichainSDK["opportunities"], GearboxAPI["opportunities"]> implements IOpportunitiesBase, IOpportunitiesOffchainOnly, IOpportunitiesOnchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOffchainBranch {
   #private;
   /**
-   * {@inheritDoc OpportunitiesBase.merge}
+   * {@inheritDoc IOpportunitiesBase.merge}
    **/
-  readonly merge: OpportunityMergers;
+  readonly merge: IOpportunityMergers;
   constructor(onchain: MultichainSDK | undefined, offchain: GearboxAPI | undefined, options: NamespaceOptions);
   /**
-   * {@inheritDoc OpportunitiesOnchainOnly.prepare}
+   * {@inheritDoc IOpportunitiesOnchainOnly.prepare}
    **/
-  get prepare(): OpportunitiesPrepare;
+  get prepare(): IOpportunitiesPrepare;
   /**
-   * {@inheritDoc OpportunitiesOnchainOnly.execute}
+   * {@inheritDoc IOpportunitiesOnchainOnly.execute}
    **/
-  get execute(): OpportunitiesExecute;
+  get execute(): IOpportunitiesExecute;
   /**
-   * {@inheritDoc OpportunitiesBase.list}
+   * {@inheritDoc IOpportunitiesBase.list}
    **/
   list(filter?: OpportunityFilter): Promise<DataResponse<Opportunity[]>>;
   /**
-   * {@inheritDoc OpportunitiesBase.getPool}
+   * {@inheritDoc IOpportunitiesBase.getPool}
    **/
   getPool(key: PoolOpportunityKey): Promise<DataResponse<PoolOpportunityDetail>>;
   /**
-   * {@inheritDoc OpportunitiesBase.getStrategy}
+   * {@inheritDoc IOpportunitiesBase.getStrategy}
    **/
   getStrategy(key: StrategyOpportunityKey): Promise<DataResponse<StrategyOpportunityDetail>>;
   /**
-   * {@inheritDoc OpportunitiesBase.filter}
+   * {@inheritDoc IOpportunitiesBase.filter}
    **/
   filter<R extends DataResponse<Opportunity[]> | undefined>(response: R, filter?: OpportunityFilter): FilterResult<R, Opportunity>;
   /**
-   * {@inheritDoc OpportunitiesOffchainOnly.charts}
+   * {@inheritDoc IOpportunitiesOffchainOnly.totals}
+   **/
+  totals(): Promise<DataResponse<OpportunityTotals>>;
+  /**
+   * {@inheritDoc IOpportunitiesOffchainOnly.charts}
    **/
   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>>>;

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

@@ -1,3 +1,3 @@
-import { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers } from "./types.js";
+import { IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunityMergers } from "./types.js";
 import { OpportunitiesNamespace } from "./OpportunitiesNamespace.js";
-export { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesNamespace, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers };
+export { IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunityMergers, OpportunitiesNamespace };

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

@@ -1,27 +1,27 @@
 import { ChartBundle, ChartRange, PoolOpportunityChartMetric, StrategyOpportunityChartMetric } from "../../model/charts.js";
-import { Opportunity, OpportunityFilter, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef } from "../../model/opportunities.js";
+import { Opportunity, OpportunityFilter, OpportunityTotals, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef } from "../../model/opportunities.js";
 import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
-import { MultichainOpportunitiesService } from "../../onchain/opportunities/MultichainOpportunitiesService.js";
+import { IMultichainOpportunitiesService } from "../../onchain/opportunities/types.js";
 import "../../onchain/index.js";
-import { OffchainOpportunities } from "../../offchain/opportunities/OffchainOpportunities.js";
+import { IOffchainOpportunities } from "../../offchain/opportunities/types.js";
 import "../../offchain/index.js";
-import { Mode } from "../types.js";
-import { EntityMerger, FilterResult, ListMerger } from "../utils/types.js";
-import "../utils/index.js";
-import { OpportunitiesPrepare } from "../prepare/types.js";
+import { IOpportunitiesPrepare } from "../prepare/types.js";
 import "../prepare/index.js";
-import { OpportunitiesExecute } from "../execute/ExecuteApi.js";
+import { IOpportunitiesExecute } from "../execute/types.js";
 import "../execute/index.js";
+import { EntityMerger, FilterResult, ListMerger } from "../utils/types.js";
+import "../utils/index.js";
+import { Mode } from "../types.js";
 //#region src/sdk/opportunities/types.d.ts
 /**
  * What the `opportunities` namespace offers in every mode.
  **/
-interface OpportunitiesBase {
+interface IOpportunitiesBase {
   /**
    * All pool and strategy opportunities, optionally narrowed. In `both` mode
    * each chain is served by whichever source is fresh enough, see
-   * {@link OpportunityMergers}.
+   * {@link IOpportunityMergers}.
    **/
   list(filter?: OpportunityFilter): Promise<DataResponse<Opportunity[]>>;
   /**
@@ -38,26 +38,24 @@ interface OpportunitiesBase {
    * narrows to a list.
    **/
   filter<R extends DataResponse<Opportunity[]> | undefined>(response: R, filter?: OpportunityFilter): FilterResult<R, Opportunity>;
-  /**
-   * The chain on its own, for a consumer that shows each source as it arrives.
-   * Throws in `offchain` mode.
-   **/
-  readonly onchain: MultichainOpportunitiesService;
-  /**
-   * The backend on its own, see {@link OpportunitiesBase.onchain}. Throws in
-   * `onchain` mode.
-   **/
-  readonly offchain: OffchainOpportunities;
   /**
    * Merge policy of each read, for a consumer combining the two branches
-   * itself, see {@link OpportunityMergers}.
+   * itself, see {@link IOpportunityMergers}.
    **/
-  readonly merge: OpportunityMergers;
+  readonly merge: IOpportunityMergers;
 }
 /**
  * Reads only a backend can answer.
  **/
-interface OpportunitiesOffchainOnly {
+interface IOpportunitiesOffchainOnly {
+  /**
+   * Protocol-wide totals across every opportunity: the TVL, total borrowed and
+   * total supplied the landing page shows.
+   *
+   * Absent in `onchain` mode: it is served by the backend rather than summed
+   * from the chain.
+   **/
+  totals(): Promise<DataResponse<OpportunityTotals>>;
   /**
    * Historical charts of one opportunity, one series per metric on a shared
    * axis: `charts(key, ["depositApy", "depositApyAvg7d"], "1m")`.
@@ -72,40 +70,42 @@ interface OpportunitiesOffchainOnly {
 /**
  * Reads only the chain can answer.
  **/
-interface OpportunitiesOnchainOnly {
+interface IOpportunitiesOnchainOnly {
   /**
-   * Simulations of what a deposit, withdrawal or leverage change would do.
+   * What a deposit, withdrawal or leverage change would do, and the calldata
+   * that does it.
    *
    * 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;
+  readonly prepare: IOpportunitiesPrepare;
   /**
    * The transaction a prepared operation stands for, see
-   * {@link OpportunitiesExecute.buildTx}. Absent in `offchain` mode for the
+   * {@link IOpportunitiesExecute.buildTx}. Absent in `offchain` mode for the
    * same reason as {@link prepare}: it encodes against live chain state.
    **/
-  readonly execute: OpportunitiesExecute;
+  readonly execute: IOpportunitiesExecute;
 }
 /**
- * Which reads the `opportunities` namespace has in each mode. A widened mode
- * offers what every mode has, i.e. {@link OpportunitiesBase} alone.
+ * The chain on its own, for a consumer that shows each source as it arrives.
+ * Absent in `offchain` mode.
  **/
-interface OpportunitiesOnchainBranch {
-  readonly onchain: MultichainOpportunitiesService;
+interface IOpportunitiesOnchainBranch {
+  readonly onchain: IMultichainOpportunitiesService;
 }
 /**
- * The backend on its own, see {@link OpportunitiesOnchainBranch}.
+ * The backend on its own, see {@link IOpportunitiesOnchainBranch}. Absent in
+ * `onchain` mode.
  **/
-interface OpportunitiesOffchainBranch {
-  readonly offchain: OffchainOpportunities;
+interface IOpportunitiesOffchainBranch {
+  readonly offchain: IOffchainOpportunities;
 }
 /**
  * Merge policy of each read, exposed so that a consumer reading the two
  * branches itself combines them exactly as `both` mode would.
  **/
-interface OpportunityMergers {
+interface IOpportunityMergers {
   list: ListMerger<Opportunity[]>;
   pool: EntityMerger<PoolOpportunityDetail>;
   strategy: EntityMerger<StrategyOpportunityDetail>;
@@ -113,14 +113,14 @@ interface OpportunityMergers {
 /**
  * Which methods the `opportunities` namespace has in each mode.
  **/
-interface OpportunitiesByMode {
-  onchain: OpportunitiesBase & OpportunitiesOnchainOnly & OpportunitiesOnchainBranch;
-  offchain: OpportunitiesBase & OpportunitiesOffchainOnly & OpportunitiesOffchainBranch;
-  both: OpportunitiesBase & OpportunitiesOnchainOnly & OpportunitiesOffchainOnly;
+interface IOpportunitiesByMode {
+  onchain: IOpportunitiesBase & IOpportunitiesOnchainOnly & IOpportunitiesOnchainBranch;
+  offchain: IOpportunitiesBase & IOpportunitiesOffchainOnly & IOpportunitiesOffchainBranch;
+  both: IOpportunitiesBase & IOpportunitiesOnchainOnly & IOpportunitiesOffchainOnly & IOpportunitiesOnchainBranch & IOpportunitiesOffchainBranch;
 }
 /**
  * The `opportunities` namespace of a {@link GearboxSDK} in mode `M`.
  **/
-type Opportunities<M extends Mode = Mode> = OpportunitiesByMode[M];
+type IOpportunities<M extends Mode = Mode> = IOpportunitiesByMode[M];
 //#endregion
-export { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesOffchainBranch, OpportunitiesOffchainOnly, OpportunitiesOnchainBranch, OpportunitiesOnchainOnly, OpportunityMergers };
+export { IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunityMergers };

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

@@ -1,41 +1,55 @@
 import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
-import { PoolPositionRef, Position, PositionFilter, StrategyPositionRef } from "../../model/positions.js";
+import { PoolPositionRef, Position, PositionFilter, PositionTransaction, PositionsTotals, StrategyPositionRef } from "../../model/positions.js";
 import { DataResponse } from "../../model/response.js";
+import { PositionWithdrawals } from "../../model/withdrawals.js";
 import "../../model/index.js";
+import { GetCurrentWithdrawalsProps } from "../../onchain/positions/types.js";
 import { MultichainSDK } from "../../onchain/MultichainSDK.js";
 import "../../onchain/index.js";
 import { GearboxAPI } from "../../offchain/GearboxAPI.js";
 import "../../offchain/index.js";
-import { NamespaceOptions } from "../types.js";
 import { FilterResult } from "../utils/types.js";
 import "../utils/index.js";
+import { IPositionMergers, IPositionsBase, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly } from "./types.js";
+import { NamespaceOptions } from "../types.js";
 import { AbstractNamespace } from "../AbstractNamespace.js";
-import { PositionMergers, PositionsBase, PositionsOffchainOnly } from "./types.js";
 import { Address } from "viem";
 //#region src/sdk/positions/PositionsNamespace.d.ts
 /**
  * The `positions` namespace of a {@link GearboxSDK}, see
- * {@link PositionsByMode} for what each mode offers.
+ * {@link IPositionsByMode} for what each mode offers.
  **/
-declare class PositionsNamespace extends AbstractNamespace<MultichainSDK["positions"], GearboxAPI["positions"]> implements PositionsBase, PositionsOffchainOnly {
+declare class PositionsNamespace extends AbstractNamespace<MultichainSDK["positions"], GearboxAPI["positions"]> implements IPositionsBase, IPositionsOffchainOnly, IPositionsOnchainOnly, IPositionsOnchainBranch, IPositionsOffchainBranch {
   /**
-   * {@inheritDoc PositionsBase.merge}
+   * {@inheritDoc IPositionsBase.merge}
    **/
-  readonly merge: PositionMergers;
+  readonly merge: IPositionMergers;
   constructor(onchain: MultichainSDK | undefined, offchain: GearboxAPI | undefined, options: NamespaceOptions);
   /**
-   * {@inheritDoc PositionsBase.list}
+   * {@inheritDoc IPositionsBase.list}
    **/
   list(wallet: Address, filter?: PositionFilter): Promise<DataResponse<Position[]>>;
   /**
-   * {@inheritDoc PositionsBase.filter}
+   * {@inheritDoc IPositionsBase.filter}
    **/
   filter<R extends DataResponse<Position[]> | undefined>(response: R, filter?: PositionFilter): FilterResult<R, Position>;
   /**
-   * {@inheritDoc PositionsOffchainOnly.charts}
+   * {@inheritDoc IPositionsOffchainOnly.totals}
+   **/
+  totals(wallet: Address): Promise<DataResponse<PositionsTotals>>;
+  /**
+   * {@inheritDoc IPositionsOffchainOnly.charts}
    **/
   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>>>;
+  /**
+   * {@inheritDoc IPositionsOffchainOnly.transactions}
+   **/
+  transactions(key: StrategyPositionRef): Promise<DataResponse<PositionTransaction[]>>;
+  /**
+   * {@inheritDoc IPositionsOnchainOnly.getCurrentWithdrawals}
+   **/
+  getCurrentWithdrawals(props: GetCurrentWithdrawalsProps<true>): Promise<DataResponse<PositionWithdrawals>>;
 }
 //#endregion
 export { PositionsNamespace };

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

@@ -1,3 +1,3 @@
-import { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly } from "./types.js";
+import { IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly } from "./types.js";
 import { PositionsNamespace } from "./PositionsNamespace.js";
-export { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsNamespace, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly };
+export { IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly, PositionsNamespace };

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

@@ -9,6 +9,11 @@ import { MergeListResult } from "../utils/types.js";
  * `name` onto every strategy row the backend has — even when that chain was
  * served from on-chain data because the backend was stale.
  *
+ * Liquidation rows are merged independently: the backend does not serve them
+ * yet, so a fresh off-chain list must not drop on-chain liquidations. Once it
+ * does return them, they follow the same freshness rule as the rest of the
+ * list.
+ *
  * 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,

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

@@ -1,25 +1,26 @@
 import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
-import { PoolPositionRef, Position, PositionFilter, StrategyPositionRef } from "../../model/positions.js";
+import { PoolPositionRef, Position, PositionFilter, PositionTransaction, PositionsTotals, StrategyPositionRef } from "../../model/positions.js";
 import { DataResponse } from "../../model/response.js";
+import { PositionWithdrawals } from "../../model/withdrawals.js";
 import "../../model/index.js";
-import { MultichainPositionsService } from "../../onchain/positions/MultichainPositionsService.js";
+import { GetCurrentWithdrawalsProps, IMultichainPositionsService } from "../../onchain/positions/types.js";
 import "../../onchain/index.js";
-import { OffchainPositions } from "../../offchain/positions/OffchainPositions.js";
+import { IOffchainPositions } from "../../offchain/positions/types.js";
 import "../../offchain/index.js";
-import { Mode } from "../types.js";
 import { FilterResult, ListMerger } from "../utils/types.js";
 import "../utils/index.js";
+import { Mode } from "../types.js";
 import { Address } from "viem";
 //#region src/sdk/positions/types.d.ts
 /**
  * What the `positions` namespace offers in every mode.
  **/
-interface PositionsBase {
+interface IPositionsBase {
   /**
    * Everything a wallet holds: its pool shares, its credit accounts and the
    * delayed withdrawals it took over by liquidating, optionally narrowed. In
    * `both` mode each chain is served by whichever source is fresh enough, see
-   * {@link PositionMergers}.
+   * {@link IPositionMergers}.
    **/
   list(wallet: Address, filter?: PositionFilter): Promise<DataResponse<Position[]>>;
   /**
@@ -28,26 +29,24 @@ interface PositionsBase {
    * narrows to a list.
    **/
   filter<R extends DataResponse<Position[]> | undefined>(response: R, filter?: PositionFilter): FilterResult<R, Position>;
-  /**
-   * The chain on its own, for a consumer that shows each source as it arrives.
-   * Throws in `offchain` mode.
-   **/
-  readonly onchain: MultichainPositionsService;
-  /**
-   * The backend on its own, see {@link PositionsBase.onchain}. Throws in
-   * `onchain` mode.
-   **/
-  readonly offchain: OffchainPositions;
   /**
    * Merge policy of each read, for a consumer combining the two branches
-   * itself, see {@link PositionMergers}.
+   * itself, see {@link IPositionMergers}.
    **/
-  readonly merge: PositionMergers;
+  readonly merge: IPositionMergers;
 }
 /**
  * Reads only a backend can answer.
  **/
-interface PositionsOffchainOnly {
+interface IPositionsOffchainOnly {
+  /**
+   * Aggregate over everything a wallet holds: the list screen's badges, see
+   * {@link PositionsTotals}.
+   *
+   * Absent in `onchain` mode: it is served by the backend rather than summed
+   * from the chain.
+   **/
+  totals(wallet: Address): Promise<DataResponse<PositionsTotals>>;
   /**
    * Historical charts of one position, one series per metric on a shared axis:
    * `charts(key, ["apy", "mwr"], "1m")`.
@@ -58,42 +57,59 @@ interface PositionsOffchainOnly {
    **/
   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>>>;
+  /**
+   * History of one strategy position: every transaction that touched the
+   * credit account while its current session was open, newest first. There is
+   * no paging, and an account with no open session answers with an empty list.
+   *
+   * Absent in `onchain` mode: the history is indexed by the backend rather
+   * than reconstructed from the chain.
+   **/
+  transactions(key: StrategyPositionRef): Promise<DataResponse<PositionTransaction[]>>;
 }
 /**
- * Reads only the chain can answer. Empty for now.
+ * Reads only the chain can answer.
  **/
-interface PositionsOnchainOnly {}
+interface IPositionsOnchainOnly {
+  /**
+   * Delayed withdrawals of one credit account: claimable rows carry the
+   * adapter call and recorded intent a claim is built from; pending rows
+   * name when they mature. Absent in `offchain` mode.
+   **/
+  getCurrentWithdrawals(props: GetCurrentWithdrawalsProps<true>): Promise<DataResponse<PositionWithdrawals>>;
+}
 /**
- * Which reads the `positions` namespace has in each mode. A widened mode offers
- * what every mode has, i.e. {@link PositionsBase} alone.
+ * The chain on its own, for a consumer that shows each source as it arrives.
+ * Absent in `offchain` mode.
  **/
-interface PositionsOnchainBranch {
-  readonly onchain: MultichainPositionsService;
+interface IPositionsOnchainBranch {
+  readonly onchain: IMultichainPositionsService;
 }
 /**
- * The backend on its own, see {@link PositionsOnchainBranch}.
+ * The backend on its own, see {@link IPositionsOnchainBranch}. Absent in
+ * `onchain` mode.
  **/
-interface PositionsOffchainBranch {
-  readonly offchain: OffchainPositions;
+interface IPositionsOffchainBranch {
+  readonly offchain: IOffchainPositions;
 }
 /**
  * Merge policy of each read, exposed so that a consumer reading the two
  * branches itself combines them exactly as `both` mode would.
  **/
-interface PositionMergers {
+interface IPositionMergers {
   list: ListMerger<Position[]>;
 }
 /**
  * Which methods the `positions` namespace has in each mode.
  **/
-interface PositionsByMode {
-  onchain: PositionsBase & PositionsOnchainOnly;
-  offchain: PositionsBase & PositionsOffchainOnly;
-  both: PositionsBase & PositionsOnchainOnly & PositionsOffchainOnly;
+interface IPositionsByMode {
+  onchain: IPositionsBase & IPositionsOnchainOnly & IPositionsOnchainBranch;
+  offchain: IPositionsBase & IPositionsOffchainOnly & IPositionsOffchainBranch;
+  both: IPositionsBase & IPositionsOnchainOnly & IPositionsOffchainOnly & IPositionsOnchainBranch & IPositionsOffchainBranch;
 }
 /**
  * The `positions` namespace of a {@link GearboxSDK} in mode `M`.
  **/
-type Positions<M extends Mode = Mode> = PositionsByMode[M];
+type IPositions<M extends Mode = Mode> = IPositionsByMode[M];
 //#endregion
-export { PositionMergers, Positions, PositionsBase, PositionsByMode, PositionsOffchainBranch, PositionsOffchainOnly, PositionsOnchainBranch, PositionsOnchainOnly };
+export { IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly };