@gearbox-protocol/sdk 16.2.0 → 16.3.0-next.2

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

@@ -4,6 +4,7 @@ import { DataResponse } from "../../model/response.js";
 import { GearboxAPIOptions } from "../types.js";
 import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";
 import { IOffchainOpportunities, OpportunityChartMetricFor } from "./types.js";
+import { Address } from "viem";
 //#region src/offchain/opportunities/OffchainOpportunities.d.ts
 /**
  * Backend counterpart of the `opportunities` namespace.
@@ -22,7 +23,7 @@ declare class OffchainOpportunities extends AbstractOffchainNamespace implements
   /**
    * {@inheritDoc IOffchainOpportunities.getStrategy}
    **/
-  getStrategy(key: StrategyOpportunityKey): Promise<DataResponse<StrategyOpportunityDetail>>;
+  getStrategy(key: StrategyOpportunityKey, _wallet?: Address): Promise<DataResponse<StrategyOpportunityDetail>>;
   /**
    * {@inheritDoc IOffchainOpportunities.getTotals}
    **/

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

@@ -1,6 +1,7 @@
 import { ChartBundle, ChartRange, PoolOpportunityChartMetric, StrategyOpportunityChartMetric } from "../../model/charts.js";
 import { Opportunity, OpportunityFilter, OpportunityKey, OpportunityTotals, PoolOpportunityDetail, PoolOpportunityKey, StrategyOpportunityDetail, StrategyOpportunityKey } from "../../model/opportunities.js";
 import { DataResponse } from "../../model/response.js";
+import { Address } from "viem";
 //#region src/offchain/opportunities/types.d.ts
 type OpportunityChartMetricFor<K extends OpportunityKey> = {
   pool: PoolOpportunityChartMetric;
@@ -21,8 +22,10 @@ interface IOffchainOpportunities {
   getPool(key: PoolOpportunityKey): Promise<DataResponse<PoolOpportunityDetail>>;
   /**
    * Detailed view of one strategy opportunity.
+   *
+   * @param wallet - Optional wallet address to check KYC status for.
    **/
-  getStrategy(key: StrategyOpportunityKey): Promise<DataResponse<StrategyOpportunityDetail>>;
+  getStrategy(key: StrategyOpportunityKey, wallet?: Address): Promise<DataResponse<StrategyOpportunityDetail>>;
   /**
    * Protocol-wide totals across every opportunity the backend serves.
    **/

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

@@ -1,6 +1,8 @@
+import { RWAOpenAccountRequirements } from "../../model/rwa.js";
+import "../../model/index.js";
 import { RequestableWithdrawal } from "./withdrawal-compressor/types.js";
 import { Asset, CreditAccountData, CreditAccountTokensSlice, PermitResult } from "../base/types.js";
-import { GetOpenAccountRequirementsProps, RWAOpenAccountRequirements } from "../market/rwa/types.js";
+import { GetOpenAccountRequirementsProps } from "../market/rwa/types.js";
 import "../market/rwa/index.js";
 import { PriceUpdate } from "../market/pricefeeds/types.js";
 import { PrepareUpdateQuotasProps } from "../market/credit/types.js";

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

@@ -1,4 +1,3 @@
-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";
@@ -20,11 +19,10 @@ import { AccountBotsService } from "./bots/AccountBotsService.js";
 import { PeripheryCompressorV310Contract } from "./bots/PeripheryCompressorV310Contract.js";
 import "./bots/index.js";
 import { CreditAccountsServiceV310 } from "./CreditAccountsServiceV310.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 { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteErrors, 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";
@@ -34,4 +32,4 @@ import { BuildLiquidationTxProps, BuildLiquidationTxPropsBase, GetLiquidatableAc
 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, 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 };
+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, 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 RouteErrors, SetBotProps, SetBotResult, type StartIntent, type WithdrawAssetIntent, type WithdrawCeilings, type WithdrawStrategyIntent, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, 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,7 +2,6 @@ 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
 /**
@@ -24,16 +23,6 @@ import "../../index.js";
  * every intent the engine previews would revert on arrival.
  */
 declare function assertMarketOperable(suite: CreditSuite): void;
-/**
- * What the pool will hand this manager in one transaction: the tightest of its
- * free liquidity, the manager's remaining debt limit and the per-block cap the
- * 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): {
-  limit: bigint;
-  binding: BorrowLimitBinding;
-};
 /** The pool has to be able to lend what the plan means to draw. */
 declare function assertCanBorrow(sdk: OnchainSDK, suite: CreditSuite, amount: bigint): void;
 /**
@@ -60,19 +49,20 @@ 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 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:
+ * The threshold 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 thresholds 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;
+ *   leaving a margin, 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`.
+ * that rescue it. A form wanting the stricter threshold 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
@@ -89,6 +79,6 @@ declare function assertCollateralised(healthFactorBps: number, safePrices: boole
  * 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(sdk: OnchainSDK, market: MarketSuite, increases: readonly Asset[]): void;
+declare function assertQuotaAvailable(sdk: OnchainSDK, market: MarketSuite, increases: readonly Asset[]): void;
 //#endregion
-export { assertCanBorrow, assertCollateralised, assertGrowthAllowed, assertMarketOperable, assertQuotaHeadroom, borrowable };
+export { assertCanBorrow, assertCollateralised, assertGrowthAllowed, assertMarketOperable, assertQuotaAvailable };

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

@@ -1,9 +1,10 @@
+import { SDKError } from "../../../model/result.js";
+import "../../../model/index.js";
 import { SDKConstruct } from "../../base/SDKConstruct.js";
-import { PreviewRefusal } from "../../validation/refusal.js";
-import { borrowable } from "./guards.js";
+import { IntentValidationError } from "../../validation/raise.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 { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteErrors, 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";
@@ -19,7 +20,7 @@ import { Address } from "viem";
 type OpenStrategyPreviewResult = {
   ok: true;
   state: OpenStrategyState;
-} | PreviewRefusal;
+} | SDKError<IntentValidationError>;
 /** An intent plus everything previewing it needs. */
 type StartProps = StartIntentProps & {
   intent: StartIntent;
@@ -37,15 +38,15 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    * Previews an operation on an existing account.
    *
    * @param props - Intent plus account slice, quota reserve and slippage
-   * @returns Operations, projected state and calldata, or `{ ok: false, reason }`
+   * @returns Operations, projected state and calldata, or `{ ok: false, error }`
    * when the intent cannot be satisfied (e.g. the account lacks the source
    * balance)
    */
   startIntent(props: StartProps): Promise<IntentPreviewResult>;
   /**
    * 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
+   * partial withdrawal that keeps leverage and stays inside the facade's
+   * `debtLimits`, 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.
@@ -78,8 +79,8 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    *
    * 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.
+   * given deposit reaches is decided by the debt it implies and by the
+   * `debtLimits` 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
@@ -96,9 +97,9 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    * 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.
+   * a call that withdraws collateral; zero debt frees the whole balance.
    *
-   * The default is {@link MIN_HF_LIMITED}, the bar a form holds an
+   * The default is {@link MIN_HF_LIMITED}, the threshold a form holds an
    * account to.
    *
    * @param props - Account slice, the SDK holding its market, the collateral
@@ -115,8 +116,8 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    *
    * Sits apart from {@link startIntent} because it is a different trade route,
    * not a different intent: the request goes to the issuer instead of the
-   * router, and the proceeds — hence the repayment and the payout — arrive days
-   * later. Both routes of one intent are quoted together by
+   * router, and what it sells for — hence the repayment and the withdrawal —
+   * arrives days later. Both routes of one intent are quoted together by
    * {@link intentRoutes}; this is the one to call when the delayed route is the
    * only one of interest.
    *
@@ -128,7 +129,7 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    *
    * @param props - Intent plus account slice, quota reserve and slippage
    * @returns The request transaction, the state it ends in and what it recorded
-   * for the tail, or `{ ok: false, reason }` — `noDelayedRoute` when this route
+   * for the tail, or `{ ok: false, error }` — `noDelayedRoute` when this route
    * does not exist for the account at all
    */
   startDelayedIntent(props: StartIntentProps & {
@@ -141,7 +142,7 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    * Which routes an account has depends on the intent and the token it sells,
    * and a form has to know before it can offer a choice — so both are quoted
    * from the same request and each is reported on its own. A route the account
-   * cannot take comes back `undefined` with its refusal in `refused`; only when
+   * cannot take comes back `undefined` with its error in `errors`; only when
    * neither answers is the whole result `{ ok: false }`.
    *
    * A route that could not be quoted at all — a pathfinder with no path out of
@@ -151,7 +152,7 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    *
    * @param props - A withdraw or adjust-leverage intent plus account slice,
    * quota reserve and slippage
-   * @returns Whichever routes are viable, or `{ ok: false, reason }` when none is
+   * @returns Whichever routes are viable, or `{ ok: false, error }` when none is
    */
   intentRoutes(props: StartIntentProps & {
     intent: DelayableIntent;
@@ -166,7 +167,7 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    * 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
+   * multivault, which hands over 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.
    *
@@ -185,10 +186,10 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    *
    * @param props - Credit manager, wallet collateral, target token and leverage
    * @returns Debt, position size, projected balances and quotas for both the
-   * expected and the floor branch, or `{ ok: false, reason }` when the requested
+   * expected and the floor branch, or `{ ok: false, error }` when the requested
    * leverage or the resulting debt is not viable
    */
   openStrategyIntent(props: OpenStrategyProps): Promise<OpenStrategyPreviewResult>;
 }
 //#endregion
-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 };
+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 RouteErrors, type StartIntent, type WithdrawAssetIntent, type WithdrawCeilings, type WithdrawStrategyIntent, fetchCreditAccountSlice, isPhantomToken, toCreditAccountSlice };

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

@@ -32,7 +32,7 @@ interface LeverageBandProps {
  * 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 = netValue × (leverage − 1)` — and by the `debtLimits` the market puts that
  * debt in. This inverts that relation.
  *
  * Rounding is asymmetric because the forward direction truncates: the floor

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

@@ -13,8 +13,8 @@ interface Position {
   debt: bigint;
   collateral: bigint;
 }
-/** Facade limits a non-zero debt must respect. */
-interface DebtBand {
+/** Facade `debtLimits`: a non-zero debt must sit in `[minDebt, maxDebt]`. */
+interface DebtLimits {
   minDebt: bigint;
   maxDebt: bigint;
 }
@@ -32,17 +32,17 @@ declare function proportionalDebt(position: Position, collateralDelta: bigint):
  * Largest withdrawal (in underlying) that {@link proportionalDebt} can still
  * pay for: the repayment it implies leaves debt at or above `minDebt`, and
  * strictly less than the collateral goes — the last unit closes the account
- * rather than shrinks it. `0n` when the debt already sits below the band.
+ * rather than shrinks it. `0n` when the debt already sits below `minDebt`.
  *
  * Solves `floor(D0 · W / C0) ≤ D0 − minDebt` for `W`.
  */
-declare function maxProportionalWithdrawal(position: Position, band: DebtBand): bigint;
+declare function maxProportionalWithdrawal(position: Position, debtLimits: DebtLimits): bigint;
 /** Total leverage cannot drop below 1x — that would be negative debt. */
 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(sdk: OnchainSDK, debt: bigint, band: DebtBand, underlying: Address): void;
+declare function assertDebtLimits(sdk: OnchainSDK, debt: bigint, debtLimits: DebtLimits, underlying: Address): void;
 //#endregion
-export { DebtBand, Position, assertDebtInBand, assertLeverageAtLeastOne, debtForLeverage, maxProportionalWithdrawal, proportionalDebt };
+export { DebtLimits, Position, assertDebtLimits, assertLeverageAtLeastOne, debtForLeverage, maxProportionalWithdrawal, proportionalDebt };

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

@@ -165,7 +165,7 @@ declare function buildWrapRwaCollateralOperation(input: RwaLegInput): Promise<Wr
 declare function buildUnwrapRwaCollateralOperation(input: RwaLegInput): Promise<UnwrapRwaCollateralOperation>;
 /**
  * The request that starts a redemption: spends the source token and receives
- * the phantom token standing in for the payout until it matures.
+ * the phantom token standing in for the claim until it matures.
  */
 interface StartDelayedWithdrawalOperation {
   type: "startDelayedWithdrawal";
@@ -173,7 +173,7 @@ interface StartDelayedWithdrawalOperation {
   token: Address;
   /** Amount of `token` the issuer burns; capped at the account balance. */
   amountIn: bigint;
-  /** Request outputs; a delayed one is the phantom token, not the payout. */
+  /** Request outputs; a delayed one is the phantom token, not the claim. */
   outputs: WithdrawalOutput[];
   /** Whether anything at all has to be waited for. */
   settlement: "instant" | "delayed";

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

@@ -3,7 +3,7 @@ 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 { DebtLimits } from "./math.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/plan.d.ts
 /**
@@ -108,7 +108,7 @@ interface AccountView {
   debt: bigint;
   /** TVL − debt, in underlying. */
   collateral: bigint;
-  band: DebtBand;
+  debtLimits: DebtLimits;
   balanceOf(token: Address): bigint;
   /** Oracle conversion; unpriceable tokens contribute 0n. */
   price(from: Address, to: Address, amount: bigint): bigint;
@@ -146,8 +146,8 @@ declare function planWithdraw(intent: Omit<WithdrawStrategyIntent, "type">, view
  * Intent 2.1 against a source that cannot be sold on a DEX.
  *
  * Some collateral only converts through its issuer — a Securitize dsToken, a
- * Mellow share — which answers a redemption request now and pays out days
- * later. The trade is unchanged; what changes is that the proceeds do not exist
+ * Mellow share — which answers a redemption request now and settles days
+ * later. The trade is unchanged; what changes is that the money does not exist
  * yet, so this half only requests the redemption:
  *
  * ```
@@ -174,10 +174,10 @@ declare function planFinishDecreaseLeverage(claimable: ClaimableWithdrawal, clai
   amount: bigint;
 }, view: AccountView): Step[];
 /**
- * The claim is split between the promised payout `W` and the debt the leading
- * half deferred: the payout is served first, the debt gets what is left, so a
- * routing shortfall shows as leverage a touch above target rather than as a
- * payout the wallet was promised and did not get.
+ * The claim is split between the promised withdrawal `W` and the debt the
+ * leading half deferred: `W` is served first, the debt gets what is left, so a
+ * bad quote shows as leverage a touch above target rather than as a wallet paid
+ * less than it was promised.
  */
 declare function planFinishWithdraw(intent: {
   withdrawToken: Address;
@@ -191,7 +191,7 @@ declare function planFinishWithdraw(intent: {
 }, view: AccountView): Step[];
 /**
  * The tail of an exit: the claim lands, everything the account holds is sold
- * into the underlying, the loan is settled out of the proceeds and the rest
+ * into the underlying, the loan is settled out of what it sells for and the rest
  * goes to the wallet. The account survives it, empty and owing nothing.
  *
  * Nothing is quoted from the request — the same shape {@link planWithdraw}

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

@@ -20,7 +20,7 @@ interface TailPlan {
  * tail as it is projected the moment the request is made.
  *
  * A claim that brought only part of what was queued is served in proportion,
- * see {@link partialTail}: the intent's payout and its repayment are cut to the
+ * see {@link partialTail}: the intent's withdrawal and its repayment are cut to the
  * share that arrived, and the rest of both is handed to the next claim.
  */
 declare function planTail(args: {
@@ -33,7 +33,7 @@ declare function planTail(args: {
  *
  * A request is only half a withdrawal, so the state it lands in is not the
  * answer to "what does this do to my position": the debt is still there, the
- * payout has not been made, and the position sits in a phantom token. What the
+ * withdrawal has not been made, and the position sits in a phantom token. What the
  * caller means is the far side — and that side can be walked now, because the
  * request already fixes the claim it will be finished from.
  *

package/dist/types/onchain/accounts/intents/testing/expect.d.ts

@@ -38,10 +38,10 @@ declare function expectAdjustPreview(result: IntentPreviewResult | DelayedStartR
   expectedOps: ExpectedFlowOp[];
   expectedCalls?: MultiCall[];
 }): OperationState;
-/** Asserts the preview failed for a specific reason. */
-declare function expectPreviewError(result: IntentPreviewResult | DelayedStartResult, reason: Extract<IntentPreviewResult, {
+/** Asserts the preview failed with a specific error code. */
+declare function expectPreviewError(result: IntentPreviewResult | DelayedStartResult, code: Extract<IntentPreviewResult, {
   ok: false;
-}>["reason"]): void;
+}>["error"]["code"]): void;
 /**
  * What a priced list — holdings or quotas — says the account stands at for
  * `token`. A quota is denominated in the market underlying, so this reads the

package/dist/types/onchain/accounts/intents/tests/finish-withdraw.fixtures.d.ts

@@ -63,11 +63,11 @@ declare function buildWithdrawFinishProps(args: {
 };
 /** Matrix baseline debt: 8U. */
 declare const M4_DEBT = 800000000n;
-/** Matrix payout W: 1U. */
+/** Matrix withdrawal W: 1U. */
 declare const M4_W = 100000000n;
 /** Proportional repayment `dD = D0 * W / C0` = 4U. */
 declare const M4_DD = 400000000n;
-/** Payout plus repayment: 5U redeemed by the leading half. */
+/** Withdrawal plus repayment: 5U redeemed by the leading half. */
 declare const M4_SPEND: bigint;
 /** Quotable withdrawal phantom: `POS2`, 1:1 with `POS`. */
 declare const M4_PHANTOM: `0x${string}`;
@@ -85,10 +85,10 @@ interface MatrixWithdrawTailCase {
 /**
  * Matrix 4.3 tail — the claim pays `UND` directly.
  *
- * MATRIX MISMATCH: the matrix pays out first — `claim →
+ * MATRIX MISMATCH: the matrix withdraws first — `claim →
  * withdrawCollateral(min(W, claim.amount)) → decreaseDebt(rest) →
- * changeQuota`. The engine repays before paying out (`repay(debtRepaid,
- * keep: W)` precedes the payout leg in `planFinishWithdraw`):
+ * changeQuota`. The engine repays before withdrawing (`repay(debtRepaid,
+ * keep: W)` precedes the withdrawal leg in `planFinishWithdraw`):
  * `claim → decreaseDebt(dD) → withdrawCollateral(W) → changeQuota`.
  * Amounts are identical; only the order differs.
  */
@@ -103,7 +103,7 @@ declare const case_matrix_4_3_tail: MatrixWithdrawTailCase;
  */
 declare const case_matrix_4_4_tail: MatrixWithdrawTailCase;
 /**
- * Matrix 4.5 tail — 4.3 on the RWA market: unwrap before the payout.
+ * Matrix 4.5 tail — 4.3 on the RWA market: unwrap before the withdrawal.
  *
  * MATRIX MISMATCH: same ordering divergence as 4.3 — the matrix expects
  * `claim → unwrapRwaCollateral → withdrawCollateral(RWA) → decreaseDebt →

package/dist/types/onchain/accounts/intents/tests/withdraw.fixtures.d.ts

@@ -7,7 +7,7 @@ import { Address } from "viem";
 //#region src/onchain/accounts/intents/tests/withdraw.fixtures.d.ts
 /** 100 UND of value leaving the account. */
 declare const W = 10000000000n;
-/** Payout plus proportional repayment. */
+/** Withdrawal plus proportional repayment. */
 declare const SPEND: bigint;
 declare const TVL_BEFORE = 200000000000n;
 declare const DEBT_BEFORE = 100000000000n;
@@ -28,7 +28,7 @@ interface WithdrawCase {
 }
 /** Row 1 — S = U, T = U: repay, then hand over the underlying. */
 declare const case_und_und: WithdrawCase;
-/** Row 2 — S = U, T = POS: repay, then route the payout out of the underlying. */
+/** Row 2 — S = U, T = POS: repay, then route the withdrawal out of the underlying. */
 declare const case_und_pos: WithdrawCase;
 /** Row 3 — S = POS, T = U: both legs land in the underlying, so one swap covers them. */
 declare const case_pos_und: WithdrawCase;
@@ -36,29 +36,29 @@ declare const case_pos_und: WithdrawCase;
 declare const case_pos_pos: WithdrawCase;
 /** Row 5 — S = POS, T = POS2: two independent legs out of the same source. */
 declare const case_pos_pos2: WithdrawCase;
-/** RWA market: the underlying payout is force-unwrapped to the asset. */
-declare const case_rwa_payout: WithdrawCase;
+/** RWA market: the underlying withdrawal is force-unwrapped to the asset. */
+declare const case_rwa_pos_und: WithdrawCase;
 /** Matrix baseline: 10A of position against 8U of debt (2U collateral at 5x). */
 declare const M4_BALANCE = 1000000000n;
 declare const M4_DEBT = 800000000n;
-/** Matrix payout W: 1U. */
+/** Matrix withdrawal W: 1U. */
 declare const M4_W = 100000000n;
 /** Proportional repayment `dD = D0 * W / C0` = 4U. */
 declare const M4_DD = 400000000n;
-/** Payout plus repayment: 5U liquidated in total. */
+/** Withdrawal plus repayment: 5U liquidated in total. */
 declare const M4_SPEND: bigint;
 /**
- * Matrix 4.1 — withdraw 1U, source `POS`, payout `UND`.
+ * Matrix 4.1 — withdraw 1U, source `POS`, tokenOut `UND`.
  *
- * MATRIX MISMATCH: the matrix pays out first — `swap → withdrawCollateral →
- * decreaseDebt → changeQuota`. The engine repays before paying out
- * (`repay(dD, keep: W)` precedes the payout leg in `planWithdraw`):
+ * MATRIX MISMATCH: the matrix withdraws first — `swap → withdrawCollateral →
+ * decreaseDebt → changeQuota`. The engine repays before withdrawing
+ * (`repay(dD, keep: W)` precedes the withdrawal leg in `planWithdraw`):
  * `swap → decreaseDebt → withdrawCollateral → changeQuota`. Amounts are
  * identical; only the order differs.
  */
 declare const case_matrix_4_1: WithdrawCase;
 /**
- * Matrix 4.2 — 4.1 on the RWA market: the payout is unwrapped on the way out.
+ * Matrix 4.2 — 4.1 on the RWA market: the withdrawal is unwrapped on the way out.
  *
  * MATRIX MISMATCH: same ordering divergence as 4.1 — the matrix expects
  * `swap → unwrapRwaCollateral → withdrawCollateral(RWA) → decreaseDebt →
@@ -76,4 +76,4 @@ declare function buildWithdrawProps(c: WithdrawCase, sdk: OnchainSDK): {
   slippage: undefined;
 };
 //#endregion
-export { DEBT_AFTER, DEBT_BEFORE, M4_BALANCE, M4_DD, M4_DEBT, M4_SPEND, M4_W, QUOTA_AFTER, QUOTA_BEFORE, QUOTA_DELTA, SPEND, TVL_AFTER, TVL_BEFORE, W, WithdrawCase, buildWithdrawProps, buildWithdrawSdk, case_matrix_4_1, case_matrix_4_2, case_pos_pos, case_pos_pos2, case_pos_und, case_rwa_payout, case_und_pos, case_und_und };
+export { DEBT_AFTER, DEBT_BEFORE, M4_BALANCE, M4_DD, M4_DEBT, M4_SPEND, M4_W, QUOTA_AFTER, QUOTA_BEFORE, QUOTA_DELTA, SPEND, TVL_AFTER, TVL_BEFORE, W, WithdrawCase, buildWithdrawProps, buildWithdrawSdk, case_matrix_4_1, case_matrix_4_2, case_pos_pos, case_pos_pos2, case_pos_und, case_rwa_pos_und, case_und_pos, case_und_und };