@gearbox-protocol/sdk 16.4.0-next.5 → 16.4.0-next.7

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

@@ -19,17 +19,18 @@ import { AccountBotsService } from "./bots/AccountBotsService.js";
 import { PeripheryCompressorV310Contract } from "./bots/PeripheryCompressorV310Contract.js";
 import "./bots/index.js";
 import { CreditAccountsServiceV310 } from "./CreditAccountsServiceV310.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, RouteErrors, StartIntent, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent } from "./intents/types.js";
+import { BorrowProps, BorrowState } from "./intents/borrow.js";
+import { LeverageBand } from "./intents/leverage-band.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 { BorrowPreviewResult, CreditAccountOperationsService, EmptyAccountPreviewResult, 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, 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 };
+export { AbstractWithdrawalCompressorContract, AccountBotsService, type AccountCalculatorOperation, AccountToCheck, type AddCollateralIntent, type AdjustLeverageIntent, AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, BorrowPreviewResult, type BorrowProps, type BorrowState, 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, EmptyAccountPreviewResult, 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/borrow.d.ts

@@ -0,0 +1,141 @@
+import { TokenAmount } from "../../../model/primitives.js";
+import "../../../model/index.js";
+import { Asset } from "../../base/types.js";
+import { MultiCall } from "../../types/transactions.js";
+import { OnchainSDK } from "../../OnchainSDK.js";
+import { CreditAccountSlice, OperationState } from "./types.js";
+import "../../index.js";
+import { Address } from "viem";
+//#region src/onchain/accounts/intents/borrow.d.ts
+/**
+ * Taking a loan against collateral, in one transaction that opens the account.
+ *
+ * The plainest thing a credit account can do, and the one shape of it the
+ * leveraged flows cannot express: the borrowed funds do not stay on the
+ * account to be traded, they go to the wallet. What is left behind is the
+ * collateral and the debt it backs.
+ */
+interface BorrowProps {
+  sdk: OnchainSDK;
+  /** Credit manager to open the account in. */
+  creditManager: Address;
+  /** Token the wallet puts up, in the manager's collateral list. */
+  collateralToken: Address;
+  /** Amount of {@link collateralToken}, in its own units. */
+  collateralAmount: bigint;
+  /**
+   * Token the loan is paid out in. The market underlying needs no trade;
+   * anything else is bought with the borrowed underlying on the way out.
+   *
+   * On an RWA market the underlying is a compliance wrapper that cannot leave
+   * the account, so the payout there is the asset behind it — USDC rather than
+   * dcUSDC — and the wrapper itself is refused.
+   */
+  borrowToken: Address;
+  /** Amount of {@link borrowToken} the wallet asks for, in its own units. */
+  borrowAmount: bigint;
+  /** Router slippage in PERCENTAGE_FORMAT (100% = 10_000). */
+  slippage: number | undefined;
+  /** Extra quota headroom in PERCENTAGE_FORMAT. */
+  quotaReserve: number | undefined;
+  /**
+   * Existing credit account to draw the loan on, instead of opening one.
+   *
+   * Must carry no debt and no quotas, as a reused opening must. Borrowing on
+   * an account that already owes is what the `ADJUST_LEVERAGE` intent is for.
+   **/
+  creditAccount?: CreditAccountSlice;
+}
+/**
+ * Where a borrow leaves the wallet and the account it opens.
+ *
+ * A whole {@link OperationState}, holdings included: unlike an opening, a
+ * borrow has no second branch of balances to choose between — the collateral
+ * is the only thing left on the account and its amount is known exactly.
+ * Slippage lands on the payout instead, which is why that one is reported
+ * twice.
+ *
+ * Being that state rather than merely resembling it is what lets a borrow
+ * result go straight to `checkSimulation`, which weighs whatever the engine
+ * projected: the market, the debt, the quotas and the two factors, all of
+ * which a borrow reports where an operation on an existing account does.
+ */
+interface BorrowState extends OperationState {
+  /** What the wallet puts up, as it will sit on the account. */
+  collateral: TokenAmount;
+  /**
+   * What the wallet is expected to receive, in the token it asked for. Equal
+   * to the debt when that token is the market underlying, and to the debt
+   * rescaled where an RWA payout unwraps it one for one; in neither case is
+   * anything traded.
+   */
+  borrowed: TokenAmount;
+  /**
+   * The floor under {@link borrowed} once slippage is allowed for — what the
+   * transaction is signed against. Equal to `borrowed` when nothing is traded.
+   */
+  minBorrowed: TokenAmount;
+  /**
+   * Router slippage the payout leg was quoted at, in PERCENTAGE_FORMAT
+   * (100% = 10_000). The SDK's own default where the caller named none.
+   */
+  slippage: number;
+  /**
+   * Quota to buy for the collateral; feeds `openCA.averageQuota` and
+   * `openCA.minQuota` alike, both branches being the same here.
+   *
+   * Transport for the transaction rather than something to display, like
+   * {@link calls} below.
+   */
+  quotaIncrease: Asset[];
+  /**
+   * The leg that turns the borrowed underlying into the payout: a router path
+   * where it is bought, the vault redemption where an RWA market unwraps it,
+   * empty where the payout is the underlying itself. Feeds `openCA.calls`,
+   * which places it before the withdrawal.
+   */
+  calls: MultiCall[];
+  /**
+   * The account this loan was simulated against and must be executed on, when
+   * it reuses one; `undefined` for a borrow that opens 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 a borrow would leave behind.
+ *
+ * The debt is named rather than derived: a borrow asks for an amount, where an
+ * opening asks for a leverage and lets the collateral decide. Everything the
+ * loan pays out leaves the account, so the collateral alone backs it — which
+ * is what makes the health factor here a straight function of the two amounts.
+ *
+ * Produces no operation list, as opening never does: the caller hands the
+ * numbers and the calls to `sdk.accounts.openCA`, with `withdrawToken` set to
+ * the payout.
+ */
+declare function buildBorrowState(props: BorrowProps): Promise<BorrowState>;
+/** Inputs of {@link borrowCollateralQuota}. */
+interface BorrowCollateralQuotaProps {
+  sdk: OnchainSDK;
+  creditManager: Address;
+  /** Collateral the fresh account will hold. */
+  assets: Asset[];
+  /** Extra quota headroom in PERCENTAGE_FORMAT. */
+  quotaReserve: number | undefined;
+}
+/**
+ * Quota a borrow buys for its collateral on an account that holds none yet.
+ *
+ * Shared with `maxBorrow`, because a quota short of the collateral's weighted
+ * value is what caps the loan: the two have to read the same number or the
+ * ceiling one offers is one the other refuses.
+ *
+ * @param props - {@link BorrowCollateralQuotaProps}
+ **/
+declare function borrowCollateralQuota({ sdk, creditManager, assets, quotaReserve }: BorrowCollateralQuotaProps): Asset[];
+//#endregion
+export { BorrowCollateralQuotaProps, BorrowProps, BorrowState, borrowCollateralQuota, buildBorrowState };

package/dist/types/onchain/accounts/intents/{collateral-money.d.ts → collateral-valuation.d.ts}

@@ -2,7 +2,7 @@ import { OnchainSDK } from "../../OnchainSDK.js";
 import { CreditAccountSlice } from "./types.js";
 import "../../index.js";
 import { Address } from "viem";
-//#region src/onchain/accounts/intents/collateral-money.d.ts
+//#region src/onchain/accounts/intents/collateral-valuation.d.ts
 /** One balance on the account, as the slice carries it. */
 type Holding = CreditAccountSlice["tokens"][number];
 /**
@@ -17,10 +17,10 @@ type Holding = CreditAccountSlice["tokens"][number];
  * exempt and stays on the main feed, as `CreditManagerV3._safeConvertToUSD`
  * does.
  *
- * Money is carried in USD × `PERCENTAGE_FACTOR`, the units the check compares
- * in, so a threshold never has to be divided back out.
+ * Every figure is carried in USD × `PERCENTAGE_FACTOR`, the units the check
+ * compares in, so a threshold never has to be divided back out.
  */
-interface CollateralMoney {
+interface CollateralValuation {
   /** Market underlying, the one token safe pricing does not touch. */
   underlying: Address;
   /** Whether the holding is weighed at all. */
@@ -28,7 +28,7 @@ interface CollateralMoney {
   /** What the holding backs, in USD × `PERCENTAGE_FACTOR`. */
   weigh(holding: Holding): bigint;
   /** What the holding's quota backs, in the same units; 0 on a closed market. */
-  quotaMoney(holding: Holding): bigint;
+  quotaValue(holding: Holding): bigint;
   /** USD at the main feed; `undefined` when the token has no price at all. */
   mainUsd(token: Address, amount: bigint): bigint | undefined;
   /** USD the check counts the holding at, before its threshold. */
@@ -36,7 +36,7 @@ interface CollateralMoney {
   /** Liquidation threshold in basis points; 0 for a token the manager refuses. */
   lt(token: Address): bigint;
 }
-/** {@inheritDoc CollateralMoney} */
-declare function collateralMoney(creditAccount: CreditAccountSlice, sdk: OnchainSDK): CollateralMoney;
+/** {@inheritDoc CollateralValuation} */
+declare function collateralValuation(creditAccount: CreditAccountSlice, sdk: OnchainSDK): CollateralValuation;
 //#endregion
-export { CollateralMoney, Holding, collateralMoney };
+export { CollateralValuation, Holding, collateralValuation };

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

@@ -2,9 +2,11 @@ import { SDKError } from "../../../model/result.js";
 import "../../../model/index.js";
 import { SDKConstruct } from "../../base/SDKConstruct.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, RouteErrors, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent } from "./types.js";
+import { BorrowProps, BorrowState } from "./borrow.js";
+import { LeverageBand, LeverageBandProps } from "./leverage-band.js";
+import { MaxBorrowProps } from "./maxBorrow.js";
 import { OpenStrategyProps, OpenStrategyState } from "./open-strategy.js";
 import { fetchCreditAccountSlice, toCreditAccountSlice } from "./utils/credit-account-slice.js";
 import { isPhantomToken } from "./utils/pick-token.js";
@@ -21,6 +23,22 @@ type OpenStrategyPreviewResult = {
   ok: true;
   state: OpenStrategyState;
 } | SDKError<IntentValidationError>;
+/**
+ * Borrow preview outcome, shaped like {@link OpenStrategyPreviewResult}: both
+ * open an account, so neither has an operation chain to report.
+ */
+type BorrowPreviewResult = {
+  ok: true;
+  state: BorrowState;
+} | SDKError<IntentValidationError>;
+/**
+ * Empty-account preview outcome: the thinnest of the three, since an account
+ * that holds nothing has no state to project — only the market's own refusal
+ * to open one at all.
+ */
+type EmptyAccountPreviewResult = {
+  ok: true;
+} | SDKError<IntentValidationError>;
 /** An intent plus everything previewing it needs. */
 type StartProps = StartIntentProps & {
   intent: StartIntent;
@@ -119,6 +137,30 @@ declare class CreditAccountOperationsService extends SDKConstruct {
     token: Address;
     targetHF?: bigint;
   }): bigint;
+  /**
+   * Largest loan a given collateral supports at `targetHF`, in the payout
+   * token's units — the ceiling a borrow form should offer.
+   *
+   * Reads no account, like {@link leverageBand}: the borrow opens one. The
+   * collateral is valued the way the transaction will be judged, at safe
+   * prices and under the quota the borrow buys, and the answer is then held to
+   * what the market will lend.
+   *
+   * A ceiling, not a verdict: the facade's `minDebt` is a floor and is not
+   * applied here, so collateral too small for this market still answers with
+   * what it carries and {@link borrowIntent} is the one that refuses the loan.
+   *
+   * The default is {@link MIN_HF_LIMITED}, the threshold a form holds an
+   * account to.
+   *
+   * @param props - The manager, the SDK holding its market, the collateral put
+   * up, the token to be paid in, and optionally the health factor to land at
+   * @returns Amount in the payout token's units; `0n` where no loan of this
+   * shape can be funded at any size
+   */
+  maxBorrow(props: Omit<MaxBorrowProps, "targetHF"> & {
+    targetHF?: bigint;
+  }): bigint;
   /**
    * Previews the same operation when its source only redeems through its
    * issuer: a Securitize dsToken, a Mellow share.
@@ -186,6 +228,21 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    * beside it, so both halves of an operation are consumed the same way
    */
   finishIntent(props: FinishIntentProps): Promise<FinishIntentResult>;
+  /**
+   * Previews opening an account that holds nothing.
+   *
+   * Nothing is put up, drawn or routed, so there is no state to build and no
+   * guard to run beyond the market's own: a paused or expired facade takes no
+   * multicall, and an opening is a multicall like any other. Answers the same
+   * envelope its two neighbours do so a caller branches on `ok` throughout.
+   *
+   * @param props - The SDK holding the market, and the manager to open in
+   * @returns `{ ok: true }`, or `{ ok: false, error }` when the market takes
+   * no transaction right now
+   */
+  openEmptyAccountIntent(props: Pick<StartIntentProps, "sdk"> & {
+    creditManager: Address;
+  }): Promise<EmptyAccountPreviewResult>;
   /**
    * Previews opening a brand-new leveraged position.
    *
@@ -199,6 +256,28 @@ declare class CreditAccountOperationsService extends SDKConstruct {
    * leverage or the resulting debt is not viable
    */
   openStrategyIntent(props: OpenStrategyProps): Promise<OpenStrategyPreviewResult>;
+  /**
+   * Previews taking a loan against collateral, on an account this same
+   * transaction opens.
+   *
+   * Sits beside {@link openStrategyIntent} rather than under
+   * {@link startIntent} for the same reason: there is no account yet, and the
+   * output feeds `sdk.accounts.openCA`. What sets it apart from an opening is
+   * where the loan goes — out to the wallet rather than into a position — so
+   * the debt is named outright instead of following from a leverage, and the
+   * collateral is the only thing the account is left holding.
+   *
+   * `creditAccount` draws the loan on one the wallet already holds instead of
+   * opening another, as an opening takes one.
+   *
+   * @param props - Credit manager, the collateral the wallet puts up and the
+   * payout it asks for
+   * @returns Debt, the payout's two branches and the projection the account
+   * lands in, or `{ ok: false, error }` when the loan is not viable — a debt
+   * outside the facade's limits, collateral that cannot carry it, a payout the
+   * router has no path to
+   */
+  borrowIntent(props: BorrowProps): Promise<BorrowPreviewResult>;
 }
 //#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 RouteErrors, type StartIntent, type WithdrawAssetIntent, type WithdrawCeilings, type WithdrawStrategyIntent, fetchCreditAccountSlice, isPhantomToken, toCreditAccountSlice };
+export { type AccountCalculatorOperation, type AddCollateralIntent, type AdjustLeverageIntent, BorrowPreviewResult, type BorrowProps, type BorrowState, type ClaimRemainder, CreditAccountOperationsService, type CreditAccountSlice, type DelayableIntent, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, EmptyAccountPreviewResult, 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/maxBorrow.d.ts

@@ -0,0 +1,54 @@
+import { OnchainSDK } from "../../OnchainSDK.js";
+import "../../index.js";
+import { Address } from "viem";
+//#region src/onchain/accounts/intents/maxBorrow.d.ts
+interface MaxBorrowProps {
+  sdk: OnchainSDK;
+  /** Credit manager the loan would be taken in. */
+  creditManager: Address;
+  /** Token the wallet puts up, in the manager's collateral list. */
+  collateralToken: Address;
+  /** Amount of {@link collateralToken}, in its own units. */
+  collateralAmount: bigint;
+  /** Token the loan is paid out in; the answer is in its units. */
+  borrowToken: Address;
+  /** Health factor the loan has to leave the account at, in basis points. */
+  targetHF: bigint;
+  /** Extra quota headroom in PERCENTAGE_FORMAT, as the borrow itself takes. */
+  quotaReserve: number | undefined;
+}
+/**
+ * Largest loan this collateral supports at `targetHF` — the ceiling a borrow
+ * form should offer, in the payout token's units.
+ *
+ * The inverse of a borrow rather than a search for one: the loan leaves the
+ * account entirely, so the collateral is the whole of what backs the debt, and
+ * the health factor is one division away from the amount. Solving it the other
+ * way round costs a division too, and no iteration.
+ *
+ * Collateral is valued the way the transaction will be judged — at safe
+ * prices, under its liquidation threshold, capped by the quota the borrow
+ * buys for it, all of which is {@link collateralValuation}'s business. The ceiling
+ * is then held to what the market will actually lend: the pool's free
+ * liquidity, the manager's own allowance and the facade's `maxDebt`, whichever
+ * binds first.
+ *
+ * The facade's `minDebt` is deliberately not applied. It is a floor, and a
+ * ceiling answered as `0n` because the collateral is too small for this market
+ * would tell a form nothing about what it is holding — the number a user needs
+ * to see is the one they are short of. Collateral that carries something
+ * therefore answers with it, whether or not the market would lend that little;
+ * a loan under the floor is refused by `borrow` itself, with `debtOutOfRange`
+ * naming both ends.
+ *
+ * Nothing is fetched or simulated — the account does not exist yet and every
+ * input is loaded market state, so a form can call this on each keystroke.
+ *
+ * @param props - {@link MaxBorrowProps}
+ * @returns Amount in the payout token's units; `0n` where no loan of this
+ * shape exists at any size — a collateral that backs nothing at safe prices, a
+ * market with nothing left to lend, and a manager the SDK does not hold yet
+ **/
+declare function maxBorrow(props: MaxBorrowProps): bigint;
+//#endregion
+export { MaxBorrowProps, maxBorrow };

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

@@ -16,9 +16,9 @@ interface MaxWithdrawCollateralProps {
  * factor stays at or above `targetHF`.
  *
  * This is the collateral check solved for one balance, and it counts what that
- * check counts — see {@link collateralMoney} for the valuation, safe prices
- * included. The debt is valued at the main feed, as the check does. Zero debt
- * frees the whole balance.
+ * check counts — see {@link collateralValuation} for it, safe prices included.
+ * 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

@@ -8,15 +8,8 @@ import { CreditAccountSlice, SimulationPrices } from "./types.js";
 import "../../index.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/open-strategy.d.ts
-/**
- * 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 {
+/** Opening an account and putting a position on it in one transaction. */
+interface OpenStrategyProps {
   sdk: OnchainSDK;
   /** Credit manager to open the account in. */
   creditManager: Address;
@@ -39,13 +32,6 @@ interface OpenStrategyFunded {
    * 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.
@@ -95,4 +81,4 @@ interface OpenStrategyState extends Omit<AccountProjection, "assets" | "quotas">
  */
 declare function buildOpenStrategyState(props: OpenStrategyProps): Promise<OpenStrategyState>;
 //#endregion
-export { OpenStrategyEmpty, OpenStrategyFunded, OpenStrategyProps, OpenStrategyState, buildOpenStrategyState };
+export { OpenStrategyProps, OpenStrategyState, buildOpenStrategyState };

package/dist/types/onchain/accounts/intents/testing/sdk-mock.d.ts

@@ -90,6 +90,8 @@ interface BuildMockSdkArgs {
   baseInterestRate?: bigint;
   /** Credit manager interest fee in Bps; feeds position metrics. */
   feeInterest?: number;
+  /** Quoted tokens the facade enables at once; feeds `checkQuotaCount`. */
+  maxEnabledTokens?: number;
   creditManager: Address;
   creditFacade: Address;
   /** Market underlying token (`market.pool.underlying`). */

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 { OpenStrategyFunded } from "../open-strategy.js";
+import { OpenStrategyProps } 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): OpenStrategyFunded;
+declare function buildOpenStrategyProps(c: OpenStrategyCase, sdk: OnchainSDK): OpenStrategyProps;
 //#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/types.d.ts

@@ -68,7 +68,12 @@ interface OperationState extends AccountProjection, SimulationPrices {
    * underlying of everything its routed legs and redemption request return,
    * the expected claim included, against the value of what they spend.
    * In `PERCENTAGE_FACTOR_1KK` (1_000_000 = 100%), negative for a loss.
-   * `undefined` where nothing was traded or a leg cannot be priced.
+   *
+   * `undefined` where nothing was traded, where a leg cannot be priced, and on
+   * a {@link BorrowState}, which does not measure it: the rate compares an
+   * account against itself before and after, and a borrow's payout goes to the
+   * wallet rather than staying to be compared. What its route cost is on that
+   * state as `borrowed` against `totalDebt`.
    */
   executionCost: bigint | undefined;
 }

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

@@ -1,5 +1,7 @@
 import { Asset } from "../../../base/types.js";
 import { RouterCASlice } from "../../../router/types.js";
+import { MarketSuite } from "../../../market/MarketSuite.js";
+import { CreditSuite } from "../../../market/credit/CreditSuite.js";
 import { OnchainSDK } from "../../../OnchainSDK.js";
 import { CreditAccountSlice } from "../types.js";
 import "../../../index.js";
@@ -7,6 +9,18 @@ import { Address } from "viem";
 //#region src/onchain/accounts/intents/utils/common.d.ts
 /** Case-insensitive address equality. */
 declare const eq: (a: Address, b: Address) => boolean;
+/**
+ * The suite and market behind a credit manager, or nothing where the register
+ * has no entry for it.
+ *
+ * For the reads a form calls on every keystroke, including before the SDK has
+ * finished attaching: a question the register cannot answer yet is not an
+ * error. Everything that prepares a transaction wants the throw instead.
+ */
+declare function resolveCreditManager(sdk: OnchainSDK, creditManager: Address): {
+  suite: CreditSuite;
+  market: MarketSuite;
+} | undefined;
 declare function toTargetDecimals(fromAmount: bigint, fromToken: Address, toToken: Address, sdk: OnchainSDK): bigint;
 /**
  * Router CA slice from the account slice. RouterV310 reads `ca.tokens` for
@@ -16,4 +30,4 @@ declare function toTargetDecimals(fromAmount: bigint, fromToken: Address, toToke
  */
 declare function toRouterCaSlice(creditAccount: CreditAccountSlice, expectedBalances?: Asset[]): RouterCASlice;
 //#endregion
-export { eq, toRouterCaSlice, toTargetDecimals };
+export { eq, resolveCreditManager, toRouterCaSlice, toTargetDecimals };

package/dist/types/onchain/accounts/intents/utils/credit-account-slice.d.ts

@@ -15,6 +15,19 @@ import { Address } from "viem";
  * behave consistently everywhere downstream.
  */
 declare function toCreditAccountSlice(ca: CreditAccountDataPayload): CreditAccountSlice;
+/**
+ * The slice a flow that has no account yet quotes against.
+ *
+ * Nothing of it exists on chain until the transaction lands, and nothing has
+ * to: the pathfinder is asked about the credit manager, and every balance the
+ * flow reasons about is one the transaction itself puts there. The zero
+ * address stands in for the account so the shape is complete.
+ */
+declare function unopenedAccountSlice(args: {
+  creditManager: Address;
+  creditFacade: Address;
+  underlying: Address;
+}): CreditAccountSlice;
 /**
  * Reads an account by address and narrows it to {@link CreditAccountSlice}.
  *
@@ -26,4 +39,4 @@ declare function toCreditAccountSlice(ca: CreditAccountDataPayload): CreditAccou
  */
 declare function fetchCreditAccountSlice(sdk: OnchainSDK, creditAccount: Address): Promise<CreditAccountSlice>;
 //#endregion
-export { fetchCreditAccountSlice, toCreditAccountSlice };
+export { fetchCreditAccountSlice, toCreditAccountSlice, unopenedAccountSlice };

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

@@ -1,11 +1,11 @@
-import { fetchCreditAccountSlice, toCreditAccountSlice } from "./credit-account-slice.js";
+import { fetchCreditAccountSlice, toCreditAccountSlice, unopenedAccountSlice } from "./credit-account-slice.js";
 import { CandidateToken, isPhantomToken, isRedemptionPhantomToken, pickFattestNonPhantomToken, rankAccountTokens } from "./pick-token.js";
 import { LegProbe, collectPriceImpact, lossRate, startProbe } from "./price-impact.js";
 import { OpenStrategyLeg, RouterPaths, SwapLeg, createOraclePaths, createRouterPaths } from "./router-path.js";
 import { adjustStateToSnapshot } from "./adjust-state-to-snapshot.js";
 import { assembleOperationCalls } from "./assemble-operation-calls.js";
 import { calcBorrowedAmountPlusInterestAndFees } from "./borrowed-amount-plus-interest-and-fees.js";
-import { eq, toRouterCaSlice, toTargetDecimals } from "./common.js";
+import { eq, resolveCreditManager, toRouterCaSlice, toTargetDecimals } from "./common.js";
 import { LedgerSnapshot, OperationLedger } from "./ledger.js";
 import { clearedQuotas, getQuotasForUpdate, quotasAfterUpdate } from "./quotas-for-update.js";
-export { CandidateToken, LedgerSnapshot, LegProbe, OpenStrategyLeg, OperationLedger, RouterPaths, SwapLeg, adjustStateToSnapshot, assembleOperationCalls, calcBorrowedAmountPlusInterestAndFees, clearedQuotas, collectPriceImpact, createOraclePaths, createRouterPaths, eq, fetchCreditAccountSlice, getQuotasForUpdate, isPhantomToken, isRedemptionPhantomToken, lossRate, pickFattestNonPhantomToken, quotasAfterUpdate, rankAccountTokens, startProbe, toCreditAccountSlice, toRouterCaSlice, toTargetDecimals };
+export { CandidateToken, LedgerSnapshot, LegProbe, OpenStrategyLeg, OperationLedger, RouterPaths, SwapLeg, adjustStateToSnapshot, assembleOperationCalls, calcBorrowedAmountPlusInterestAndFees, clearedQuotas, collectPriceImpact, createOraclePaths, createRouterPaths, eq, fetchCreditAccountSlice, getQuotasForUpdate, isPhantomToken, isRedemptionPhantomToken, lossRate, pickFattestNonPhantomToken, quotasAfterUpdate, rankAccountTokens, resolveCreditManager, startProbe, toCreditAccountSlice, toRouterCaSlice, toTargetDecimals, unopenedAccountSlice };

package/dist/types/onchain/accounts/intents/withdraw-limits.d.ts

@@ -47,7 +47,7 @@ interface MaxSafeWithdrawalProps {
  * in underlying units.
  *
  * A withdrawal hands funds over, so the facade weighs the account it leaves
- * behind at safe prices rather than main ones — see {@link collateralMoney}.
+ * behind at safe prices rather than main ones — see {@link collateralValuation}.
  * That is a second limit on top of the facade's `debtLimits`, and the two are
  * independent: a caller wanting the amount a form may actually offer takes the
  * lesser of this and `maxProportionalWithdrawal`.