@gearbox-protocol/sdk 16.0.0-next.52 → 16.0.0-next.54

package/dist/cjs/dev/mode-parity/compareOpportunities.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_model_opportunities = require("../../model/opportunities.js");
 const require_model_opportunities_schema = require("../../model/opportunities.schema.js");
+const require_model_opportunities = require("../../model/opportunities.js");
 require("../../model/index.js");
 const require_dev_mode_parity_fieldDiff = require("./fieldDiff.js");
 const require_dev_mode_parity_compareRules = require("./compareRules.js");

package/dist/cjs/dev/mode-parity/comparePositions.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_liquidations_schema = require("../../model/liquidations.schema.js");
-const require_model_positions = require("../../model/positions.js");
 const require_model_positions_schema = require("../../model/positions.schema.js");
+const require_model_positions = require("../../model/positions.js");
 require("../../model/index.js");
 const require_dev_mode_parity_fieldDiff = require("./fieldDiff.js");
 const require_dev_mode_parity_compareRules = require("./compareRules.js");

package/dist/cjs/model/analytics.js

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

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

@@ -0,0 +1,117 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_utils_zod = require("../onchain/utils/zod.js");
+const require_model_filters = require("./filters.js");
+const require_model_filters_schema = require("./filters.schema.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
+const require_model_liquidations_schema = require("./liquidations.schema.js");
+const require_model_positions_schema = require("./positions.schema.js");
+let viem = require("viem");
+let zod_v4 = require("zod/v4");
+//#region src/model/analytics.schema.ts
+/** Default page size of the protocol-wide positions list. */
+const ANALYTICS_POSITIONS_DEFAULT_LIMIT = 25;
+/** Largest page the protocol-wide positions list accepts. */
+const ANALYTICS_POSITIONS_MAX_LIMIT = 100;
+/** {@link AnalyticsPositionSortField} */
+const analyticsPositionSortFieldSchema = zod_v4.z.enum([
+	"netValueUsd",
+	"totalValueUsd",
+	"totalDebtUsd",
+	"pnlUsd",
+	"apy",
+	"healthFactor",
+	"leverage",
+	"chainId",
+	"name",
+	"borrower"
+]);
+/** {@link AnalyticsSortDirection} */
+const analyticsSortDirectionSchema = zod_v4.z.enum(["asc", "desc"]);
+const analyticsOwnerShape = { borrower: require_onchain_utils_zod.ZodAddress() };
+const addressSchema = zod_v4.z.custom((value) => typeof value === "string" && (0, viem.isAddress)(value, { strict: false }));
+/** {@link AnalyticsPosition} */
+const analyticsPositionSchema = zod_v4.z.discriminatedUnion("kind", [
+	zod_v4.z.object({
+		...require_model_positions_schema.poolPositionSchema.shape,
+		...analyticsOwnerShape
+	}),
+	zod_v4.z.object({
+		...require_model_positions_schema.strategyPositionSchema.shape,
+		...analyticsOwnerShape
+	}),
+	zod_v4.z.object({
+		...require_model_liquidations_schema.liquidationPositionSchema.shape,
+		...analyticsOwnerShape
+	})
+]);
+/** {@link AnalyticsPositionListOptions} */
+const analyticsPositionListOptionsSchema = zod_v4.z.object({
+	borrower: addressSchema.optional(),
+	kind: require_model_filters_schema.filterable(require_model_positions_schema.positionKindSchema).optional(),
+	isZeroDebt: require_model_filters_schema.filterable(zod_v4.z.boolean()).optional(),
+	chainIds: zod_v4.z.array(require_model_primitives_schema.chainIdSchema).optional(),
+	underlyingType: require_model_filters_schema.filterable(require_model_primitives_schema.assetTypeSchema).optional(),
+	sortBy: analyticsPositionSortFieldSchema.optional(),
+	sortDirection: analyticsSortDirectionSchema.optional(),
+	offset: zod_v4.z.number().int().nonnegative().optional(),
+	limit: zod_v4.z.number().int().positive().max(100).optional()
+});
+/**
+* {@link AnalyticsPositionListOptions} as URL query parameters.
+**/
+const analyticsPositionListQueryParamsSchema = zod_v4.z.object({
+	borrower: zod_v4.z.string().refine((value) => (0, viem.isAddress)(value, { strict: false }), "invalid address").optional(),
+	kind: require_model_positions_schema.positionKindSchema.optional(),
+	isZeroDebt: zod_v4.z.enum(["true", "false"]).optional(),
+	chainIds: zod_v4.z.string().regex(/^$|^\d+(,\d+)*$/).optional(),
+	underlyingType: require_model_primitives_schema.assetTypeSchema.optional(),
+	sortBy: analyticsPositionSortFieldSchema.optional(),
+	sortDirection: analyticsSortDirectionSchema.optional(),
+	offset: zod_v4.z.string().regex(/^\d+$/).optional(),
+	limit: zod_v4.z.string().regex(/^[1-9]\d*$/).optional()
+});
+/**
+* Codec for an analytics position-list query. It is shared by the SDK client
+* and backend controller so both sides interpret every parameter identically.
+**/
+const analyticsPositionListQuerySchema = zod_v4.z.codec(analyticsPositionListQueryParamsSchema, analyticsPositionListOptionsSchema, {
+	decode: (params) => ({
+		...params.borrower === void 0 ? {} : { borrower: params.borrower },
+		...params.kind === void 0 ? {} : { kind: params.kind },
+		...params.isZeroDebt === void 0 ? {} : { isZeroDebt: params.isZeroDebt === "true" },
+		...params.chainIds === void 0 ? {} : { chainIds: params.chainIds === "" ? [] : params.chainIds.split(",").map(Number) },
+		...params.underlyingType === void 0 ? {} : { underlyingType: params.underlyingType },
+		...params.sortBy === void 0 ? {} : { sortBy: params.sortBy },
+		...params.sortDirection === void 0 ? {} : { sortDirection: params.sortDirection },
+		...params.offset === void 0 ? {} : { offset: Number(params.offset) },
+		...params.limit === void 0 ? {} : { limit: Number(params.limit) }
+	}),
+	encode: (options) => ({
+		borrower: options.borrower,
+		kind: require_model_filters.isFilterSet(options.kind) ? options.kind : void 0,
+		isZeroDebt: require_model_filters_schema.encodeFlag(options.isZeroDebt),
+		chainIds: options.chainIds?.join(","),
+		underlyingType: require_model_filters.isFilterSet(options.underlyingType) ? options.underlyingType : void 0,
+		sortBy: options.sortBy,
+		sortDirection: options.sortDirection,
+		offset: options.offset?.toString(),
+		limit: options.limit?.toString()
+	})
+});
+/** {@link AnalyticsPositionPage} */
+const analyticsPositionPageSchema = zod_v4.z.object({
+	items: zod_v4.z.array(analyticsPositionSchema),
+	total: zod_v4.z.number().int().nonnegative(),
+	offset: zod_v4.z.number().int().nonnegative(),
+	limit: zod_v4.z.number().int().positive().max(100)
+});
+//#endregion
+exports.ANALYTICS_POSITIONS_DEFAULT_LIMIT = ANALYTICS_POSITIONS_DEFAULT_LIMIT;
+exports.ANALYTICS_POSITIONS_MAX_LIMIT = ANALYTICS_POSITIONS_MAX_LIMIT;
+exports.analyticsPositionListOptionsSchema = analyticsPositionListOptionsSchema;
+exports.analyticsPositionListQueryParamsSchema = analyticsPositionListQueryParamsSchema;
+exports.analyticsPositionListQuerySchema = analyticsPositionListQuerySchema;
+exports.analyticsPositionPageSchema = analyticsPositionPageSchema;
+exports.analyticsPositionSchema = analyticsPositionSchema;
+exports.analyticsPositionSortFieldSchema = analyticsPositionSortFieldSchema;
+exports.analyticsSortDirectionSchema = analyticsSortDirectionSchema;

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

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_model_charts = require("./charts.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
+const require_model_charts = require("./charts.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/charts.schema.ts
 /**

package/dist/cjs/model/index.js

@@ -1,22 +1,24 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_model_charts = require("./charts.js");
+require("./analytics.js");
+const require_model_filters = require("./filters.js");
+const require_model_filters_schema = require("./filters.schema.js");
 const require_model_compare_schema = require("./compare.schema.js");
+const require_model_curators_schema = require("./curators.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
+const require_model_liquidations_schema = require("./liquidations.schema.js");
+const require_model_opportunities_schema = require("./opportunities.schema.js");
+const require_model_positions_schema = require("./positions.schema.js");
+const require_model_analytics_schema = require("./analytics.schema.js");
+const require_model_charts = require("./charts.js");
 const require_model_charts_schema = require("./charts.schema.js");
 require("./curators.js");
-const require_model_curators_schema = require("./curators.schema.js");
 require("./delayed-intents.js");
 require("./errors.js");
-const require_model_filters = require("./filters.js");
-const require_model_filters_schema = require("./filters.schema.js");
 const require_model_liquidations = require("./liquidations.js");
-const require_model_liquidations_schema = require("./liquidations.schema.js");
 require("./notices.js");
 const require_model_notices_schema = require("./notices.schema.js");
 const require_model_opportunities = require("./opportunities.js");
-const require_model_opportunities_schema = require("./opportunities.schema.js");
 const require_model_positions = require("./positions.js");
-const require_model_positions_schema = require("./positions.schema.js");
 const require_model_previews = require("./previews.js");
 require("./primitives.js");
 require("./response.js");
@@ -24,6 +26,8 @@ const require_model_response_schema = require("./response.schema.js");
 const require_model_result = require("./result.js");
 require("./withdrawals.js");
 const require_model_withdrawals_schema = require("./withdrawals.schema.js");
+exports.ANALYTICS_POSITIONS_DEFAULT_LIMIT = require_model_analytics_schema.ANALYTICS_POSITIONS_DEFAULT_LIMIT;
+exports.ANALYTICS_POSITIONS_MAX_LIMIT = require_model_analytics_schema.ANALYTICS_POSITIONS_MAX_LIMIT;
 exports.CHART_METRIC_UNITS = require_model_charts.CHART_METRIC_UNITS;
 exports.CHART_RANGES = require_model_charts.CHART_RANGES;
 exports.CHART_UNAVAILABLE_CODES = require_model_charts.CHART_UNAVAILABLE_CODES;
@@ -34,6 +38,13 @@ exports.STRATEGY_OPPORTUNITY_CHART_METRICS = require_model_charts.STRATEGY_OPPOR
 exports.STRATEGY_POSITION_CHART_METRICS = require_model_charts.STRATEGY_POSITION_CHART_METRICS;
 exports.STRATEGY_POSITION_COLLATERAL_ERROR = require_model_positions.STRATEGY_POSITION_COLLATERAL_ERROR;
 exports.amountSchema = require_model_primitives_schema.amountSchema;
+exports.analyticsPositionListOptionsSchema = require_model_analytics_schema.analyticsPositionListOptionsSchema;
+exports.analyticsPositionListQueryParamsSchema = require_model_analytics_schema.analyticsPositionListQueryParamsSchema;
+exports.analyticsPositionListQuerySchema = require_model_analytics_schema.analyticsPositionListQuerySchema;
+exports.analyticsPositionPageSchema = require_model_analytics_schema.analyticsPositionPageSchema;
+exports.analyticsPositionSchema = require_model_analytics_schema.analyticsPositionSchema;
+exports.analyticsPositionSortFieldSchema = require_model_analytics_schema.analyticsPositionSortFieldSchema;
+exports.analyticsSortDirectionSchema = require_model_analytics_schema.analyticsSortDirectionSchema;
 exports.apyBreakdownSchema = require_model_opportunities_schema.apyBreakdownSchema;
 exports.asEstimated = require_model_previews.asEstimated;
 exports.assetTypeSchema = require_model_primitives_schema.assetTypeSchema;

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

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_zod = require("../onchain/utils/zod.js");
-const require_model_primitives_schema = require("./primitives.schema.js");
-const require_model_curators_schema = require("./curators.schema.js");
 const require_model_filters_schema = require("./filters.schema.js");
+const require_model_curators_schema = require("./curators.schema.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/liquidations.schema.ts
 /**

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

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_zod = require("../onchain/utils/zod.js");
-const require_model_compare_schema = require("./compare.schema.js");
-const require_model_primitives_schema = require("./primitives.schema.js");
-const require_model_curators_schema = require("./curators.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
+const require_model_compare_schema = require("./compare.schema.js");
+const require_model_curators_schema = require("./curators.schema.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/opportunities.schema.ts
 /**

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

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_zod = require("../onchain/utils/zod.js");
-const require_model_compare_schema = require("./compare.schema.js");
-const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
+const require_model_compare_schema = require("./compare.schema.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_liquidations_schema = require("./liquidations.schema.js");
 const require_model_opportunities_schema = require("./opportunities.schema.js");
 let zod_v4 = require("zod/v4");

package/dist/cjs/offchain/GearboxAPI.js

@@ -1,4 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_offchain_analytics_OffchainAnalytics = require("./analytics/OffchainAnalytics.js");
+require("./analytics/index.js");
 const require_offchain_notices_OffchainNotices = require("./notices/OffchainNotices.js");
 require("./notices/index.js");
 const require_offchain_opportunities_OffchainOpportunities = require("./opportunities/OffchainOpportunities.js");
@@ -28,6 +30,8 @@ var GearboxAPI = class {
 	* Chains every read of this client is scoped to.
 	**/
 	chainIds;
+	/** Protocol-wide, backend-only analytics. */
+	analytics;
 	/**
 	* Namespace for pool and strategy opportunities.
 	**/
@@ -42,6 +46,7 @@ var GearboxAPI = class {
 	notices;
 	constructor(options) {
 		this.chainIds = [...options.chainIds];
+		this.analytics = new require_offchain_analytics_OffchainAnalytics.OffchainAnalytics(options);
 		this.opportunities = new require_offchain_opportunities_OffchainOpportunities.OffchainOpportunities(options);
 		this.positions = new require_offchain_positions_OffchainPositions.OffchainPositions(options);
 		this.notices = new require_offchain_notices_OffchainNotices.OffchainNotices(options);

package/dist/cjs/offchain/analytics/OffchainAnalytics.js

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_offchain_analytics_OffchainAnalyticsPositions = require("./OffchainAnalyticsPositions.js");
+//#region src/offchain/analytics/OffchainAnalytics.ts
+/** Backend-only protocol analytics, grouped by subject. */
+var OffchainAnalytics = class {
+	positions;
+	constructor(options) {
+		this.positions = new require_offchain_analytics_OffchainAnalyticsPositions.OffchainAnalyticsPositions(options);
+	}
+};
+//#endregion
+exports.OffchainAnalytics = OffchainAnalytics;

package/dist/cjs/offchain/analytics/OffchainAnalyticsPositions.js

@@ -0,0 +1,24 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_analytics_schema = require("../../model/analytics.schema.js");
+const require_offchain_AbstractOffchainNamespace = require("../AbstractOffchainNamespace.js");
+let zod_v4 = require("zod/v4");
+//#region src/offchain/analytics/OffchainAnalyticsPositions.ts
+/** Backend client for protocol-wide position analytics. */
+var OffchainAnalyticsPositions = class extends require_offchain_AbstractOffchainNamespace.AbstractOffchainNamespace {
+	constructor(options) {
+		super("OffchainAnalyticsPositions", options);
+	}
+	/** {@inheritDoc IOffchainAnalyticsPositions.list} */
+	async list(options) {
+		return this.get({
+			path: "/v2/analytics/positions",
+			query: zod_v4.z.encode(require_model_analytics_schema.analyticsPositionListQuerySchema, {
+				...options,
+				chainIds: this.scopedChainIds(options)
+			}),
+			schema: require_model_analytics_schema.analyticsPositionPageSchema
+		});
+	}
+};
+//#endregion
+exports.OffchainAnalyticsPositions = OffchainAnalyticsPositions;

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

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_offchain_analytics_OffchainAnalyticsPositions = require("./OffchainAnalyticsPositions.js");
+const require_offchain_analytics_OffchainAnalytics = require("./OffchainAnalytics.js");
+require("./types.js");
+exports.OffchainAnalytics = require_offchain_analytics_OffchainAnalytics.OffchainAnalytics;
+exports.OffchainAnalyticsPositions = require_offchain_analytics_OffchainAnalyticsPositions.OffchainAnalyticsPositions;

package/dist/cjs/offchain/analytics/types.js

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

package/dist/cjs/offchain/index.js

@@ -11,6 +11,9 @@ const require_offchain_errors_OffchainValidationError = require("./errors/Offcha
 const require_offchain_errors_readResponseBody = require("./errors/readResponseBody.js");
 require("./errors/index.js");
 const require_offchain_AbstractOffchainNamespace = require("./AbstractOffchainNamespace.js");
+const require_offchain_analytics_OffchainAnalyticsPositions = require("./analytics/OffchainAnalyticsPositions.js");
+const require_offchain_analytics_OffchainAnalytics = require("./analytics/OffchainAnalytics.js");
+require("./analytics/index.js");
 const require_offchain_notices_OffchainNotices = require("./notices/OffchainNotices.js");
 require("./notices/index.js");
 const require_offchain_opportunities_OffchainOpportunities = require("./opportunities/OffchainOpportunities.js");
@@ -21,6 +24,8 @@ const require_offchain_GearboxAPI = require("./GearboxAPI.js");
 require("./types.js");
 exports.AbstractOffchainNamespace = require_offchain_AbstractOffchainNamespace.AbstractOffchainNamespace;
 exports.GearboxAPI = require_offchain_GearboxAPI.GearboxAPI;
+exports.OffchainAnalytics = require_offchain_analytics_OffchainAnalytics.OffchainAnalytics;
+exports.OffchainAnalyticsPositions = require_offchain_analytics_OffchainAnalyticsPositions.OffchainAnalyticsPositions;
 exports.OffchainInvalidJsonError = require_offchain_errors_OffchainInvalidJsonError.OffchainInvalidJsonError;
 exports.OffchainNotConfiguredError = require_offchain_errors_OffchainNotConfiguredError.OffchainNotConfiguredError;
 exports.OffchainNotImplementedError = require_offchain_errors_OffchainNotImplementedError.OffchainNotImplementedError;

package/dist/cjs/onchain/market/credit/CreditSuite.js

@@ -291,13 +291,13 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 	}
 	/**
 	* Describes this suite's leveraged strategy as the shared read model does,
-	* or `undefined` when {@link strategyTargetCollateral} cannot be resolved or
-	* {@link maxBorrowAmount} is at or below {@link MIN_STRATEGY_BORROW_AMOUNT}.
+	* or `undefined` when credit suite does not offer a strategy opportunity.
 	*/
 	strategyOpportunity() {
 		if (this.maxBorrowAmount <= MIN_STRATEGY_BORROW_AMOUNT) return;
 		const collateral = this.strategyTargetCollateral;
 		if (!collateral) return;
+		if (!require_onchain_market_credit_collateralUtils.isStrategyCollateral(this.#strategyCollateralProps(collateral), true)) return;
 		const { market, creditManager: cm } = this;
 		const { pool } = market.pool;
 		const oracle = market.priceOracle;

package/dist/cjs/sdk/GearboxSDK.js

@@ -7,6 +7,8 @@ require("../offchain/index.js");
 const require_sdk_errors_assertSameChains = require("./errors/assertSameChains.js");
 const require_sdk_errors_MissingSourceError = require("./errors/MissingSourceError.js");
 require("./errors/index.js");
+const require_sdk_analytics_AnalyticsNamespace = require("./analytics/AnalyticsNamespace.js");
+require("./analytics/index.js");
 const require_sdk_liquidations_LiquidationsNamespace = require("./liquidations/LiquidationsNamespace.js");
 require("./liquidations/index.js");
 require("./utils/mergeChains.js");
@@ -51,6 +53,8 @@ var GearboxSDK = class {
 	* Chains this instance covers, which every read is scoped to.
 	**/
 	networks;
+	/** Protocol-wide analytics. Undefined in `onchain` mode. */
+	analytics;
 	/**
 	* Namespace for pool and strategy opportunities.
 	**/
@@ -131,6 +135,7 @@ var GearboxSDK = class {
 			ensureFresh: this.#onchain ? (chainIds) => this.#ensureFresh(chainIds) : void 0,
 			logger
 		};
+		this.analytics = this.#offchain ? new require_sdk_analytics_AnalyticsNamespace.AnalyticsNamespace(this.#offchain) : void 0;
 		this.opportunities = new require_sdk_opportunities_OpportunitiesNamespace.OpportunitiesNamespace(this.#onchain, this.#offchain, namespaceOptions);
 		this.positions = new require_sdk_positions_PositionsNamespace.PositionsNamespace(this.#onchain, this.#offchain, namespaceOptions);
 		this.liquidations = this.#onchain ? new require_sdk_liquidations_LiquidationsNamespace.LiquidationsNamespace(this.#onchain, namespaceOptions) : void 0;

package/dist/cjs/sdk/analytics/AnalyticsNamespace.js

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/sdk/analytics/AnalyticsNamespace.ts
+/** Backend-only protocol analytics exposed by {@link GearboxSDK}. */
+var AnalyticsNamespace = class {
+	positions;
+	constructor(backend) {
+		this.positions = backend.analytics.positions;
+	}
+};
+//#endregion
+exports.AnalyticsNamespace = AnalyticsNamespace;

package/dist/cjs/sdk/analytics/index.js

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

package/dist/cjs/sdk/analytics/types.js

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

package/dist/cjs/sdk/index.js

@@ -9,6 +9,8 @@ const require_sdk_errors_NoSourceServedError = require("./errors/NoSourceServedE
 const require_sdk_errors_SourceUnavailableError = require("./errors/SourceUnavailableError.js");
 require("./errors/index.js");
 const require_sdk_AbstractNamespace = require("./AbstractNamespace.js");
+const require_sdk_analytics_AnalyticsNamespace = require("./analytics/AnalyticsNamespace.js");
+require("./analytics/index.js");
 const require_sdk_liquidations_LiquidationsNamespace = require("./liquidations/LiquidationsNamespace.js");
 require("./liquidations/index.js");
 const require_sdk_execute_ExecuteApi = require("./execute/ExecuteApi.js");
@@ -29,6 +31,7 @@ const require_sdk_GearboxSDK = require("./GearboxSDK.js");
 require("./types.js");
 exports.AbstractNamespace = require_sdk_AbstractNamespace.AbstractNamespace;
 exports.AllSourcesFailedError = require_sdk_errors_AllSourcesFailedError.AllSourcesFailedError;
+exports.AnalyticsNamespace = require_sdk_analytics_AnalyticsNamespace.AnalyticsNamespace;
 exports.DEFAULT_MAX_OFFCHAIN_LAG = require_sdk_utils_mergeChains.DEFAULT_MAX_OFFCHAIN_LAG;
 exports.DEFAULT_MAX_STATE_AGE = require_sdk_GearboxSDK.DEFAULT_MAX_STATE_AGE;
 exports.ExecuteApi = require_sdk_execute_ExecuteApi.ExecuteApi;

package/dist/esm/dev/mode-parity/compareOpportunities.js

@@ -1,5 +1,5 @@
-import { opportunityId } from "../../model/opportunities.js";
 import { poolOpportunitySchema, strategyOpportunitySchema } from "../../model/opportunities.schema.js";
+import { opportunityId } from "../../model/opportunities.js";
 import "../../model/index.js";
 import { countPaths, diffObjects, toCompareCounts, union } from "./fieldDiff.js";
 import { compileCompareRules, makeTagDiff } from "./compareRules.js";

package/dist/esm/dev/mode-parity/comparePositions.js

@@ -1,6 +1,6 @@
 import { liquidationPositionSchema } from "../../model/liquidations.schema.js";
-import { positionId } from "../../model/positions.js";
 import { poolPositionSchema, strategyPositionSchema } from "../../model/positions.schema.js";
+import { positionId } from "../../model/positions.js";
 import "../../model/index.js";
 import { countPaths, diffObjects, isRecord, toCompareCounts, union } from "./fieldDiff.js";
 import { compileCompareRules, makeTagDiff } from "./compareRules.js";

package/dist/esm/model/analytics.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/model/analytics.schema.js

@@ -0,0 +1,108 @@
+import { ZodAddress } from "../onchain/utils/zod.js";
+import { isFilterSet } from "./filters.js";
+import { encodeFlag, filterable } from "./filters.schema.js";
+import { assetTypeSchema, chainIdSchema } from "./primitives.schema.js";
+import { liquidationPositionSchema } from "./liquidations.schema.js";
+import { poolPositionSchema, positionKindSchema, strategyPositionSchema } from "./positions.schema.js";
+import { isAddress } from "viem";
+import { z } from "zod/v4";
+//#region src/model/analytics.schema.ts
+/** Default page size of the protocol-wide positions list. */
+const ANALYTICS_POSITIONS_DEFAULT_LIMIT = 25;
+/** Largest page the protocol-wide positions list accepts. */
+const ANALYTICS_POSITIONS_MAX_LIMIT = 100;
+/** {@link AnalyticsPositionSortField} */
+const analyticsPositionSortFieldSchema = z.enum([
+	"netValueUsd",
+	"totalValueUsd",
+	"totalDebtUsd",
+	"pnlUsd",
+	"apy",
+	"healthFactor",
+	"leverage",
+	"chainId",
+	"name",
+	"borrower"
+]);
+/** {@link AnalyticsSortDirection} */
+const analyticsSortDirectionSchema = z.enum(["asc", "desc"]);
+const analyticsOwnerShape = { borrower: ZodAddress() };
+const addressSchema = z.custom((value) => typeof value === "string" && isAddress(value, { strict: false }));
+/** {@link AnalyticsPosition} */
+const analyticsPositionSchema = z.discriminatedUnion("kind", [
+	z.object({
+		...poolPositionSchema.shape,
+		...analyticsOwnerShape
+	}),
+	z.object({
+		...strategyPositionSchema.shape,
+		...analyticsOwnerShape
+	}),
+	z.object({
+		...liquidationPositionSchema.shape,
+		...analyticsOwnerShape
+	})
+]);
+/** {@link AnalyticsPositionListOptions} */
+const analyticsPositionListOptionsSchema = z.object({
+	borrower: addressSchema.optional(),
+	kind: filterable(positionKindSchema).optional(),
+	isZeroDebt: filterable(z.boolean()).optional(),
+	chainIds: z.array(chainIdSchema).optional(),
+	underlyingType: filterable(assetTypeSchema).optional(),
+	sortBy: analyticsPositionSortFieldSchema.optional(),
+	sortDirection: analyticsSortDirectionSchema.optional(),
+	offset: z.number().int().nonnegative().optional(),
+	limit: z.number().int().positive().max(100).optional()
+});
+/**
+* {@link AnalyticsPositionListOptions} as URL query parameters.
+**/
+const analyticsPositionListQueryParamsSchema = z.object({
+	borrower: z.string().refine((value) => isAddress(value, { strict: false }), "invalid address").optional(),
+	kind: positionKindSchema.optional(),
+	isZeroDebt: z.enum(["true", "false"]).optional(),
+	chainIds: z.string().regex(/^$|^\d+(,\d+)*$/).optional(),
+	underlyingType: assetTypeSchema.optional(),
+	sortBy: analyticsPositionSortFieldSchema.optional(),
+	sortDirection: analyticsSortDirectionSchema.optional(),
+	offset: z.string().regex(/^\d+$/).optional(),
+	limit: z.string().regex(/^[1-9]\d*$/).optional()
+});
+/**
+* Codec for an analytics position-list query. It is shared by the SDK client
+* and backend controller so both sides interpret every parameter identically.
+**/
+const analyticsPositionListQuerySchema = z.codec(analyticsPositionListQueryParamsSchema, analyticsPositionListOptionsSchema, {
+	decode: (params) => ({
+		...params.borrower === void 0 ? {} : { borrower: params.borrower },
+		...params.kind === void 0 ? {} : { kind: params.kind },
+		...params.isZeroDebt === void 0 ? {} : { isZeroDebt: params.isZeroDebt === "true" },
+		...params.chainIds === void 0 ? {} : { chainIds: params.chainIds === "" ? [] : params.chainIds.split(",").map(Number) },
+		...params.underlyingType === void 0 ? {} : { underlyingType: params.underlyingType },
+		...params.sortBy === void 0 ? {} : { sortBy: params.sortBy },
+		...params.sortDirection === void 0 ? {} : { sortDirection: params.sortDirection },
+		...params.offset === void 0 ? {} : { offset: Number(params.offset) },
+		...params.limit === void 0 ? {} : { limit: Number(params.limit) }
+	}),
+	encode: (options) => ({
+		borrower: options.borrower,
+		kind: isFilterSet(options.kind) ? options.kind : void 0,
+		isZeroDebt: encodeFlag(options.isZeroDebt),
+		chainIds: options.chainIds?.join(","),
+		underlyingType: isFilterSet(options.underlyingType) ? options.underlyingType : void 0,
+		sortBy: options.sortBy,
+		sortDirection: options.sortDirection,
+		offset: options.offset?.toString(),
+		limit: options.limit?.toString()
+	})
+});
+/** {@link AnalyticsPositionPage} */
+const analyticsPositionPageSchema = z.object({
+	items: z.array(analyticsPositionSchema),
+	total: z.number().int().nonnegative(),
+	offset: z.number().int().nonnegative(),
+	limit: z.number().int().positive().max(100)
+});
+//#endregion
+export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema };

package/dist/esm/model/charts.schema.js

@@ -1,5 +1,5 @@
-import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS } from "./charts.js";
 import { timestampSchema, tokenSchema } from "./primitives.schema.js";
+import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS } from "./charts.js";
 import { z } from "zod/v4";
 //#region src/model/charts.schema.ts
 /**

package/dist/esm/model/index.js

@@ -1,21 +1,23 @@
-import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS } from "./charts.js";
+import "./analytics.js";
+import { FILTER_ALL, isFilterSet } from "./filters.js";
+import { booleanParamSchema, encodeFlag, filterAllSchema, filterable } from "./filters.schema.js";
 import { backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema, underlyingTokenSchema } from "./primitives.schema.js";
+import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, receivedAssetSchema } from "./liquidations.schema.js";
+import { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema } from "./opportunities.schema.js";
+import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
+import { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema } from "./analytics.schema.js";
+import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS } from "./charts.js";
 import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
 import "./curators.js";
-import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
 import "./delayed-intents.js";
 import "./errors.js";
-import { FILTER_ALL, isFilterSet } from "./filters.js";
-import { booleanParamSchema, encodeFlag, filterAllSchema, filterable } from "./filters.schema.js";
 import { matchesLiquidatableAccountFilter } from "./liquidations.js";
-import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, receivedAssetSchema } from "./liquidations.schema.js";
 import "./notices.js";
 import { noticeKindSchema, noticeSchema } from "./notices.schema.js";
 import { matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
-import { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema } from "./opportunities.schema.js";
 import { STRATEGY_POSITION_COLLATERAL_ERROR, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
-import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
 import { asEstimated } from "./previews.js";
 import "./primitives.js";
 import "./response.js";
@@ -23,4 +25,4 @@ import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourc
 import { isSDKError, safeValue, sdkErr, sdkOk } from "./result.js";
 import "./withdrawals.js";
 import { positionClaimableWithdrawalSchema, positionPendingWithdrawalSchema, positionWithdrawalsSchema, withdrawalOutputAmountSchema } from "./withdrawals.schema.js";
-export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, amountSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, isSDKError, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, withdrawalOutputAmountSchema };
+export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, amountSchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, isSDKError, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, withdrawalOutputAmountSchema };

package/dist/esm/model/liquidations.schema.js

@@ -1,7 +1,7 @@
 import { ZodAddress } from "../onchain/utils/zod.js";
-import { assetTypeSchema, bpsSchema, chainIdSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema, underlyingTokenSchema } from "./primitives.schema.js";
-import { curatorSchema } from "./curators.schema.js";
 import { filterable } from "./filters.schema.js";
+import { curatorSchema } from "./curators.schema.js";
+import { assetTypeSchema, bpsSchema, chainIdSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { z } from "zod/v4";
 //#region src/model/liquidations.schema.ts
 /**