@gearbox-protocol/sdk 16.1.2 → 16.3.0-next.1

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/open-strategy.d.ts

@@ -4,11 +4,19 @@ 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 { CreditAccountSlice, SimulationPrices } from "./types.js";
 import "../../index.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/open-strategy.d.ts
-interface OpenStrategyProps {
+/**
+ * Opening an account and putting a position on it in one transaction.
+ *
+ * The union says which of the two openings this is: {@link OpenStrategyEmpty}
+ * takes only the market, because an account holding nothing has nothing to
+ * route, no leverage to reach and no target to reach it in.
+ */
+type OpenStrategyProps = OpenStrategyFunded | OpenStrategyEmpty;
+interface OpenStrategyFunded {
   sdk: OnchainSDK;
   /** Credit manager to open the account in. */
   creditManager: Address;
@@ -24,6 +32,20 @@ interface OpenStrategyProps {
   quotaReserve: number | undefined;
   /** Balances to leave unswapped; everything else is routed into the target. */
   leftoverBalances?: Asset[];
+  /**
+   * Existing credit account to put the position on, instead of opening one.
+   *
+   * Must carry no debt and no quotas. Growing a position that already exists
+   * is what the `DEPOSIT` intent is for.
+   **/
+  creditAccount?: CreditAccountSlice;
+  empty?: false;
+}
+/** Opening an account that holds nothing, for a position to land on later. */
+interface OpenStrategyEmpty {
+  sdk: OnchainSDK;
+  creditManager: Address;
+  empty: true;
 }
 /**
  * Projected result of opening a brand-new leveraged position.
@@ -49,6 +71,15 @@ interface OpenStrategyState extends Omit<AccountProjection, "assets" | "quotas">
   minQuota: Asset[];
   /** Router path; feeds `openCA.calls`. */
   calls: MultiCall[];
+  /**
+   * The account this opening was simulated against and must be executed on,
+   * when it reuses one; `undefined` for an opening that creates its own.
+   *
+   * Carried here rather than asked of the caller again at `buildTx`, so the
+   * transaction cannot be built against an account the numbers were not
+   * computed for.
+   **/
+  creditAccount?: Address;
 }
 /**
  * Builds the state opening a leveraged position out of wallet collateral would
@@ -64,4 +95,4 @@ interface OpenStrategyState extends Omit<AccountProjection, "assets" | "quotas">
  */
 declare function buildOpenStrategyState(props: OpenStrategyProps): Promise<OpenStrategyState>;
 //#endregion
-export { OpenStrategyProps, OpenStrategyState, buildOpenStrategyState };
+export { OpenStrategyEmpty, OpenStrategyFunded, OpenStrategyProps, OpenStrategyState, buildOpenStrategyState };

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/open-strategy.fixtures.d.ts

@@ -1,6 +1,6 @@
 import { Asset } from "../../../base/types.js";
 import { OnchainSDK } from "../../../OnchainSDK.js";
-import { OpenStrategyProps } from "../open-strategy.js";
+import { OpenStrategyFunded } from "../open-strategy.js";
 import "../../../index.js";
 import { MarketSdkExtras } from "../testing/market.js";
 import { Address } from "viem";
@@ -51,6 +51,6 @@ declare const case_underlying_1x: OpenStrategyCase;
  */
 declare const case_mixed_with_leftover: OpenStrategyCase;
 declare function buildOpenStrategySdk(extras?: MarketSdkExtras): OnchainSDK;
-declare function buildOpenStrategyProps(c: OpenStrategyCase, sdk: OnchainSDK): OpenStrategyProps;
+declare function buildOpenStrategyProps(c: OpenStrategyCase, sdk: OnchainSDK): OpenStrategyFunded;
 //#endregion
 export { COLLATERAL_ANY, HALF_UND, KEEP_ANY, LEVERAGE_1X, LEVERAGE_2X, LEVERAGE_3X, LT, MARGIN_UND, OpenStrategyCase, buildOpenStrategyProps, buildOpenStrategySdk, case_mixed_with_leftover, case_underlying_1x, case_underlying_3x, quotaFor };

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 };

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

@@ -1,12 +1,13 @@
 import { TokenAmount } from "../../../model/primitives.js";
 import { DelayedIntent } from "../../../model/delayed-intents.js";
 import { AccountProjection } from "../../../model/previews.js";
+import { SDKError } from "../../../model/result.js";
 import "../../../model/index.js";
 import { ClaimableWithdrawal } from "../withdrawal-compressor/types.js";
 import { RouterCASlice } from "../../router/types.js";
 import { MultiCall } from "../../types/transactions.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
-import { PreviewErrorReason, PreviewRefusal } from "../../validation/refusal.js";
+import { IntentValidationError } from "../../validation/raise.js";
 import { AccountCalculatorOperation } from "./operations.js";
 import "../../index.js";
 import { Address } from "viem";
@@ -64,14 +65,14 @@ interface SimulationPrices {
 interface OperationState extends AccountProjection, SimulationPrices {}
 /**
  * What planning an intent yields: the operation chain, the state it projects,
- * and the calldata that realises it — or the reason the request is not viable.
+ * and the calldata that realises it — or the error that stopped the plan.
  */
 type IntentPreviewResult = {
   ok: true;
   operations: AccountCalculatorOperation[];
   state: OperationState;
   calls: MultiCall[];
-} | PreviewRefusal;
+} | SDKError<IntentValidationError>;
 /**
  * What a claim did not bring, when the venue served part of a matured
  * withdrawal and left the rest of it queued.
@@ -109,7 +110,7 @@ type FinishIntentResult = (Extract<IntentPreviewResult, {
    * {@link ClaimRemainder}.
    */
   remainder: ClaimRemainder | undefined;
-}) | PreviewRefusal;
+}) | SDKError<IntentValidationError>;
 /** What the request recorded, and when the tail can be run. */
 interface DelayedStart {
   /**
@@ -123,17 +124,17 @@ interface DelayedStart {
   /**
    * `instant` when the venue served the whole request on the spot, so no claim
    * will ever arrive to carry the tail. The intent is then left half-done —
-   * nothing repaid, nothing paid out — and the caller wants `startIntent`
+   * nothing repaid, nothing withdrawn — and the caller wants `startIntent`
    * instead, which settles all of it in one transaction.
    */
   settlement: "instant" | "delayed";
   /**
    * What the claim is expected to credit the account with once the redemption
-   * matures: the venue's payout token and the amount the request queued.
+   * matures: the token the redemption settles in and the amount the request queued.
    * `undefined` when the request settled on the spot and nothing is coming.
    *
-   * An estimate, not a quote — the issuer prices the redemption when it pays
-   * out, and the state the intent is previewed against was read now.
+   * An estimate, not a quote — the issuer prices the redemption when it settles,
+   * and the state the intent is previewed against was read now.
    */
   claim: {
     token: Address;
@@ -172,7 +173,7 @@ type DelayedStartResult = {
   state: OperationState;
   calls: MultiCall[];
   delayed: DelayedStart;
-} | PreviewRefusal;
+} | SDKError<IntentValidationError>;
 /** An intent previewed through the router: one transaction, settled now. */
 type InstantRoute = Extract<IntentPreviewResult, {
   ok: true;
@@ -184,35 +185,35 @@ type DelayedRoute = Extract<DelayedStartResult, {
 /**
  * Why a route is missing from an {@link IntentRoutesResult}.
  *
- * A reason is the engine's refusal — `noDelayedRoute` for a source with no
+ * An error is the engine's verdict — `noDelayedRoute` for a source with no
  * redemption venue or for a leverage move that settles at once,
- * `insufficientSourceBalance` for a payout the account cannot fund. `undefined`
+ * `insufficientBalance` for a withdrawal the account cannot fund. A missing key
  * next to a missing route means the route could not be quoted at all: the
  * pathfinder found no way out of the source, or the read behind it failed.
  */
-interface RouteRefusals {
-  instant: PreviewErrorReason | undefined;
-  delayed: PreviewErrorReason | undefined;
+interface RouteErrors {
+  instant?: IntentValidationError;
+  delayed?: IntentValidationError;
 }
 /**
  * Both ways one intent can be served, previewed side by side: traded through
  * the router, which settles in a single transaction, or redeemed through the
- * source's issuer, which answers now and pays out days later.
+ * source's issuer, which answers now and settles days later.
  *
  * Which of them an account can take depends on the intent and the token it
  * sells, so both are quoted and a route it cannot take comes back `undefined`
- * with its refusal in `refused`. Only when neither answers is the request itself
- * unviable, and then `reason` is the instant route's refusal — the route every
- * account is expected to have — falling back to the delayed one's.
+ * with its error in `errors`. Only when neither answers is the request itself
+ * unviable, and then `error` is the instant route's — the route every account
+ * is expected to have — falling back to the delayed one's.
  */
 type IntentRoutesResult = {
   ok: true;
   instant: InstantRoute | undefined;
   delayed: DelayedRoute | undefined;
-  refused: RouteRefusals;
-} | (PreviewRefusal & {
-  /** {@inheritDoc IntentRoutesResult.refused} */
-  refused: RouteRefusals;
+  errors: RouteErrors;
+} | (SDKError<IntentValidationError> & {
+  /** {@inheritDoc IntentRoutesResult.errors} */
+  errors: RouteErrors;
 });
 /**
  * The intents the engine previews.
@@ -368,12 +369,13 @@ interface RepayStrategyIntent {
  * Intent 2.1 — withdraw part of the position's net value at fixed leverage.
  *
  * The requested amount leaves the account, and debt is repaid in the same
- * proportion so leverage is unchanged: `dD = D0 * W / C0`. Both the payout and
- * the repayment are funded by liquidating the source token, which means the
+ * proportion so leverage is unchanged: `dD = D0 * W / C0`. Both the withdrawal
+ * and the repayment are funded by liquidating the source token, which means the
  * account must give up `W + dD` of value in total.
  *
- * The payout leg and the repayment leg are quoted separately and do not share a
- * pool, so a shortfall on the payout leg does not eat into the repayment.
+ * The withdrawal leg and the repayment leg are quoted separately and do not
+ * share a pool, so a bad quote on the withdrawal leg does not eat into the
+ * repayment.
  *
  * Asking for the whole net value is the exit instead — there is no leverage
  * left to hold — and the shape changes with it: the quotas are dropped, the
@@ -388,7 +390,7 @@ interface WithdrawStrategyIntent {
   type: "WITHDRAW";
   /**
    * Amount the wallet receives, denominated in `tokenOut`. At or above the
-   * account's net value this is an exit, which pays out the underlying the
+   * account's net value this is an exit, which hands over the underlying the
    * position was sold into rather than in `tokenOut`.
    *
    * `MAX_UINT256` is that exit stated outright, and the amount a "close
@@ -396,7 +398,7 @@ interface WithdrawStrategyIntent {
    * rounding can turn it back into a withdrawal that leaves dust behind.
    */
   amount: bigint;
-  /** Wallet receiving the payout. */
+  /** Token recipient. */
   to: Address;
   /**
    * Token the wallet receives. Defaults to the market underlying — which, on an
@@ -439,7 +441,7 @@ interface WithdrawCeilings {
    * has caught up with its collateral.
    *
    * A Max button is better served by sending `MAX_UINT256` than this figure —
-   * the exit is then named outright, and no rounding in the payout token's
+   * the exit is then named outright, and no rounding in the withdrawal token's
    * price can drop the request back into the refused gap.
    */
   exit: bigint;
@@ -468,4 +470,4 @@ type FinishIntentProps = StartIntentProps & {
   claimable: ClaimableWithdrawal;
 };
 //#endregion
-export { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteRefusals, SimulationPrices, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent };
+export { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteErrors, SimulationPrices, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent };

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

@@ -1,8 +1,9 @@
 import { DelayedIntent } from "../../model/delayed-intents.js";
+import { RWAOpenAccountRequirements, RWAOperationArgs } from "../../model/rwa.js";
 import "../../model/index.js";
 import { ClaimableWithdrawal, RequestableWithdrawal } from "./withdrawal-compressor/types.js";
 import { Asset, CreditAccountData, CreditAccountTokensSlice, PermitResult } from "../base/types.js";
-import { GetOpenAccountRequirementsProps, RWAOpenAccountRequirements, RWAOperationArgs } 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 { PartialLiquidationParams, PrepareUpdateQuotasProps } from "../market/credit/types.js";
@@ -214,7 +215,8 @@ interface OpenCAProps extends PrepareUpdateQuotasProps {
    */
   creditManager: Address;
   /**
-   * Optional address of credit account to reopen
+   * Optional address of an existing credit account to run the opening on,
+   * instead of opening a new one.
    */
   reopenCreditAccount?: Address;
   /**

package/dist/types/onchain/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.d.ts

@@ -1,7 +1,7 @@
 import { DelayedIntent } from "../../../model/delayed-intents.js";
+import { InvalidDelayedIntentError } from "../../../model/errors/preview-errors.js";
 import { SDKReturn } from "../../../model/result.js";
 import "../../../model/index.js";
-import { InvalidDelayedIntentError } from "./errors.js";
 import { IRedemptionLoggerContract, RedemptionLog } from "./types.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
 import { BaseContract } from "../../base/BaseContract.js";

package/dist/types/onchain/accounts/withdrawal-compressor/index.d.ts

@@ -1,4 +1,3 @@
-import { InvalidDelayedIntentError } from "./errors.js";
 import { ClaimableWithdrawal, CurrentWithdrawals, DelayedIntentExtended, GetExternalAccountCurrentWithdrawalsProps, GetWithdrawalRequestResultProps, IRedemptionLoggerContract, IWithdrawalCompressorContract, PendingWithdrawal, RedemptionLog, RequestableWithdrawal, WithdrawableAsset, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, toWithdrawalStatus } from "./types.js";
 import { AbstractWithdrawalCompressorContract, OnchainRequestableWithdrawal, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal } from "./AbstractWithdrawalCompressorContract.js";
 import { WithdrawalCompressorLocation, WithdrawalCompressorVersion, getWithdrawalCompressorAddress } from "./addresses.js";
@@ -9,4 +8,4 @@ import { RedemptionLoggerV310Contract } from "./RedemptionLoggerV310Contract.js"
 import { WithdrawalCompressorV310Contract } from "./WithdrawalCompressorV310Contract.js";
 import { WithdrawalCompressorV311Contract } from "./WithdrawalCompressorV311Contract.js";
 import { WithdrawalCompressorV313Contract } from "./WithdrawalCompressorV313Contract.js";
-export { AbstractWithdrawalCompressorContract, ClaimableWithdrawal, CurrentWithdrawals, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DelayedIntentExtended, GetExternalAccountCurrentWithdrawalsProps, GetWithdrawalRequestResultProps, IRedemptionLoggerContract, IWithdrawalCompressorContract, InvalidDelayedIntentError, OnchainRequestableWithdrawal, PendingWithdrawal, RedemptionLog, RedemptionLoggerV310Contract, RequestableWithdrawal, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+export { AbstractWithdrawalCompressorContract, ClaimableWithdrawal, CurrentWithdrawals, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DelayedIntentExtended, GetExternalAccountCurrentWithdrawalsProps, GetWithdrawalRequestResultProps, IRedemptionLoggerContract, IWithdrawalCompressorContract, OnchainRequestableWithdrawal, PendingWithdrawal, RedemptionLog, RedemptionLoggerV310Contract, RequestableWithdrawal, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

package/dist/types/onchain/accounts/withdrawal-compressor/types.d.ts

@@ -1,9 +1,9 @@
 import { DelayedIntent } from "../../../model/delayed-intents.js";
+import { InvalidDelayedIntentError } from "../../../model/errors/preview-errors.js";
 import { SDKReturn } from "../../../model/result.js";
 import "../../../model/index.js";
 import { MulticallBatch } from "../../utils/viem/executeMulticallBatches.js";
 import "../../utils/viem/index.js";
-import { InvalidDelayedIntentError } from "./errors.js";
 import { IBaseContract } from "../../base/types.js";
 import { MultiCall } from "../../types/transactions.js";
 import "../../types/index.js";