@gearbox-protocol/sdk 16.0.0-next.9 → 16.1.0

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

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

package/dist/esm/model/charts.js

@@ -31,7 +31,8 @@ const POOL_OPPORTUNITY_CHART_METRICS = [
 	"depositApyAvg7d",
 	"dieselRate",
 	"supplied",
-	"borrowed"
+	"borrowed",
+	"utilization"
 ];
 /**
 * Every metric a strategy opportunity can chart.
@@ -61,6 +62,7 @@ const STRATEGY_OPPORTUNITY_CHART_METRICS = [
 **/
 const POOL_POSITION_CHART_METRICS = [
 	"apy",
+	"apyAvg7d",
 	"pnl",
 	"mwr"
 ];
@@ -82,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
@@ -99,17 +113,20 @@ const CHART_METRIC_UNITS = {
 	supplied: "token",
 	borrowed: "token",
 	tvl: "token",
+	utilization: "bps",
 	dieselRate: "ratio",
 	collateralPrice: "ratio",
 	collateralUsdPrice: "usd",
 	underlyingUsdPrice: "usd",
 	apy: "bps",
+	apyAvg7d: "bps",
 	pnl: "token",
 	mwr: "bps",
 	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
@@ -123,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,4 +1,4 @@
-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 { 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 { 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/compare.schema.js

@@ -12,6 +12,13 @@ function onchainOnly(schema) {
 	return schema.meta({ compare: "onchainOnly" });
 }
 /**
+* Marks a field whose backend value both-mode merge overlays onto the chain
+* row, so a source disagreement is expected.
+**/
+function backendPreferred(schema) {
+	return schema.meta({ compare: "backendPreferred" });
+}
+/**
 * Marks a numeric field whose two sources may drift within {@link kind}.
 **/
 function tolerance(schema, kind) {
@@ -26,4 +33,4 @@ function compareTagOf(schema) {
 	return meta.compare;
 }
 //#endregion
-export { compareTagOf, offchainOnly, onchainOnly, tolerance };
+export { backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance };

package/dist/esm/model/delayed-intent.schema.js

@@ -0,0 +1,34 @@
+import { ZodAddress, ZodBigInt } from "../onchain/utils/zod.js";
+import { z } from "zod/v4";
+//#region src/model/delayed-intent.schema.ts
+const delayedIncreaseLeverageIntentSchema = z.object({ type: z.literal("INCREASE_LEVERAGE") });
+const delayedDepositIntentSchema = z.object({ type: z.literal("DEPOSIT") });
+const delayedDepositAndIncreaseLeverageIntentSchema = z.object({ type: z.literal("DEPOSIT_AND_INCREASE_LEVERAGE") });
+const delayedWithdrawCollateralIntentSchema = z.object({
+	type: z.literal("WITHDRAW_COLLATERAL"),
+	to: ZodAddress(),
+	withdrawToken: ZodAddress(),
+	withdrawAmount: ZodBigInt(),
+	sourceToken: ZodAddress(),
+	debtRepaid: ZodBigInt()
+});
+const delayedCloseAccountIntentSchema = z.object({
+	type: z.literal("CLOSE_ACCOUNT"),
+	to: ZodAddress()
+});
+const delayedAddCollateralIntentSchema = z.object({ type: z.literal("ADD_COLLATERAL") });
+const delayedDecreaseLeverageIntentSchema = z.object({ type: z.literal("DECREASE_LEVERAGE") });
+/**
+* {@link DelayedIntent}
+**/
+const delayedIntentSchema = z.discriminatedUnion("type", [
+	delayedIncreaseLeverageIntentSchema,
+	delayedDepositIntentSchema,
+	delayedDepositAndIncreaseLeverageIntentSchema,
+	delayedWithdrawCollateralIntentSchema,
+	delayedCloseAccountIntentSchema,
+	delayedAddCollateralIntentSchema,
+	delayedDecreaseLeverageIntentSchema
+]);
+//#endregion
+export { delayedIntentSchema };

package/dist/esm/model/index.js

@@ -1,22 +1,28 @@
-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 { compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+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, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
-import "./curators.js";
-import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
-import "./delayed-intents.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 { matchesLiquidatableAccountFilter } from "./liquidations.js";
+import { curatorNameSchema, curatorSchema } from "./curators.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, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema } from "./analytics.schema.js";
+import "./curators.js";
+import "./delayed-intents.js";
+import "./errors.js";
+import { matchesLiquidatableAccountFilter } from "./liquidations.js";
 import "./notices.js";
 import { noticeKindSchema, noticeSchema } from "./notices.schema.js";
 import { matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
-import { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema } from "./opportunities.schema.js";
-import { liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
-import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
-import { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN } from "./previews.js";
+import { STRATEGY_POSITION_COLLATERAL_ERROR, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
+import { asEstimated } from "./previews.js";
 import "./primitives.js";
 import "./response.js";
 import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
-export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, 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, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema };
+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, 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,6 +1,7 @@
 import { ZodAddress } from "../onchain/utils/zod.js";
-import { assetTypeSchema, chainIdSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.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 { z } from "zod/v4";
 //#region src/model/liquidations.schema.ts
 /**
@@ -21,9 +22,13 @@ const liquidatableAccountFilterSchema = z.object({
 * {@link LiquidatableAccount}
 **/
 const liquidatableAccountSchema = z.object({
+	creditManager: ZodAddress(),
+	name: z.string(),
+	underlyingToken: underlyingTokenSchema,
+	curator: curatorSchema,
+	liquidationDiscount: bpsSchema,
 	chainId: chainIdSchema,
 	creditAccount: ZodAddress(),
-	creditManager: ZodAddress(),
 	asset: tokenSchema,
 	totalValue: tokenAmountSchema,
 	repaymentAmount: tokenAmountSchema,

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 { curatorSchema } from "./curators.schema.js";
 import { isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
+import { curatorSchema } from "./curators.schema.js";
 import { z } from "zod/v4";
 //#region src/model/opportunities.schema.ts
 /**
@@ -244,5 +244,13 @@ const opportunityKeySchema = z.discriminatedUnion("kind", [z.object({
 	kind: z.literal("strategy"),
 	...strategyOpportunityKeySchema.shape
 })]);
+/**
+* {@link OpportunityTotals}
+**/
+const opportunityTotalsSchema = z.object({
+	tvl: z.number(),
+	totalBorrowed: z.number(),
+	totalSupply: z.number()
+});
 //#endregion
-export { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema };
+export { 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 };

package/dist/esm/model/positions.js

@@ -1,6 +1,11 @@
 import { isFilterSet } from "./filters.js";
 //#region src/model/positions.ts
 /**
+* Set on {@link StrategyPosition.error} when the account could not be fully
+* valued (e.g. a dead price feed).
+**/
+const STRATEGY_POSITION_COLLATERAL_ERROR = "collateral computation failed";
+/**
 * Builds the canonical id of a pool position.
 *
 * @example
@@ -84,4 +89,4 @@ function positionUnderlying(position) {
 	}
 }
 //#endregion
-export { liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId };
+export { STRATEGY_POSITION_COLLATERAL_ERROR, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId };

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

@@ -1,5 +1,5 @@
 import { ZodAddress, ZodBigInt, ZodHex } from "../onchain/utils/zod.js";
-import { offchainOnly, onchainOnly, tolerance } from "./compare.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";
@@ -95,12 +95,12 @@ const borrowRateBreakdownSchema = z.object({
 **/
 const strategyPositionSchema = z.object({
 	kind: z.literal("strategy"),
-	name: z.string(),
+	name: backendPreferred(z.string()),
 	chainId: chainIdSchema,
 	creditManager: ZodAddress(),
 	creditAccount: ZodAddress(),
 	underlyingToken: underlyingTokenSchema,
-	targetCollateral: tokenSchema.nullable(),
+	targetCollateral: backendPreferred(tokenSchema.nullable()),
 	leverage: tolerance(leverageSchema, "float"),
 	borrowApy: tolerance(bpsSchema, "bps"),
 	borrowApyAvg7D: offchainOnly(bpsSchema).optional(),
@@ -114,7 +114,8 @@ const strategyPositionSchema = z.object({
 	timeToLiquidation: onchainOnly(ZodBigInt().nullable()).optional(),
 	liquidationPrice: onchainOnly(ZodBigInt().nullable()).optional(),
 	pnl: offchainOnly(pnlBreakdownSchema).optional(),
-	collaterals: z.array(positionCollateralSchema)
+	collaterals: z.array(positionCollateralSchema),
+	error: z.string().optional()
 });
 /**
 * {@link Position}
@@ -192,7 +193,7 @@ const positionKeySchema = z.discriminatedUnion("kind", [z.object({
 **/
 const positionsTotalsSchema = z.object({
 	currentYield: apyBreakdownSchema.nullable(),
-	pnl: pnlBreakdownSchema.nullable(),
+	pnlUsd: z.number().nullable(),
 	netValueUsd: z.number().nullable(),
 	claimableUsd: z.number().nullable()
 });
@@ -206,7 +207,10 @@ const positionTransactionKindSchema = z.union([
 	z.literal("adjustLeverage"),
 	z.literal("addCollateral"),
 	z.literal("withdrawCollateral"),
-	z.literal("liquidation")
+	z.literal("liquidation"),
+	z.literal("repay"),
+	z.literal("rebalance"),
+	z.literal("other")
 ]);
 /**
 * {@link PositionTransaction}
@@ -215,7 +219,9 @@ const positionTransactionSchema = z.object({
 	txHash: ZodHex(),
 	timestamp: timestampSchema,
 	kind: positionTransactionKindSchema,
-	assets: z.array(tokenAmountSchema)
+	assets: z.array(tokenAmountSchema),
+	balanceChanges: z.array(tokenAmountSchema),
+	debtChange: tokenAmountSchema
 });
 //#endregion
 export { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema };

package/dist/esm/model/previews.js

@@ -1,35 +1,25 @@
 //#region src/model/previews.ts
 /**
-* Broken `storeExpectedBalances`/`compareBalances` bracket structure:
-* `storeExpectedBalances` without a matching `compareBalances`, nested
-* brackets, or `compareBalances` without a preceding `storeExpectedBalances`.
-* We expect transactions that were generated by our frontend using router/withdrawal compressor
+* Renames a projection's routed fields, for a caller that built one from floor
+* balances.
+*
+* Lives beside the type so the two cannot drift: a field added to
+* {@link RoutedField} fails to compile until it is renamed here too.
 **/
-const ERROR_MALFORMED_BRACKET = 1001;
-/**
-* Adapter call outside a `storeExpectedBalances`/`compareBalances` bracket
-* We expect transactions that were generated by our frontend using router/withdrawal compressor,
-**/
-const ERROR_ADAPTER_CALL_OUTSIDE_BRACKET = 1002;
-/**
-* Bracketed call whose target is not an adapter (or adapter that is not known to the SDK)
-**/
-const ERROR_NON_ADAPTER_CALL_IN_BRACKET = 1003;
-/**
-* Bracketed adapter call cannot be replayed (undecodable/unsupported calldata)
-**/
-const ERROR_UNPREVIEWABLE_ADAPTER_CALL = 1004;
-/**
-* Out-of-bracket RWA wrap/unwrap calldata cannot be decoded
-**/
-const ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP = 1005;
-/**
-* `msg.value` does not fit into the declared WETH collateral
-* Transactions can have arbitrary value, but the ones that we create
-* using our frontend should have a value that fits into the declared WETH collateral.
-**/
-const ERROR_INVALID_TRANSACTION_VALUE = 1006;
-/** A token in the preview could not be priced by the oracle */
-const ERROR_UNPRICEABLE_TOKEN = 2001;
+function asEstimated(p) {
+	const { totalValue, netValue, assets, healthFactor, safeHealthFactor, borrowRate, timeToLiquidation, liquidationPrice, leverage, ...settled } = p;
+	return {
+		...settled,
+		estTotalValue: totalValue,
+		estNetValue: netValue,
+		estAssets: assets,
+		estHealthFactor: healthFactor,
+		estSafeHealthFactor: safeHealthFactor,
+		estBorrowRate: borrowRate,
+		estTimeToLiquidation: timeToLiquidation,
+		estLiquidationPrice: liquidationPrice,
+		estLeverage: leverage
+	};
+}
 //#endregion
-export { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN };
+export { asEstimated };

package/dist/esm/model/result.js

@@ -0,0 +1,33 @@
+//#region src/model/result.ts
+/**
+* Builds a {@link SafeValue}. Omits `error` when the value was not degraded.
+**/
+function safeValue(value, error) {
+	return error === void 0 ? { value } : {
+		value,
+		error
+	};
+}
+/** The success half, built. */
+function sdkOk(data) {
+	return {
+		ok: true,
+		data
+	};
+}
+/** The failure half, built. */
+function sdkErr(error) {
+	return {
+		ok: false,
+		error
+	};
+}
+/**
+* Narrows a {@link SDKReturn} to its failure half. Trivial over `ok`, but it
+* names the intent at call sites that would otherwise read `!r.ok`.
+**/
+function isSDKError(answer) {
+	return !answer.ok;
+}
+//#endregion
+export { isSDKError, safeValue, sdkErr, sdkOk };

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

@@ -0,0 +1,40 @@
+import { ZodAddress } from "../onchain/utils/zod.js";
+import { timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
+import { delayedIntentSchema } from "./delayed-intent.schema.js";
+import { z } from "zod/v4";
+//#region src/model/withdrawals.schema.ts
+/**
+* {@link WithdrawalOutputAmount}
+**/
+const withdrawalOutputAmountSchema = tokenAmountSchema.extend({ isDelayed: z.boolean() });
+/**
+* {@link PositionClaimableWithdrawal}
+**/
+const positionClaimableWithdrawalSchema = z.object({
+	sourceToken: tokenSchema,
+	withdrawalPhantomToken: tokenAmountSchema,
+	outputs: z.array(withdrawalOutputAmountSchema),
+	claimCall: txCallSchema,
+	redeemer: ZodAddress().optional(),
+	intent: delayedIntentSchema.optional()
+});
+/**
+* {@link PositionPendingWithdrawal}
+**/
+const positionPendingWithdrawalSchema = z.object({
+	sourceToken: tokenSchema,
+	withdrawalPhantomToken: tokenSchema,
+	expectedOutputs: z.array(withdrawalOutputAmountSchema),
+	claimableAt: timestampSchema,
+	redeemer: ZodAddress().optional(),
+	intent: delayedIntentSchema.optional()
+});
+/**
+* {@link PositionWithdrawals}
+**/
+const positionWithdrawalsSchema = z.object({
+	claimable: z.array(positionClaimableWithdrawalSchema),
+	pending: z.array(positionPendingWithdrawalSchema)
+});
+//#endregion
+export { positionClaimableWithdrawalSchema, positionPendingWithdrawalSchema, positionWithdrawalsSchema, withdrawalOutputAmountSchema };

package/dist/esm/offchain/GearboxAPI.js

@@ -1,3 +1,5 @@
+import { OffchainAnalytics } from "./analytics/OffchainAnalytics.js";
+import "./analytics/index.js";
 import { OffchainNotices } from "./notices/OffchainNotices.js";
 import "./notices/index.js";
 import { OffchainOpportunities } from "./opportunities/OffchainOpportunities.js";
@@ -27,6 +29,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.
 	**/
@@ -41,6 +45,7 @@ var GearboxAPI = class {
 	notices;
 	constructor(options) {
 		this.chainIds = [...options.chainIds];
+		this.analytics = new OffchainAnalytics(options);
 		this.opportunities = new OffchainOpportunities(options);
 		this.positions = new OffchainPositions(options);
 		this.notices = new OffchainNotices(options);