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

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

@@ -1,28 +1,34 @@
-import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
-import { Position, PositionKey } from "../../model/positions.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";
 import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";
+import { IOffchainPositions, PositionChartMetricFor } from "./types.js";
+import { Address } from "viem";
 //#region src/offchain/positions/OffchainPositions.d.ts
-type PositionChartMetricFor<K extends PositionKey> = {
-  pool: PoolPositionChartMetric;
-  strategy: StrategyPositionChartMetric;
-}[K["kind"]];
 /**
  * Backend counterpart of the `positions` namespace.
  **/
-declare class OffchainPositions extends AbstractOffchainNamespace {
+declare class OffchainPositions extends AbstractOffchainNamespace implements IOffchainPositions {
   #private;
   constructor(options: GearboxAPIOptions);
   /**
-   * Everything a wallet holds, optionally narrowed by {@link PositionFilter}.
+   * {@inheritDoc IOffchainPositions.list}
    **/
   list(props: ListPositionsPropsBase): Promise<DataResponse<Position[]>>;
   /**
-   * Charts of one position: one series per metric, on a shared grid.
+   * {@inheritDoc IOffchainPositions.getTotals}
+   **/
+  getTotals(wallet: Address): Promise<DataResponse<PositionsTotals>>;
+  /**
+   * {@inheritDoc IOffchainPositions.getCharts}
    **/
   getCharts<K extends PositionKey, const Metrics extends readonly PositionChartMetricFor<K>[]>(key: K, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
+  /**
+   * {@inheritDoc IOffchainPositions.getTransactions}
+   **/
+  getTransactions(key: StrategyPositionKey): Promise<DataResponse<PositionTransaction[]>>;
 }
 //#endregion
 export { OffchainPositions };

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

@@ -1,2 +1,3 @@
+import { IOffchainPositions, PositionChartMetricFor } from "./types.js";
 import { OffchainPositions } from "./OffchainPositions.js";
-export { OffchainPositions };
+export { IOffchainPositions, OffchainPositions, PositionChartMetricFor };

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

@@ -0,0 +1,36 @@
+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";
+//#region src/offchain/positions/types.d.ts
+type PositionChartMetricFor<K extends PositionKey> = {
+  pool: PoolPositionChartMetric;
+  strategy: StrategyPositionChartMetric;
+}[K["kind"]];
+/**
+ * Backend counterpart of the `positions` namespace.
+ **/
+interface IOffchainPositions {
+  /**
+   * Everything a wallet holds, optionally narrowed by the filter on
+   * {@link ListPositionsPropsBase}.
+   **/
+  list(props: ListPositionsPropsBase): Promise<DataResponse<Position[]>>;
+  /**
+   * Aggregate over everything a wallet holds, see {@link PositionsTotals}.
+   **/
+  getTotals(wallet: Address): Promise<DataResponse<PositionsTotals>>;
+  /**
+   * Charts of one position: one series per metric, on a shared grid.
+   **/
+  getCharts<K extends PositionKey, const Metrics extends readonly PositionChartMetricFor<K>[]>(key: K, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
+  /**
+   * Every transaction that touched the credit account while its current
+   * session was open, newest first. There is no paging, and an account with
+   * no open session answers with an empty list.
+   **/
+  getTransactions(key: StrategyPositionKey): Promise<DataResponse<PositionTransaction[]>>;
+}
+//#endregion
+export { IOffchainPositions, PositionChartMetricFor };

package/dist/types/onchain/accounts/CreditAccountsServiceV310.d.ts

@@ -15,7 +15,7 @@ import "../base/index.js";
 import { GetCreditAccountsOptions } from "./credit-account-compressor/types.js";
 import "./credit-account-compressor/index.js";
 import "./withdrawal-compressor/index.js";
-import { AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, ClaimFarmRewardsProps, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, ICreditAccountsService, OpenCAProps, PartiallyLiquidateProps, PreviewDelayedWithdrawalProps, Rewards } from "./types.js";
+import { AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, ClaimFarmRewardsProps, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, ICreditAccountsService, OpenCAProps, PartiallyLiquidateProps, PreviewDelayedWithdrawalProps, Rewards } from "./types.js";
 import { AccountBotsService } from "./bots/AccountBotsService.js";
 import "./bots/index.js";
 import { Address } from "viem";
@@ -68,10 +68,6 @@ declare class CreditAccountsServiceV310 extends SDKConstruct implements ICreditA
    * {@inheritDoc ICreditAccountsService.previewDelayedWithdrawal}
    **/
   previewDelayedWithdrawal({ creditAccount, amount, token, withdrawalPhantomToken, intent }: PreviewDelayedWithdrawalProps): Promise<RequestableWithdrawal>;
-  /**
-   * {@inheritDoc ICreditAccountsService.getPendingWithdrawals}
-   **/
-  getPendingWithdrawals({ creditAccount }: GetPendingWithdrawalsProps): Promise<GetPendingWithdrawalsResult>;
   /**
    * {@inheritDoc ICreditAccountsService.assembleStartDelayedWithdrawalCalls}
    **/

package/dist/types/onchain/accounts/index.d.ts

@@ -1,3 +1,4 @@
+import { InvalidDelayedIntentError } from "./withdrawal-compressor/errors.js";
 import { ClaimableWithdrawal, CurrentWithdrawals, DelayedIntentExtended, GetExternalAccountCurrentWithdrawalsProps, GetWithdrawalRequestResultProps, IRedemptionLoggerContract, IWithdrawalCompressorContract, PendingWithdrawal, RedemptionLog, RequestableWithdrawal, WithdrawableAsset, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, toWithdrawalStatus } from "./withdrawal-compressor/types.js";
 import { CreditAccountDataCall, CreditAccountFilter, CreditAccountReadOptions, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsTarget, CreditManagerFilter, GetCreditAccountsArgs, GetCreditAccountsOptions } from "./credit-account-compressor/types.js";
 import { CreditAccountCompressor } from "./credit-account-compressor/CreditAccountCompressor.js";
@@ -7,27 +8,30 @@ import { AbstractWithdrawalCompressorContract, OnchainRequestableWithdrawal, iCr
 import { WithdrawalCompressorLocation, WithdrawalCompressorVersion, getWithdrawalCompressorAddress } from "./withdrawal-compressor/addresses.js";
 import { createRedemptionLogger } from "./withdrawal-compressor/createRedemptionLogger.js";
 import { createWithdrawalCompressor } from "./withdrawal-compressor/createWithdrawalCompressor.js";
-import { InvalidDelayedIntentError } from "./withdrawal-compressor/errors.js";
 import { DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, decodeDelayedIntent, encodeDelayedIntent } from "./withdrawal-compressor/intent-codec.js";
 import { RedemptionLoggerV310Contract } from "./withdrawal-compressor/RedemptionLoggerV310Contract.js";
 import { WithdrawalCompressorV310Contract } from "./withdrawal-compressor/WithdrawalCompressorV310Contract.js";
 import { WithdrawalCompressorV311Contract } from "./withdrawal-compressor/WithdrawalCompressorV311Contract.js";
 import { WithdrawalCompressorV313Contract } from "./withdrawal-compressor/WithdrawalCompressorV313Contract.js";
 import "./withdrawal-compressor/index.js";
-import { AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, ClaimFarmRewardsProps, CloseCreditAccountResult, CreditAccountOperationResult, CreditManagerOperationResult, EncodableCreditAccountOperation, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, ICreditAccountsService, OpenCAProps, PartiallyLiquidateProps, PreviewDelayedWithdrawalProps, Rewards } from "./types.js";
+import { AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, ClaimFarmRewardsProps, CloseCreditAccountResult, CreditAccountOperationResult, CreditManagerOperationResult, EncodableCreditAccountOperation, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, ICreditAccountsService, OpenCAProps, PartiallyLiquidateProps, PreviewDelayedWithdrawalProps, Rewards } from "./types.js";
 import { AccountToCheck, BotStatusCall, BotsDirectResponse, CMSlice, ConnectedBotsCall, ConnectedBotsPerAccount, GetConnectedBotsResponse, GetConnectedBotsResult, GetConnectedMigrationBotsResult, MulticallWithFailure, SetBotProps, SetBotResult } from "./bots/types.js";
 import { AccountBotsService } from "./bots/AccountBotsService.js";
 import { PeripheryCompressorV310Contract } from "./bots/PeripheryCompressorV310Contract.js";
 import "./bots/index.js";
 import { CreditAccountsServiceV310 } from "./CreditAccountsServiceV310.js";
-import { OpenStrategyPreview, OpenStrategyProps } from "./intents/open-strategy.js";
-import { AddCollateralIntent, AdjustLeverageIntent, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, InstantRoute, IntentPreviewError, IntentPreviewResult, IntentRoutesResult, OperationState, PreviewErrorReason, RepayStrategyIntent, ResumableIntent, RouteRefusals, StartIntent, WithdrawAssetIntent, WithdrawStrategyIntent } from "./intents/types.js";
+import { borrowable } from "./intents/guards.js";
+import { LeverageBand } from "./intents/leverage-band.js";
+import { CalcDefaultQuotaProps, CalcQuotaUpdateProps, CalcRecommendedQuotaProps, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, roundUpQuota } from "./quota-utils.js";
 import { AccountCalculatorOperation } from "./intents/operations.js";
+import { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteRefusals, StartIntent, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent } from "./intents/types.js";
+import { OpenStrategyProps, OpenStrategyState } from "./intents/open-strategy.js";
 import { fetchCreditAccountSlice, toCreditAccountSlice } from "./intents/utils/credit-account-slice.js";
+import { isPhantomToken } from "./intents/utils/pick-token.js";
 import { CreditAccountOperationsService, OpenStrategyPreviewResult } from "./intents/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./liquidations/constants.js";
 import { BuildLiquidationTxProps, BuildLiquidationTxPropsBase, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationDetailsPropsBase, GetLiquidationPositionsProps, GetLiquidationPositionsPropsBase, LoadRWALiquidatorsProps, OnchainLiquidationCall, OnchainLiquidationData, OnchainLiquidationOutput, RWALiquidatorInfo } from "./liquidations/types.js";
 import { LiquidationsService } from "./liquidations/LiquidationsService.js";
 import { MultichainLiquidationsService } from "./liquidations/MultichainLiquidationsService.js";
 import "./liquidations/index.js";
-export { AbstractWithdrawalCompressorContract, AccountBotsService, type AccountCalculatorOperation, AccountToCheck, type AddCollateralIntent, type AdjustLeverageIntent, AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, BotStatusCall, BotsDirectResponse, BuildLiquidationTxProps, BuildLiquidationTxPropsBase, CMSlice, ClaimFarmRewardsProps, ClaimableWithdrawal, CloseCreditAccountResult, ConnectedBotsCall, ConnectedBotsPerAccount, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountDataCall, CreditAccountFilter, CreditAccountOperationResult, CreditAccountOperationsService, CreditAccountReadOptions, type CreditAccountSlice, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsServiceV310, CreditAccountsTarget, CreditManagerFilter, CreditManagerOperationResult, CurrentWithdrawals, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, type DelayableIntent, DelayedIntentExtended, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, EncodableCreditAccountOperation, type FinishIntentProps, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResponse, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsArgs, GetCreditAccountsOptions, GetExternalAccountCurrentWithdrawalsProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationDetailsPropsBase, GetLiquidationPositionsProps, GetLiquidationPositionsPropsBase, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, GetWithdrawalRequestResultProps, ICreditAccountsService, IRedemptionLoggerContract, IWithdrawalCompressorContract, type InstantRoute, IntentPreviewError, type IntentPreviewResult, type IntentRoutesResult, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, LoadRWALiquidatorsProps, MulticallWithFailure, MultichainLiquidationsService, OnchainLiquidationCall, OnchainLiquidationData, OnchainLiquidationOutput, OnchainRequestableWithdrawal, OpenCAProps, type OpenStrategyPreview, OpenStrategyPreviewResult, type OpenStrategyProps, type OperationState, PartiallyLiquidateProps, PendingWithdrawal, PeripheryCompressorV310Contract, PreviewDelayedWithdrawalProps, type PreviewErrorReason, RWALiquidatorInfo, RedemptionLog, RedemptionLoggerV310Contract, type RepayStrategyIntent, RequestableWithdrawal, type ResumableIntent, Rewards, type RouteRefusals, SetBotProps, SetBotResult, type StartIntent, type WithdrawAssetIntent, type WithdrawStrategyIntent, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+export { AbstractWithdrawalCompressorContract, AccountBotsService, type AccountCalculatorOperation, AccountToCheck, type AddCollateralIntent, type AdjustLeverageIntent, AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, BotStatusCall, BotsDirectResponse, BuildLiquidationTxProps, BuildLiquidationTxPropsBase, CMSlice, CalcDefaultQuotaProps, CalcQuotaUpdateProps, CalcRecommendedQuotaProps, ClaimFarmRewardsProps, type ClaimRemainder, ClaimableWithdrawal, CloseCreditAccountResult, ConnectedBotsCall, ConnectedBotsPerAccount, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountDataCall, CreditAccountFilter, CreditAccountOperationResult, CreditAccountOperationsService, CreditAccountReadOptions, type CreditAccountSlice, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsServiceV310, CreditAccountsTarget, CreditManagerFilter, CreditManagerOperationResult, CurrentWithdrawals, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, type DelayableIntent, DelayedIntentExtended, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, EncodableCreditAccountOperation, type FinishIntentProps, type FinishIntentResult, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResponse, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsArgs, GetCreditAccountsOptions, GetExternalAccountCurrentWithdrawalsProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationDetailsPropsBase, GetLiquidationPositionsProps, GetLiquidationPositionsPropsBase, GetWithdrawalRequestResultProps, ICreditAccountsService, IRedemptionLoggerContract, IWithdrawalCompressorContract, type InstantRoute, type IntentPreviewResult, type IntentRoutesResult, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, type LeverageBand, LiquidationsService, LoadRWALiquidatorsProps, MulticallWithFailure, MultichainLiquidationsService, OnchainLiquidationCall, OnchainLiquidationData, OnchainLiquidationOutput, OnchainRequestableWithdrawal, OpenCAProps, OpenStrategyPreviewResult, type OpenStrategyProps, type OpenStrategyState, type OperationState, PartiallyLiquidateProps, type PathLossRate, PendingWithdrawal, PeripheryCompressorV310Contract, PreviewDelayedWithdrawalProps, RWALiquidatorInfo, RedemptionLog, RedemptionLoggerV310Contract, type RepayStrategyIntent, RequestableWithdrawal, type ResumableIntent, Rewards, type RouteRefusals, SetBotProps, SetBotResult, type StartIntent, type WithdrawAssetIntent, type WithdrawCeilings, type WithdrawStrategyIntent, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, borrowable, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, isPhantomToken, roundUpQuota, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

package/dist/types/onchain/accounts/intents/guards.d.ts

@@ -2,6 +2,7 @@ import { Asset } from "../../base/types.js";
 import { MarketSuite } from "../../market/MarketSuite.js";
 import { CreditSuite } from "../../market/credit/CreditSuite.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
+import { BorrowLimitBinding } from "../../validation/refusal.js";
 import "../../index.js";
 //#region src/onchain/accounts/intents/guards.d.ts
 /**
@@ -12,6 +13,11 @@ import "../../index.js";
  * pool has run out of what it lends. On-chain those come back as a reverted
  * multicall with a selector no form can explain, so they are read from the
  * loaded market and reported as refusals instead.
+ *
+ * Every guard here refuses something the market decides rather than something
+ * the arithmetic cannot do, which is why all six of their reasons are
+ * `blocking`: the walk that hit one still reached an end state, and a caller
+ * gets that state alongside the refusal.
  */
 /**
  * The facade takes no multicall while it is paused or past its expiration, so
@@ -24,9 +30,12 @@ declare function assertMarketOperable(suite: CreditSuite): void;
  * facade puts on a single borrow. A zero multiplier switches borrowing off
  * outright, which reads here as nothing being available.
  */
-declare function borrowable(suite: CreditSuite): bigint;
+declare function borrowable(suite: CreditSuite): {
+  limit: bigint;
+  binding: BorrowLimitBinding;
+};
 /** The pool has to be able to lend what the plan means to draw. */
-declare function assertCanBorrow(suite: CreditSuite, amount: bigint): void;
+declare function assertCanBorrow(sdk: OnchainSDK, suite: CreditSuite, amount: bigint): void;
 /**
  * What the account is allowed to end up holding more of than it started with.
  *
@@ -51,10 +60,23 @@ declare function assertGrowthAllowed(args: {
  * and reverts if the collateral does not cover it, so a plan that lands the
  * account below water is refused here.
  *
- * The bar is the health factor of the state the plan projects: collateral under
- * liquidation thresholds, capped by quota, against the debt. Note that a
- * position already underwater cannot be nursed back one step at a time — the
- * check is on where the transaction ends, not on whether it improved things.
+ * The bar is the facade's own `1.0`, because this guard answers one question:
+ * would the transaction revert. It is deliberately not `MIN_HF_LIMITED`, and
+ * the three bars in this codebase are three different jobs:
+ *
+ * - here, `1.0` — what the facade enforces, so what a plan must clear to land;
+ * - `maxWithdrawCollateral` sizes at `MIN_HF_LIMITED + 2` — a *sizing* helper
+ *   leaving headroom, which is not the same as a validity check;
+ * - a form refuses at or below `MIN_HF_LIMITED` (`MIN_HEALTH_FACTOR_FORM`).
+ *
+ * Raising this one to `MIN_HF_LIMITED` was tried and reverted: it made
+ * `maxWithdraw` hand back a ceiling this guard then refused, and it blocked
+ * small top-ups of an account sitting in `[1.0, 1.01)` — the very operations
+ * that rescue it. A form wanting the stricter bar has `validateHF`.
+ *
+ * Note that a position already underwater cannot be nursed back one step at a
+ * time — the check is on where the transaction ends, not on whether it
+ * improved things.
  *
  * @remarks
  * The caller decides the pricing the factor was computed at: main prices, or
@@ -62,11 +84,11 @@ declare function assertGrowthAllowed(args: {
  * whose reserve feed the SDK cannot read keeps its main price, so a plan can
  * still be refused on-chain after passing here.
  */
-declare function assertCollateralised(healthFactorBps: number): void;
+declare function assertCollateralised(healthFactorBps: number, safePrices: boolean): void;
 /**
  * A quota can only be raised as far as the market still has room for: past the
  * token's limit the keeper takes nothing more, whoever is asking.
  */
-declare function assertQuotaHeadroom(market: MarketSuite, increases: readonly Asset[]): void;
+declare function assertQuotaHeadroom(sdk: OnchainSDK, market: MarketSuite, increases: readonly Asset[]): void;
 //#endregion
 export { assertCanBorrow, assertCollateralised, assertGrowthAllowed, assertMarketOperable, assertQuotaHeadroom, borrowable };

package/dist/types/onchain/accounts/intents/index.d.ts

@@ -1,8 +1,12 @@
 import { SDKConstruct } from "../../base/SDKConstruct.js";
-import { OpenStrategyPreview, OpenStrategyProps } from "./open-strategy.js";
-import { AddCollateralIntent, AdjustLeverageIntent, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, InstantRoute, IntentPreviewError, IntentPreviewResult, IntentRoutesResult, OperationState, PreviewErrorReason, RepayStrategyIntent, ResumableIntent, RouteRefusals, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawStrategyIntent } from "./types.js";
+import { PreviewRefusal } from "../../validation/refusal.js";
+import { borrowable } from "./guards.js";
+import { LeverageBand, LeverageBandProps } from "./leverage-band.js";
 import { AccountCalculatorOperation } from "./operations.js";
+import { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteRefusals, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent } from "./types.js";
+import { OpenStrategyProps, OpenStrategyState } from "./open-strategy.js";
 import { fetchCreditAccountSlice, toCreditAccountSlice } from "./utils/credit-account-slice.js";
+import { isPhantomToken } from "./utils/pick-token.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/index.d.ts
 /**
@@ -14,11 +18,8 @@ import { Address } from "viem";
  */
 type OpenStrategyPreviewResult = {
   ok: true;
-  preview: OpenStrategyPreview;
-} | {
-  ok: false;
-  reason: PreviewErrorReason;
-};
+  state: OpenStrategyState;
+} | PreviewRefusal;
 /** An intent plus everything previewing it needs. */
 type StartProps = StartIntentProps & {
   intent: StartIntent;
@@ -42,15 +43,22 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    */
   startIntent(props: StartProps): Promise<IntentPreviewResult>;
   /**
-   * Largest `WITHDRAW` amount (in underlying) the account can take out while
-   * keeping leverage and staying inside the facade's debt band — the ceiling a
-   * withdraw form should offer. Taking everything out is the same intent with
-   * `MAX_UINT256` for an amount, and needs none of this arithmetic.
+   * Both ends of what a `WITHDRAW` can take out, in underlying: the largest
+   * partial withdrawal that keeps leverage and stays inside the facade's debt
+   * band, and the net value an exit hands over. They are reported together
+   * because a withdraw form needs both — the range it may offer, and the one
+   * amount past it that is allowed — and because the distance between them is
+   * the account's own, not a constant a caller could assume.
+   *
+   * Takes no target health factor, unlike {@link maxWithdrawCollateral}: a
+   * proportional withdrawal leaves the factor where it found it, and the
+   * facade's `minDebt` is what bounds it.
    *
    * @param props - Account slice and the SDK holding its market
-   * @returns Amount in underlying units; `0n` when nothing can leave
+   * @returns The two ceilings, see {@link WithdrawCeilings} for the gap between
+   * them
    */
-  maxWithdraw(props: Pick<StartIntentProps, "creditAccount" | "sdk">): bigint;
+  maxWithdraw(props: Pick<StartIntentProps, "creditAccount" | "sdk">): WithdrawCeilings;
   /**
    * Debt a `REPAY` would have to cover to settle the account, in underlying
    * units: principal plus the interest and fees accrued as of the read.
@@ -65,19 +73,41 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    * @returns Amount in underlying units; `0n` on an account that owes nothing
    */
   maxRepay(props: Pick<StartIntentProps, "creditAccount" | "sdk">): bigint;
+  /**
+   * The leverages a position of a given size can be opened at, or moved to.
+   *
+   * A credit manager's `maxLeverage` follows from the liquidation threshold
+   * alone, so it is the same for a hundred dollars and for a million. What a
+   * given deposit reaches is decided by the debt it implies and by the band
+   * the market puts that debt in — the range a leverage slider should offer.
+   *
+   * Unlike the other ceilings here this one reads no account: opening has none
+   * yet, and adjusting measures against the net value the caller already
+   * holds. Nothing is fetched, so a form can ask on every keystroke.
+   *
+   * @param props - The manager, the SDK holding its market, what stands
+   * behind the position, and optionally the health factor the ceiling should
+   * leave
+   * @returns The band, or nothing when the market has none to offer
+   */
+  leverageBand(props: LeverageBandProps): LeverageBand | undefined;
   /**
    * Largest `WITHDRAW_ASSET` amount of one token the account can take out
-   * while its health factor stays at {@link MIN_HF_LIMITED} plus a basis
-   * point — the ceiling a withdraw-collateral form should offer. Thresholds,
-   * prices and quota activity come from the account's market, valued the way
-   * the facade values a call that pays out; zero debt frees the whole balance.
+   * while its health factor stays at `targetHF` — the ceiling a
+   * withdraw-collateral form should offer. Thresholds, prices and quota
+   * activity come from the account's market, valued the way the facade values
+   * a call that pays out; zero debt frees the whole balance.
    *
-   * @param props - Account slice, the SDK holding its market, and the
-   * collateral to withdraw
+   * The default is {@link MIN_HF_LIMITED}, the bar a form holds an
+   * account to.
+   *
+   * @param props - Account slice, the SDK holding its market, the collateral
+   * to withdraw, and optionally the health factor to leave behind
    * @returns Amount in the token's units; `0n` when nothing can leave
    */
   maxWithdrawCollateral(props: Pick<StartIntentProps, "creditAccount" | "sdk"> & {
     token: Address;
+    targetHF?: bigint;
   }): bigint;
   /**
    * Previews the same operation when its source only redeems through its
@@ -135,12 +165,17 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    * whole tail: the tokens land on the account and only their quota has to
    * catch up.
    *
+   * A claim that brought only part of what the request queued — a legacy Mellow
+   * multivault, which pays out what it holds liquid and re-queues the rest — is
+   * served in proportion, and what it did not settle comes back as `remainder`:
+   * the withdrawal still in flight and the intent to finish it with.
+   *
    * @param props - The recorded intent, the account slice as it stands now, and
    * the matured claimable
-   * @returns Shaped exactly like {@link startIntent}'s result, so both halves of
-   * an operation are consumed the same way
+   * @returns Shaped exactly like {@link startIntent}'s result with the remainder
+   * beside it, so both halves of an operation are consumed the same way
    */
-  finishIntent(props: FinishIntentProps): Promise<IntentPreviewResult>;
+  finishIntent(props: FinishIntentProps): Promise<FinishIntentResult>;
   /**
    * Previews opening a brand-new leveraged position.
    *
@@ -156,4 +191,4 @@ declare class CreditAccountOperationsService extends SDKConstruct {
   openStrategyIntent(props: OpenStrategyProps): Promise<OpenStrategyPreviewResult>;
 }
 //#endregion
-export { type AccountCalculatorOperation, type AddCollateralIntent, type AdjustLeverageIntent, CreditAccountOperationsService, type CreditAccountSlice, type DelayableIntent, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, type FinishIntentProps, type InstantRoute, IntentPreviewError, type IntentPreviewResult, type IntentRoutesResult, type OpenStrategyPreview, OpenStrategyPreviewResult, type OpenStrategyProps, type OperationState, type PreviewErrorReason, type RepayStrategyIntent, type ResumableIntent, type RouteRefusals, type StartIntent, type WithdrawAssetIntent, type WithdrawStrategyIntent, fetchCreditAccountSlice, toCreditAccountSlice };
+export { type AccountCalculatorOperation, type AddCollateralIntent, type AdjustLeverageIntent, type ClaimRemainder, CreditAccountOperationsService, type CreditAccountSlice, type DelayableIntent, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, type FinishIntentProps, type FinishIntentResult, type InstantRoute, type IntentPreviewResult, type IntentRoutesResult, type LeverageBand, OpenStrategyPreviewResult, type OpenStrategyProps, type OpenStrategyState, type OperationState, type PathLossRate, type RepayStrategyIntent, type ResumableIntent, type RouteRefusals, type StartIntent, type WithdrawAssetIntent, type WithdrawCeilings, type WithdrawStrategyIntent, borrowable, fetchCreditAccountSlice, isPhantomToken, toCreditAccountSlice };

package/dist/types/onchain/accounts/intents/leverage-band.d.ts

@@ -0,0 +1,58 @@
+import { Bps, Leverage } from "../../../model/primitives.js";
+import "../../../model/index.js";
+import { Asset } from "../../base/types.js";
+import { OnchainSDK } from "../../OnchainSDK.js";
+import "../../index.js";
+import { Address } from "viem";
+//#region src/onchain/accounts/intents/leverage-band.d.ts
+/** The leverages a position of a given size can be opened at, or moved to. */
+interface LeverageBand {
+  readonly min: Leverage;
+  readonly max: Leverage;
+}
+interface LeverageBandProps {
+  readonly sdk: OnchainSDK;
+  /** Credit manager the position lives in; every limit is read off it. */
+  readonly creditManager: Address;
+  /**
+   * What stands behind the position: the tokens being deposited when opening
+   * one, or its own net value when adjusting one. Priced into the market's
+   * underlying here, so a caller hands over amounts and no exchange rates.
+   **/
+  readonly collateral: readonly Asset[];
+  /**
+   * Health factor the maxed leverage should leave the position at, in basis
+   * points. Omitted keeps `calcMaxLeverage` on its flat buffer.
+   **/
+  readonly targetHF?: Bps;
+}
+/**
+ * The leverages this market will actually fund for a position of this size.
+ *
+ * A credit manager's `maxLeverage` follows from the liquidation threshold
+ * alone, so it is the same for a hundred dollars and for a million. What a
+ * given deposit reaches is decided by the debt it implies —
+ * `debt = netValue × (leverage − 1)` — and by the band the market puts that
+ * debt in. This inverts that relation.
+ *
+ * Rounding is asymmetric because the forward direction truncates: the floor
+ * rounds **up** so the leverage it names really does clear `minDebt`, and the
+ * ceiling rounds **down** so it really does stay under the borrow limit.
+ *
+ * Nothing here is fetched or simulated — every input is loaded market state,
+ * so a form can call this on each keystroke.
+ *
+ * @param props - {@link LeverageBandProps}
+ * @returns The band, or `undefined` when there is nothing to offer: an
+ * unknown manager, a market with no strategy, or a deposit too small to reach
+ * `minDebt` at any leverage the threshold allows.
+ *
+ * @example
+ * ```ts
+ * // minDebt 1k, borrow limit 100k, threshold ceiling 9x, deposit worth 10k
+ * calcLeverageBand({ sdk, creditManager, collateral }) // { min: 1.1, max: 9 }
+ * ```
+ **/
+declare function calcLeverageBand({ sdk, creditManager, collateral, targetHF }: LeverageBandProps): LeverageBand | undefined;
+//#endregion
+export { LeverageBand, LeverageBandProps, calcLeverageBand };

package/dist/types/onchain/accounts/intents/math.d.ts

@@ -1,3 +1,5 @@
+import { OnchainSDK } from "../../OnchainSDK.js";
+import { Address } from "viem";
 //#region src/onchain/accounts/intents/math.d.ts
 /**
  * The whole arithmetic behind every intent, in underlying units.
@@ -41,6 +43,6 @@ declare function assertLeverageAtLeastOne(leverage: bigint): void;
  * Rejects a debt the facade would revert on: zero is always fine (no loan at
  * all), anything else has to sit inside `[minDebt, maxDebt]`.
  */
-declare function assertDebtInBand(debt: bigint, band: DebtBand): void;
+declare function assertDebtInBand(sdk: OnchainSDK, debt: bigint, band: DebtBand, underlying: Address): void;
 //#endregion
 export { DebtBand, Position, assertDebtInBand, assertLeverageAtLeastOne, debtForLeverage, maxProportionalWithdrawal, proportionalDebt };

package/dist/types/onchain/accounts/intents/maxWithdrawCollateral.d.ts

@@ -19,9 +19,11 @@ interface MaxWithdrawCollateralProps {
  * check counts: a holding backed by a quota contributes the lesser of the
  * quota and its threshold-weighted value, an unquoted one — the underlying —
  * its weighted value alone, and dust or a disabled balance nothing at all.
- * Collateral is valued at the lower of its two feeds, the way the facade
- * values a call that hands funds over; the debt is valued at the main feed,
- * as the check does. Zero debt frees the whole balance.
+ * Collateral is valued at the protocol safe price (`min` of the two feeds,
+ * 0 when there is no reserve), the way the facade values a call that hands
+ * funds over; the underlying is exempt and is valued at the main feed, as
+ * `CreditManagerV3._safeConvertToUSD` does. The debt is valued at the main
+ * feed, as the check does. Zero debt frees the whole balance.
  *
  * Rounding always favours the account, so the answer clears the check rather
  * than landing a wei short of it.

package/dist/types/onchain/accounts/intents/open-strategy.d.ts

@@ -1,9 +1,10 @@
-import { Bps, TokenAmount } from "../../../model/primitives.js";
-import { BorrowRateBreakdown } from "../../../model/positions.js";
+import { TokenAmount } from "../../../model/primitives.js";
+import { AccountProjection } from "../../../model/previews.js";
 import "../../../model/index.js";
 import { Asset } from "../../base/types.js";
 import { MultiCall } from "../../types/transactions.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
+import { SimulationPrices } from "./types.js";
 import "../../index.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/open-strategy.d.ts
@@ -31,40 +32,18 @@ interface OpenStrategyProps {
  * hands back expected and floor balances from a single call, and `openCA` wants
  * both `minQuota` and `averageQuota`, so there is nothing to gain by dropping one.
  */
-interface OpenStrategyPreview {
-  /**
-   * Health factor in basis points: below `10000` the account is liquidatable.
-   *
-   * @example `12500` for a health factor of 1.25
-   **/
-  healthFactor: Bps;
-  /**
-   * Cost of the debt, broken down by source.
-   **/
-  borrowRate: BorrowRateBreakdown;
-  /**
-   * Estimated milliseconds until the health factor decays to `10000` under
-   * the current borrow rate, or `null` when the debt carries no rate (or the
-   * account is already liquidatable).
-   **/
-  timeToLiquidation: bigint | null;
-  /**
-   * Price of the single non-underlying collateral at which the account
-   * becomes liquidatable, in the oracle's 8-decimal fixed point, or `null`
-   * when the account holds zero or several non-underlying assets.
-   **/
-  liquidationPrice: bigint | null;
-  /** Debt drawn, in underlying. */
-  debt: bigint;
-  /** Collateral supplied, valued in underlying. */
-  collateral: bigint;
-  /** Position size — collateral plus debt, in underlying. */
-  totalValue: bigint;
+interface OpenStrategyState extends Omit<AccountProjection, "assets" | "quotas">, SimulationPrices {
   /** Expected post-open balances. */
   averageAssets: TokenAmount[];
   /** Floor post-open balances after slippage. */
   minAssets: TokenAmount[];
-  /** Quotas to buy against `averageAssets`; feeds `openCA.averageQuota`. */
+  /**
+   * Quotas to buy against `averageAssets`; feeds `openCA.averageQuota`.
+   *
+   * Bare pairs rather than priced amounts, like `calls` below: these three are
+   * transport for the transaction, handed to `openCA` untouched, and are the
+   * only fields here a caller is not meant to display.
+   **/
   averageQuota: Asset[];
   /** Quotas to buy against `minAssets`; feeds `openCA.minQuota`. */
   minQuota: Asset[];
@@ -72,7 +51,8 @@ interface OpenStrategyPreview {
   calls: MultiCall[];
 }
 /**
- * Previews opening a leveraged position out of wallet collateral.
+ * Builds the state opening a leveraged position out of wallet collateral would
+ * reach.
  *
  * Debt follows from the target leverage against the supplied margin
  * (`debt = margin * (L - 1)`, `totalValue = margin * L`); the collateral and the
@@ -82,6 +62,6 @@ interface OpenStrategyPreview {
  * no operation list — the caller passes the numbers and calls straight to
  * `sdk.accounts.openCA`.
  */
-declare function previewOpenStrategy(props: OpenStrategyProps): Promise<OpenStrategyPreview>;
+declare function buildOpenStrategyState(props: OpenStrategyProps): Promise<OpenStrategyState>;
 //#endregion
-export { OpenStrategyPreview, OpenStrategyProps, previewOpenStrategy };
+export { OpenStrategyProps, OpenStrategyState, buildOpenStrategyState };

package/dist/types/onchain/accounts/intents/operations.d.ts

@@ -3,7 +3,7 @@ import { Asset } from "../../base/types.js";
 import { MultiCall } from "../../types/transactions.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
 import { EncodableCreditAccountOperation } from "../types.js";
-import { calcQuotaUpdate } from "../../../common-utils/utils/creditAccount/quota-utils.js";
+import { calcQuotaUpdate } from "../quota-utils.js";
 import { CreditAccountSlice } from "./types.js";
 import "../../index.js";
 import { Address } from "viem";

package/dist/types/onchain/accounts/intents/plan.d.ts

@@ -1,6 +1,7 @@
 import { DelayedIntent } from "../../../model/delayed-intents.js";
 import "../../../model/index.js";
 import { ClaimableWithdrawal } from "../withdrawal-compressor/types.js";
+import { OnchainSDK } from "../../OnchainSDK.js";
 import { AddCollateralIntent, AdjustLeverageIntent, DepositStrategyIntent, RepayStrategyIntent, WithdrawAssetIntent, WithdrawStrategyIntent } from "./types.js";
 import { DebtBand } from "./math.js";
 import { Address } from "viem";
@@ -100,6 +101,8 @@ type Step = {
 /** What a planner is allowed to know about the account. */
 interface AccountView {
   underlying: Address;
+  /** The attached SDK, for the guards that inline a token into a refusal. */
+  sdk: OnchainSDK;
   /** Raw asset of an RWA market (e.g. USDC behind dcUSDC); undefined otherwise. */
   rwaAsset: Address | undefined;
   debt: bigint;
@@ -107,7 +110,7 @@ interface AccountView {
   collateral: bigint;
   band: DebtBand;
   balanceOf(token: Address): bigint;
-  /** Oracle conversion, RWA-aware. */
+  /** Oracle conversion; unpriceable tokens contribute 0n. */
   price(from: Address, to: Address, amount: bigint): bigint;
   /** Most valuable non-phantom balance, or undefined when there is none. */
   fattest(exclude?: Address[]): Address | undefined;

package/dist/types/onchain/accounts/intents/realize.d.ts

@@ -1,7 +1,7 @@
 import { MultiCall } from "../../types/transactions.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
-import { CreditAccountSlice, DelayedStart, OperationState } from "./types.js";
 import { AccountCalculatorOperation } from "./operations.js";
+import { CreditAccountSlice, DelayedStart, OperationState } from "./types.js";
 import "../../index.js";
 import { Step } from "./plan.js";
 import { RouterPaths } from "./utils/router-path.js";