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

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

@@ -0,0 +1,62 @@
+import { PoolPosition, PositionFilter, StrategyPosition } from "./positions.js";
+import { LiquidationPosition } from "./liquidations.js";
+import { Address } from "viem";
+//#region src/model/analytics.d.ts
+/**
+ * A protocol-wide position row together with the wallet that owns it.
+ *
+ * The position fields stay flat, so consumers can render this row exactly as
+ * they render a wallet-scoped {@link Position}; `borrower` is the only extra
+ * identity the protocol-wide list needs.
+ **/
+type AnalyticsPosition = AnalyticsPoolPosition | AnalyticsStrategyPosition | AnalyticsLiquidationPosition;
+/** Pool position with its owner on the protocol-wide list. */
+type AnalyticsPoolPosition = PoolPosition & AnalyticsPositionOwner;
+/** Strategy position with its borrower on the protocol-wide list. */
+type AnalyticsStrategyPosition = StrategyPosition & AnalyticsPositionOwner;
+/** Liquidation position with its owner on the protocol-wide list. */
+type AnalyticsLiquidationPosition = LiquidationPosition & AnalyticsPositionOwner;
+/** Ownership added to every protocol-wide position row. */
+interface AnalyticsPositionOwner {
+  /** Wallet that owns the pool shares or opened the credit account. */
+  borrower: Address;
+}
+/** Fields the protocol-wide position list can order by. */
+type AnalyticsPositionSortField = "netValueUsd" | "totalValueUsd" | "totalDebtUsd" | "pnlUsd" | "apy" | "healthFactor" | "leverage" | "chainId" | "name" | "borrower";
+/** Direction of one analytics list ordering. */
+type AnalyticsSortDirection = "asc" | "desc";
+/**
+ * Filtering, ordering and offset pagination of the protocol-wide position
+ * list. Omitted position criteria have the same meaning as they do on
+ * {@link PositionFilter}.
+ **/
+interface AnalyticsPositionListOptions extends PositionFilter {
+  /** Keep only positions owned by this wallet. */
+  borrower?: Address;
+  /**
+   * Field to order by. Values that do not apply to a position kind, and USD
+   * values that cannot be priced, are always placed after concrete values.
+   *
+   * @defaultValue `"netValueUsd"`
+   */
+  sortBy?: AnalyticsPositionSortField;
+  /** @defaultValue `"desc"` */
+  sortDirection?: AnalyticsSortDirection;
+  /** Number of matching rows to skip. @defaultValue `0` */
+  offset?: number;
+  /** Number of rows to return, from 1 through 100. @defaultValue `25` */
+  limit?: number;
+}
+/** One page of the protocol-wide position list. */
+interface AnalyticsPositionPage {
+  /** Requested slice after filtering and ordering. */
+  items: AnalyticsPosition[];
+  /** Number of rows matching the filter before pagination. */
+  total: number;
+  /** Effective number of rows skipped. */
+  offset: number;
+  /** Effective maximum number of rows returned. */
+  limit: number;
+}
+//#endregion
+export { AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition };

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

@@ -0,0 +1,149 @@
+import { AnalyticsPosition } from "./analytics.js";
+import { z } from "zod/v4";
+//#region src/model/analytics.schema.d.ts
+/** Default page size of the protocol-wide positions list. */
+declare const ANALYTICS_POSITIONS_DEFAULT_LIMIT = 25;
+/** Largest page the protocol-wide positions list accepts. */
+declare const ANALYTICS_POSITIONS_MAX_LIMIT = 100;
+/** {@link AnalyticsPositionSortField} */
+declare const analyticsPositionSortFieldSchema: z.ZodEnum<{
+  apy: "apy";
+  borrower: "borrower";
+  chainId: "chainId";
+  healthFactor: "healthFactor";
+  leverage: "leverage";
+  name: "name";
+  netValueUsd: "netValueUsd";
+  pnlUsd: "pnlUsd";
+  totalDebtUsd: "totalDebtUsd";
+  totalValueUsd: "totalValueUsd";
+}>;
+/** {@link AnalyticsSortDirection} */
+declare const analyticsSortDirectionSchema: z.ZodEnum<{
+  asc: "asc";
+  desc: "desc";
+}>;
+/** {@link AnalyticsPosition} */
+declare const analyticsPositionSchema: z.ZodType<AnalyticsPosition>;
+/** {@link AnalyticsPositionListOptions} */
+declare const analyticsPositionListOptionsSchema: z.ZodObject<{
+  borrower: z.ZodOptional<z.ZodCustom<`0x${string}`, `0x${string}`>>;
+  kind: z.ZodOptional<z.ZodUnion<[z.ZodUnion<readonly [z.ZodLiteral<"pool">, z.ZodLiteral<"strategy">, z.ZodLiteral<"liquidation">]>, z.ZodLiteral<"all">]>>;
+  isZeroDebt: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"all">]>>;
+  chainIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+  underlyingType: z.ZodOptional<z.ZodUnion<[z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>, z.ZodLiteral<"all">]>>;
+  sortBy: z.ZodOptional<z.ZodEnum<{
+    apy: "apy";
+    borrower: "borrower";
+    chainId: "chainId";
+    healthFactor: "healthFactor";
+    leverage: "leverage";
+    name: "name";
+    netValueUsd: "netValueUsd";
+    pnlUsd: "pnlUsd";
+    totalDebtUsd: "totalDebtUsd";
+    totalValueUsd: "totalValueUsd";
+  }>>;
+  sortDirection: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  offset: z.ZodOptional<z.ZodNumber>;
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * {@link AnalyticsPositionListOptions} as URL query parameters.
+ **/
+declare const analyticsPositionListQueryParamsSchema: z.ZodObject<{
+  borrower: z.ZodOptional<z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>>;
+  kind: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"pool">, z.ZodLiteral<"strategy">, z.ZodLiteral<"liquidation">]>>;
+  isZeroDebt: z.ZodOptional<z.ZodEnum<{
+    false: "false";
+    true: "true";
+  }>>;
+  chainIds: z.ZodOptional<z.ZodString>;
+  underlyingType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+  sortBy: z.ZodOptional<z.ZodEnum<{
+    apy: "apy";
+    borrower: "borrower";
+    chainId: "chainId";
+    healthFactor: "healthFactor";
+    leverage: "leverage";
+    name: "name";
+    netValueUsd: "netValueUsd";
+    pnlUsd: "pnlUsd";
+    totalDebtUsd: "totalDebtUsd";
+    totalValueUsd: "totalValueUsd";
+  }>>;
+  sortDirection: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  offset: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Codec for an analytics position-list query. It is shared by the SDK client
+ * and backend controller so both sides interpret every parameter identically.
+ **/
+declare const analyticsPositionListQuerySchema: z.ZodCodec<z.ZodObject<{
+  borrower: z.ZodOptional<z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>>;
+  kind: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"pool">, z.ZodLiteral<"strategy">, z.ZodLiteral<"liquidation">]>>;
+  isZeroDebt: z.ZodOptional<z.ZodEnum<{
+    false: "false";
+    true: "true";
+  }>>;
+  chainIds: z.ZodOptional<z.ZodString>;
+  underlyingType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+  sortBy: z.ZodOptional<z.ZodEnum<{
+    apy: "apy";
+    borrower: "borrower";
+    chainId: "chainId";
+    healthFactor: "healthFactor";
+    leverage: "leverage";
+    name: "name";
+    netValueUsd: "netValueUsd";
+    pnlUsd: "pnlUsd";
+    totalDebtUsd: "totalDebtUsd";
+    totalValueUsd: "totalValueUsd";
+  }>>;
+  sortDirection: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  offset: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  borrower: z.ZodOptional<z.ZodCustom<`0x${string}`, `0x${string}`>>;
+  kind: z.ZodOptional<z.ZodUnion<[z.ZodUnion<readonly [z.ZodLiteral<"pool">, z.ZodLiteral<"strategy">, z.ZodLiteral<"liquidation">]>, z.ZodLiteral<"all">]>>;
+  isZeroDebt: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"all">]>>;
+  chainIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+  underlyingType: z.ZodOptional<z.ZodUnion<[z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>, z.ZodLiteral<"all">]>>;
+  sortBy: z.ZodOptional<z.ZodEnum<{
+    apy: "apy";
+    borrower: "borrower";
+    chainId: "chainId";
+    healthFactor: "healthFactor";
+    leverage: "leverage";
+    name: "name";
+    netValueUsd: "netValueUsd";
+    pnlUsd: "pnlUsd";
+    totalDebtUsd: "totalDebtUsd";
+    totalValueUsd: "totalValueUsd";
+  }>>;
+  sortDirection: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  offset: z.ZodOptional<z.ZodNumber>;
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/** {@link AnalyticsPositionPage} */
+declare const analyticsPositionPageSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodType<AnalyticsPosition, unknown, z.core.$ZodTypeInternals<AnalyticsPosition, unknown>>>;
+  total: z.ZodNumber;
+  offset: z.ZodNumber;
+  limit: z.ZodNumber;
+}, z.core.$strip>;
+//#endregion
+export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema };

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

@@ -1,17 +1,19 @@
 import { Amount, Asset, AssetType, Bps, ChainId, Leverage, Timestamp, Token, TokenAmount, TxCall, UnderlyingToken } from "./primitives.js";
-import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, GridSampling, OpportunityChartMetric, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PoolOpportunityChartMetric, PoolPositionChartMetric, PositionChartMetric, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, StrategyOpportunityChartMetric, StrategyPositionChartMetric } from "./charts.js";
-import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
-import { CompareTag, CompareTolerance, ToleranceCompareTag, backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { ChainScopedFilter, FILTER_ALL, FilterAll, Filterable, isFilterSet } from "./filters.js";
+import { IGearboxError } from "./errors.js";
 import { Curator, CuratorName } from "./curators.js";
-import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
 import { DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedWithdrawCollateralIntent } from "./delayed-intents.js";
-import { IGearboxError } from "./errors.js";
-import { ChainScopedFilter, FILTER_ALL, FilterAll, Filterable, isFilterSet } from "./filters.js";
-import { booleanParamSchema, encodeFlag, filterAllSchema, filterable } from "./filters.schema.js";
 import { ApyBreakdown, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, OpportunityTotals, PointRewards, PointsProgram, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, Rewards, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, TokenRewards, matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
 import { BorrowRateBreakdown, PnlBreakdown, PointsProgramPnL, PointsRewardsPnL, PoolPosition, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionTransaction, PositionTransactionKind, PositionsTotals, RewardsPnL, STRATEGY_POSITION_COLLATERAL_ERROR, StrategyPosition, StrategyPositionKey, StrategyPositionRef, TokenQuotaRate, TokenRewardsPnL, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
 import { AccountHoldings, AccountMetrics, AccountProjection, AccountStateChange, AdapterCallOutsideBracketError, AdjustStrategyPositionPreview, CreditOperationMarket, DelayedStrategyPositionOperationPreview, Estimated, EstimatedProjection, ExitStrategyPositionPreview, InstantStrategyPositionOperationPreview, InvalidTransactionValueError, MalformedBracketError, MalformedBracketKind, MalformedPreviewError, NonAdapterCallInBracketError, OpenStrategyPositionPreview, OperationPreview, OperationPreviewError, PoolOperationType, PoolPositionOperationPreview, PreviewOperationInput, PreviewOperationOptions, RepayStrategyPositionPreview, RoutedField, UnpreviewableAdapterCallError, UnsupportedOutOfBracketCallError, asEstimated } from "./previews.js";
 import { DelayedReceivedAsset, InstantReceivedAsset, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, ReceivedAsset, matchesLiquidatableAccountFilter } from "./liquidations.js";
+import { AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition } from "./analytics.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, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, GridSampling, OpportunityChartMetric, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PoolOpportunityChartMetric, PoolPositionChartMetric, PositionChartMetric, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, StrategyOpportunityChartMetric, StrategyPositionChartMetric } from "./charts.js";
+import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
+import { CompareTag, CompareTolerance, ToleranceCompareTag, backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
+import { booleanParamSchema, encodeFlag, filterAllSchema, filterable } from "./filters.schema.js";
 import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, receivedAssetSchema } from "./liquidations.schema.js";
 import { Notice, NoticeKind, NoticeSubject } from "./notices.js";
 import { noticeKindSchema, noticeSchema } from "./notices.schema.js";
@@ -23,4 +25,4 @@ import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourc
 import { SDKError, SDKResult, SDKReturn, SafeValue, isSDKError, safeValue, sdkErr, sdkOk } from "./result.js";
 import { PositionClaimableWithdrawal, PositionPendingWithdrawal, PositionWithdrawals, WithdrawalOutputAmount } from "./withdrawals.js";
 import { positionClaimableWithdrawalSchema, positionPendingWithdrawalSchema, positionWithdrawalsSchema, withdrawalOutputAmountSchema } from "./withdrawals.schema.js";
-export { AccountHoldings, AccountMetrics, AccountProjection, AccountStateChange, AdapterCallOutsideBracketError, AdjustStrategyPositionPreview, Amount, ApyBreakdown, Asset, AssetType, BorrowRateBreakdown, Bps, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainScopedFilter, ChainSucceeded, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, CompareTag, CompareTolerance, CreditOperationMarket, Curator, CuratorName, DataResponse, DataSource, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedReceivedAsset, DelayedStrategyPositionOperationPreview, DelayedWithdrawCollateralIntent, Estimated, EstimatedProjection, ExitStrategyPositionPreview, FILTER_ALL, FilterAll, Filterable, GridSampling, IGearboxError, InstantReceivedAsset, InstantStrategyPositionOperationPreview, InvalidTransactionValueError, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, MalformedBracketError, MalformedBracketKind, MalformedPreviewError, NonAdapterCallInBracketError, Notice, NoticeKind, NoticeSubject, OpenStrategyPositionPreview, OperationPreview, OperationPreviewError, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, OpportunityTotals, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolOperationType, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionOperationPreview, PoolPositionRef, Position, PositionChartMetric, PositionClaimableWithdrawal, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionPendingWithdrawal, PositionTransaction, PositionTransactionKind, PositionWithdrawals, PositionsTotals, PreviewOperationInput, PreviewOperationOptions, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, RepayStrategyPositionPreview, ResponseMetadata, Rewards, RewardsPnL, RoutedField, SDKError, SDKResult, SDKReturn, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, SafeValue, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenQuotaRate, TokenRewards, TokenRewardsPnL, ToleranceCompareTag, TxCall, UnderlyingToken, UnpreviewableAdapterCallError, UnsupportedOutOfBracketCallError, WithdrawalOutputAmount, amountSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, isSDKError, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, withdrawalOutputAmountSchema };
+export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, AccountHoldings, AccountMetrics, AccountProjection, AccountStateChange, AdapterCallOutsideBracketError, AdjustStrategyPositionPreview, Amount, AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition, ApyBreakdown, Asset, AssetType, BorrowRateBreakdown, Bps, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainScopedFilter, ChainSucceeded, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, CompareTag, CompareTolerance, CreditOperationMarket, Curator, CuratorName, DataResponse, DataSource, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedReceivedAsset, DelayedStrategyPositionOperationPreview, DelayedWithdrawCollateralIntent, Estimated, EstimatedProjection, ExitStrategyPositionPreview, FILTER_ALL, FilterAll, Filterable, GridSampling, IGearboxError, InstantReceivedAsset, InstantStrategyPositionOperationPreview, InvalidTransactionValueError, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, MalformedBracketError, MalformedBracketKind, MalformedPreviewError, NonAdapterCallInBracketError, Notice, NoticeKind, NoticeSubject, OpenStrategyPositionPreview, OperationPreview, OperationPreviewError, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, OpportunityTotals, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolOperationType, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionOperationPreview, PoolPositionRef, Position, PositionChartMetric, PositionClaimableWithdrawal, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionPendingWithdrawal, PositionTransaction, PositionTransactionKind, PositionWithdrawals, PositionsTotals, PreviewOperationInput, PreviewOperationOptions, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, RepayStrategyPositionPreview, ResponseMetadata, Rewards, RewardsPnL, RoutedField, SDKError, SDKResult, SDKReturn, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, SafeValue, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenQuotaRate, TokenRewards, TokenRewardsPnL, ToleranceCompareTag, TxCall, UnderlyingToken, UnpreviewableAdapterCallError, UnsupportedOutOfBracketCallError, WithdrawalOutputAmount, amountSchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, isSDKError, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, withdrawalOutputAmountSchema };

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

@@ -1,6 +1,6 @@
 import { Amount, AssetType, Bps, ChainId, Leverage, Timestamp, Token, UnderlyingToken } from "./primitives.js";
-import { Curator } from "./curators.js";
 import { ChainScopedFilter, Filterable } from "./filters.js";
+import { Curator } from "./curators.js";
 import { Address } from "viem";
 //#region src/model/opportunities.d.ts
 /**

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

@@ -1,8 +1,8 @@
 import { Bps, ChainId, Leverage, Timestamp, Token, TokenAmount, UnderlyingToken } from "./primitives.js";
-import { Curator } from "./curators.js";
-import { DelayedIntent } from "./delayed-intents.js";
 import { IGearboxError } from "./errors.js";
 import { UnpriceableTokenError } from "../onchain/market/oracle/errors.js";
+import { Curator } from "./curators.js";
+import { DelayedIntent } from "./delayed-intents.js";
 import { BorrowRateBreakdown } from "./positions.js";
 import { Address, Hex } from "viem";
 //#region src/model/previews.d.ts

package/dist/types/offchain/AbstractOffchainNamespace.d.ts

@@ -1,7 +1,7 @@
 import { ILogger } from "../onchain/types/logger.js";
 import { ChainId } from "../model/primitives.js";
-import { ChartBundle, ChartMetric, ChartRange } from "../model/charts.js";
 import { ChainScopedFilter } from "../model/filters.js";
+import { ChartBundle, ChartMetric, ChartRange } from "../model/charts.js";
 import { DataResponse } from "../model/response.js";
 import { GearboxAPIOptions } from "./types.js";
 import { z } from "zod/v4";

package/dist/types/offchain/GearboxAPI.d.ts

@@ -1,5 +1,7 @@
 import { ChainId } from "../model/primitives.js";
 import { GearboxAPIOptions } from "./types.js";
+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";
@@ -29,6 +31,8 @@ declare class GearboxAPI {
    * Chains every read of this client is scoped to.
    **/
   readonly chainIds: readonly ChainId[];
+  /** Protocol-wide, backend-only analytics. */
+  readonly analytics: OffchainAnalytics;
   /**
    * Namespace for pool and strategy opportunities.
    **/

package/dist/types/offchain/analytics/OffchainAnalytics.d.ts

@@ -0,0 +1,11 @@
+import { GearboxAPIOptions } from "../types.js";
+import { IOffchainAnalytics } from "./types.js";
+import { OffchainAnalyticsPositions } from "./OffchainAnalyticsPositions.js";
+//#region src/offchain/analytics/OffchainAnalytics.d.ts
+/** Backend-only protocol analytics, grouped by subject. */
+declare class OffchainAnalytics implements IOffchainAnalytics {
+  readonly positions: OffchainAnalyticsPositions;
+  constructor(options: GearboxAPIOptions);
+}
+//#endregion
+export { OffchainAnalytics };

package/dist/types/offchain/analytics/OffchainAnalyticsPositions.d.ts

@@ -0,0 +1,14 @@
+import { AnalyticsPositionListOptions, AnalyticsPositionPage } from "../../model/analytics.js";
+import { DataResponse } from "../../model/response.js";
+import { GearboxAPIOptions } from "../types.js";
+import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";
+import { IOffchainAnalyticsPositions } from "./types.js";
+//#region src/offchain/analytics/OffchainAnalyticsPositions.d.ts
+/** Backend client for protocol-wide position analytics. */
+declare class OffchainAnalyticsPositions extends AbstractOffchainNamespace implements IOffchainAnalyticsPositions {
+  constructor(options: GearboxAPIOptions);
+  /** {@inheritDoc IOffchainAnalyticsPositions.list} */
+  list(options?: AnalyticsPositionListOptions): Promise<DataResponse<AnalyticsPositionPage>>;
+}
+//#endregion
+export { OffchainAnalyticsPositions };

package/dist/types/offchain/analytics/index.d.ts

@@ -0,0 +1,4 @@
+import { IOffchainAnalytics, IOffchainAnalyticsPositions } from "./types.js";
+import { OffchainAnalyticsPositions } from "./OffchainAnalyticsPositions.js";
+import { OffchainAnalytics } from "./OffchainAnalytics.js";
+export { IOffchainAnalytics, IOffchainAnalyticsPositions, OffchainAnalytics, OffchainAnalyticsPositions };

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

@@ -0,0 +1,17 @@
+import { AnalyticsPositionListOptions, AnalyticsPositionPage } from "../../model/analytics.js";
+import { DataResponse } from "../../model/response.js";
+//#region src/offchain/analytics/types.d.ts
+/** Protocol-wide position reads served by the backend. */
+interface IOffchainAnalyticsPositions {
+  /**
+   * Every current position in the protocol, with its owning borrower, after
+   * applying the requested filter, ordering and pagination.
+   **/
+  list(options?: AnalyticsPositionListOptions): Promise<DataResponse<AnalyticsPositionPage>>;
+}
+/** Backend-only protocol analytics, grouped by subject. */
+interface IOffchainAnalytics {
+  readonly positions: IOffchainAnalyticsPositions;
+}
+//#endregion
+export { IOffchainAnalytics, IOffchainAnalyticsPositions };

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

@@ -1,5 +1,9 @@
 import { GearboxAPIOptions } from "./types.js";
 import { AbstractOffchainNamespace, OffchainGetRequest, OffchainQuery } from "./AbstractOffchainNamespace.js";
+import { IOffchainAnalytics, IOffchainAnalyticsPositions } from "./analytics/types.js";
+import { OffchainAnalyticsPositions } from "./analytics/OffchainAnalyticsPositions.js";
+import { OffchainAnalytics } from "./analytics/OffchainAnalytics.js";
+import "./analytics/index.js";
 import { OffchainNotices } from "./notices/OffchainNotices.js";
 import "./notices/index.js";
 import { IOffchainOpportunities, OpportunityChartMetricFor } from "./opportunities/types.js";
@@ -20,4 +24,4 @@ import { backendMessage } from "./errors/backendMessage.js";
 import { ErrorCause, errorCause } from "./errors/errorCause.js";
 import { readResponseBody } from "./errors/readResponseBody.js";
 import "./errors/index.js";
-export { AbstractOffchainNamespace, ErrorCause, GearboxAPI, GearboxAPIOptions, IOffchainOpportunities, IOffchainPositions, OffchainGetRequest, OffchainInvalidJsonError, OffchainNotConfiguredError, OffchainNotImplementedError, OffchainNotices, OffchainOpportunities, OffchainPositions, OffchainQuery, OffchainRequestFailedError, OffchainStatusError, OffchainTransportError, OffchainTransportErrorParams, OffchainValidationError, OpportunityChartMetricFor, PositionChartMetricFor, backendMessage, errorCause, readResponseBody };
+export { AbstractOffchainNamespace, ErrorCause, GearboxAPI, GearboxAPIOptions, IOffchainAnalytics, IOffchainAnalyticsPositions, IOffchainOpportunities, IOffchainPositions, OffchainAnalytics, OffchainAnalyticsPositions, OffchainGetRequest, OffchainInvalidJsonError, OffchainNotConfiguredError, OffchainNotImplementedError, OffchainNotices, OffchainOpportunities, OffchainPositions, OffchainQuery, OffchainRequestFailedError, OffchainStatusError, OffchainTransportError, OffchainTransportErrorParams, OffchainValidationError, OpportunityChartMetricFor, PositionChartMetricFor, backendMessage, errorCause, readResponseBody };

package/dist/types/offchain/opportunities/OffchainOpportunities.d.ts

@@ -1,5 +1,5 @@
-import { ChartBundle, ChartRange } from "../../model/charts.js";
 import { Opportunity, OpportunityFilter, OpportunityKey, OpportunityTotals, PoolOpportunityDetail, PoolOpportunityKey, StrategyOpportunityDetail, StrategyOpportunityKey } from "../../model/opportunities.js";
+import { ChartBundle, ChartRange } from "../../model/charts.js";
 import { DataResponse } from "../../model/response.js";
 import { GearboxAPIOptions } from "../types.js";
 import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";

package/dist/types/offchain/opportunities/types.d.ts

@@ -1,5 +1,5 @@
-import { ChartBundle, ChartRange, PoolOpportunityChartMetric, StrategyOpportunityChartMetric } from "../../model/charts.js";
 import { Opportunity, OpportunityFilter, OpportunityKey, OpportunityTotals, PoolOpportunityDetail, PoolOpportunityKey, StrategyOpportunityDetail, StrategyOpportunityKey } from "../../model/opportunities.js";
+import { ChartBundle, ChartRange, PoolOpportunityChartMetric, StrategyOpportunityChartMetric } from "../../model/charts.js";
 import { DataResponse } from "../../model/response.js";
 //#region src/offchain/opportunities/types.d.ts
 type OpportunityChartMetricFor<K extends OpportunityKey> = {

package/dist/types/offchain/positions/OffchainPositions.d.ts

@@ -1,5 +1,5 @@
-import { ChartBundle, ChartRange } from "../../model/charts.js";
 import { Position, PositionKey, PositionTransaction, PositionsTotals, StrategyPositionKey } from "../../model/positions.js";
+import { ChartBundle, ChartRange } from "../../model/charts.js";
 import { DataResponse } from "../../model/response.js";
 import { ListPositionsPropsBase } from "../../onchain/positions/types.js";
 import { GearboxAPIOptions } from "../types.js";

package/dist/types/offchain/positions/types.d.ts

@@ -1,5 +1,5 @@
-import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
 import { Position, PositionKey, PositionTransaction, PositionsTotals, StrategyPositionKey } from "../../model/positions.js";
+import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
 import { DataResponse } from "../../model/response.js";
 import { ListPositionsPropsBase } from "../../onchain/positions/types.js";
 import { Address } from "viem";

package/dist/types/rewards/errors.d.ts

@@ -0,0 +1,18 @@
+import { ChainId } from "../model/primitives.js";
+import "../model/index.js";
+import { BaseError } from "viem";
+//#region src/rewards/errors.d.ts
+/**
+ * Thrown when none of Merkl's domains answered for a chain.
+ *
+ * Everything a reader needs is in the message: this error travels to consumers
+ * inside a chain's {@link ChainFailed} metadata, where it is typed `unknown`
+ * and may be serialised by something that turns an arbitrary object into `{}`.
+ */
+declare class MerklRequestFailedError extends BaseError {
+  name: string;
+  readonly chainId: ChainId;
+  constructor(chainId: ChainId, path: string, attempts: ReadonlyArray<[domain: string, cause: unknown]>);
+}
+//#endregion
+export { MerklRequestFailedError };

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

@@ -1,7 +1,4 @@
-import { Apy, ApyDetails, DebtReward, ExternalApy, ExtraCollateralAPY, ExtraCollateralPointsInfo, FarmInfo, GearAPY, GearAPYDetails, PointsInfo, PointsReward, PoolExtraApy, PoolOutputDetails, PoolPointsInfo, TokenOutputDetails } from "./apy/output-details.js";
-import { DataResult, Output } from "./apy/output.js";
-import "./apy/index.js";
-import { GetMerklRewardsProps, MerklReward, MerklRewardsSdk, getMerklRewards } from "./rewards/api.js";
-import { GetPointsByPoolProps, GetTotalTokensOnProtocolProps, PoolPointsAPI, PoolPointsBase, getKeyForPoolPointsInfo } from "./rewards/extra-apy.js";
-import "./rewards/index.js";
-export { Apy, ApyDetails, DataResult, DebtReward, ExternalApy, ExtraCollateralAPY, ExtraCollateralPointsInfo, FarmInfo, GearAPY, GearAPYDetails, GetMerklRewardsProps, GetPointsByPoolProps, GetTotalTokensOnProtocolProps, MerklReward, MerklRewardsSdk, Output, PointsInfo, PointsReward, PoolExtraApy, PoolOutputDetails, PoolPointsAPI, PoolPointsBase, PoolPointsInfo, TokenOutputDetails, getKeyForPoolPointsInfo, getMerklRewards };
+import { MerklRequestFailedError } from "./errors.js";
+import { MerklReward, MerklRewardsSdk, toMerklRewards } from "./toMerklRewards.js";
+import { GetMerklRewardsMultichainProps, getMerklRewardsMultichain } from "./multichain.js";
+export { GetMerklRewardsMultichainProps, MerklRequestFailedError, MerklReward, MerklRewardsSdk, getMerklRewardsMultichain, toMerklRewards };

package/dist/types/rewards/merkl-api.d.ts

@@ -0,0 +1,64 @@
+import { ChainId } from "../model/primitives.js";
+import "../model/index.js";
+import { Address } from "viem";
+//#region src/rewards/merkl-api.d.ts
+interface MerkleXYZUserRewardsV4 {
+  chain: MerkleXYZChain;
+  rewards: Array<{
+    root: Address;
+    recipient: Address;
+    amount: string;
+    claimed: string;
+    pending: string;
+    proofs: Array<Address>;
+    token: {
+      address: Address;
+      chainId: number;
+      symbol: string;
+      decimals: number;
+      /**
+       * USD price of one whole token. Optional because Merkl omits the key
+       * outright for the tokens it does not price — points and the like —
+       * rather than sending a null.
+       */
+      price?: number;
+    };
+    breakdowns: Array<{
+      reason: string;
+      amount: string;
+      claimed: string;
+      pending: string;
+      campaignId: Address;
+    }>;
+  }>;
+}
+type MerkleXYZUserRewardsV4Response = Array<MerkleXYZUserRewardsV4>;
+interface MerkleXYZChain {
+  id: number;
+  name: string;
+  icon: string;
+}
+/**
+ * Merkl's own host and the Angle mirror, tried in this order.
+ */
+declare const MERKL_DOMAINS: readonly ["https://api.merkl.xyz", "https://api-merkl.angle.money"];
+declare const MERKL_API_KEY_HEADER = "X-API-Key";
+interface FetchMerklUserRewardsProps {
+  chainId: ChainId;
+  /** Checksummed by the caller — Merkl keys its answer on the exact string. */
+  user: Address;
+  /** Raises Merkl's rate limit; the keyless path answers too. */
+  apiKey?: string;
+}
+/**
+ * The wallet's raw Merkl rewards on one chain.
+ *
+ * Rejects with {@link MerklRequestFailedError} when neither domain answers, so
+ * a caller can tell an unreachable Merkl from a wallet with nothing to claim.
+ * A non-2xx counts as no answer and moves to the next domain: it carries no
+ * rewards either way, and treating it as success would report emptiness that
+ * was never established.
+ */
+declare function fetchMerklUserRewards({ chainId, user, apiKey }: FetchMerklUserRewardsProps): Promise<MerkleXYZUserRewardsV4Response>;
+//#endregion
+export { FetchMerklUserRewardsProps, MERKL_API_KEY_HEADER, MERKL_DOMAINS, MerkleXYZUserRewardsV4, MerkleXYZUserRewardsV4Response, fetchMerklUserRewards };

package/dist/types/rewards/multichain.d.ts

@@ -0,0 +1,33 @@
+import { ChainId } from "../model/primitives.js";
+import { DataResponse } from "../model/response.js";
+import "../model/index.js";
+import { PluginsMap } from "../onchain/plugins/types.js";
+import { MultichainSDK } from "../onchain/MultichainSDK.js";
+import "../onchain/index.js";
+import { MerklReward } from "./toMerklRewards.js";
+import { Address } from "viem";
+//#region src/rewards/multichain.d.ts
+interface GetMerklRewardsMultichainProps<Plugins extends PluginsMap = {}> {
+  /** Handle whose chains are asked. */
+  sdk: MultichainSDK<Plugins>;
+  /** Wallet whose claimable rewards to list. */
+  wallet: Address;
+  /**
+   * Chains to ask, defaulting to every chain the handle carries.
+   **/
+  chainIds?: ChainId[];
+  /** Raises Merkl's rate limit; the keyless path answers too. */
+  apiKey?: string;
+}
+/**
+ * Every claimable Merkl reward a wallet holds, across the chains the handle
+ * carries.
+ *
+ * Answers the read model's own envelope, so a chain that could not be reached
+ * is `status: "error"` in `meta.chains` while a chain with nothing to claim is
+ * a `"success"` that contributed no rows. That distinction is the point: the
+ * single-chain read this replaces resolved empty either way.
+ **/
+declare function getMerklRewardsMultichain<const Plugins extends PluginsMap = {}>({ sdk, wallet, chainIds, apiKey }: GetMerklRewardsMultichainProps<Plugins>): Promise<DataResponse<MerklReward[]>>;
+//#endregion
+export { GetMerklRewardsMultichainProps, getMerklRewardsMultichain };

package/dist/types/rewards/toMerklRewards.d.ts

@@ -0,0 +1,42 @@
+import { ChainId, Token, TokenAmount } from "../model/primitives.js";
+import "../model/index.js";
+import { OnchainSDK } from "../onchain/OnchainSDK.js";
+import "../onchain/index.js";
+import { MerkleXYZUserRewardsV4Response } from "./merkl-api.js";
+import { Address } from "viem";
+//#region src/rewards/toMerklRewards.d.ts
+/**
+ * One claimable Merkl liquidity-mining reward, denominated and priced.
+ *
+ * Both tokens arrive resolved, so a consumer neither looks one up nor
+ * reassembles one out of the loose fields Merkl sends.
+ */
+interface MerklReward {
+  readonly chainId: ChainId;
+  /** Market pool whose depositors the campaign rewards. */
+  readonly pool: Address;
+  /** That pool's share token — what the campaign is keyed on. */
+  readonly poolToken: Token;
+  /**
+   * The incentive token being handed out, how much of it is claimable
+   * (distributed minus already claimed, always > 0) and what that is worth.
+   *
+   * Priced by Merkl, not by the market oracles: a campaign's incentive token
+   * is rarely collateral in the pool it incentivises, so the oracles usually
+   * do not know it — GEAR, which most Gearbox campaigns pay in, among them.
+   * `valueUsd` is `null` for a token Merkl does not price either.
+   */
+  readonly amount: TokenAmount;
+}
+/**
+ * What the mapping needs off a chain's SDK: which chain the rows belong to,
+ * the pools a campaign can be keyed on, and the registry that names their
+ * tokens. Nothing else, and nothing asynchronous.
+ */
+type MerklRewardsSdk = Pick<OnchainSDK, "chainId" | "marketRegister" | "tokensMeta">;
+/**
+ * Merkl's answer for one chain, turned into rows of the read model.
+ */
+declare function toMerklRewards(sdk: MerklRewardsSdk, response: MerkleXYZUserRewardsV4Response): MerklReward[];
+//#endregion
+export { MerklReward, MerklRewardsSdk, toMerklRewards };

package/dist/types/sdk/GearboxSDK.d.ts

@@ -1,10 +1,12 @@
 import { NetworkType } from "../onchain/chain/chains.js";
 import "../onchain/index.js";
+import { IAnalyticsByMode } from "./analytics/types.js";
 import { ILiquidationsByMode } from "./liquidations/types.js";
 import { IOpportunities } from "./opportunities/types.js";
 import { IPositions } from "./positions/types.js";
 import { IPreviewByMode } from "./preview/types.js";
 import { GearboxSDKOptions, IGearboxSDK, INoticesByMode, Mode, OffchainByMode, OnchainByMode } from "./types.js";
+import "./analytics/index.js";
 import "./liquidations/index.js";
 import "./opportunities/index.js";
 import "./positions/index.js";
@@ -44,6 +46,8 @@ declare class GearboxSDK<const M extends Mode = Mode> implements IGearboxSDK<M>
    * Chains this instance covers, which every read is scoped to.
    **/
   readonly networks: readonly NetworkType[];
+  /** Protocol-wide analytics. Undefined in `onchain` mode. */
+  readonly analytics: IAnalyticsByMode[M];
   /**
    * Namespace for pool and strategy opportunities.
    **/