@gearbox-protocol/sdk 14.12.0-next.69 → 14.12.0-next.70

package/dist/types/sdk/accounts/intents/quoters/close.d.ts

@@ -0,0 +1,43 @@
+import { Asset } from "../../../base/types.js";
+import { MultiCall } from "../../../types/transactions.js";
+import { OnchainSDK } from "../../../OnchainSDK.js";
+import { CreditAccountSlice } from "../types.js";
+import "../../../index.js";
+//#region src/sdk/accounts/intents/quoters/close.d.ts
+/** Close path quote: how much underlying the wallet receives after close. */
+type CloseQuote = {
+  /** Router avg amount received. */
+  amount: bigint;
+  /**Router min amount received. */
+  minAmount: bigint;
+  /** Total amount to receive on wallet */
+  underlyingBalance: bigint;
+  /** Router close path calls; empty for oracle quotes. */
+  calls: MultiCall[];
+};
+type CloseQuoter = (input: {
+  assets: Asset[];
+  debt: bigint;
+}) => Promise<CloseQuote>;
+/**
+ * Offchain quoter: debt is repaid from NON-underlying value
+ * (`amount = Σ convert(non-underlying → underlying) − debt`, clamped at 0),
+ * underlying already on the account goes straight to the wallet
+ * (`underlyingBalance = underlying + amount`). No router involved.
+ */
+declare function createCloseOracleQuoter(args: {
+  sdk: OnchainSDK;
+  creditAccount: CreditAccountSlice;
+}): CloseQuoter;
+/**
+ * Onchain quoter: router close path over post-claim balances
+ * (phantom already spent). `amount` mirrors legacy
+ * `patchCloseOperationReceiveAmount` (debt 0n — closed preview is zeroed).
+ */
+declare function createRouterCloseQuoter(args: {
+  sdk: OnchainSDK;
+  creditAccount: CreditAccountSlice;
+  slippage: number;
+}): CloseQuoter;
+//#endregion
+export { CloseQuote, CloseQuoter, createCloseOracleQuoter, createRouterCloseQuoter };

package/dist/types/sdk/accounts/intents/quoters/index.d.ts

@@ -0,0 +1,3 @@
+import { CloseQuote, CloseQuoter, createCloseOracleQuoter, createRouterCloseQuoter } from "./close.js";
+import { SwapQuote, SwapQuoter, createOracleSwapQuoter, createRouterSwapQuoter } from "./swap.js";
+export { CloseQuote, CloseQuoter, SwapQuote, SwapQuoter, createCloseOracleQuoter, createOracleSwapQuoter, createRouterCloseQuoter, createRouterSwapQuoter };

package/dist/types/sdk/accounts/intents/quoters/swap.d.ts

@@ -0,0 +1,43 @@
+import { Asset } from "../../../base/types.js";
+import { MultiCall } from "../../../types/transactions.js";
+import { OnchainSDK } from "../../../OnchainSDK.js";
+import { CreditAccountSlice } from "../types.js";
+import "../../../index.js";
+import { Address } from "viem";
+//#region src/sdk/accounts/intents/quoters/swap.d.ts
+/** Swap quote for a conversion leg of a resume flow. */
+type SwapQuote = {
+  /** Average (or oracle) output amount. */
+  amount: bigint;
+  /** Conservative output (router floor); equals `amountOut` for oracle quotes. */
+  minAmount: bigint;
+  /** Router swap calls; empty for oracle quotes. */
+  calls: MultiCall[];
+};
+type SwapQuoter = (request: {
+  from: [Asset];
+  tokenOut: Address;
+  /** Full token-in balance after operations preceding this swap leg. */
+  tokenInBalance: bigint;
+}) => Promise<SwapQuote>;
+/**
+ * Offchain quoter: oracle prices via {@link convertAmount} (with an RWA
+ * bridge through the wrapped underlying when `rwa.asset` has no direct pool
+ * price).
+ */
+declare function createOracleSwapQuoter(args: {
+  sdk: OnchainSDK;
+  creditAccount: CreditAccountSlice;
+}): SwapQuoter;
+/**
+ * Onchain quoter: a full token-in spend uses `findOneTokenPath`; a partial
+ * spend uses `findManyToOnePath` with the exact post-operations balance and
+ * leftover. RWA wrap/unwrap calls are resolved by the router.
+ */
+declare function createRouterSwapQuoter(args: {
+  sdk: OnchainSDK;
+  creditAccount: CreditAccountSlice;
+  slippage: number;
+}): SwapQuoter;
+//#endregion
+export { SwapQuote, SwapQuoter, createOracleSwapQuoter, createRouterSwapQuoter };

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

@@ -0,0 +1,52 @@
+import { MultiCall } from "../../../types/transactions.js";
+import { AdjustState, IntentPreviewResult } from "../types.js";
+import { ClaimDelayedWithdrawalOperation } from "../operations/claim-delayed/index.js";
+import { CloseCreditAccountOperation } from "../operations/close-credit-account/index.js";
+import { QuotaUpdateOperation } from "../operations/quota-update/index.js";
+import { AccountCalculatorOperation } from "../operations/types.js";
+import "../operations/index.js";
+import "../../../index.js";
+import { Address } from "viem";
+//#region src/sdk/accounts/intents/testing/expect.d.ts
+/**
+ * Spec expectation: exact op count + type + tokens + amounts + calls.
+ * Ported from intent-calculator `expectOpsExact`, reduced to the op types the
+ * resume flows produce. Shared offchain fixtures may omit `calls` (treated as
+ * `[]`); onchain expectations should set sentinel calls via
+ * {@link withOnchainOpCalls}.
+ */
+type CallsOptional<T> = T extends {
+  calls: MultiCall[];
+} ? Omit<T, "calls"> & {
+  calls?: MultiCall[];
+} : T;
+type ExpectedFlowOp = CallsOptional<ClaimDelayedWithdrawalOperation | QuotaUpdateOperation | CloseCreditAccountOperation | Extract<AccountCalculatorOperation, {
+  type: "swap" | "decreaseDebt" | "withdrawCollateral" | "unwrapRwaCollateral" | "wrapRwaCollateral";
+}>>;
+/**
+ * Fills sentinel `calls` for onchain resume expectations. Shared fixtures keep
+ * `calls: []` for offchain; onchain tests map through this helper.
+ */
+declare function withOnchainOpCalls(ops: ExpectedFlowOp[]): ExpectedFlowOp[];
+/** Asserts exact operations on a raw op array (type + tokens + amounts). */
+declare function expectOpsArrayExact(ops: AccountCalculatorOperation[], expected: ExpectedFlowOp[]): void;
+/** Asserts exact calls on a raw MultiCall array (target + callData). */
+declare function expectCallsArrayExact(calls: MultiCall[], expected: MultiCall[], label?: string): void;
+/**
+ * Asserts a successful adjust-style resume preview: ok, instant branch present,
+ * exact calls (empty unless `expectedCalls` is provided), metrics from the
+ * post-claim CA, and exact operations (incl. changeQuota).
+ * Returns the adjust preview state for further asset/quota assertions.
+ */
+declare function expectAdjustResumePreview(result: IntentPreviewResult, args: {
+  totalValue: bigint;
+  accountDebt: bigint;
+  expectedOps: ExpectedFlowOp[];
+  expectedCalls?: MultiCall[];
+}): AdjustState;
+declare function assetBalance(assets: Array<{
+  token: Address;
+  balance: bigint;
+}>, token: Address): bigint;
+//#endregion
+export { ExpectedFlowOp, assetBalance, expectAdjustResumePreview, expectCallsArrayExact, expectOpsArrayExact, withOnchainOpCalls };

package/dist/types/sdk/accounts/intents/testing/resume.d.ts

@@ -0,0 +1,84 @@
+import { DelayedIntent } from "../../withdrawal-compressor/types.js";
+import { MultiCall } from "../../../types/transactions.js";
+import { OnchainSDK } from "../../../OnchainSDK.js";
+import { CreditAccountSlice } from "../types.js";
+import { ClaimDelayedOption } from "../operations/claim-delayed/index.js";
+import "../operations/index.js";
+import "../../../index.js";
+import { ExpectedFlowOp } from "./expect.js";
+import { Address } from "viem";
+//#region src/sdk/accounts/intents/testing/resume.d.ts
+/**
+ * Shared kit for claim-only resume fixtures (add collateral, increase
+ * leverage, deposit, deposit+increase).
+ *
+ * Unlike the legacy props (which echoed `creditAccount.totalValue`), the
+ * service computes totalValue from CA token balances via the price oracle.
+ * Each case's base balance is therefore `postClaimTotalValue − claimed value
+ * in UND`, so the derived totalValue matches the legacy expectation exactly.
+ */
+declare const UND_DECIMALS = 8;
+declare const TOK_DECIMALS = 18;
+declare const UND: Address;
+declare const ANY: Address;
+declare const ANY2: Address;
+declare const RWA_ASSET: Address;
+declare const RESUME_FIXTURE_PHANTOM: Address;
+declare const CREDIT_MANAGER: Address;
+declare const CREDIT_FACADE: Address;
+declare const CREDIT_ACCOUNT: Address;
+interface ResumeCase {
+  claimedToken: Address;
+  claimedAmount: bigint;
+  postClaimTotalValue: bigint;
+  postClaimDebt: bigint;
+  resumeOps: ExpectedFlowOp[];
+  expectedQuotaBalance?: bigint;
+  /**
+   * Pre-existing CA balances besides the withdrawal phantom. Defaults to
+   * `postClaimTotalValue − claimed value` in UND. Cases claiming UND override
+   * it with another token so the claimed balance stays distinguishable.
+   */
+  baseAssets?: CreditAccountSlice["tokens"];
+}
+/** Claimed proceeds converted to UND (mirrors the mock price oracle). */
+declare function claimedValueInUnd(amount: bigint, token: Address): bigint;
+/**
+ * Mock sdk for a resume case. The fixture phantom token gets the claimed
+ * token's decimals so the offchain `toTargetDecimals` rescale stays identity
+ * (its `10n * decimals` factor is only correct for equal decimals).
+ * `closePath` configures the router `findBestClosePath` result (close resume).
+ */
+declare function buildResumeSdk(c: Pick<ResumeCase, "claimedToken">, extras?: {
+  closePath?: {
+    amount: bigint;
+    minAmount: bigint;
+    underlyingBalance: bigint;
+    calls: MultiCall[];
+  };
+  /** RWA markets: underlying → rwa.asset (tokensMeta.rwaUnderlyings). */
+  rwaAssets?: Record<Address, Address>;
+  /** Additional / overriding token prices (PRICE_DECIMALS_POW-scaled). */
+  extraPrices?: Record<Address, bigint>;
+  /** Additional / overriding token decimals. */
+  extraDecimals?: Record<Address, number>;
+  /** Withdrawal phantom address (defaults to RESUME_FIXTURE_PHANTOM). */
+  phantom?: Address;
+}): OnchainSDK;
+declare function buildOffchainOptions(c: Pick<ResumeCase, "claimedToken" | "claimedAmount">): ClaimDelayedOption;
+declare function buildOnchainOptions(c: Pick<ResumeCase, "claimedToken" | "claimedAmount">): ClaimDelayedOption;
+declare function buildClaimResumeProps<T extends DelayedIntent>(args: {
+  intent: T;
+  case: ResumeCase;
+  sdk: OnchainSDK;
+  options: ClaimDelayedOption;
+}): {
+  intent: T;
+  creditAccount: CreditAccountSlice;
+  sdk: OnchainSDK<{}>;
+  quotaReserve: undefined;
+  options: ClaimDelayedOption;
+  slippage: undefined;
+};
+//#endregion
+export { ANY, ANY2, CREDIT_ACCOUNT, CREDIT_FACADE, CREDIT_MANAGER, RESUME_FIXTURE_PHANTOM, RWA_ASSET, ResumeCase, TOK_DECIMALS, UND, UND_DECIMALS, buildClaimResumeProps, buildOffchainOptions, buildOnchainOptions, buildResumeSdk, claimedValueInUnd };

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

@@ -0,0 +1,90 @@
+import { MultiCall } from "../../../types/transactions.js";
+import { OnchainSDK } from "../../../OnchainSDK.js";
+import "../../../index.js";
+import { Address } from "viem";
+//#region src/sdk/accounts/intents/testing/sdk-mock.d.ts
+/**
+ * Test kit for intent-service specs.
+ *
+ * The service resolves all market data through `OnchainSDK`
+ * (`marketRegister`, `tokensMeta`, `accounts`). `buildMockSdk` builds a mock
+ * from plain records; assemble mocks ECHO recognizable sentinel calls derived
+ * from their inputs, so `result.instant.calls` pins down which ops reached the
+ * assembler and in which order.
+ */
+/** Fixture `claimableWithdrawal.claimCalls` content; echoes through claim ops. */
+declare const MOCK_CLAIM_CALL: MultiCall;
+/** Recognizable router call embedded in close path results. */
+declare const MOCK_ROUTER_CALL: MultiCall;
+/** Returned by the `getRWAWrapCalls` mock; passes through per wrap op. */
+declare const MOCK_RWA_WRAP_CALL: MultiCall;
+/** Router-produced call for an RWA underlying → asset unwrap leg. */
+declare const MOCK_RWA_UNWRAP_CALL: MultiCall;
+/** Returned by the `assembleCloseCreditAccountCalls` mock. */
+declare const MOCK_CLOSE_CALL: MultiCall;
+/** One sentinel call per plain encodable op type. */
+declare const CA_OP_CALLS: {
+  readonly addCollateral: {
+    readonly target: Address;
+    readonly callData: "0x";
+  };
+  readonly increaseDebt: {
+    readonly target: Address;
+    readonly callData: "0x";
+  };
+  readonly decreaseDebt: {
+    readonly target: Address;
+    readonly callData: "0x";
+  };
+  readonly withdrawCollateral: {
+    readonly target: Address;
+    readonly callData: "0x";
+  };
+  readonly changeQuota: {
+    readonly target: Address;
+    readonly callData: "0x";
+  };
+};
+interface MockQuotaEntry {
+  token: Address;
+  rate: bigint;
+  limit: bigint;
+  totalQuoted?: bigint;
+  quotaIncreaseFee?: bigint;
+  isActive: boolean;
+}
+interface BuildMockSdkArgs {
+  /** Price per token (PRICE_DECIMALS_POW-scaled), like legacy `prices`. */
+  prices: Record<Address, bigint>;
+  /** Token decimals; used by `tokensMeta` and the price conversion. */
+  decimals: Record<Address, number>;
+  /** Pool quota params (AddressMap values shape). */
+  quotas: Record<Address, MockQuotaEntry>;
+  liquidationThresholds: Record<Address, number>;
+  maxDebt: bigint;
+  creditManager: Address;
+  creditFacade: Address;
+  /** Market underlying token (`market.pool.underlying`). */
+  underlying: Address;
+  /**
+   * Close resume: router `findBestClosePath` result. When set, the mock
+   * provides `routerFor` and `assembleCloseCreditAccountCalls`.
+   */
+  closePath?: {
+    amount: bigint;
+    minAmount: bigint;
+    underlyingBalance: bigint;
+    calls: MultiCall[];
+  };
+  /** RWA markets: underlying → rwa.asset (`tokensMeta.rwaUnderlyings`). */
+  rwaAssets?: Record<Address, Address>;
+}
+/**
+ * Mock `OnchainSDK` covering exactly what the intent-service touches:
+ * price conversion, quota params, CM/facade lookup and call assembly.
+ * Conversion mirrors the legacy price-based math:
+ * `amount * price[from] * 10^dec(to) / (price[to] * 10^dec(from))`.
+ */
+declare function buildMockSdk(args: BuildMockSdkArgs): OnchainSDK;
+//#endregion
+export { CA_OP_CALLS, MOCK_CLAIM_CALL, MOCK_CLOSE_CALL, MOCK_ROUTER_CALL, MOCK_RWA_UNWRAP_CALL, MOCK_RWA_WRAP_CALL, MockQuotaEntry, buildMockSdk };

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

@@ -0,0 +1,75 @@
+import { DelayedIntent, RequestableWithdrawal } from "../withdrawal-compressor/types.js";
+import { Asset } from "../../base/types.js";
+import { RouterCASlice } from "../../router/types.js";
+import { MultiCall } from "../../types/transactions.js";
+import { AccountCalculatorOperation } from "./operations/types.js";
+import "./operations/index.js";
+import "../../index.js";
+import { Address } from "viem";
+//#region src/sdk/accounts/intents/types.d.ts
+/**
+ * Minimal credit-account data needed by resume previews:
+ * account address, CM lookup, underlying for conversion, debt, token balances
+ * and initial quotas.
+ */
+type CreditAccountSlice = Omit<RouterCASlice, "debt"> & {
+  /** either base debt or debt plus interest and fees */
+  accountDebt: bigint;
+};
+/** Post-adjust CA metrics. */
+type AdjustState = {
+  kind: "adjust";
+  /** Account TVL after operation */
+  totalValue: bigint;
+  /** Account debt after operation */
+  accountDebt: bigint;
+  /** Account assets after operation */
+  assets: Asset[];
+  /** Account quotas after operation */
+  quotas: Record<Address, Asset>;
+};
+/** Close state result. */
+type CloseState = {
+  kind: "close";
+  /** Received amount */
+  amount: bigint;
+  /** Conservative receive (min branch / pathfinder floor). */
+  minAmount: bigint;
+  /** Pathfinder underlying on CA after close path; 0n when unknown (instant). */
+  underlyingBalance: bigint;
+};
+type OperationState = AdjustState | CloseState;
+type DelayedBranchKind = "instantSettle" | "partialSettle" | "delayedSettle";
+type DelayedBranchResult = {
+  kind: DelayedBranchKind;
+  operations: AccountCalculatorOperation[];
+  preview: {
+    min: OperationState;
+  };
+  calls: MultiCall[];
+  intent: DelayedIntent;
+  request?: RequestableWithdrawal;
+};
+type DelayedErrorReason = "multipleDelayedWithdrawals" | "withdrawalInProgress";
+type InstantBranchResult = {
+  operations: AccountCalculatorOperation[];
+  preview: {
+    min: OperationState;
+  };
+  calls: MultiCall[];
+};
+type InstantErrorReason = "pathNotFound";
+type PreviewErrorResult = {
+  ok: false;
+  reason: "unsupportedFieldPair" | "debtOutOfRange" | "leverageOutOfRange" | "multipleDelayedWithdrawals" | "unsupportedMixedDelayedWithdrawal" | "unsupportedCloseClaimOutput" | "insufficientSourceBalance";
+};
+interface IntentPreviewSuccessResult {
+  ok: true;
+  instant: InstantBranchResult | undefined;
+  instantError: InstantErrorReason | undefined;
+  delayedBranch: DelayedBranchResult | undefined;
+  delayedError: DelayedErrorReason | undefined;
+}
+type IntentPreviewResult = IntentPreviewSuccessResult | PreviewErrorResult;
+//#endregion
+export { AdjustState, CloseState, CreditAccountSlice, IntentPreviewResult, OperationState };

package/dist/types/sdk/accounts/intents/utils/assemble-operation-calls.d.ts

@@ -0,0 +1,10 @@
+import { MultiCall } from "../../../types/transactions.js";
+import { AccountCalculatorOperation } from "../operations/types.js";
+import "../../../index.js";
+//#region src/sdk/accounts/intents/utils/assemble-operation-calls.d.ts
+interface Props {
+  operations: AccountCalculatorOperation[];
+}
+declare function assembleOperationCalls({ operations }: Props): MultiCall[];
+//#endregion
+export { assembleOperationCalls };

package/dist/types/sdk/accounts/intents/utils/borrowed-amount-plus-interest-and-fees.d.ts

@@ -0,0 +1,17 @@
+//#region src/sdk/accounts/intents/utils/borrowed-amount-plus-interest-and-fees.d.ts
+/**
+ * Total debt of a credit account: principal + accrued interest + accrued fees.
+ *
+ * On the v3 SDK `CreditAccountData` the parts
+ * come as separate `debt` / `accruedInterest` / `accruedFees` fields.
+ */
+declare function calcBorrowedAmountPlusInterestAndFees(ca: {
+  /** Debt principal in underlying. */
+  debt: bigint;
+  /** Base and quota interest accrued on the account. */
+  accruedInterest: bigint;
+  /** Fees accrued on the account. */
+  accruedFees: bigint;
+}): bigint;
+//#endregion
+export { calcBorrowedAmountPlusInterestAndFees };

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

@@ -0,0 +1,19 @@
+import { Asset } from "../../../base/types.js";
+import { RouterCASlice } from "../../../router/types.js";
+import { OnchainSDK } from "../../../OnchainSDK.js";
+import { CreditAccountSlice } from "../types.js";
+import "../../../index.js";
+import { Address } from "viem";
+//#region src/sdk/accounts/intents/utils/common.d.ts
+/** Case-insensitive address equality. */
+declare const eq: (a: Address, b: Address) => boolean;
+declare function toTargetDecimals(fromAmount: bigint, fromToken: Address, toToken: Address, sdk: OnchainSDK): bigint;
+/**
+ * Router CA slice from the account slice. RouterV310 reads `ca.tokens` for
+ * underlyingBalance, so balances are overlaid with the post-claim projection
+ * (legacy `overlayExpectedBalancesOntoCaTokens`): existing tokens keep quota
+ * with balance from the projection (0n when absent), new tokens get quota 0n.
+ */
+declare function toRouterCaSlice(creditAccount: CreditAccountSlice, expectedBalances?: Asset[]): RouterCASlice;
+//#endregion
+export { eq, toRouterCaSlice, toTargetDecimals };

package/dist/types/sdk/accounts/intents/utils/convert-amount.d.ts

@@ -0,0 +1,13 @@
+import { OnchainSDK } from "../../../OnchainSDK.js";
+import "../../../index.js";
+import { Address } from "viem";
+//#region src/sdk/accounts/intents/utils/convert-amount.d.ts
+/**
+ * Converts an amount from one token to another using oracle prices of the
+ * given credit manager's market. When the direct oracle path is missing
+ * (e.g. `rwa.asset` has no pool price), bridges via the wrapped underlying
+ * (1:1 wrap + decimals rescale) — mirrors legacy `convertAmountWithRwaBridge`.
+ */
+declare const convertAmount: (sdk: OnchainSDK, creditManager: Address) => (fromTokenRaw: Address, toTokenRaw: Address, amount: bigint) => bigint;
+//#endregion
+export { convertAmount };

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

@@ -0,0 +1,9 @@
+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 { convertAmount } from "./convert-amount.js";
+import { ConvertFn, simulateOperationAssets } from "./simulate-assets.js";
+import { getQuotasForUpdate } from "./quotas-for-update.js";
+import { SimulateStateReturn, simulateState } from "./simulate-adjust-state.js";
+import { getOperationsWithQuotaUpdate } from "./with-quota-update.js";
+export { ConvertFn, SimulateStateReturn, assembleOperationCalls, calcBorrowedAmountPlusInterestAndFees, convertAmount, eq, getOperationsWithQuotaUpdate, getQuotasForUpdate, simulateOperationAssets, simulateState, toRouterCaSlice, toTargetDecimals };

package/dist/types/sdk/accounts/intents/utils/quotas-for-update.d.ts

@@ -0,0 +1,35 @@
+import { AddressMap } from "../../../utils/AddressMap.js";
+import { Asset } from "../../../base/types.js";
+import { QuotaUpdateState } from "../operations/quota-update/index.js";
+import "../operations/index.js";
+import "../../../index.js";
+import { ConvertFn } from "./simulate-assets.js";
+import { Address } from "viem";
+//#region src/sdk/accounts/intents/utils/quotas-for-update.d.ts
+interface InitialQuota {
+  token: Address;
+  quota: bigint;
+}
+interface Quota {
+  token: Address;
+  rate: number;
+  cumulativeIndexLU: bigint;
+  quotaIncreaseFee: number;
+  totalQuoted: bigint;
+  limit: bigint;
+  isActive: boolean;
+}
+interface GetQuotasForUpdateProps {
+  assetsBefore: Asset[] | readonly Asset[];
+  assetsAfter: Asset[];
+  initialQuotas: Array<InitialQuota> | readonly InitialQuota[];
+  quotaReserve: number | undefined;
+  underlyingToken: Address;
+  liquidationThresholds: AddressMap<number>;
+  quotas: AddressMap<Quota>;
+  maxDebt: bigint;
+  convert: ConvertFn;
+}
+declare function getQuotasForUpdate({ assetsBefore, assetsAfter, initialQuotas, quotaReserve, liquidationThresholds: liquidationThresholdsMap, quotas: quotasMap, maxDebt, underlyingToken, convert }: GetQuotasForUpdateProps): QuotaUpdateState;
+//#endregion
+export { getQuotasForUpdate };

package/dist/types/sdk/accounts/intents/utils/simulate-adjust-state.d.ts

@@ -0,0 +1,19 @@
+import { OnchainSDK } from "../../../OnchainSDK.js";
+import { AdjustState, CreditAccountSlice } from "../types.js";
+import { QuotaUpdateState } from "../operations/quota-update/index.js";
+import { AccountCalculatorOperation } from "../operations/types.js";
+import "../../../index.js";
+//#region src/sdk/accounts/intents/utils/simulate-adjust-state.d.ts
+interface Props {
+  operations: AccountCalculatorOperation[];
+  creditAccount: CreditAccountSlice;
+  sdk: OnchainSDK;
+  quotaReserve: number | undefined;
+}
+type SimulateStateReturn = ReturnType<typeof simulateState>;
+declare function simulateState(props: Props): {
+  state: AdjustState;
+  quotaResult: QuotaUpdateState;
+};
+//#endregion
+export { SimulateStateReturn, simulateState };

package/dist/types/sdk/accounts/intents/utils/simulate-assets.d.ts

@@ -0,0 +1,21 @@
+import { Asset } from "../../../base/types.js";
+import { AccountCalculatorOperation } from "../operations/types.js";
+import "../../../index.js";
+import { Address } from "viem";
+//#region src/sdk/accounts/intents/utils/simulate-assets.d.ts
+type ConvertFn = (token: Address, to: Address, amount: bigint) => bigint;
+interface SimulateOperationAssetsProps {
+  initialAssets: readonly Asset[] | Asset[];
+  operations: AccountCalculatorOperation[];
+  underlyingToken: Address;
+  debt: bigint;
+  convert: ConvertFn;
+}
+/** Apply an op chain to CA token balances. Address keys are lowercased. */
+declare function simulateOperationAssets({ initialAssets, operations, underlyingToken, debt, convert }: SimulateOperationAssetsProps): {
+  assets: Asset[];
+  totalValue: bigint;
+  debt: bigint;
+};
+//#endregion
+export { ConvertFn, simulateOperationAssets };

package/dist/types/sdk/accounts/intents/utils/with-quota-update.d.ts

@@ -0,0 +1,16 @@
+import { OnchainSDK } from "../../../OnchainSDK.js";
+import { CreditAccountSlice } from "../types.js";
+import { AccountCalculatorOperation, OperationBuilderOption } from "../operations/types.js";
+import "../../../index.js";
+import { SimulateStateReturn } from "./simulate-adjust-state.js";
+//#region src/sdk/accounts/intents/utils/with-quota-update.d.ts
+interface Props {
+  operations: AccountCalculatorOperation[];
+  state: SimulateStateReturn;
+  creditAccount: CreditAccountSlice;
+  sdk: OnchainSDK;
+  options: OperationBuilderOption;
+}
+declare function getOperationsWithQuotaUpdate({ operations: coreOps, state, creditAccount, sdk, options }: Props): AccountCalculatorOperation[];
+//#endregion
+export { getOperationsWithQuotaUpdate };

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

@@ -1080,6 +1080,26 @@ interface ICreditAccountsService extends Construct {
    * @returns Array of facade / adapter multicall calls (without price feed updates)
    */
   assembleCaOperations(props: AssembleCaOperationsProps): Array<MultiCall>;
+  /**
+   * Encodes a facade `increaseDebt` multicall entry.
+   */
+  prepareIncreaseDebt(creditFacade: Address, debt: bigint): MultiCall;
+  /**
+   * Encodes a facade `increaseDebt` or `decreaseDebt` multicall entry.
+   */
+  prepareChangeDebt(creditFacade: Address, change: bigint, isDecrease: boolean): MultiCall;
+  /**
+   * Encodes facade `addCollateral` / `addCollateralWithPermit` multicall entries.
+   */
+  prepareAddCollateral(creditFacade: Address, assets: Array<Asset>, permits: Record<string, PermitResult>): Array<MultiCall>;
+  /**
+   * Encodes a facade `withdrawCollateral` multicall entry.
+   */
+  prepareWithdrawToken(creditFacade: Address, token: Address, amount: bigint, to: Address): MultiCall;
+  /**
+   * Encodes facade `updateQuota` multicall entries from average/min quota assets.
+   */
+  prepareUpdateQuotas(creditFacade: Address, props: PrepareUpdateQuotasProps): Array<MultiCall>;
   /**
    * Executes a credit account update: prepends price feed updates and builds the raw
    * multicall transaction. Uses the RWA factory when applicable.