@gearbox-protocol/sdk 16.0.0-next.8 → 16.0.0

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

@@ -29,6 +29,7 @@ declare const poolOpportunityChartMetricSchema: z.ZodEnum<{
   depositApyAvg7d: "depositApyAvg7d";
   dieselRate: "dieselRate";
   supplied: "supplied";
+  utilization: "utilization";
 }>;
 /**
  * {@link StrategyOpportunityChartMetric}
@@ -49,6 +50,7 @@ declare const strategyOpportunityChartMetricSchema: z.ZodEnum<{
  **/
 declare const poolPositionChartMetricSchema: z.ZodEnum<{
   apy: "apy";
+  apyAvg7d: "apyAvg7d";
   mwr: "mwr";
   pnl: "pnl";
 }>;
@@ -74,6 +76,7 @@ declare const chartMetricSchema: z.ZodUnion<readonly [z.ZodEnum<{
   depositApyAvg7d: "depositApyAvg7d";
   dieselRate: "dieselRate";
   supplied: "supplied";
+  utilization: "utilization";
 }>, z.ZodEnum<{
   borrowApy: "borrowApy";
   borrowApyAvg7d: "borrowApyAvg7d";
@@ -86,6 +89,7 @@ declare const chartMetricSchema: z.ZodUnion<readonly [z.ZodEnum<{
   underlyingUsdPrice: "underlyingUsdPrice";
 }>, z.ZodEnum<{
   apy: "apy";
+  apyAvg7d: "apyAvg7d";
   mwr: "mwr";
   pnl: "pnl";
 }>, z.ZodEnum<{
@@ -108,6 +112,7 @@ declare const chartQuerySchema: z.ZodObject<{
     depositApyAvg7d: "depositApyAvg7d";
     dieselRate: "dieselRate";
     supplied: "supplied";
+    utilization: "utilization";
   }>, z.ZodEnum<{
     borrowApy: "borrowApy";
     borrowApyAvg7d: "borrowApyAvg7d";
@@ -120,6 +125,7 @@ declare const chartQuerySchema: z.ZodObject<{
     underlyingUsdPrice: "underlyingUsdPrice";
   }>, z.ZodEnum<{
     apy: "apy";
+    apyAvg7d: "apyAvg7d";
     mwr: "mwr";
     pnl: "pnl";
   }>, z.ZodEnum<{
@@ -179,6 +185,7 @@ declare const chartQueryCodec: z.ZodCodec<z.ZodObject<{
     depositApyAvg7d: "depositApyAvg7d";
     dieselRate: "dieselRate";
     supplied: "supplied";
+    utilization: "utilization";
   }>, z.ZodEnum<{
     borrowApy: "borrowApy";
     borrowApyAvg7d: "borrowApyAvg7d";
@@ -191,6 +198,7 @@ declare const chartQueryCodec: z.ZodCodec<z.ZodObject<{
     underlyingUsdPrice: "underlyingUsdPrice";
   }>, z.ZodEnum<{
     apy: "apy";
+    apyAvg7d: "apyAvg7d";
     mwr: "mwr";
     pnl: "pnl";
   }>, z.ZodEnum<{

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

@@ -23,10 +23,12 @@ interface ToleranceCompareTag {
  *
  * - `"offchainOnly"` / `"onchainOnly"` — the other source typically leaves
  *   the field empty, so a disagreement is expected.
+ * - `"backendPreferred"` — both sources fill the field, but both-mode merge
+ *   overlays the backend value, so a disagreement is expected.
  * - {@link ToleranceCompareTag} — a numeric disagreement within the named
  *   formula is expected snapshot noise.
  **/
-type CompareTag = "offchainOnly" | "onchainOnly" | ToleranceCompareTag;
+type CompareTag = "offchainOnly" | "onchainOnly" | "backendPreferred" | ToleranceCompareTag;
 /**
  * Marks a field that only the backend fills.
  **/
@@ -35,6 +37,11 @@ declare function offchainOnly<S extends z.ZodType>(schema: S): S;
  * Marks a field that only the chain fills.
  **/
 declare function onchainOnly<S extends z.ZodType>(schema: S): S;
+/**
+ * Marks a field whose backend value both-mode merge overlays onto the chain
+ * row, so a source disagreement is expected.
+ **/
+declare function backendPreferred<S extends z.ZodType>(schema: S): S;
 /**
  * Marks a numeric field whose two sources may drift within {@link kind}.
  **/
@@ -44,4 +51,4 @@ declare function tolerance<S extends z.ZodType>(schema: S, kind: CompareToleranc
  **/
 declare function compareTagOf(schema: z.ZodType): CompareTag | undefined;
 //#endregion
-export { CompareTag, CompareTolerance, ToleranceCompareTag, compareTagOf, offchainOnly, onchainOnly, tolerance };
+export { CompareTag, CompareTolerance, ToleranceCompareTag, backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance };

package/dist/types/model/delayed-intent.schema.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod/v4";
+//#region src/model/delayed-intent.schema.d.ts
+/**
+ * {@link DelayedIntent}
+ **/
+declare const delayedIntentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"INCREASE_LEVERAGE">;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"DEPOSIT">;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"DEPOSIT_AND_INCREASE_LEVERAGE">;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"WITHDRAW_COLLATERAL">;
+  to: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+  withdrawToken: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+  withdrawAmount: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
+  sourceToken: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+  debtRepaid: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"CLOSE_ACCOUNT">;
+  to: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"ADD_COLLATERAL">;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"DECREASE_LEVERAGE">;
+}, z.core.$strip>], "type">;
+//#endregion
+export { delayedIntentSchema };

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

@@ -0,0 +1,46 @@
+//#region src/model/errors.d.ts
+/**
+ * The failure vocabulary the SDK answers in.
+ *
+ * A request that the protocol, the market or the request's own numbers rule out
+ * is not an exception: it is an answer, and a screen shows it the way it shows
+ * any other. So a method that can be refused returns an {@link SDKReturn}
+ * envelope rather than throwing, and what it puts in the failure half is one of
+ * these — never a bare string, never a boolean the caller has to interpret.
+ *
+ * A thrown exception still means what it always did: the SDK could not do its
+ * job (a read failed, a contract reverted unexpectedly, an argument is wrong).
+ * Those are bugs and outages, not refusals of the request.
+ **/
+/**
+ * What every error the SDK reports has.
+ *
+ * `code` is the discriminant: switch on it and the error narrows to the shape
+ * carrying that failure's own numbers, so a caller reads `available` and
+ * `required` off the error rather than re-deriving them from the request.
+ *
+ * The codes themselves are per namespace — there is no SDK-wide enumeration of
+ * them, because the set a method can answer with is part of that method's
+ * contract, see the `E` of {@link SDKReturn}.
+ **/
+interface IGearboxError {
+  /**
+   * Machine-readable identity of the failure, and the discriminant of the
+   * union a method returns.
+   **/
+  code: string;
+  /**
+   * One sentence naming what was refused, in English, safe to log. Not a
+   * message to show a user as-is: a screen renders the code and the numbers
+   * beside it in its own words and its own language.
+   **/
+  message: string;
+  /**
+   * The failure this one was raised for, where one error stands in front of
+   * another. Absent for a refusal that is its own reason, which is most of
+   * them.
+   **/
+  cause?: IGearboxError | Error;
+}
+//#endregion
+export { IGearboxError };

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

@@ -1,22 +1,28 @@
 import { Amount, Asset, AssetType, Bps, ChainId, Leverage, Timestamp, Token, TokenAmount, TxCall, UnderlyingToken } from "./primitives.js";
+import { ChainScopedFilter, FILTER_ALL, FilterAll, Filterable, isFilterSet } from "./filters.js";
+import { IGearboxError } from "./errors.js";
+import { Curator, CuratorName } from "./curators.js";
+import { DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedWithdrawCollateralIntent } from "./delayed-intents.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, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
-import { Curator, CuratorName } from "./curators.js";
+import { CompareTag, CompareTolerance, ToleranceCompareTag, backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
 import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
-import { DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedWithdrawCollateralIntent } from "./delayed-intents.js";
-import { ChainScopedFilter, FILTER_ALL, FilterAll, Filterable, isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterAllSchema, filterable } from "./filters.schema.js";
-import { DelayedReceivedAsset, InstantReceivedAsset, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, ReceivedAsset, matchesLiquidatableAccountFilter } from "./liquidations.js";
 import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, receivedAssetSchema } from "./liquidations.schema.js";
-import { ApyBreakdown, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, 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, StrategyPosition, StrategyPositionKey, StrategyPositionRef, TokenQuotaRate, TokenRewardsPnL, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
 import { Notice, NoticeKind, NoticeSubject } from "./notices.js";
 import { noticeKindSchema, noticeSchema } from "./notices.schema.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 { 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 { AdjustCreditAccountPreview, CloseCreditAccountPreview, DelayedCreditAccountOperationPreview, 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, InstantOperationPreview, OpenCreditAccountPreview, OperationPreview, OperationPreviewError, PoolOperationPreview, PoolOperationType, PreviewOperationInput, PreviewOperationOptions, RepayCreditAccountPreview } from "./previews.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { ChainFailed, ChainMetadata, ChainScoped, ChainSucceeded, DataResponse, DataSource, ResponseMetadata } from "./response.js";
 import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
-export { AdjustCreditAccountPreview, 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, CloseCreditAccountPreview, CompareTag, CompareTolerance, Curator, CuratorName, DataResponse, DataSource, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedCreditAccountOperationPreview, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedReceivedAsset, DelayedWithdrawCollateralIntent, 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, FilterAll, Filterable, GridSampling, InstantOperationPreview, InstantReceivedAsset, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, Notice, NoticeKind, NoticeSubject, OpenCreditAccountPreview, OperationPreview, OperationPreviewError, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolOperationPreview, PoolOperationType, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionRef, Position, PositionChartMetric, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionTransaction, PositionTransactionKind, PositionsTotals, PreviewOperationInput, PreviewOperationOptions, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, RepayCreditAccountPreview, ResponseMetadata, Rewards, RewardsPnL, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenQuotaRate, TokenRewards, TokenRewardsPnL, ToleranceCompareTag, TxCall, UnderlyingToken, 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 { 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 { 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/liquidations.d.ts

@@ -1,5 +1,6 @@
 import { AssetType, ChainId, Timestamp, Token, TokenAmount, TxCall } from "./primitives.js";
 import { ChainScopedFilter, Filterable } from "./filters.js";
+import { CreditOperationMarket } from "./previews.js";
 import { Address } from "viem";
 //#region src/model/liquidations.d.ts
 /**
@@ -34,8 +35,12 @@ interface LiquidatableAccountFilter extends ChainScopedFilter {
 /**
  * A credit account that can be liquidated, with amounts precomputed for
  * manual liquidation.
+ *
+ * The market it lives in is named the same way every other credit result names
+ * it — through {@link CreditOperationMarket} — so a liquidation screen labels
+ * the manager, its curator and the discount from the row it already holds.
  **/
-interface LiquidatableAccount {
+interface LiquidatableAccount extends CreditOperationMarket {
   /**
    * Chain the account lives on.
    **/
@@ -44,10 +49,6 @@ interface LiquidatableAccount {
    * Credit account address.
    **/
   creditAccount: Address;
-  /**
-   * Credit manager the account is opened in.
-   **/
-  creditManager: Address;
   /**
    * Main asset being liquidated: the most valuable enabled non-underlying
    * collateral token. For delayed-withdrawal phantom tokens, the source
@@ -63,12 +64,17 @@ interface LiquidatableAccount {
   totalValue: TokenAmount;
   /**
    * Estimated amount the liquidator pays to fully liquidate the account:
-   * `totalValue * liquidationDiscount`. Same token as {@link totalValue}.
+   * {@link totalValue} less the premium the liquidator keeps, in the same
+   * token.
+   *
+   * Not `totalValue * (1 - liquidationDiscount)`: {@link liquidationDiscount}
+   * also carries the protocol's own liquidation fee, which comes out of what
+   * the repayment covers rather than off what the liquidator pays.
    **/
   repaymentAmount: TokenAmount;
   /**
-   * Estimated liquidator profit: `totalValue * (1 - liquidationDiscount)`.
-   * Same token as {@link totalValue}.
+   * Estimated liquidator profit: the premium on {@link totalValue}, i.e.
+   * `totalValue - repaymentAmount`, in the same token.
    **/
   estimatedProfit: TokenAmount;
   /**

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

@@ -18,9 +18,40 @@ declare const liquidatableAccountFilterSchema: z.ZodObject<{
  * {@link LiquidatableAccount}
  **/
 declare const liquidatableAccountSchema: z.ZodObject<{
+  creditManager: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+  name: z.ZodString;
+  underlyingToken: z.ZodObject<{
+    chainId: z.ZodNumber;
+    address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+    symbol: z.ZodString;
+    name: z.ZodString;
+    decimals: z.ZodNumber;
+    assetType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+    wrappedAddress: z.ZodNullable<z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>>;
+  }, z.core.$strip>;
+  curator: z.ZodObject<{
+    address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+    name: z.ZodOptional<z.ZodEnum<{
+      "Chaos Labs": "Chaos Labs";
+      "Gami Labs": "Gami Labs";
+      Hyperithm: "Hyperithm";
+      "Invariant Group": "Invariant Group";
+      K3: "K3";
+      KPK: "KPK";
+      "M11 Credit": "M11 Credit";
+      Re7: "Re7";
+      Securitize: "Securitize";
+      TelosC: "TelosC";
+      "Testnet Curator": "Testnet Curator";
+      Tulipa: "Tulipa";
+      UltraYield: "UltraYield";
+      cp0x: "cp0x";
+    }>>;
+    url: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  liquidationDiscount: z.ZodNumber;
   chainId: z.ZodNumber;
   creditAccount: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
-  creditManager: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
   asset: z.ZodObject<{
     chainId: z.ZodNumber;
     address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
@@ -188,9 +219,40 @@ declare const liquidationPositionSchema: z.ZodObject<{
  * {@link LiquidationDetails}
  **/
 declare const liquidationDetailsSchema: z.ZodObject<{
+  creditManager: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+  name: z.ZodString;
+  underlyingToken: z.ZodObject<{
+    chainId: z.ZodNumber;
+    address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+    symbol: z.ZodString;
+    name: z.ZodString;
+    decimals: z.ZodNumber;
+    assetType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+    wrappedAddress: z.ZodNullable<z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>>;
+  }, z.core.$strip>;
+  curator: z.ZodObject<{
+    address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
+    name: z.ZodOptional<z.ZodEnum<{
+      "Chaos Labs": "Chaos Labs";
+      "Gami Labs": "Gami Labs";
+      Hyperithm: "Hyperithm";
+      "Invariant Group": "Invariant Group";
+      K3: "K3";
+      KPK: "KPK";
+      "M11 Credit": "M11 Credit";
+      Re7: "Re7";
+      Securitize: "Securitize";
+      TelosC: "TelosC";
+      "Testnet Curator": "Testnet Curator";
+      Tulipa: "Tulipa";
+      UltraYield: "UltraYield";
+      cp0x: "cp0x";
+    }>>;
+    url: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  liquidationDiscount: z.ZodNumber;
   chainId: z.ZodNumber;
   creditAccount: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
-  creditManager: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
   asset: z.ZodObject<{
     chainId: z.ZodNumber;
     address: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;

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
 /**
@@ -626,5 +626,23 @@ interface StrategyOpportunityRef extends StrategyOpportunityKey {
  * Identifies any opportunity, for requests that accept both kinds.
  **/
 type OpportunityKey = PoolOpportunityRef | StrategyOpportunityRef;
+/**
+ * Protocol-wide aggregate over every opportunity, served by the backend rather
+ * than summed by a consumer: the landing page's headline figures.
+ **/
+interface OpportunityTotals {
+  /**
+   * Total value locked in Gearbox Protocol
+   **/
+  tvl: number;
+  /**
+   * Total borrowed from pools in Gearbox Protocol
+   **/
+  totalBorrowed: number;
+  /**
+   * Total supplied to pools in Gearbox Protocol
+   **/
+  totalSupply: number;
+}
 //#endregion
-export { ApyBreakdown, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, PointRewards, PointsProgram, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, Rewards, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, TokenRewards, matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId };
+export { 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 };

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

@@ -1446,5 +1446,13 @@ declare const opportunityKeySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   creditManager: z.ZodCodec<z.ZodString, z.ZodCustom<`0x${string}`, `0x${string}`>>;
   kind: z.ZodLiteral<"strategy">;
 }, z.core.$strip>], "kind">;
+/**
+ * {@link OpportunityTotals}
+ **/
+declare const opportunityTotalsSchema: z.ZodObject<{
+  tvl: z.ZodNumber;
+  totalBorrowed: z.ZodNumber;
+  totalSupply: z.ZodNumber;
+}, z.core.$strip>;
 //#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/types/model/positions.d.ts

@@ -1,7 +1,7 @@
 import { AssetType, Bps, ChainId, Leverage, Timestamp, Token, TokenAmount, UnderlyingToken } from "./primitives.js";
 import { ChainScopedFilter, Filterable } from "./filters.js";
-import { DelayedReceivedAsset, LiquidationPosition } from "./liquidations.js";
 import { ApyBreakdown, PointsProgram } from "./opportunities.js";
+import { DelayedReceivedAsset, LiquidationPosition } from "./liquidations.js";
 import { Address, Hex } from "viem";
 //#region src/model/positions.d.ts
 /**
@@ -122,7 +122,10 @@ interface PoolPosition {
   underlyingToken: UnderlyingToken;
   /**
    * Underlying the held shares are worth at the current share rate, i.e.
-   * `pool.convertToAssets(pool.balanceOf(wallet))`.
+   * `pool.sharesToUnderlying(pool.getShareBalance(wallet))`.
+   *
+   * Does not account for withdraw fee: this is what the shares are worth,
+   * not what leaving with them would pay.
    **/
   netValue: TokenAmount;
   /**
@@ -181,6 +184,11 @@ interface BorrowRateBreakdown {
    **/
   quotas: TokenQuotaRate[];
 }
+/**
+ * Set on {@link StrategyPosition.error} when the account could not be fully
+ * valued (e.g. a dead price feed).
+ **/
+declare const STRATEGY_POSITION_COLLATERAL_ERROR = "collateral computation failed";
 /**
  * An open credit account of a wallet.
  **/
@@ -192,6 +200,9 @@ interface StrategyPosition {
   /**
    * Human-readable strategy name, e.g. `"wstETH / WETH"`. Derived from
    * {@link targetCollateral}.
+   *
+   * In both-mode merge the backend value overlays the chain row, so a
+   * source disagreement is expected.
    **/
   name: string;
   /**
@@ -215,6 +226,9 @@ interface StrategyPosition {
   underlyingToken: UnderlyingToken;
   /**
    * Collateral token this position is a strategy in.
+   *
+   * In both-mode merge the backend value overlays the chain row, so a
+   * source disagreement is expected.
    **/
   targetCollateral: Token | null;
   /**
@@ -310,6 +324,13 @@ interface StrategyPosition {
    * withdrawals.
    **/
   collaterals: PositionCollateral[];
+  /**
+   * Present when the account could not be fully valued (e.g. a dead price
+   * feed). Identity, balances, and debt principal are still filled; valued
+   * fields are best-effort. Set by either the chain compressor path or the
+   * backend.
+   **/
+  error?: string;
 }
 /**
  * A row of the positions list: anything a wallet holds in the protocol.
@@ -452,9 +473,9 @@ interface PositionsTotals {
    **/
   currentYield: ApyBreakdown | null;
   /**
-   * Profit and loss over every position, in USD terms of {@link PnlBreakdown}.
+   * Profit and loss over every position in USD.
    **/
-  pnl: PnlBreakdown | null;
+  pnlUsd: number | null;
   /**
    * Net value of every position in US dollars.
    **/
@@ -468,11 +489,27 @@ interface PositionsTotals {
 /**
  * What a transaction did to a position.
  **/
-type PositionTransactionKind = "open" | "deposit" | "withdraw" | "adjustLeverage" | "addCollateral" | "withdrawCollateral" | "liquidation";
+type PositionTransactionKind = "open" | "deposit" | "withdraw" | "adjustLeverage" | "addCollateral" | "withdrawCollateral" | "liquidation" | "repay" |
+/**
+ * The transaction only rearranged what the account already held — a swap, a
+ * claim or a quota change — without moving its net value or its debt.
+ **/
+"rebalance" |
+/**
+ * The residual kind: the transaction is not one of the above. Either the
+ * backend could not attribute the account's state movement completely, or
+ * the movements it did observe contradict each other (value left the
+ * account while debt grew, say), so no single intent describes it. Never a
+ * synonym for "nothing happened", and never a direction to infer from.
+ **/
+"other";
 /**
  * One transaction in a position's history, from the backend's indexer.
  **/
 interface PositionTransaction {
+  /**
+   * Hash of the transaction.
+   **/
   txHash: Hex;
   /**
    * Unix seconds of the block the transaction was mined in.
@@ -480,9 +517,27 @@ interface PositionTransaction {
   timestamp: Timestamp;
   kind: PositionTransactionKind;
   /**
-   * Assets the transaction moved, in the direction the kind implies.
+   * Net magnitudes of the assets the borrower moved. A directional kind
+   * supplies the direction; callers must not infer one for an `other`
+   * transaction.
    **/
   assets: TokenAmount[];
+  /**
+   * Signed change of every credit-account token balance caused by the
+   * transaction. Positive values were added to the account; negative values
+   * left it. Tokens whose balance did not change are omitted.
+   **/
+  balanceChanges: TokenAmount[];
+  /**
+   * Signed change of the position's total debt — principal plus accrued
+   * interest plus accrued fees — denominated in the market underlying. It is
+   * differenced between the backend's consecutive debt observations around
+   * the transaction, so it is what the borrower ends up owing, not the
+   * principal the transaction asked to move: a repayment outrun by accrued
+   * interest is positive, and a transaction that moved no principal at all
+   * can still carry the interest that accrued alongside it.
+   **/
+  debtChange: TokenAmount;
 }
 //#endregion
-export { BorrowRateBreakdown, PnlBreakdown, PointsProgramPnL, PointsRewardsPnL, PoolPosition, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionTransaction, PositionTransactionKind, PositionsTotals, RewardsPnL, StrategyPosition, StrategyPositionKey, StrategyPositionRef, TokenQuotaRate, TokenRewardsPnL, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId };
+export { 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 };