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

package/dist/cjs/model/history.js

@@ -23,6 +23,31 @@ const STRATEGY_HISTORY_METRICS = [
 	"collateralUsdPrice",
 	"underlyingUsdPrice"
 ];
+/**
+* Every {@link PoolPositionHistoryMetric}, for callers that enumerate them.
+**/
+const POOL_POSITION_HISTORY_METRICS = [
+	"depositApy",
+	"borrowApy",
+	"dieselRate",
+	"supplied",
+	"borrowed",
+	"availableLiquidity"
+];
+/**
+* Every {@link StrategyPositionHistoryMetric}, for callers that enumerate them.
+**/
+const STRATEGY_POSITION_HISTORY_METRICS = [
+	"netApy",
+	"borrowApy",
+	"collateralApy",
+	"tvl",
+	"collateralPrice",
+	"collateralUsdPrice",
+	"underlyingUsdPrice"
+];
 //#endregion
 exports.POOL_HISTORY_METRICS = POOL_HISTORY_METRICS;
+exports.POOL_POSITION_HISTORY_METRICS = POOL_POSITION_HISTORY_METRICS;
 exports.STRATEGY_HISTORY_METRICS = STRATEGY_HISTORY_METRICS;
+exports.STRATEGY_POSITION_HISTORY_METRICS = STRATEGY_POSITION_HISTORY_METRICS;

package/dist/cjs/model/history.schema.js

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_opportunities_schema = require("./opportunities.schema.js");
+const require_model_positions_schema = require("./positions.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/history.schema.ts
 /**
@@ -41,9 +42,40 @@ const strategyHistoryMetricSchema = zod_v4.z.union([
 	zod_v4.z.literal("underlyingUsdPrice")
 ]);
 /**
+* {@link PoolPositionHistoryMetric}
+**/
+const poolPositionHistoryMetricSchema = zod_v4.z.union([
+	zod_v4.z.literal("depositApy"),
+	zod_v4.z.literal("borrowApy"),
+	zod_v4.z.literal("dieselRate"),
+	zod_v4.z.literal("supplied"),
+	zod_v4.z.literal("borrowed"),
+	zod_v4.z.literal("availableLiquidity")
+]);
+/**
+* {@link StrategyPositionHistoryMetric}
+**/
+const strategyPositionHistoryMetricSchema = zod_v4.z.union([
+	zod_v4.z.literal("netApy"),
+	zod_v4.z.literal("borrowApy"),
+	zod_v4.z.literal("collateralApy"),
+	zod_v4.z.literal("tvl"),
+	zod_v4.z.literal("collateralPrice"),
+	zod_v4.z.literal("collateralUsdPrice"),
+	zod_v4.z.literal("underlyingUsdPrice")
+]);
+/**
+* {@link PositionHistoryMetric}
+**/
+const positionHistoryMetricSchema = zod_v4.z.union([poolPositionHistoryMetricSchema, strategyPositionHistoryMetricSchema]);
+/**
 * {@link HistoryMetric}
 **/
-const historyMetricSchema = zod_v4.z.union([poolHistoryMetricSchema, strategyHistoryMetricSchema]);
+const historyMetricSchema = zod_v4.z.union([
+	poolHistoryMetricSchema,
+	strategyHistoryMetricSchema,
+	positionHistoryMetricSchema
+]);
 /**
 * {@link HistoryPoint}
 **/
@@ -73,6 +105,14 @@ const opportunityHistoryQuerySchema = zod_v4.z.object({
 	range: historyRangeSchema,
 	metric: historyMetricSchema
 });
+/**
+* {@link PositionHistoryQuery}
+**/
+const positionHistoryQuerySchema = zod_v4.z.object({
+	position: require_model_positions_schema.positionKeySchema,
+	range: historyRangeSchema,
+	metric: positionHistoryMetricSchema
+});
 //#endregion
 exports.historyChartMetadataSchema = historyChartMetadataSchema;
 exports.historyMetricSchema = historyMetricSchema;
@@ -81,4 +121,8 @@ exports.historyRangeSchema = historyRangeSchema;
 exports.historySeriesSchema = historySeriesSchema;
 exports.opportunityHistoryQuerySchema = opportunityHistoryQuerySchema;
 exports.poolHistoryMetricSchema = poolHistoryMetricSchema;
+exports.poolPositionHistoryMetricSchema = poolPositionHistoryMetricSchema;
+exports.positionHistoryMetricSchema = positionHistoryMetricSchema;
+exports.positionHistoryQuerySchema = positionHistoryQuerySchema;
 exports.strategyHistoryMetricSchema = strategyHistoryMetricSchema;
+exports.strategyPositionHistoryMetricSchema = strategyPositionHistoryMetricSchema;

package/dist/cjs/model/index.js

@@ -2,15 +2,17 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_history = require("./history.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_opportunities_schema = require("./opportunities.schema.js");
+const require_model_liquidations_schema = require("./liquidations.schema.js");
+const require_model_positions_schema = require("./positions.schema.js");
 const require_model_history_schema = require("./history.schema.js");
 const require_model_liquidations = require("./liquidations.js");
-const require_model_liquidations_schema = require("./liquidations.schema.js");
 const require_model_opportunities = require("./opportunities.js");
-require("./positions.js");
-const require_model_positions_schema = require("./positions.schema.js");
+const require_model_positions = require("./positions.js");
 require("./primitives.js");
 exports.POOL_HISTORY_METRICS = require_model_history.POOL_HISTORY_METRICS;
+exports.POOL_POSITION_HISTORY_METRICS = require_model_history.POOL_POSITION_HISTORY_METRICS;
 exports.STRATEGY_HISTORY_METRICS = require_model_history.STRATEGY_HISTORY_METRICS;
+exports.STRATEGY_POSITION_HISTORY_METRICS = require_model_history.STRATEGY_POSITION_HISTORY_METRICS;
 exports.amountSchema = require_model_primitives_schema.amountSchema;
 exports.apyBreakdownSchema = require_model_opportunities_schema.apyBreakdownSchema;
 exports.assetTypeSchema = require_model_primitives_schema.assetTypeSchema;
@@ -29,9 +31,11 @@ exports.liquidatableAccountFilterSchema = require_model_liquidations_schema.liqu
 exports.liquidatableAccountSchema = require_model_liquidations_schema.liquidatableAccountSchema;
 exports.liquidationApprovalSchema = require_model_liquidations_schema.liquidationApprovalSchema;
 exports.liquidationDetailsSchema = require_model_liquidations_schema.liquidationDetailsSchema;
+exports.liquidationPositionId = require_model_positions.liquidationPositionId;
 exports.liquidationPositionSchema = require_model_liquidations_schema.liquidationPositionSchema;
 exports.matchesLiquidatableAccountFilter = require_model_liquidations.matchesLiquidatableAccountFilter;
 exports.matchesOpportunityFilter = require_model_opportunities.matchesOpportunityFilter;
+exports.matchesPositionFilter = require_model_positions.matchesPositionFilter;
 exports.opportunityBaseSchema = require_model_opportunities_schema.opportunityBaseSchema;
 exports.opportunityDetailSchema = require_model_opportunities_schema.opportunityDetailSchema;
 exports.opportunityFilterSchema = require_model_opportunities_schema.opportunityFilterSchema;
@@ -50,9 +54,16 @@ exports.poolOpportunityDetailSchema = require_model_opportunities_schema.poolOpp
 exports.poolOpportunityId = require_model_opportunities.poolOpportunityId;
 exports.poolOpportunityKeySchema = require_model_opportunities_schema.poolOpportunityKeySchema;
 exports.poolOpportunitySchema = require_model_opportunities_schema.poolOpportunitySchema;
+exports.poolPositionHistoryMetricSchema = require_model_history_schema.poolPositionHistoryMetricSchema;
+exports.poolPositionId = require_model_positions.poolPositionId;
+exports.poolPositionKeySchema = require_model_positions_schema.poolPositionKeySchema;
 exports.poolPositionSchema = require_model_positions_schema.poolPositionSchema;
 exports.positionCollateralSchema = require_model_positions_schema.positionCollateralSchema;
 exports.positionFilterSchema = require_model_positions_schema.positionFilterSchema;
+exports.positionHistoryMetricSchema = require_model_history_schema.positionHistoryMetricSchema;
+exports.positionHistoryQuerySchema = require_model_history_schema.positionHistoryQuerySchema;
+exports.positionId = require_model_positions.positionId;
+exports.positionKeySchema = require_model_positions_schema.positionKeySchema;
 exports.positionKindSchema = require_model_positions_schema.positionKindSchema;
 exports.positionSchema = require_model_positions_schema.positionSchema;
 exports.priceFeedDataSchema = require_model_opportunities_schema.priceFeedDataSchema;
@@ -68,6 +79,9 @@ exports.strategyOpportunityDetailSchema = require_model_opportunities_schema.str
 exports.strategyOpportunityId = require_model_opportunities.strategyOpportunityId;
 exports.strategyOpportunityKeySchema = require_model_opportunities_schema.strategyOpportunityKeySchema;
 exports.strategyOpportunitySchema = require_model_opportunities_schema.strategyOpportunitySchema;
+exports.strategyPositionHistoryMetricSchema = require_model_history_schema.strategyPositionHistoryMetricSchema;
+exports.strategyPositionId = require_model_positions.strategyPositionId;
+exports.strategyPositionKeySchema = require_model_positions_schema.strategyPositionKeySchema;
 exports.strategyPositionSchema = require_model_positions_schema.strategyPositionSchema;
 exports.timestampSchema = require_model_primitives_schema.timestampSchema;
 exports.tokenAmountSchema = require_model_primitives_schema.tokenAmountSchema;

package/dist/cjs/model/positions.js

@@ -1 +1,90 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/model/positions.ts
+/**
+* Builds the canonical id of a pool position.
+*
+* @example
+* ```ts
+* poolPositionId(1, "0xda00...") // "1:pool:0xda00..."
+* ```
+**/
+function poolPositionId(chainId, pool) {
+	return `${chainId}:pool:${pool.toLowerCase()}`;
+}
+/**
+* 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..."
+* ```
+**/
+function strategyPositionId(chainId, creditAccount) {
+	return `${chainId}:strategy:${creditAccount.toLowerCase()}`;
+}
+/**
+* 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.
+**/
+function liquidationPositionId(chainId, position) {
+	const { redeemer, sourceToken, claimableAt } = position;
+	return `${chainId}:liquidation:${redeemer ? redeemer.toLowerCase() : `${sourceToken.address.toLowerCase()}:${claimableAt ?? "claimable"}`}`;
+}
+/**
+* Canonical id of any position, dispatching on {@link Position.kind}.
+**/
+function positionId(position) {
+	switch (position.kind) {
+		case "pool": return poolPositionId(position.chainId, position.pool);
+		case "strategy": return strategyPositionId(position.chainId, position.creditAccount);
+		case "liquidation": return liquidationPositionId(position.chainId, position);
+	}
+}
+/**
+* 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.
+**/
+function matchesPositionFilter(position, filter) {
+	if (!filter) return true;
+	if (filter.kind && position.kind !== filter.kind) return false;
+	if (filter.chainIds && !filter.chainIds.includes(position.chainId)) return false;
+	if (filter.isZeroDebt !== void 0 && position.kind === "strategy" && position.totalDebt.value === 0n !== filter.isZeroDebt) return false;
+	if (filter.underlyingType) {
+		const underlying = positionUnderlying(position);
+		if (underlying && underlying.assetType !== filter.underlyingType) return false;
+	}
+	return true;
+}
+/**
+* Token a position's headline amount is denominated in, or `undefined` for a
+* kind that has no single underlying.
+**/
+function positionUnderlying(position) {
+	switch (position.kind) {
+		case "pool": return position.netValue.token;
+		case "strategy": return position.totalValue.token;
+		case "liquidation": return;
+	}
+}
+//#endregion
+exports.liquidationPositionId = liquidationPositionId;
+exports.matchesPositionFilter = matchesPositionFilter;
+exports.poolPositionId = poolPositionId;
+exports.positionId = positionId;
+exports.strategyPositionId = strategyPositionId;

package/dist/cjs/model/positions.schema.js

@@ -106,15 +106,43 @@ const positionFilterSchema = zod_v4.z.object({
 	chainIds: zod_v4.z.array(require_model_primitives_schema.chainIdSchema).optional(),
 	underlyingType: require_model_primitives_schema.assetTypeSchema.optional()
 });
+/**
+* {@link PoolPositionKey}
+**/
+const poolPositionKeySchema = zod_v4.z.object({
+	chainId: require_model_primitives_schema.chainIdSchema,
+	pool: require_sdk_utils_zod.ZodAddress(),
+	wallet: require_sdk_utils_zod.ZodAddress()
+});
+/**
+* {@link StrategyPositionKey}
+**/
+const strategyPositionKeySchema = zod_v4.z.object({
+	chainId: require_model_primitives_schema.chainIdSchema,
+	creditAccount: require_sdk_utils_zod.ZodAddress()
+});
+/**
+* {@link PositionKey}
+**/
+const positionKeySchema = zod_v4.z.discriminatedUnion("kind", [zod_v4.z.object({
+	kind: zod_v4.z.literal("pool"),
+	...poolPositionKeySchema.shape
+}), zod_v4.z.object({
+	kind: zod_v4.z.literal("strategy"),
+	...strategyPositionKeySchema.shape
+})]);
 //#endregion
 exports.pnlBreakdownSchema = pnlBreakdownSchema;
 exports.pointsProgramPnLSchema = pointsProgramPnLSchema;
 exports.pointsRewardsPnLSchema = pointsRewardsPnLSchema;
+exports.poolPositionKeySchema = poolPositionKeySchema;
 exports.poolPositionSchema = poolPositionSchema;
 exports.positionCollateralSchema = positionCollateralSchema;
 exports.positionFilterSchema = positionFilterSchema;
+exports.positionKeySchema = positionKeySchema;
 exports.positionKindSchema = positionKindSchema;
 exports.positionSchema = positionSchema;
 exports.rewardsPnLSchema = rewardsPnLSchema;
+exports.strategyPositionKeySchema = strategyPositionKeySchema;
 exports.strategyPositionSchema = strategyPositionSchema;
 exports.tokenRewardsPnLSchema = tokenRewardsPnLSchema;

package/dist/cjs/new-sdk/GearboxSDK.js

@@ -5,6 +5,8 @@ const require_offchain_GearboxAPI = require("../offchain/GearboxAPI.js");
 require("../offchain/index.js");
 const require_new_sdk_opportunities_OpportunitiesNamespace = require("./opportunities/OpportunitiesNamespace.js");
 require("./opportunities/index.js");
+const require_new_sdk_positions_PositionsNamespace = require("./positions/PositionsNamespace.js");
+require("./positions/index.js");
 //#region src/new-sdk/GearboxSDK.ts
 /**
 * Combined entry point over both sources of Gearbox data: the chain and the
@@ -46,6 +48,10 @@ var GearboxSDK = class {
 	* Namespace for pool and strategy opportunities.
 	**/
 	opportunities;
+	/**
+	* Namespace for the positions a wallet holds.
+	**/
+	positions;
 	#attachOptions;
 	#onchain;
 	#offchain;
@@ -79,6 +85,7 @@ var GearboxSDK = class {
 		});
 		this.#attached = !this.#ownsOnchain;
 		this.opportunities = new require_new_sdk_opportunities_OpportunitiesNamespace.OpportunitiesNamespace(this.#onchain, this.#offchain, logger);
+		this.positions = new require_new_sdk_positions_PositionsNamespace.PositionsNamespace(this.#onchain, this.#offchain, logger);
 	}
 	/**
 	* Attaches the on-chain SDK when this instance owns one.

package/dist/cjs/new-sdk/index.js

@@ -3,9 +3,12 @@ const require_new_sdk_types = require("./types.js");
 const require_new_sdk_AbstractNamespace = require("./AbstractNamespace.js");
 const require_new_sdk_opportunities_OpportunitiesNamespace = require("./opportunities/OpportunitiesNamespace.js");
 require("./opportunities/index.js");
+const require_new_sdk_positions_PositionsNamespace = require("./positions/PositionsNamespace.js");
+require("./positions/index.js");
 const require_new_sdk_GearboxSDK = require("./GearboxSDK.js");
 require("./utils/index.js");
 exports.AbstractNamespace = require_new_sdk_AbstractNamespace.AbstractNamespace;
 exports.AllSourcesFailedError = require_new_sdk_types.AllSourcesFailedError;
 exports.GearboxSDK = require_new_sdk_GearboxSDK.GearboxSDK;
 exports.OpportunitiesNamespace = require_new_sdk_opportunities_OpportunitiesNamespace.OpportunitiesNamespace;
+exports.PositionsNamespace = require_new_sdk_positions_PositionsNamespace.PositionsNamespace;

package/dist/cjs/new-sdk/positions/PositionsNamespace.js

@@ -0,0 +1,119 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_positions = require("../../model/positions.js");
+require("../../model/index.js");
+const require_new_sdk_AbstractNamespace = require("../AbstractNamespace.js");
+//#region src/new-sdk/positions/PositionsNamespace.ts
+/**
+* Fields the backend owns even when the chain also fills them.
+*
+* The yield and PnL groups are derived from a position's history and from
+* incentive programs, neither of which the chain has. `targetCollateral` is
+* there for a subtler reason: the read model defines it as the collateral the
+* position was opened into, which only the backend can know, while the chain
+* approximates it with the dominant collateral held right now.
+**/
+const OFFCHAIN_OWNED_FIELDS = /* @__PURE__ */ new Set([
+	"apy",
+	"netApy",
+	"pnl",
+	"targetCollateral"
+]);
+/**
+* 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.
+**/
+var PositionsNamespace = class extends require_new_sdk_AbstractNamespace.AbstractNamespace {
+	constructor(onchain, offchain, logger) {
+		super("Positions", onchain, offchain, logger);
+	}
+	/**
+	* {@inheritDoc PositionsBase.list}
+	**/
+	async list(wallet, filter) {
+		return this.readList("list positions", async (sdk) => {
+			const { result, meta } = await sdk.positions.list({
+				wallet,
+				filter
+			});
+			return {
+				value: result,
+				chains: meta
+			};
+		}, (api) => api.positions.list(wallet, filter));
+	}
+	history(key) {
+		return { chart: (metric, range) => this.#chart(key, metric, range) };
+	}
+	/**
+	* Reads one chart of one position from the backend.
+	*
+	* The metric a caller may name is gated by the reader's type, so the kind of
+	* the key is not re-checked here.
+	**/
+	async #chart(key, metric, range) {
+		const { result, meta } = await this.readOffchain(`get ${metric} history`, (api) => api.positions.getHistory({
+			position: key,
+			range,
+			metric
+		}), {
+			metric,
+			points: [],
+			metadata: {}
+		});
+		return {
+			data: result.points,
+			metadata: {
+				...result.metadata,
+				source: meta
+			}
+		};
+	}
+	/**
+	* 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.
+	**/
+	mergeOne(onchain, offchain) {
+		const merged = { ...onchain };
+		for (const [field, value] of Object.entries(offchain)) {
+			if (value === void 0) continue;
+			if (OFFCHAIN_OWNED_FIELDS.has(field) || merged[field] === void 0) merged[field] = value;
+		}
+		return merged;
+	}
+	/**
+	* 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.
+	**/
+	mergeList(onchain, offchain) {
+		const byId = /* @__PURE__ */ new Map();
+		for (const row of onchain) byId.set(require_model_positions.positionId(row), row);
+		const extra = [];
+		for (const row of offchain) {
+			const id = require_model_positions.positionId(row);
+			const existing = byId.get(id);
+			if (existing) byId.set(id, this.mergeOne(existing, row));
+			else extra.push(row);
+		}
+		return [...byId.values(), ...extra];
+	}
+};
+//#endregion
+exports.PositionsNamespace = PositionsNamespace;

package/dist/cjs/new-sdk/positions/index.js

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_new_sdk_positions_PositionsNamespace = require("./PositionsNamespace.js");
+require("./types.js");
+exports.PositionsNamespace = require_new_sdk_positions_PositionsNamespace.PositionsNamespace;

package/dist/cjs/new-sdk/positions/types.js

@@ -0,0 +1 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });

package/dist/cjs/offchain/GearboxAPI.js

@@ -1,6 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_offchain_opportunities_OffchainOpportunities = require("./opportunities/OffchainOpportunities.js");
 require("./opportunities/index.js");
+const require_offchain_positions_OffchainPositions = require("./positions/OffchainPositions.js");
+require("./positions/index.js");
 //#region src/offchain/GearboxAPI.ts
 /**
 * Client for the Gearbox backend, the off-chain source of the read model.
@@ -17,16 +19,21 @@ require("./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.
 **/
 var GearboxAPI = class {
 	/**
 	* Namespace for pool and strategy opportunities.
 	**/
 	opportunities;
+	/**
+	* Namespace for the positions a wallet holds.
+	**/
+	positions;
 	constructor(options) {
 		this.opportunities = new require_offchain_opportunities_OffchainOpportunities.OffchainOpportunities(options);
+		this.positions = new require_offchain_positions_OffchainPositions.OffchainPositions(options);
 	}
 };
 //#endregion

package/dist/cjs/offchain/index.js

@@ -1,8 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_offchain_types = require("./types.js");
 const require_offchain_opportunities_OffchainOpportunities = require("./opportunities/OffchainOpportunities.js");
 require("./opportunities/index.js");
+const require_offchain_positions_OffchainPositions = require("./positions/OffchainPositions.js");
+require("./positions/index.js");
 const require_offchain_GearboxAPI = require("./GearboxAPI.js");
-require("./types.js");
 exports.GearboxAPI = require_offchain_GearboxAPI.GearboxAPI;
-exports.OffchainNotImplementedError = require_offchain_opportunities_OffchainOpportunities.OffchainNotImplementedError;
+exports.OffchainNotImplementedError = require_offchain_types.OffchainNotImplementedError;
 exports.OffchainOpportunities = require_offchain_opportunities_OffchainOpportunities.OffchainOpportunities;
+exports.OffchainPositions = require_offchain_positions_OffchainPositions.OffchainPositions;

package/dist/cjs/offchain/opportunities/OffchainOpportunities.js

@@ -1,17 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_offchain_types = require("../types.js");
 //#region src/offchain/opportunities/OffchainOpportunities.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.
-**/
-var OffchainNotImplementedError = class extends Error {
-	constructor(endpoint) {
-		super(`GearboxAPI: ${endpoint} is not implemented yet`);
-		this.name = "OffchainNotImplementedError";
-	}
-};
-/**
 * Backend counterpart of the `opportunities` namespace.
 *
 * This is a stub: the HTTP client is not written yet, so list reads answer with
@@ -58,7 +48,7 @@ var OffchainOpportunities = class {
 	* implemented.
 	**/
 	async getPool(key) {
-		throw new OffchainNotImplementedError("opportunities.getPool");
+		throw new require_offchain_types.OffchainNotImplementedError("opportunities.getPool");
 	}
 	/**
 	* Detailed view of one strategy opportunity.
@@ -67,7 +57,7 @@ var OffchainOpportunities = class {
 	* implemented.
 	**/
 	async getStrategy(key) {
-		throw new OffchainNotImplementedError("opportunities.getStrategy");
+		throw new require_offchain_types.OffchainNotImplementedError("opportunities.getStrategy");
 	}
 	/**
 	* One historical series of one opportunity. History exists only here:
@@ -93,5 +83,4 @@ var OffchainOpportunities = class {
 	}
 };
 //#endregion
-exports.OffchainNotImplementedError = OffchainNotImplementedError;
 exports.OffchainOpportunities = OffchainOpportunities;

package/dist/cjs/offchain/opportunities/index.js

@@ -1,4 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_offchain_opportunities_OffchainOpportunities = require("./OffchainOpportunities.js");
-exports.OffchainNotImplementedError = require_offchain_opportunities_OffchainOpportunities.OffchainNotImplementedError;
 exports.OffchainOpportunities = require_offchain_opportunities_OffchainOpportunities.OffchainOpportunities;

package/dist/cjs/offchain/positions/OffchainPositions.js

@@ -0,0 +1,69 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/offchain/positions/OffchainPositions.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.
+**/
+var OffchainPositions = class {
+	#baseUrl;
+	#logger;
+	constructor(options) {
+		this.#baseUrl = options?.baseUrl;
+		this.#logger = options?.logger?.child?.({ name: "OffchainPositions" });
+	}
+	/**
+	* Base URL the client will call once the transport is implemented.
+	**/
+	get baseUrl() {
+		return this.#baseUrl;
+	}
+	/**
+	* Everything a wallet holds, optionally narrowed by {@link PositionFilter}.
+	*
+	* @returns An empty list until the backend client is implemented.
+	**/
+	async list(wallet, filter) {
+		this.#logger?.debug({
+			wallet,
+			filter
+		}, "offchain positions list is not implemented, serving empty list");
+		return {
+			result: [],
+			meta: { status: "success" }
+		};
+	}
+	/**
+	* 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.
+	**/
+	async getHistory(query) {
+		this.#logger?.debug({ query }, "offchain positions history is not implemented, serving empty series");
+		return {
+			result: {
+				metric: query.metric,
+				points: [],
+				metadata: {}
+			},
+			meta: { status: "success" }
+		};
+	}
+};
+//#endregion
+exports.OffchainPositions = OffchainPositions;

package/dist/cjs/offchain/positions/index.js

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_offchain_positions_OffchainPositions = require("./OffchainPositions.js");
+exports.OffchainPositions = require_offchain_positions_OffchainPositions.OffchainPositions;

package/dist/cjs/offchain/types.js

@@ -1 +1,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/offchain/types.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 entity.
+*
+* Lives here rather than in one namespace because every stubbed namespace
+* throws it.
+**/
+var OffchainNotImplementedError = class extends Error {
+	constructor(endpoint) {
+		super(`GearboxAPI: ${endpoint} is not implemented yet`);
+		this.name = "OffchainNotImplementedError";
+	}
+};
+//#endregion
+exports.OffchainNotImplementedError = OffchainNotImplementedError;