@gearbox-protocol/sdk 14.12.0-next.71 → 14.12.0-next.72

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

@@ -17,10 +17,22 @@ declare const poolHistoryMetricSchema: z.ZodUnion<readonly [z.ZodLiteral<"deposi
  * {@link StrategyHistoryMetric}
  **/
 declare const strategyHistoryMetricSchema: z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>;
+/**
+ * {@link PoolPositionHistoryMetric}
+ **/
+declare const poolPositionHistoryMetricSchema: z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>;
+/**
+ * {@link StrategyPositionHistoryMetric}
+ **/
+declare const strategyPositionHistoryMetricSchema: z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>;
+/**
+ * {@link PositionHistoryMetric}
+ **/
+declare const positionHistoryMetricSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>, z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>]>;
 /**
  * {@link HistoryMetric}
  **/
-declare const historyMetricSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>, z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>]>;
+declare const historyMetricSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>, z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>, z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>]>]>;
 /**
  * {@link HistoryPoint}
  **/
@@ -38,7 +50,7 @@ declare const historyChartMetadataSchema: z.ZodType<HistoryChartMetadata>;
  * {@link HistorySeries}
  **/
 declare const historySeriesSchema: z.ZodObject<{
-  metric: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>, z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>]>;
+  metric: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>, z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>, z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>]>]>;
   points: z.ZodArray<z.ZodObject<{
     timestamp: z.ZodNumber;
     value: z.ZodNumber;
@@ -60,7 +72,24 @@ declare const opportunityHistoryQuerySchema: z.ZodObject<{
     kind: z.ZodLiteral<"strategy">;
   }, z.core.$strip>], "kind">;
   range: z.ZodUnion<readonly [z.ZodLiteral<"1d">, z.ZodLiteral<"1w">, z.ZodLiteral<"1m">, z.ZodLiteral<"1y">, z.ZodLiteral<"max">]>;
+  metric: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>, z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>, z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>]>]>;
+}, z.core.$strip>;
+/**
+ * {@link PositionHistoryQuery}
+ **/
+declare const positionHistoryQuerySchema: z.ZodObject<{
+  position: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    chainId: z.ZodNumber;
+    pool: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    wallet: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    kind: z.ZodLiteral<"pool">;
+  }, z.core.$strip>, z.ZodObject<{
+    chainId: z.ZodNumber;
+    creditAccount: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    kind: z.ZodLiteral<"strategy">;
+  }, z.core.$strip>], "kind">;
+  range: z.ZodUnion<readonly [z.ZodLiteral<"1d">, z.ZodLiteral<"1w">, z.ZodLiteral<"1m">, z.ZodLiteral<"1y">, z.ZodLiteral<"max">]>;
   metric: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"depositApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"dieselRate">, z.ZodLiteral<"supplied">, z.ZodLiteral<"borrowed">, z.ZodLiteral<"availableLiquidity">]>, z.ZodUnion<readonly [z.ZodLiteral<"netApy">, z.ZodLiteral<"borrowApy">, z.ZodLiteral<"collateralApy">, z.ZodLiteral<"tvl">, z.ZodLiteral<"collateralPrice">, z.ZodLiteral<"collateralUsdPrice">, z.ZodLiteral<"underlyingUsdPrice">]>]>;
 }, z.core.$strip>;
 //#endregion
-export { historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, opportunityHistoryQuerySchema, poolHistoryMetricSchema, strategyHistoryMetricSchema };
+export { historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, opportunityHistoryQuerySchema, poolHistoryMetricSchema, poolPositionHistoryMetricSchema, positionHistoryMetricSchema, positionHistoryQuerySchema, strategyHistoryMetricSchema, strategyPositionHistoryMetricSchema };

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

@@ -1,11 +1,11 @@
 import { Amount, AssetType, Bps, ChainId, Curator, Leverage, Timestamp, Token, TokenAmount, TxCall } from "./primitives.js";
 import { ApyBreakdown, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, PointRewards, PointsProgram, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, Rewards, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, TokenRewards, matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
-import { HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange, HistorySeries, OpportunityHistoryQuery, POOL_HISTORY_METRICS, PoolHistoryMetric, STRATEGY_HISTORY_METRICS, StrategyHistoryMetric } from "./history.js";
-import { historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, opportunityHistoryQuerySchema, poolHistoryMetricSchema, strategyHistoryMetricSchema } from "./history.schema.js";
 import { DelayedReceivedAsset, InstantReceivedAsset, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, ReceivedAsset, matchesLiquidatableAccountFilter } from "./liquidations.js";
+import { PnlBreakdown, PointsProgramPnL, PointsRewardsPnL, PoolPosition, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, RewardsPnL, StrategyPosition, StrategyPositionKey, StrategyPositionRef, TokenRewardsPnL, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
+import { HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange, HistorySeries, OpportunityHistoryQuery, POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, PoolHistoryMetric, PoolPositionHistoryMetric, PositionHistoryMetric, PositionHistoryQuery, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, StrategyHistoryMetric, StrategyPositionHistoryMetric } from "./history.js";
+import { historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, opportunityHistoryQuerySchema, poolHistoryMetricSchema, poolPositionHistoryMetricSchema, positionHistoryMetricSchema, positionHistoryQuerySchema, strategyHistoryMetricSchema, strategyPositionHistoryMetricSchema } from "./history.schema.js";
 import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, receivedAssetSchema } from "./liquidations.schema.js";
 import { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema } from "./opportunities.schema.js";
-import { PnlBreakdown, PointsProgramPnL, PointsRewardsPnL, PoolPosition, Position, PositionCollateral, PositionFilter, PositionKind, RewardsPnL, StrategyPosition, TokenRewardsPnL } from "./positions.js";
-import { pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionKindSchema, positionSchema, rewardsPnLSchema, strategyPositionSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
+import { pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, curatorSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
-export { Amount, ApyBreakdown, AssetType, Bps, ChainId, Curator, DelayedReceivedAsset, HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange, HistorySeries, InstantReceivedAsset, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityHistoryQuery, OpportunityId, OpportunityKey, OpportunityKind, POOL_HISTORY_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolHistoryMetric, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, Position, PositionCollateral, PositionFilter, PositionKind, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, Rewards, RewardsPnL, STRATEGY_HISTORY_METRICS, StrategyHistoryMetric, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, Timestamp, Token, TokenAmount, TokenRewards, TokenRewardsPnL, TxCall, amountSchema, apyBreakdownSchema, assetTypeSchema, bpsSchema, chainIdSchema, curatorSchema, delayedReceivedAssetSchema, historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, instantReceivedAssetSchema, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterSchema, opportunityHistoryQuerySchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolHistoryMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionKindSchema, positionSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, rewardsPnLSchema, rewardsSchema, strategyHistoryMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, txCallSchema };
+export { Amount, ApyBreakdown, AssetType, Bps, ChainId, Curator, DelayedReceivedAsset, HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange, HistorySeries, InstantReceivedAsset, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityHistoryQuery, OpportunityId, OpportunityKey, OpportunityKind, POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolHistoryMetric, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionHistoryMetric, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionHistoryMetric, PositionHistoryQuery, PositionId, PositionKey, PositionKind, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, Rewards, RewardsPnL, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, StrategyHistoryMetric, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionHistoryMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenRewards, TokenRewardsPnL, TxCall, amountSchema, apyBreakdownSchema, assetTypeSchema, bpsSchema, chainIdSchema, curatorSchema, delayedReceivedAssetSchema, historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, instantReceivedAssetSchema, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterSchema, opportunityHistoryQuerySchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolHistoryMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionHistoryMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionHistoryMetricSchema, positionHistoryQuerySchema, positionId, positionKeySchema, positionKindSchema, positionSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, rewardsPnLSchema, rewardsSchema, strategyHistoryMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionHistoryMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, txCallSchema };

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

@@ -215,6 +215,46 @@ interface StrategyPosition {
  * A row of the positions list: anything a wallet holds in the protocol.
  **/
 type Position = PoolPosition | StrategyPosition | LiquidationPosition;
+/**
+ * Canonical id of a position: the string used to match a row read from the
+ * chain with the same row served by the backend.
+ *
+ * A position list is always scoped to one wallet, so the wallet is not part of
+ * the id.
+ **/
+type PositionId = string;
+/**
+ * Builds the canonical id of a pool position.
+ *
+ * @example
+ * ```ts
+ * poolPositionId(1, "0xda00...") // "1:pool:0xda00..."
+ * ```
+ **/
+declare function poolPositionId(chainId: ChainId, pool: Address): PositionId;
+/**
+ * Builds the canonical id of a strategy position. The credit account address
+ * identifies it on its own, the credit manager is not part of the id.
+ *
+ * @example
+ * ```ts
+ * strategyPositionId(1, "0x9c4c...") // "1:strategy:0x9c4c..."
+ * ```
+ **/
+declare function strategyPositionId(chainId: ChainId, creditAccount: Address): PositionId;
+/**
+ * Builds the canonical id of a liquidation position.
+ *
+ * The redeemer is the withdrawal's own contract and therefore identifies it,
+ * but compressor versions below 313 do not report one; those fall back to the
+ * source token plus the moment the withdrawal becomes claimable, which is what
+ * distinguishes two withdrawals of the same asset.
+ **/
+declare function liquidationPositionId(chainId: ChainId, position: Pick<LiquidationPosition, "redeemer" | "sourceToken" | "claimableAt">): PositionId;
+/**
+ * Canonical id of any position, dispatching on {@link Position.kind}.
+ **/
+declare function positionId(position: Position): PositionId;
 /**
  * Optional narrowing of a positions list.
  *
@@ -243,5 +283,64 @@ interface PositionFilter {
    **/
   underlyingType?: AssetType;
 }
+/**
+ * Whether a position satisfies every criterion of a filter.
+ *
+ * This is the single definition of what each criterion means: every source
+ * builds its rows first and runs them through here, so the chain and the
+ * backend cannot disagree on what a filter selects.
+ *
+ * A criterion that does not apply to a position's kind keeps the row rather
+ * than dropping it: `isZeroDebt` says nothing about a pool position, and
+ * `underlyingType` says nothing about a liquidation position, which is
+ * denominated in whatever its withdrawal pays out.
+ *
+ * @param position - Row to test.
+ * @param filter - Criteria to test against. An absent filter matches anything.
+ **/
+declare function matchesPositionFilter(position: Position, filter?: PositionFilter): boolean;
+/**
+ * Identifies a pool position in a detail or history request.
+ **/
+interface PoolPositionKey {
+  chainId: ChainId;
+  /**
+   * Address of the ERC-4626 pool contract.
+   **/
+  pool: Address;
+  /**
+   * Wallet holding the shares. Unlike an opportunity, a position exists only
+   * relative to its holder.
+   **/
+  wallet: Address;
+}
+/**
+ * Identifies a strategy position in a detail or history request. The credit
+ * account address identifies it on its own.
+ **/
+interface StrategyPositionKey {
+  chainId: ChainId;
+  creditAccount: Address;
+}
+/**
+ * {@link PoolPositionKey} tagged with its kind, for requests that accept both
+ * kinds.
+ **/
+interface PoolPositionRef extends PoolPositionKey {
+  kind: "pool";
+}
+/**
+ * {@link StrategyPositionKey} tagged with its kind, for requests that accept
+ * both kinds.
+ **/
+interface StrategyPositionRef extends StrategyPositionKey {
+  kind: "strategy";
+}
+/**
+ * Identifies any position that has a history, for requests that accept both
+ * kinds. Liquidation positions have none: a delayed withdrawal is a single
+ * event rather than a series.
+ **/
+type PositionKey = PoolPositionRef | StrategyPositionRef;
 //#endregion
-export { PnlBreakdown, PointsProgramPnL, PointsRewardsPnL, PoolPosition, Position, PositionCollateral, PositionFilter, PositionKind, RewardsPnL, StrategyPosition, TokenRewardsPnL };
+export { PnlBreakdown, PointsProgramPnL, PointsRewardsPnL, PoolPosition, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, RewardsPnL, StrategyPosition, StrategyPositionKey, StrategyPositionRef, TokenRewardsPnL, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId };

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

@@ -697,5 +697,33 @@ declare const positionFilterSchema: z.ZodObject<{
   chainIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
   underlyingType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
 }, z.core.$strip>;
+/**
+ * {@link PoolPositionKey}
+ **/
+declare const poolPositionKeySchema: z.ZodObject<{
+  chainId: z.ZodNumber;
+  pool: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+  wallet: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+}, z.core.$strip>;
+/**
+ * {@link StrategyPositionKey}
+ **/
+declare const strategyPositionKeySchema: z.ZodObject<{
+  chainId: z.ZodNumber;
+  creditAccount: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+}, z.core.$strip>;
+/**
+ * {@link PositionKey}
+ **/
+declare const positionKeySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  chainId: z.ZodNumber;
+  pool: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+  wallet: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+  kind: z.ZodLiteral<"pool">;
+}, z.core.$strip>, z.ZodObject<{
+  chainId: z.ZodNumber;
+  creditAccount: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+  kind: z.ZodLiteral<"strategy">;
+}, z.core.$strip>], "kind">;
 //#endregion
-export { pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionKindSchema, positionSchema, rewardsPnLSchema, strategyPositionSchema, tokenRewardsPnLSchema };
+export { pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenRewardsPnLSchema };

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

@@ -1,8 +1,8 @@
-import { ILogger } from "../sdk/types/logger.js";
 import { ChainId } from "../model/primitives.js";
+import "../model/index.js";
+import { ILogger } from "../sdk/types/logger.js";
 import { NetworkType } from "../sdk/chain/chains.js";
 import { MultichainNetworkMeta } from "../sdk/types/multichain.js";
-import "../model/index.js";
 import { MultichainSDK } from "../sdk/MultichainSDK.js";
 import "../sdk/index.js";
 import { OffchainResult } from "../offchain/types.js";

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

@@ -3,6 +3,8 @@ import "../sdk/index.js";
 import { GearboxSDKOptions, Mode, 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
 /**
  * Combined entry point over both sources of Gearbox data: the chain and the
@@ -45,6 +47,10 @@ declare class GearboxSDK<const M extends Mode = Mode> {
    * Namespace for pool and strategy opportunities.
    **/
   readonly opportunities: Opportunities<M>;
+  /**
+   * Namespace for the positions a wallet holds.
+   **/
+  readonly positions: Positions<M>;
   constructor(options: GearboxSDKOptions<M>);
   /**
    * Attaches the on-chain SDK when this instance owns one.

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

@@ -5,5 +5,8 @@ import "./utils/index.js";
 import { Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesOffchainOnly, OpportunitiesOnchainOnly } from "./opportunities/types.js";
 import { OpportunitiesNamespace } from "./opportunities/OpportunitiesNamespace.js";
 import "./opportunities/index.js";
+import { Positions, PositionsBase, PositionsByMode, PositionsOffchainOnly, PositionsOnchainOnly } from "./positions/types.js";
+import { PositionsNamespace } from "./positions/PositionsNamespace.js";
+import "./positions/index.js";
 import { GearboxSDK } from "./GearboxSDK.js";
-export { AbstractNamespace, AllSourcesFailedError, Chart, ChartMetadata, CombineSources, GearboxSDK, GearboxSDKOptions, HistoryReader, Mode, OffchainByMode, OffchainContribution, OffchainSource, OffchainSourceStatus, OnchainByMode, OnchainContribution, OnchainSource, Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesNamespace, OpportunitiesOffchainOnly, OpportunitiesOnchainOnly, PlainMultichainSDKOptions, ReadResult, SourceMeta };
+export { AbstractNamespace, AllSourcesFailedError, Chart, ChartMetadata, CombineSources, GearboxSDK, GearboxSDKOptions, HistoryReader, Mode, OffchainByMode, OffchainContribution, OffchainSource, OffchainSourceStatus, OnchainByMode, OnchainContribution, OnchainSource, Opportunities, OpportunitiesBase, OpportunitiesByMode, OpportunitiesNamespace, OpportunitiesOffchainOnly, OpportunitiesOnchainOnly, PlainMultichainSDKOptions, Positions, PositionsBase, PositionsByMode, PositionsNamespace, PositionsOffchainOnly, PositionsOnchainOnly, ReadResult, SourceMeta };

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

@@ -1,7 +1,7 @@
-import { ILogger } from "../../sdk/types/logger.js";
 import { Opportunity, OpportunityFilter, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef } from "../../model/opportunities.js";
 import { PoolHistoryMetric, StrategyHistoryMetric } from "../../model/history.js";
 import "../../model/index.js";
+import { ILogger } from "../../sdk/types/logger.js";
 import { MultichainSDK } from "../../sdk/MultichainSDK.js";
 import "../../sdk/index.js";
 import { GearboxAPI } from "../../offchain/GearboxAPI.js";

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

@@ -0,0 +1,62 @@
+import { PoolPositionRef, Position, PositionFilter, StrategyPositionRef } from "../../model/positions.js";
+import { PoolPositionHistoryMetric, StrategyPositionHistoryMetric } from "../../model/history.js";
+import "../../model/index.js";
+import { ILogger } from "../../sdk/types/logger.js";
+import { MultichainSDK } from "../../sdk/MultichainSDK.js";
+import "../../sdk/index.js";
+import { GearboxAPI } from "../../offchain/GearboxAPI.js";
+import "../../offchain/index.js";
+import { ReadResult } from "../types.js";
+import { AbstractNamespace } from "../AbstractNamespace.js";
+import { HistoryReader } from "../utils/history.js";
+import "../utils/index.js";
+import { PositionsBase, PositionsOffchainOnly } from "./types.js";
+import { Address } from "viem";
+//#region src/new-sdk/positions/PositionsNamespace.d.ts
+/**
+ * The `positions` namespace of the combined SDK.
+ *
+ * A stateless router over the two sources, see {@link AbstractNamespace} for the
+ * routing itself. What is specific to positions is the reads below and the merge
+ * policy at the bottom of the class.
+ *
+ * The class implements the methods of every mode; {@link GearboxSDK} exposes it
+ * as its mode's slice of {@link PositionsByMode}, so calling a method the mode
+ * does not have is a compile error rather than a runtime one.
+ **/
+declare class PositionsNamespace extends AbstractNamespace<Position> implements PositionsBase, PositionsOffchainOnly {
+  #private;
+  constructor(onchain: MultichainSDK | undefined, offchain: GearboxAPI | undefined, logger?: ILogger);
+  /**
+   * {@inheritDoc PositionsBase.list}
+   **/
+  list(wallet: Address, filter?: PositionFilter): Promise<ReadResult<Position[]>>;
+  /**
+   * {@inheritDoc PositionsOffchainOnly.history}
+   **/
+  history(key: PoolPositionRef): HistoryReader<PoolPositionHistoryMetric>;
+  history(key: StrategyPositionRef): HistoryReader<StrategyPositionHistoryMetric>;
+  /**
+   * Merges the two versions of one position.
+   *
+   * The chain wins every field it fills; the backend fills the rest and owns
+   * {@link OFFCHAIN_OWNED_FIELDS}.
+   *
+   * The rule is onchain-first, field-wise, and never deeper than one level: a
+   * group like `totalValue` or `apy` is taken whole from one source, so a row
+   * never mixes an on-chain token amount with a backend dollar value derived
+   * from a different block.
+   **/
+  protected mergeOne<T extends object>(onchain: T, offchain: T): T;
+  /**
+   * Unions the two lists by canonical position id.
+   *
+   * Rows present in both are merged by {@link PositionsNamespace.mergeOne}.
+   * Rows only the backend knows are appended: a chain the SDK does not cover,
+   * or a market it has not loaded, must not hide a position the wallet actually
+   * holds.
+   **/
+  protected mergeList(onchain: Position[], offchain: Position[]): Position[];
+}
+//#endregion
+export { PositionsNamespace };

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

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

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

@@ -0,0 +1,62 @@
+import { PoolPositionRef, Position, PositionFilter, StrategyPositionRef } from "../../model/positions.js";
+import { PoolPositionHistoryMetric, StrategyPositionHistoryMetric } from "../../model/history.js";
+import "../../model/index.js";
+import { Mode, ReadResult } from "../types.js";
+import { HistoryReader } from "../utils/history.js";
+import { Address } from "viem";
+//#region src/new-sdk/positions/types.d.ts
+/**
+ * Reads every mode supports, because either source alone can answer them.
+ **/
+interface PositionsBase {
+  /**
+   * Everything a wallet holds: its pool shares, its credit accounts and the
+   * delayed withdrawals it took over by liquidating, optionally narrowed.
+   *
+   * In `both` mode the two lists are unioned by canonical position id and
+   * merged field-wise, with the chain winning any field both sources fill.
+   **/
+  list(wallet: Address, filter?: PositionFilter): Promise<ReadResult<Position[]>>;
+}
+/**
+ * Reads only a backend can answer.
+ **/
+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 history at
+   * all: a delayed withdrawal is a single event rather than a series, which is
+   * why no key names one.
+   *
+   * Absent in `onchain` mode: the chain serves the present, and rebuilding a
+   * series from it would mean an archive read per point.
+   **/
+  history(key: PoolPositionRef): HistoryReader<PoolPositionHistoryMetric>;
+  history(key: StrategyPositionRef): HistoryReader<StrategyPositionHistoryMetric>;
+}
+/**
+ * Reads only the chain can answer. Empty for now — every on-chain read the
+ * namespace exposes has a backend counterpart.
+ **/
+interface PositionsOnchainOnly {}
+/**
+ * Which methods the `positions` namespace has in each mode.
+ *
+ * A lookup map rather than a conditional type: `both` is spelled out instead of
+ * being inferred, and a widened mode degrades to the intersection of what all
+ * modes offer rather than silently distributing into a union of everything.
+ **/
+interface PositionsByMode {
+  onchain: PositionsBase & PositionsOnchainOnly;
+  offchain: PositionsBase & PositionsOffchainOnly;
+  both: PositionsBase & PositionsOffchainOnly & PositionsOnchainOnly;
+}
+/**
+ * The `positions` namespace of a {@link GearboxSDK} in mode `M`.
+ **/
+type Positions<M extends Mode = Mode> = PositionsByMode[M];
+//#endregion
+export { Positions, PositionsBase, PositionsByMode, PositionsOffchainOnly, PositionsOnchainOnly };

package/dist/types/new-sdk/utils/history.d.ts

@@ -1,4 +1,4 @@
-import { HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange } from "../../model/history.js";
+import { HistoryChartMetadata, HistoryPoint, HistoryRange } from "../../model/history.js";
 import "../../model/index.js";
 import { SourceMeta } from "../types.js";
 //#region src/new-sdk/utils/history.d.ts
@@ -29,9 +29,13 @@ interface Chart {
 /**
  * Reads the charts of one subject, one metric and one range at a time.
  *
+ * The constraint is `string` rather than {@link HistoryMetric}, matching
+ * {@link HistorySeries}: opportunities and positions carry their own metric
+ * unions, and those are free to drift apart.
+ *
  * @typeParam Metric - Metrics the subject has.
  **/
-interface HistoryReader<Metric extends HistoryMetric> {
+interface HistoryReader<Metric extends string> {
   /**
    * Historical chart of one metric over one window.
    *

package/dist/types/offchain/GearboxAPI.d.ts

@@ -1,6 +1,8 @@
 import { GearboxAPIOptions } from "./types.js";
 import { OffchainOpportunities } from "./opportunities/OffchainOpportunities.js";
 import "./opportunities/index.js";
+import { OffchainPositions } from "./positions/OffchainPositions.js";
+import "./positions/index.js";
 //#region src/offchain/GearboxAPI.d.ts
 /**
  * Client for the Gearbox backend, the off-chain source of the read model.
@@ -17,14 +19,18 @@ import "./opportunities/index.js";
  * return those types directly, so there is no wire DTO layer here — only
  * transport and schema validation.
  *
- * The transport is not implemented yet; see {@link OffchainOpportunities} for
- * what each stubbed endpoint currently answers.
+ * The transport is not implemented yet; see {@link OffchainOpportunities} and
+ * {@link OffchainPositions} for what each stubbed endpoint currently answers.
  **/
 declare class GearboxAPI {
   /**
    * Namespace for pool and strategy opportunities.
    **/
   readonly opportunities: OffchainOpportunities;
+  /**
+   * Namespace for the positions a wallet holds.
+   **/
+  readonly positions: OffchainPositions;
   constructor(options?: GearboxAPIOptions);
 }
 //#endregion

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

@@ -1,5 +1,7 @@
-import { GearboxAPIOptions, OffchainResult, OffchainSourceMeta } from "./types.js";
-import { OffchainNotImplementedError, OffchainOpportunities } from "./opportunities/OffchainOpportunities.js";
+import { GearboxAPIOptions, OffchainNotImplementedError, OffchainResult, OffchainSourceMeta } from "./types.js";
+import { OffchainOpportunities } from "./opportunities/OffchainOpportunities.js";
 import "./opportunities/index.js";
+import { OffchainPositions } from "./positions/OffchainPositions.js";
+import "./positions/index.js";
 import { GearboxAPI } from "./GearboxAPI.js";
-export { GearboxAPI, GearboxAPIOptions, OffchainNotImplementedError, OffchainOpportunities, OffchainResult, OffchainSourceMeta };
+export { GearboxAPI, GearboxAPIOptions, OffchainNotImplementedError, OffchainOpportunities, OffchainPositions, OffchainResult, OffchainSourceMeta };

package/dist/types/offchain/opportunities/OffchainOpportunities.d.ts

@@ -2,14 +2,6 @@ import { Opportunity, OpportunityFilter, PoolOpportunityDetail, PoolOpportunityK
 import { HistoryMetric, HistorySeries, OpportunityHistoryQuery } from "../../model/history.js";
 import { GearboxAPIOptions, OffchainResult } from "../types.js";
 //#region src/offchain/opportunities/OffchainOpportunities.d.ts
-/**
- * Thrown by the endpoints that have no stub answer, so that a caller in
- * `offchain` mode fails loudly instead of reading an empty detail page as a
- * missing opportunity.
- **/
-declare class OffchainNotImplementedError extends Error {
-  constructor(endpoint: string);
-}
 /**
  * Backend counterpart of the `opportunities` namespace.
  *
@@ -66,4 +58,4 @@ declare class OffchainOpportunities {
   getHistory<M extends HistoryMetric>(query: OpportunityHistoryQuery<M>): Promise<OffchainResult<HistorySeries<M>>>;
 }
 //#endregion
-export { OffchainNotImplementedError, OffchainOpportunities };
+export { OffchainOpportunities };

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

@@ -1,2 +1,2 @@
-import { OffchainNotImplementedError, OffchainOpportunities } from "./OffchainOpportunities.js";
-export { OffchainNotImplementedError, OffchainOpportunities };
+import { OffchainOpportunities } from "./OffchainOpportunities.js";
+export { OffchainOpportunities };

package/dist/types/offchain/positions/OffchainPositions.d.ts

@@ -0,0 +1,47 @@
+import { Position, PositionFilter } from "../../model/positions.js";
+import { HistorySeries, PositionHistoryMetric, PositionHistoryQuery } from "../../model/history.js";
+import { GearboxAPIOptions, OffchainResult } from "../types.js";
+import { Address } from "viem";
+//#region src/offchain/positions/OffchainPositions.d.ts
+/**
+ * Backend counterpart of the `positions` namespace.
+ *
+ * This is a stub: the HTTP client is not written yet, so reads answer with an
+ * empty payload. Every signature is already the final one, because the backend
+ * returns the read model types directly — there is no wire DTO and no mapper
+ * between the two.
+ *
+ * When the transport lands, each method will validate the response against the
+ * matching schema from `src/model` before returning it. A validation failure is
+ * a version-skew error and is handled exactly like a transport error: the
+ * combined SDK drops the backend's contribution in `both` mode and rethrows in
+ * `offchain` mode.
+ **/
+declare class OffchainPositions {
+  #private;
+  constructor(options?: GearboxAPIOptions);
+  /**
+   * Base URL the client will call once the transport is implemented.
+   **/
+  get baseUrl(): string | undefined;
+  /**
+   * Everything a wallet holds, optionally narrowed by {@link PositionFilter}.
+   *
+   * @returns An empty list until the backend client is implemented.
+   **/
+  list(wallet: Address, filter?: PositionFilter): Promise<OffchainResult<Position[]>>;
+  /**
+   * One historical series of one position. History exists only here: rebuilding
+   * it from the chain would mean an archive read per point.
+   *
+   * The requested metric types the response, so a caller asking for one metric
+   * does not have to narrow the union back down. When the transport lands,
+   * validation is what upholds it: a response carrying a different metric than
+   * the one asked for is a version-skew error like any other.
+   *
+   * @returns An empty series until the backend client is implemented.
+   **/
+  getHistory<M extends PositionHistoryMetric>(query: PositionHistoryQuery<M>): Promise<OffchainResult<HistorySeries<M>>>;
+}
+//#endregion
+export { OffchainPositions };

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

@@ -0,0 +1,2 @@
+import { OffchainPositions } from "./OffchainPositions.js";
+export { OffchainPositions };

package/dist/types/offchain/types.d.ts

@@ -31,6 +31,17 @@ interface OffchainResult<T> {
    **/
   meta: OffchainSourceMeta;
 }
+/**
+ * Thrown by the endpoints that have no stub answer, so that a caller in
+ * `offchain` mode fails loudly instead of reading an empty detail page as a
+ * missing entity.
+ *
+ * Lives here rather than in one namespace because every stubbed namespace
+ * throws it.
+ **/
+declare class OffchainNotImplementedError extends Error {
+  constructor(endpoint: string);
+}
 /**
  * Options for creating a {@link GearboxAPI} instance.
  **/
@@ -47,4 +58,4 @@ interface GearboxAPIOptions {
   logger?: ILogger;
 }
 //#endregion
-export { GearboxAPIOptions, OffchainResult, OffchainSourceMeta };
+export { GearboxAPIOptions, OffchainNotImplementedError, OffchainResult, OffchainSourceMeta };

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

@@ -8,6 +8,8 @@ import { RedstoneOptions } from "./market/pricefeeds/updates/RedstoneUpdater.js"
 import "./market/pricefeeds/updates/index.js";
 import { MultichainOpportunitiesService } from "./opportunities/MultichainOpportunitiesService.js";
 import "./opportunities/index.js";
+import { MultichainPositionsService } from "./positions/MultichainPositionsService.js";
+import "./positions/index.js";
 import { AttachOptions, ClientOptions, HydrateOptions, OnchainSDK } from "./OnchainSDK.js";
 import { MultichainState } from "./types/state.js";
 import "./types/index.js";
@@ -123,6 +125,10 @@ declare class MultichainSDK<const Plugins extends PluginsMap = {}> {
    * chains.
    */
   readonly opportunities: MultichainOpportunitiesService<Plugins>;
+  /**
+   * Namespace for the positions a wallet holds on all configured chains.
+   */
+  readonly positions: MultichainPositionsService<Plugins>;
   constructor(options: MultichainSDKOptions<Plugins>);
   /**
    * Attach all configured chains in parallel.