@gearbox-protocol/sdk 16.0.0-next.53 → 16.0.0-next.55

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");
@@ -15,8 +15,8 @@ const tagDiff = require_dev_mode_parity_compareRules.makeTagDiff({
 *
 * Nothing is filtered out. A field only the backend can fill, or a USD value
 * that drifted within snapshot-lag noise, is still reported — tagged
-* {@link FieldDiff.expected} so that {@link CompareCounts.clean} can ignore it
-* while {@link CompareCounts.identical} stays strict.
+* {@link FieldDiff.expected} so that {@link CompareCounts.similar} can ignore
+* it.
 **/
 function compareOpportunities(input) {
 	const onchainRows = indexById(input.onchain.data);
@@ -37,8 +37,7 @@ function compareOpportunities(input) {
 			chainId: row.chainId,
 			onchainName: row.name,
 			offchainName: counterpart.name,
-			identical: diffs.length === 0,
-			clean: diffs.every((diff) => diff.expected),
+			similar: diffs.every((diff) => diff.expected),
 			diffs
 		});
 	}

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");
@@ -18,8 +18,8 @@ const tagDiff = require_dev_mode_parity_compareRules.makeTagDiff({
 * Nothing is filtered out. A field only one mode can fill, a strategy field
 * both-mode merge overlays from the backend, or a USD value that drifted
 * within snapshot-lag noise, is still reported — tagged
-* {@link FieldDiff.expected} so that {@link CompareCounts.clean} can ignore it
-* while {@link CompareCounts.identical} stays strict.
+* {@link FieldDiff.expected} so that {@link CompareCounts.similar} can ignore
+* it.
 **/
 function comparePositions(input) {
 	const failures = input.failures ?? [];
@@ -66,8 +66,7 @@ function compareWallet(input) {
 			chainId: row.chainId,
 			onchainName: row.name,
 			offchainName: counterpart.name,
-			identical: diffs.length === 0,
-			clean: diffs.every((diff) => diff.expected),
+			similar: diffs.every((diff) => diff.expected),
 			diffs
 		});
 	}
@@ -130,11 +129,11 @@ function summarize(inputs, wallets, failed) {
 		...wallet.error ? { error: wallet.error } : {},
 		...require_dev_mode_parity_fieldDiff.toCompareCounts(wallet.matched.length + wallet.onlyOnchain.length, wallet.matched.length + wallet.onlyOffchain.length, wallet.onlyOnchain.length, wallet.onlyOffchain.length, wallet.matched)
 	}));
-	const walletsClean = compared.filter((wallet) => wallet.onlyOnchain.length === 0 && wallet.onlyOffchain.length === 0 && wallet.matched.every((match) => match.clean)).length;
+	const walletsSimilar = compared.filter((wallet) => wallet.onlyOnchain.length === 0 && wallet.onlyOffchain.length === 0 && wallet.matched.every((match) => match.similar)).length;
 	return {
 		...require_dev_mode_parity_fieldDiff.toCompareCounts(allOnchain.length, allOffchain.length, onlyOnchain.length, onlyOffchain.length, matched),
 		wallets: wallets.length,
-		walletsClean,
+		walletsSimilar,
 		walletsFailed: failed,
 		byChain,
 		byWallet,

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

@@ -54,7 +54,7 @@ function diffObjects(onchain, offchain, options) {
 	return diffs;
 }
 /**
-* Mark a diff expected, so a later `clean` count can ignore it.
+* Mark a diff expected, so a later `similar` count can ignore it.
 **/
 function withExpected(diff, reason) {
 	return {
@@ -118,15 +118,13 @@ function collapseArrayKeys(path) {
 * Membership and match totals of one comparison, from already-built lists.
 **/
 function toCompareCounts(onchainRows, offchainRows, onlyOnchain, onlyOffchain, matched) {
-	const identical = matched.filter((match) => match.identical).length;
-	const clean = matched.filter((match) => match.clean).length;
+	const similar = matched.filter((match) => match.similar).length;
 	return {
 		onchainRows,
 		offchainRows,
 		matched: matched.length,
-		identical,
-		clean,
-		differing: matched.length - identical,
+		similar,
+		different: matched.length - similar,
 		onlyOnchain,
 		onlyOffchain
 	};

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

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_dev_providers = require("../providers.js");
+let node_fs = require("node:fs");
 let pino = require("pino");
 //#region src/dev/mode-parity/scriptUtils.ts
 const NETWORKS = [
@@ -77,6 +78,40 @@ function worstColumns(worst) {
 	};
 }
 /**
+* Reasons a compare run should fail CI: unexpected membership or field diffs,
+* both sources empty, a chain that could not be read, or wallets that failed
+* to list. Expected diffs (mode-scoped, backend-preferred, tolerance) do not
+* fail the run.
+**/
+function evaluateCompareFailure(report) {
+	const { summary } = report;
+	const reasons = [];
+	if (summary.onchainRows === 0 && summary.offchainRows === 0) reasons.push("both sources produced no data");
+	if (summary.different > 0) reasons.push(`${summary.different} matched rows are different`);
+	if (summary.onlyOnchain > 0) reasons.push(`${summary.onlyOnchain} rows only onchain`);
+	if (summary.onlyOffchain > 0) reasons.push(`${summary.onlyOffchain} rows only offchain`);
+	if ((summary.walletsFailed ?? 0) > 0) reasons.push(`${summary.walletsFailed} wallets failed to list`);
+	for (const chain of [...report.onchainChains, ...report.offchainChains]) if (chain.status === "error") reasons.push(`chain ${chain.chainId} failed on ${chain.source ?? "unknown"}: ${errorMessage(chain.error)}`);
+	return reasons;
+}
+function splitDiffs(summary) {
+	return {
+		unexpected: summary.diffsByPath.filter((entry) => entry.unexpected > 0),
+		expected: summary.diffsByPath.filter((entry) => entry.unexpected === 0 && entry.expected > 0)
+	};
+}
+function markdownCell(value) {
+	return String(value).replaceAll("|", "\\|").replaceAll("\n", " ");
+}
+function markdownTable(headers, rows) {
+	const line = (cells) => `| ${cells.map(markdownCell).join(" | ")} |`;
+	return [
+		line(headers),
+		line(headers.map(() => "---")),
+		...rows.map(line)
+	].join("\n");
+}
+/**
 * Prints the shared membership table, the fields that differed most often,
 * and any chain that failed to answer.
 **/
@@ -88,15 +123,13 @@ function printCompareSummary(noun, report, extraLines = []) {
 		onchain: chain.onchainRows,
 		offchain: chain.offchainRows,
 		matched: chain.matched,
-		identical: chain.identical,
-		clean: chain.clean,
-		differing: chain.differing,
+		similar: chain.similar,
+		different: chain.different,
 		"only onchain": chain.onlyOnchain,
 		"only offchain": chain.onlyOffchain
 	})));
 	for (const line of extraLines) console.log(line);
-	const unexpected = summary.diffsByPath.filter((entry) => entry.unexpected > 0);
-	const expected = summary.diffsByPath.filter((entry) => entry.unexpected === 0 && entry.expected > 0);
+	const { unexpected, expected } = splitDiffs(summary);
 	if (unexpected.length) {
 		console.log("\nunexpected fields that differed most often:");
 		console.table(unexpected.slice(0, 25).map((entry) => ({
@@ -118,14 +151,121 @@ function printCompareSummary(noun, report, extraLines = []) {
 	}
 	for (const chain of [...report.onchainChains, ...report.offchainChains]) if (chain.status === "error") console.log(`chain ${chain.chainId} failed on ${chain.source}:`, chain.error);
 }
+/**
+* Markdown of the same summary printed to the console, for GitHub job summaries.
+**/
+function formatCompareMarkdown(noun, report, extraLines = [], reasons = []) {
+	const { summary } = report;
+	const { unexpected, expected } = splitDiffs(summary);
+	const parts = [
+		`# ${noun} compare`,
+		"",
+		reasons.length ? "**Failed**" : "**Passed**",
+		"",
+		`${noun} from \`${report.backendUrl}\` vs the chain`,
+		""
+	];
+	if (reasons.length) {
+		parts.push("## Failures", "");
+		for (const reason of reasons) parts.push(`- ${reason}`);
+		parts.push("");
+	}
+	if (extraLines.length) {
+		for (const line of extraLines) parts.push(line);
+		parts.push("");
+	}
+	if (summary.byChain.length) parts.push(markdownTable([
+		"chain",
+		"onchain",
+		"offchain",
+		"matched",
+		"similar",
+		"different",
+		"only onchain",
+		"only offchain"
+	], summary.byChain.map((chain) => [
+		chain.chainId,
+		chain.onchainRows,
+		chain.offchainRows,
+		chain.matched,
+		chain.similar,
+		chain.different,
+		chain.onlyOnchain,
+		chain.onlyOffchain
+	])), "");
+	if (unexpected.length) parts.push("## Unexpected fields that differed most often", "", markdownTable([
+		"field",
+		"unexpected",
+		"expected",
+		"kinds",
+		"max diff",
+		"worst entity"
+	], unexpected.slice(0, 25).map((entry) => {
+		const worst = worstColumns(entry.worstUnexpected);
+		return [
+			entry.path,
+			entry.unexpected,
+			entry.expected,
+			entry.kinds.join(", "),
+			worst["max diff"],
+			worst["worst entity"]
+		];
+	})), "");
+	if (expected.length) parts.push("## Expected fields (mode-scoped, backend-preferred, or within tolerance)", "", markdownTable([
+		"field",
+		"rows",
+		"kinds",
+		"max diff",
+		"worst entity"
+	], expected.slice(0, 25).map((entry) => {
+		const worst = worstColumns(entry.worstExpected);
+		return [
+			entry.path,
+			entry.expected,
+			entry.kinds.join(", "),
+			worst["max diff"],
+			worst["worst entity"]
+		];
+	})), "");
+	const failedChains = [...report.onchainChains, ...report.offchainChains].filter((chain) => chain.status === "error");
+	if (failedChains.length) {
+		parts.push("## Chain errors", "");
+		for (const chain of failedChains) parts.push(`- chain ${chain.chainId} failed on ${chain.source ?? "unknown"}: ${errorMessage(chain.error)}`);
+		parts.push("");
+	}
+	return parts.join("\n");
+}
+/**
+* Appends {@link formatCompareMarkdown} to `GITHUB_STEP_SUMMARY` when running
+* in GitHub Actions. No-op locally.
+**/
+function writeGithubJobSummary(noun, report, extraLines = [], reasons = []) {
+	const path = process.env.GITHUB_STEP_SUMMARY;
+	if (!path) return;
+	(0, node_fs.appendFileSync)(path, `${formatCompareMarkdown(noun, report, extraLines, reasons)}\n`);
+}
+/**
+* Console + job-summary output for a compare run. Returns the failure reasons
+* so the caller can exit 1 when the report is not similar.
+**/
+function reportCompare(noun, report, extraLines = []) {
+	printCompareSummary(noun, report, extraLines);
+	const reasons = evaluateCompareFailure(report);
+	writeGithubJobSummary(noun, report, extraLines, reasons);
+	return reasons;
+}
 //#endregion
 exports.BACKEND_URL = BACKEND_URL;
 exports.NETWORKS = NETWORKS;
 exports.TIMEOUT = TIMEOUT;
 exports.createLogger = createLogger;
 exports.errorMessage = errorMessage;
+exports.evaluateCompareFailure = evaluateCompareFailure;
 exports.formatBpsAsPercent = formatBpsAsPercent;
+exports.formatCompareMarkdown = formatCompareMarkdown;
 exports.mapPool = mapPool;
 exports.printCompareSummary = printCompareSummary;
+exports.reportCompare = reportCompare;
 exports.requireEnv = requireEnv;
 exports.rpcUrls = rpcUrls;
+exports.writeGithubJobSummary = writeGithubJobSummary;

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/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/rewards/errors.js

@@ -0,0 +1,27 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let viem = require("viem");
+//#region src/rewards/errors.ts
+/**
+* Thrown when none of Merkl's domains answered for a chain.
+*
+* Everything a reader needs is in the message: this error travels to consumers
+* inside a chain's {@link ChainFailed} metadata, where it is typed `unknown`
+* and may be serialised by something that turns an arbitrary object into `{}`.
+*/
+var MerklRequestFailedError = class extends viem.BaseError {
+	name = "MerklRequestFailedError";
+	chainId;
+	constructor(chainId, path, attempts) {
+		super(`Merkl could not be reached for chain ${chainId}.`, {
+			cause: attempts.find(([, c]) => c instanceof Error)?.[1],
+			metaMessages: attempts.map(([domain, cause]) => `${domain}${path} — ${describe(cause)}`)
+		});
+		this.chainId = chainId;
+	}
+};
+function describe(cause) {
+	if (cause instanceof Error) return cause.name === "TimeoutError" ? "timed out" : cause.message;
+	return String(cause);
+}
+//#endregion
+exports.MerklRequestFailedError = MerklRequestFailedError;

package/dist/cjs/rewards/index.js

@@ -1,8 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("./apy/index.js");
-const require_rewards_rewards_api = require("./rewards/api.js");
-const require_rewards_rewards_extra_apy = require("./rewards/extra-apy.js");
-require("./rewards/index.js");
-exports.PoolPointsAPI = require_rewards_rewards_extra_apy.PoolPointsAPI;
-exports.getKeyForPoolPointsInfo = require_rewards_rewards_extra_apy.getKeyForPoolPointsInfo;
-exports.getMerklRewards = require_rewards_rewards_api.getMerklRewards;
+const require_rewards_errors = require("./errors.js");
+const require_rewards_toMerklRewards = require("./toMerklRewards.js");
+const require_rewards_multichain = require("./multichain.js");
+exports.MerklRequestFailedError = require_rewards_errors.MerklRequestFailedError;
+exports.getMerklRewardsMultichain = require_rewards_multichain.getMerklRewardsMultichain;
+exports.toMerklRewards = require_rewards_toMerklRewards.toMerklRewards;