@gearbox-protocol/sdk 16.0.0 → 16.1.1

package/dist/esm/dev/claimFromFaucet.js

@@ -1,6 +1,6 @@
 import { formatBN } from "../onchain/utils/formatter.js";
 import "../onchain/index.js";
-import { faucetAbi } from "./abi.js";
+import { iFaucetAbi } from "./abi.js";
 import { readContract } from "viem/actions";
 //#region src/dev/claimFromFaucet.ts
 async function claimFromFaucet(opts) {
@@ -22,7 +22,7 @@ async function claimFromFaucet(opts) {
 	} else if (typeof amount === "function") {
 		const minAmountUSD = await readContract(publicClient, {
 			address: faucet,
-			abi: faucetAbi,
+			abi: iFaucetAbi,
 			functionName: "minAmountUSD"
 		});
 		logger?.debug(`faucet min amount USD: ${minAmountUSD}`);
@@ -38,7 +38,7 @@ async function claimFromFaucet(opts) {
 	const gas = await publicClient.estimateContractGas({
 		account: claimer,
 		address: faucet,
-		abi: faucetAbi,
+		abi: iFaucetAbi,
 		functionName: "claim",
 		args
 	});
@@ -46,7 +46,7 @@ async function claimFromFaucet(opts) {
 	const { request } = await publicClient.simulateContract({
 		account: claimer,
 		address: faucet,
-		abi: faucetAbi,
+		abi: iFaucetAbi,
 		functionName: "claim",
 		args,
 		chain: wallet.chain,

package/dist/esm/dev/index.js

@@ -1,4 +1,4 @@
-import { faucetAbi, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi } from "./abi.js";
+import { iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi } from "./abi.js";
 import { claimFromFaucet } from "./claimFromFaucet.js";
 import { anvilNodeInfo, createAnvilClient, evmMineDetailed, extendAnvilClient, isAnvil } from "./createAnvilClient.js";
 import { createMinter } from "./mint/factory.js";
@@ -25,4 +25,4 @@ import { claimDSToken, claimDSTokens, enableDSTokenBackDating } from "./securiti
 import "./types.js";
 import { ONCHAIN_EXECUTION_ID_ADDRESS, verifyTestnet } from "./verifyTestnet.js";
 import { makePendingWithdrawalsClaimable } from "./withdrawalUtils.js";
-export { AccountOpener, Create2Deployer, DEFAULT_CREATE2_SALT, EthCallSpy, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, RevolverTransport, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, faucetAbi, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, providerConfigSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeAndWait };
+export { AccountOpener, Create2Deployer, DEFAULT_CREATE2_SALT, EthCallSpy, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, RevolverTransport, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, providerConfigSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeAndWait };

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/base/TokensMeta.js

@@ -54,7 +54,7 @@ var TokensMeta = class extends AddressMap {
 	* Returns the display symbol for a token.
 	*
 	* This is not always the on-chain ERC-20 `symbol()`: curated pretty names
-	* and redemption phantom tokens (`"source -> target"`) replace it.
+	* and redemption phantom tokens (`"target redemption from source"`) replace it.
 	*
 	* @param token - Token address.
 	* @throws If the token is not in the registry.
@@ -153,7 +153,7 @@ var TokensMeta = class extends AddressMap {
 	}
 	/**
 	* Rewrites display symbols of redemption phantom tokens to
-	* `"${source} -> ${target}"`.
+	* `"${target} redemption from ${source}"`.
 	*
 	* @param renames - Phantom / source / target address triples.
 	**/
@@ -163,7 +163,7 @@ var TokensMeta = class extends AddressMap {
 			if (!meta || !this.has(source) || !this.has(target)) continue;
 			this.upsert(phantom, {
 				...meta,
-				symbol: `${this.symbol(source)} -> ${this.symbol(target)}`
+				symbol: `${this.symbol(target)} redemption from ${this.symbol(source)}`
 			});
 		}
 	}

package/dist/esm/onchain/chain/chains.js

@@ -125,6 +125,13 @@ const chains = {
 			symbol: "USDC"
 		},
 		tokenPrettyNames: AddressMap.fromRecord({
+			"0xab7d50fc2486a1ac06516e2ece9dadc95ba8cd20": "wstETH redemption from cp0xLRT",
+			"0x6252467c2fefb61cb55180282943139baeea36c5": "wstETH redemption from rstETH",
+			"0xd412ca00d177eba2843348f9c50dd17bfce32c40": "wstETH redemption from pzETH",
+			"0x26c98674e623647f11909791593fa3b6e9406c67": "wstETH redemption from steak7LRT",
+			"0x9fb930eacadad079683a4758424a53b9b3692775": "wstETH redemption from Re7LRT",
+			"0xd7f1a4e3aba92a9d20987c752bd4a6cc759d7738": "rsETH redemption from hgETH",
+			"0xc71219dca5a671aa6268ab8fb35e570bd72f372b": "iUSD redemption from liUSD-1w",
 			"0x924d24c238db7ecae2aa3a19430239ed684bde4a": "Beefy WBTC/cbBTC/hemiBTC",
 			"0x403cc0d2694ec2639101f32b146b90d766461ce9": "Beefy wstETH/tETH",
 			"0x02a4cceed3c400b5ba9fd22ad6ec18d8f7a3d48e": "Beefy ETH+/WETH",

package/dist/esm/onchain/market/strategyName.js

@@ -4,7 +4,7 @@
 * borrowed underlying, e.g. `"wstETH / WETH"`.
 *
 * Uses each token's display {@link Token.symbol}, which may already be a
-* curated pretty name or a `"source -> target"` redemption rewrite.
+* curated pretty name or a `"target redemption from source"` redemption rewrite.
 *
 * @param target - Collateral the position is built around.
 * @param underlying - Token the position borrows.

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

@@ -2,9 +2,15 @@
 /** 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
 export { AnalyticsNamespace };

package/dist/types/dev/abi.d.ts

@@ -38,11 +38,11 @@ declare const iDegenNftv2Abi: readonly [{
   }];
   readonly outputs: readonly [];
 }];
-declare const faucetAbi: readonly [{
+declare const iFaucetAbi: readonly [{
   readonly type: "function";
   readonly name: "assets";
   readonly inputs: readonly [{
-    readonly name: "";
+    readonly name: "index";
     readonly type: "uint256";
     readonly internalType: "uint256";
   }];
@@ -87,6 +87,92 @@ declare const faucetAbi: readonly [{
   }];
   readonly outputs: readonly [];
   readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly name: "claimOnBehalfOf";
+  readonly inputs: readonly [{
+    readonly name: "receiver";
+    readonly type: "address";
+    readonly internalType: "address";
+  }, {
+    readonly name: "claims";
+    readonly type: "tuple[]";
+    readonly internalType: "struct TokenClaim[]";
+    readonly components: readonly [{
+      readonly name: "token";
+      readonly type: "address";
+      readonly internalType: "address";
+    }, {
+      readonly name: "amount";
+      readonly type: "uint256";
+      readonly internalType: "uint256";
+    }];
+  }];
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly type: "bool";
+    readonly internalType: "bool";
+  }];
+  readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly name: "claimOnBehalfOf";
+  readonly inputs: readonly [{
+    readonly name: "receiver";
+    readonly type: "address";
+    readonly internalType: "address";
+  }, {
+    readonly name: "amountUSD";
+    readonly type: "uint256";
+    readonly internalType: "uint256";
+  }];
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly type: "bool";
+    readonly internalType: "bool";
+  }];
+  readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly name: "claimOnBehalfOf";
+  readonly inputs: readonly [{
+    readonly name: "receiver";
+    readonly type: "address";
+    readonly internalType: "address";
+  }];
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly type: "bool";
+    readonly internalType: "bool";
+  }];
+  readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly name: "configure";
+  readonly inputs: readonly [{
+    readonly name: "minAmountUSD";
+    readonly type: "uint256";
+    readonly internalType: "uint256";
+  }, {
+    readonly name: "tokens";
+    readonly type: "tuple[]";
+    readonly internalType: "struct FaucetToken[]";
+    readonly components: readonly [{
+      readonly name: "token";
+      readonly type: "address";
+      readonly internalType: "address";
+    }, {
+      readonly name: "price";
+      readonly type: "uint256";
+      readonly internalType: "uint256";
+    }, {
+      readonly name: "decimals";
+      readonly type: "uint8";
+      readonly internalType: "uint8";
+    }];
+  }];
+  readonly outputs: readonly [];
+  readonly stateMutability: "nonpayable";
 }, {
   readonly type: "function";
   readonly name: "getAssets";
@@ -121,21 +207,11 @@ declare const faucetAbi: readonly [{
     readonly internalType: "uint256";
   }];
   readonly stateMutability: "view";
-}, {
-  readonly type: "function";
-  readonly name: "owner";
-  readonly inputs: readonly [];
-  readonly outputs: readonly [{
-    readonly name: "";
-    readonly type: "address";
-    readonly internalType: "address";
-  }];
-  readonly stateMutability: "view";
 }, {
   readonly type: "function";
   readonly name: "prices";
   readonly inputs: readonly [{
-    readonly name: "";
+    readonly name: "token";
     readonly type: "address";
     readonly internalType: "address";
   }];
@@ -149,7 +225,7 @@ declare const faucetAbi: readonly [{
   readonly type: "function";
   readonly name: "scales";
   readonly inputs: readonly [{
-    readonly name: "";
+    readonly name: "token";
     readonly type: "address";
     readonly internalType: "address";
   }];
@@ -218,4 +294,4 @@ declare const iOnchainExecutionIdAbi: readonly [{
   readonly stateMutability: "view";
 }];
 //#endregion
-export { faucetAbi, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi };
+export { iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi };

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

@@ -2,7 +2,7 @@ import { AccountOpener, AccountOpenerOptions, OpenAccountHumanizedPreview, OpenA
 import { RpcErrorResult, RpcResponse, RpcSuccessResult } from "./types.js";
 import { CheckMulticallFn, DetectedCall, EthCallMethod, EthCallRequest, EthCallSpy } from "./EthCallSpy.js";
 import { NoAvailableTransportsError, ProviderConfig, ProviderStatus, RevolverTransport, RevolverTransportConfig, RevolverTransportValue, SelectionStrategy, providerConfigSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema } from "./RevolverTransport.js";
-import { faucetAbi, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi } from "./abi.js";
+import { iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi } from "./abi.js";
 import { calcLiquidatableLTs } from "./calcLiquidatableLTs.js";
 import { claimFromFaucet } from "./claimFromFaucet.js";
 import { Create2Deployer, Create2Parameters, DEFAULT_CREATE2_SALT, EnsureExistsUsingPublicCreate2ReturnType, GetCreate2AddressParameters, PUBLIC_CREATE2_FACTORY, deployUsingPublicCreate2, getPublicCreate2Address, isDeployedUsingPublicCreate2 } from "./create2.js";
@@ -26,4 +26,4 @@ import { EnableDSTokenBackDatingProps, RestoreDSTokenBackDating, claimDSToken, c
 import { httpTransportOptionsSchema } from "./transports.js";
 import { ONCHAIN_EXECUTION_ID_ADDRESS, VerifyTestnetParams, verifyTestnet } from "./verifyTestnet.js";
 import { MakePendingWithdrawalsClaimableOptions, makePendingWithdrawalsClaimable } from "./withdrawalUtils.js";
-export { AccountOpener, AccountOpenerOptions, AnvilActions, AnvilClient, AnvilClientConfig, AnvilDealParameters, AnvilNodeInfo, AnvilRPCSchema, CheckMulticallFn, Create2Deployer, Create2Parameters, DEFAULT_CREATE2_SALT, DetectedCall, EnableDSTokenBackDatingProps, EnsureExistsUsingPublicCreate2ReturnType, EthCallMethod, EthCallRequest, EthCallSpy, GetCreate2AddressParameters, GreenlistMidasGatewayProps, IMinter, type LogSplitterTransportOptions, MakePendingWithdrawalsClaimableOptions, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenAccountHumanizedPreview, OpenAccountResult, OpenAccountsResult, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, PoolDepositResult, ProviderConfig, ProviderStatus, RWAKycFailure, RegisterMidasInvestorProps, RegisterRWAInvestorProps, RegisterRWAInvestorResult, RegisterSecuritizeInvestorProps, ReplaceStorageParams, ResilientTransportOptions, RestoreDSTokenBackDating, RestoreMidasIssuanceVaultPause, RevolverTransport, RevolverTransportConfig, RevolverTransportValue, RpcErrorResult, RpcProvider, RpcResponse, RpcSuccessResult, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, TargetAccount, UnpauseMidasIssuanceVaultProps, VerifyTestnetParams, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, faucetAbi, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, providerConfigSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeAndWait };
+export { AccountOpener, AccountOpenerOptions, AnvilActions, AnvilClient, AnvilClientConfig, AnvilDealParameters, AnvilNodeInfo, AnvilRPCSchema, CheckMulticallFn, Create2Deployer, Create2Parameters, DEFAULT_CREATE2_SALT, DetectedCall, EnableDSTokenBackDatingProps, EnsureExistsUsingPublicCreate2ReturnType, EthCallMethod, EthCallRequest, EthCallSpy, GetCreate2AddressParameters, GreenlistMidasGatewayProps, IMinter, type LogSplitterTransportOptions, MakePendingWithdrawalsClaimableOptions, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenAccountHumanizedPreview, OpenAccountResult, OpenAccountsResult, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, PoolDepositResult, ProviderConfig, ProviderStatus, RWAKycFailure, RegisterMidasInvestorProps, RegisterRWAInvestorProps, RegisterRWAInvestorResult, RegisterSecuritizeInvestorProps, ReplaceStorageParams, ResilientTransportOptions, RestoreDSTokenBackDating, RestoreMidasIssuanceVaultPause, RevolverTransport, RevolverTransportConfig, RevolverTransportValue, RpcErrorResult, RpcProvider, RpcResponse, RpcSuccessResult, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, TargetAccount, UnpauseMidasIssuanceVaultProps, VerifyTestnetParams, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, providerConfigSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeAndWait };

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

@@ -1,3 +1,5 @@
+import { ChartRange, ProtocolChartMetric } from "./charts.js";
+import { ChainScopedFilter } from "./filters.js";
 import { PoolPosition, PositionFilter, StrategyPosition } from "./positions.js";
 import { LiquidationPosition } from "./liquidations.js";
 import { Address } from "viem";
@@ -58,5 +60,24 @@ interface AnalyticsPositionPage {
   /** Effective maximum number of rows returned. */
   limit: number;
 }
+/**
+ * What one protocol-wide chart read asks for.
+ *
+ * A {@link ChartQuery} that also carries its chain scope: the series is a sum
+ * over chains rather than a property of one subject, so which chains are in it
+ * is part of the question and not something a path segment already answered.
+ * Omitting `chainIds` asks for every chain the backend serves.
+ **/
+interface AnalyticsChartQuery extends ChainScopedFilter {
+  /**
+   * Metrics to chart, at least one and each named once. They become the keys of
+   * {@link ChartBundle.series}.
+   **/
+  metrics: readonly ProtocolChartMetric[];
+  /**
+   * Window to cover, echoed back in {@link ChartWindow.range}.
+   **/
+  range: ChartRange;
+}
 //#endregion
-export { AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition };
+export { AnalyticsChartQuery, AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition };

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

@@ -145,5 +145,69 @@ declare const analyticsPositionPageSchema: z.ZodObject<{
   offset: z.ZodNumber;
   limit: z.ZodNumber;
 }, z.core.$strip>;
+/**
+ * {@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.
+ **/
+declare const analyticsChartQueryOptionsSchema: z.ZodObject<{
+  metrics: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+    tvlUsd: "tvlUsd";
+  }>>>;
+  range: z.ZodEnum<{
+    "1d": "1d";
+    "1m": "1m";
+    "1w": "1w";
+    "1y": "1y";
+    max: "max";
+  }>;
+  chainIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * {@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.
+ **/
+declare const analyticsChartQueryParamsSchema: z.ZodObject<{
+  metrics: z.ZodString;
+  range: z.ZodEnum<{
+    "1d": "1d";
+    "1m": "1m";
+    "1w": "1w";
+    "1y": "1y";
+    max: "max";
+  }>;
+  chainIds: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Codec for a protocol-wide chart query. It is shared by the SDK client and
+ * backend controller so both sides interpret every parameter identically.
+ **/
+declare const analyticsChartQuerySchema: z.ZodCodec<z.ZodObject<{
+  metrics: z.ZodString;
+  range: z.ZodEnum<{
+    "1d": "1d";
+    "1m": "1m";
+    "1w": "1w";
+    "1y": "1y";
+    max: "max";
+  }>;
+  chainIds: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  metrics: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+    tvlUsd: "tvlUsd";
+  }>>>;
+  range: z.ZodEnum<{
+    "1d": "1d";
+    "1m": "1m";
+    "1w": "1w";
+    "1y": "1y";
+    max: "max";
+  }>;
+  chainIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>>;
 //#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 };