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

package/dist/cjs/rewards/{rewards/api.js → toMerklRewards.js}

@@ -1,28 +1,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_onchain_utils_AddressMap = require("../../onchain/utils/AddressMap.js");
-const require_onchain_utils_bigint_math = require("../../onchain/utils/bigint-math.js");
-const require_onchain_utils_formatter = require("../../onchain/utils/formatter.js");
-require("../../onchain/index.js");
-const require_rewards_rewards_merkl_api = require("./merkl-api.js");
+const require_onchain_utils_AddressMap = require("../onchain/utils/AddressMap.js");
+const require_onchain_utils_bigint_math = require("../onchain/utils/bigint-math.js");
+const require_onchain_utils_formatter = require("../onchain/utils/formatter.js");
+require("../onchain/index.js");
 let viem = require("viem");
-//#region src/rewards/rewards/api.ts
+//#region src/rewards/toMerklRewards.ts
 /**
-* The wallet's claimable Merkl rewards on one chain.
-*
-* Never rejects on a transport failure: the fetch is settled rather than
-* awaited, and a failure goes to `reportError` and yields an empty list. A
-* caller that must tell "this chain is down" from "this chain has no rewards"
-* has to watch that callback.
+* Merkl's answer for one chain, turned into rows of the read model.
 */
-async function getMerklRewards({ sdk, account, reportError, apiKey }) {
-	const [merkleXYZLMResponse] = await Promise.allSettled([require_rewards_rewards_merkl_api.MerkleXYZApi.fetchWithFallback(require_rewards_rewards_merkl_api.MerkleXYZApi.getUserRewardsUrl({ params: {
-		chainId: sdk.chainId,
-		user: (0, viem.getAddress)(account)
-	} }), apiKey)]);
-	const merkleXYZLm = extractFulfilled(merkleXYZLMResponse, reportError, "merkleXYZLm")?.data;
+function toMerklRewards(sdk, response) {
 	const poolByItsToken = require_onchain_utils_AddressMap.AddressMap.fromMappedArray(sdk.marketRegister.pools.map(({ pool }) => pool.address), (address) => address);
 	const claimable = /* @__PURE__ */ new Map();
-	for (const chainRewards of merkleXYZLm || []) for (const reward of chainRewards.rewards) {
+	for (const chainRewards of response) for (const reward of chainRewards.rewards) {
 		if (!(0, viem.isAddress)(reward.token.address, { strict: false })) continue;
 		const rewardTokenAddress = (0, viem.getAddress)(reward.token.address);
 		for (const reason of reward.breakdowns) {
@@ -30,9 +19,9 @@ async function getMerklRewards({ sdk, account, reportError, apiKey }) {
 			if (!(0, viem.isAddress)(poolTokenAddress, { strict: false })) continue;
 			const pool = poolByItsToken.get(poolTokenAddress);
 			if (!pool) continue;
-			const total = require_onchain_utils_formatter.toBigInt(reason.amount || 0);
-			const claimed = require_onchain_utils_formatter.toBigInt(reason.claimed || 0);
-			const amount = require_onchain_utils_bigint_math.BigIntMath.max(total - claimed, 0n);
+			const amounts = toAmounts(reason);
+			if (!amounts) continue;
+			const amount = require_onchain_utils_bigint_math.BigIntMath.max(amounts.total - amounts.claimed, 0n);
 			if (amount === 0n) continue;
 			const key = `${pool}_${rewardTokenAddress}`;
 			const seen = claimable.get(key);
@@ -54,6 +43,20 @@ async function getMerklRewards({ sdk, account, reportError, apiKey }) {
 	}
 	return [...claimable.values()].map(toReward);
 }
+/**
+* `toBigInt` throws on anything `BigInt()` cannot parse, and Merkl's amounts
+* are free-form strings.
+*/
+function toAmounts(reason) {
+	try {
+		return {
+			total: require_onchain_utils_formatter.toBigInt(reason.amount || 0),
+			claimed: require_onchain_utils_formatter.toBigInt(reason.claimed || 0)
+		};
+	} catch {
+		return;
+	}
+}
 function toReward({ price, token, value, ...rest }) {
 	return {
 		...rest,
@@ -78,10 +81,5 @@ function toRewardToken(sdk, address, merkl) {
 		decimals: merkl.decimals || 18
 	};
 }
-function extractFulfilled(r, reportError, description) {
-	if (r.status === "fulfilled") return r.value;
-	if (reportError) reportError(r.reason, description);
-	else console.error(r.reason);
-}
 //#endregion
-exports.getMerklRewards = getMerklRewards;
+exports.toMerklRewards = toMerklRewards;

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

@@ -3,9 +3,15 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 /** Backend-only protocol analytics exposed by {@link GearboxSDK}. */
 var AnalyticsNamespace = class {
 	positions;
+	#backend;
 	constructor(backend) {
+		this.#backend = backend;
 		this.positions = backend.analytics.positions;
 	}
+	/** {@inheritDoc IAnalytics.charts} */
+	async charts(metrics, range, filter) {
+		return this.#backend.analytics.getCharts(metrics, range, filter);
+	}
 };
 //#endregion
 exports.AnalyticsNamespace = AnalyticsNamespace;

package/dist/esm/dev/AccountOpener.js

@@ -1,5 +1,5 @@
-import { ierc20Abi } from "../abi/iERC20.js";
 import { iCreditFacadeV310Abi } from "../abi/310/generated.js";
+import { ierc20Abi } from "../abi/iERC20.js";
 import { AddressMap } from "../onchain/utils/AddressMap.js";
 import { AddressSet } from "../onchain/utils/AddressSet.js";
 import { AssetsMap } from "../onchain/utils/AssetsMap.js";

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

@@ -14,8 +14,8 @@ const tagDiff = 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);
@@ -36,8 +36,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/esm/dev/mode-parity/comparePositions.js

@@ -17,8 +17,8 @@ const tagDiff = 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 ?? [];
@@ -65,8 +65,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
 		});
 	}
@@ -129,11 +128,11 @@ function summarize(inputs, wallets, failed) {
 		...wallet.error ? { error: wallet.error } : {},
 		...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 {
 		...toCompareCounts(allOnchain.length, allOffchain.length, onlyOnchain.length, onlyOffchain.length, matched),
 		wallets: wallets.length,
-		walletsClean,
+		walletsSimilar,
 		walletsFailed: failed,
 		byChain,
 		byWallet,

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

@@ -53,7 +53,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 {
@@ -117,15 +117,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/esm/dev/mode-parity/scriptUtils.js

@@ -1,4 +1,5 @@
 import { getAlchemyUrl } from "../providers.js";
+import { appendFileSync } from "node:fs";
 import { pino } from "pino";
 //#region src/dev/mode-parity/scriptUtils.ts
 const NETWORKS = [
@@ -76,6 +77,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.
 **/
@@ -87,15 +122,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) => ({
@@ -117,5 +150,108 @@ 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;
+	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
-export { BACKEND_URL, NETWORKS, TIMEOUT, createLogger, errorMessage, formatBpsAsPercent, mapPool, printCompareSummary, requireEnv, rpcUrls };
+export { BACKEND_URL, NETWORKS, TIMEOUT, createLogger, errorMessage, evaluateCompareFailure, formatBpsAsPercent, formatCompareMarkdown, mapPool, printCompareSummary, reportCompare, requireEnv, rpcUrls, writeGithubJobSummary };

package/dist/esm/dev/withdrawalUtils.js

@@ -1,6 +1,6 @@
-import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import { getNetworkType } from "../onchain/chain/chains.js";
 import { getWithdrawalCompressorAddress } from "../onchain/accounts/withdrawal-compressor/addresses.js";
+import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import "../onchain/index.js";
 import { iMidasDataFeedAbi, iMidasRedemptionVaultAbi, midasGatewayAbi, midasRedeemerAbi, midasRedemptionVaultPhantomTokenAbi, securitizeRedeemerAbi, securitizeRedemptionGatewayAbi, securitizeRedemptionPhantomTokenAbi } from "./withdrawalAbi.js";
 import { erc20Abi, hexToString, parseAbi, parseEther } from "viem";

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

@@ -1,7 +1,8 @@
 import { ZodAddress } from "../onchain/utils/zod.js";
+import { assetTypeSchema, chainIdSchema } from "./primitives.schema.js";
+import { chartRangeSchema, protocolChartMetricSchema } from "./charts.schema.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";
@@ -104,5 +105,44 @@ const analyticsPositionPageSchema = z.object({
 	offset: z.number().int().nonnegative(),
 	limit: z.number().int().positive().max(100)
 });
+/**
+* {@link AnalyticsChartQuery}
+*
+* The metric list is narrowed to {@link ProtocolChartMetric} here rather than
+* on the route, so asking the protocol chart for an opportunity metric is
+* rejected by the one codec both sides share instead of by a check only the
+* backend runs.
+**/
+const analyticsChartQueryOptionsSchema = z.object({
+	metrics: z.array(protocolChartMetricSchema).readonly().refine((metrics) => metrics.length > 0, { error: "a chart read needs at least one metric" }).refine((metrics) => new Set(metrics).size === metrics.length, { error: "a chart read needs distinct metrics" }),
+	range: chartRangeSchema,
+	chainIds: z.array(chainIdSchema).optional()
+});
+/**
+* {@link AnalyticsChartQuery} as URL query parameters: the metrics comma-joined
+* like every other chart read, and the chains comma-joined like every other
+* analytics read.
+**/
+const analyticsChartQueryParamsSchema = z.object({
+	metrics: z.string().regex(/^\w+(,\w+)*$/),
+	range: chartRangeSchema,
+	chainIds: z.string().regex(/^$|^\d+(,\d+)*$/).optional()
+});
+/**
+* Codec for a protocol-wide chart query. It is shared by the SDK client and
+* backend controller so both sides interpret every parameter identically.
+**/
+const analyticsChartQuerySchema = z.codec(analyticsChartQueryParamsSchema, analyticsChartQueryOptionsSchema, {
+	decode: (params) => ({
+		metrics: params.metrics.split(","),
+		range: params.range,
+		...params.chainIds === void 0 ? {} : { chainIds: params.chainIds === "" ? [] : params.chainIds.split(",").map(Number) }
+	}),
+	encode: (query) => ({
+		metrics: query.metrics.join(","),
+		range: query.range,
+		chainIds: query.chainIds?.join(",")
+	})
+});
 //#endregion
-export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema };
+export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema };

package/dist/esm/model/charts.js

@@ -84,6 +84,18 @@ const STRATEGY_POSITION_CHART_METRICS = [
 	"netApy7d"
 ];
 /**
+* Every metric the protocol as a whole can chart.
+*
+* Protocol-wide rather than per subject: the series describes Gearbox itself
+* over every chain the read covers, so it has no address to hang off and is
+* read from the analytics namespace rather than from an opportunity.
+*
+* `tvlUsd` is deliberately not spelled `tvl`: that key is already the credit
+* manager's TVL in whole underlying tokens, and one metric has exactly one
+* unit in {@link CHART_METRIC_UNITS}.
+**/
+const PROTOCOL_CHART_METRICS = ["tvlUsd"];
+/**
 * Unit of every metric, the one place either side decides it.
 *
 * A metric added to a union above fails to compile here until its unit is
@@ -113,7 +125,8 @@ const CHART_METRIC_UNITS = {
 	totalValueUnderlying: "token",
 	debt: "token",
 	healthFactor: "bps",
-	netApy7d: "bps"
+	netApy7d: "bps",
+	tvlUsd: "usd"
 };
 /**
 * Reason a series could not be produced at all, which is not the same as a
@@ -127,4 +140,4 @@ const CHART_UNAVAILABLE_CODES = [
 	"internal"
 ];
 //#endregion
-export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS };
+export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PROTOCOL_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS };

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, PROTOCOL_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
 /**
@@ -32,13 +32,18 @@ const poolPositionChartMetricSchema = z.enum(POOL_POSITION_CHART_METRICS);
 **/
 const strategyPositionChartMetricSchema = z.enum(STRATEGY_POSITION_CHART_METRICS);
 /**
-* {@link ChartMetric}, every metric either kind of subject can chart.
+* {@link ProtocolChartMetric}
+**/
+const protocolChartMetricSchema = z.enum(PROTOCOL_CHART_METRICS);
+/**
+* {@link ChartMetric}, every metric any subject can chart.
 **/
 const chartMetricSchema = z.union([
 	poolOpportunityChartMetricSchema,
 	strategyOpportunityChartMetricSchema,
 	poolPositionChartMetricSchema,
-	strategyPositionChartMetricSchema
+	strategyPositionChartMetricSchema,
+	protocolChartMetricSchema
 ]);
 /**
 * {@link ChartQuery}
@@ -223,4 +228,4 @@ function chartBundleSchemaFor(metrics, range) {
 	return chartBundleSchemaWith(z.union(literals), range);
 }
 //#endregion
-export { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema };
+export { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, protocolChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema };

package/dist/esm/model/index.js

@@ -1,15 +1,15 @@
 import "./analytics.js";
+import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PROTOCOL_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS } from "./charts.js";
+import { backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema, underlyingTokenSchema } from "./primitives.schema.js";
+import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, protocolChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.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 { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema } from "./analytics.schema.js";
 import "./curators.js";
 import "./delayed-intents.js";
 import "./errors.js";
@@ -25,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 { 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 };
+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, PROTOCOL_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, amountSchema, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, 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, protocolChartMetricSchema, 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 { 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
 /**

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

@@ -1,9 +1,9 @@
 import { ZodAddress } from "../onchain/utils/zod.js";
+import { offchainOnly, tolerance } from "./compare.schema.js";
+import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
-import { offchainOnly, tolerance } from "./compare.schema.js";
 import { curatorSchema } from "./curators.schema.js";
-import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { z } from "zod/v4";
 //#region src/model/opportunities.schema.ts
 /**

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

@@ -1,8 +1,8 @@
 import { ZodAddress, ZodBigInt, ZodHex } from "../onchain/utils/zod.js";
-import { isFilterSet } from "./filters.js";
-import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
 import { backendPreferred, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
 import { assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, underlyingTokenSchema } from "./primitives.schema.js";
+import { isFilterSet } from "./filters.js";
+import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
 import { delayedReceivedAssetSchema, liquidationPositionSchema } from "./liquidations.schema.js";
 import { apyBreakdownSchema, pointsProgramSchema } from "./opportunities.schema.js";
 import { z } from "zod/v4";

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

@@ -1,11 +1,34 @@
+import { chartBundleSchemaFor } from "../../model/charts.schema.js";
+import { analyticsChartQuerySchema } from "../../model/analytics.schema.js";
+import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";
 import { OffchainAnalyticsPositions } from "./OffchainAnalyticsPositions.js";
+import { z } from "zod/v4";
 //#region src/offchain/analytics/OffchainAnalytics.ts
-/** Backend-only protocol analytics, grouped by subject. */
-var OffchainAnalytics = class {
+/**
+* Backend-only protocol analytics, grouped by subject.
+*
+* It owns the protocol-wide charts itself rather than through a sub-namespace:
+* their subject is Gearbox as a whole, so there is nothing narrower for them to
+* hang off.
+**/
+var OffchainAnalytics = class extends AbstractOffchainNamespace {
 	positions;
 	constructor(options) {
+		super("OffchainAnalytics", options);
 		this.positions = new OffchainAnalyticsPositions(options);
 	}
+	/** {@inheritDoc IOffchainAnalytics.getCharts} */
+	async getCharts(metrics, range, filter) {
+		return this.get({
+			path: "/v2/analytics/charts",
+			query: z.encode(analyticsChartQuerySchema, {
+				metrics,
+				range,
+				chainIds: this.scopedChainIds(filter)
+			}),
+			schema: chartBundleSchemaFor(metrics, range)
+		});
+	}
 };
 //#endregion
 export { OffchainAnalytics };

package/dist/esm/onchain/accounts/CreditAccountsServiceV310.js

@@ -1,5 +1,3 @@
-import { iBaseRewardPoolAbi } from "../../abi/iBaseRewardPool.js";
-import { ierc4626AdapterAbi } from "../../abi/ierc4626Adapter.js";
 import { AP_REWARDS_COMPRESSOR } from "../constants/address-provider.js";
 import { ADDRESS_0X0 } from "../constants/addresses.js";
 import { MAX_UINT256 } from "../constants/math.js";
@@ -10,6 +8,8 @@ import "../base/index.js";
 import { AccountBotsService } from "./bots/AccountBotsService.js";
 import "./bots/index.js";
 import { rewardsCompressorAbi } from "../../abi/compressors/rewardsCompressor.js";
+import { iBaseRewardPoolAbi } from "../../abi/iBaseRewardPool.js";
+import { ierc4626AdapterAbi } from "../../abi/ierc4626Adapter.js";
 import { expectedBalanceDeltas } from "../market/credit/expectedBalanceDeltas.js";
 import "../market/index.js";
 import { CreditAccountCompressor } from "./credit-account-compressor/CreditAccountCompressor.js";

package/dist/esm/onchain/accounts/liquidations/LiquidationsService.js

@@ -1,4 +1,3 @@
-import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 import { AddressSet } from "../../utils/AddressSet.js";
 import { bytes32ToString } from "../../utils/bytes32ToString.js";
 import { ADDRESS_0X0 } from "../../constants/addresses.js";
@@ -20,6 +19,7 @@ import { SecuritizeLiquidatorContract } from "../../market/rwa/securitize/Securi
 import "../../market/rwa/securitize/index.js";
 import "../../market/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
+import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 import { skipLiquidatableAccount } from "./skipLiquidatableAccount.js";
 //#region src/onchain/accounts/liquidations/LiquidationsService.ts
 /**