@gearbox-protocol/sdk 16.0.0-next.22 → 16.0.0-next.24

package/dist/types/onchain/accounts/intents/tests/adjust-leverage.fixtures.d.ts

@@ -24,9 +24,9 @@ declare const QUOTA_DOWN: bigint;
 interface AdjustLeverageCase {
   intent: AdjustLeverageIntent;
   tokens: ReturnType<typeof caToken>[];
-  accountDebt: bigint;
+  totalDebt: bigint;
   totalValue: bigint;
-  accountDebtAfter: bigint;
+  totalDebtAfter: bigint;
   ops: ExpectedFlowOp[];
   rwaAssets?: Record<Address, Address>;
 }

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

@@ -18,9 +18,9 @@ declare const LEV_3X = 300n;
 interface DepositCase {
   intent: DepositStrategyIntent;
   tokens: ReturnType<typeof caToken>[];
-  accountDebt: bigint;
+  totalDebt: bigint;
   totalValue: bigint;
-  accountDebtAfter: bigint;
+  totalDebtAfter: bigint;
   ops: ExpectedFlowOp[];
   rwaAssets?: Record<Address, Address>;
 }

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

@@ -34,7 +34,7 @@ declare const QUOTA_ANY_DELTA: bigint;
 interface WithdrawAssetCase {
   intent: WithdrawAssetIntent;
   tokens: ReturnType<typeof caToken>[];
-  accountDebt: bigint;
+  totalDebt: bigint;
   totalValue: bigint;
   ops: ExpectedFlowOp[];
   rwaAssets?: Record<Address, Address>;

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

@@ -20,9 +20,9 @@ declare const QUOTA_DELTA: bigint;
 interface WithdrawCase {
   intent: WithdrawStrategyIntent;
   tokens: ReturnType<typeof caToken>[];
-  accountDebt: bigint;
+  totalDebt: bigint;
   totalValue: bigint;
-  accountDebtAfter: bigint;
+  totalDebtAfter: bigint;
   ops: ExpectedFlowOp[];
   rwaAssets?: Record<Address, Address>;
 }

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

@@ -1,9 +1,7 @@
-import { Bps, Leverage, TokenAmount } from "../../../model/primitives.js";
 import { DelayedIntent } from "../../../model/delayed-intents.js";
-import { BorrowRateBreakdown } from "../../../model/positions.js";
+import { AccountProjection } from "../../../model/previews.js";
 import "../../../model/index.js";
 import { ClaimableWithdrawal } from "../withdrawal-compressor/types.js";
-import { Asset } from "../../base/types.js";
 import { RouterCASlice } from "../../router/types.js";
 import { MultiCall } from "../../types/transactions.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
@@ -19,7 +17,7 @@ import { Address } from "viem";
  */
 type CreditAccountSlice = Omit<RouterCASlice, "debt"> & {
   /** either base debt or debt plus interest and fees */
-  accountDebt: bigint;
+  totalDebt: bigint;
 };
 /**
  * Price impact against three bases: the routed output, net value, total value.
@@ -32,61 +30,12 @@ interface PathLossRate {
   netValuePriceImpact: bigint;
   totalValuePriceImpact: bigint;
 }
-/** Projected account metrics once the operations execute. */
-interface OperationState {
-  /**
-   * Health factor in basis points: below `10000` the account is liquidatable.
-   *
-   * @example `12500` for a health factor of 1.25
-   **/
-  healthFactor: Bps;
-  /**
-   * The same factor with collateral valued at safe prices, present only where
-   * the walk had reason to compute it — a call that hands funds over, which is
-   * the one the credit manager weighs at safe prices on-chain.
-   **/
-  safeHealthFactor?: Bps;
-  /**
-   * Cost of the debt, broken down by source.
-   **/
-  borrowRate: BorrowRateBreakdown;
-  /**
-   * Estimated milliseconds until the health factor decays to `10000` under
-   * the current borrow rate, or `null` when the debt carries no rate (or the
-   * account is already liquidatable).
-   **/
-  timeToLiquidation: bigint | null;
-  /**
-   * Price of the single non-underlying collateral at which the account
-   * becomes liquidatable, in the oracle's 8-decimal fixed point, or `null`
-   * when the account holds zero or several non-underlying assets.
-   **/
-  liquidationPrice: bigint | null;
-  /** Account TVL after operation */
-  totalValue: bigint;
-  /**
-   * Account debt after operation: principal plus accrued interest and fees,
-   * the amount it would take to settle the loan — the same quantity the
-   * preview module reports as `debt`.
-   */
-  accountDebt: bigint;
-  /**
-   * Leverage after operation in the read model's convention — `debt / equity`,
-   * as `Position.leverage` reports it — not the calculator's `TVL / collateral`.
-   */
-  leverage: Leverage;
-  /**
-   * What the account holds after the operation, priced: the same shape the
-   * read model and the transaction previews report holdings in, so a caller
-   * showing them needs no registry or oracle of its own.
-   */
-  assets: TokenAmount[];
-  /**
-   * Every quota the account stands at after the operation: the ones the plan
-   * resized as well as the ones it left alone. Tokens it leaves unquoted are
-   * absent rather than present at zero.
-   */
-  quotas: Record<Address, Asset>;
+/**
+ * What the operations leave the account at, in the shared
+ * {@link AccountProjection} vocabulary, plus the one thing only a routed walk
+ * can report.
+ */
+interface OperationState extends AccountProjection {
   /**
    * What the routed legs lost to market depth. `undefined` where nothing was
    * routed or nothing could be measured — never a manufactured zero.

package/dist/types/onchain/accounts/intents/utils/adjust-state-to-snapshot.d.ts

@@ -5,8 +5,8 @@ import { Address } from "viem";
 //#region src/onchain/accounts/intents/utils/adjust-state-to-snapshot.d.ts
 /**
  * Maps an intents {@link OperationState} onto the {@link AccountSnapshot} that
- * position-metric functions take. `accountDebt` is treated as total debt
- * (principal plus accrued interest and fees).
+ * position-metric functions take: the state prices what it reports, a snapshot
+ * only names it.
  **/
 declare function adjustStateToSnapshot(creditManager: Address, state: OperationState): AccountSnapshot;
 //#endregion

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

@@ -7,9 +7,9 @@ import { Address } from "viem";
 /**
  * Narrows full account data down to the slice the intent engine operates on.
  *
- * `accountDebt` is the total repayable debt (principal + accrued interest +
- * accrued fees) rather than the principal, because every debt-touching intent
- * settles the full outstanding amount.
+ * `totalDebt` is the total repayable debt (principal + accrued interest +
+ * accrued fees) rather than `CreditAccountData.debt`'s principal, because every
+ * debt-touching intent settles the full outstanding amount.
  *
  * Addresses are lowercased so that `eq` comparisons and `AddressMap` lookups
  * behave consistently everywhere downstream.

package/dist/types/onchain/market/MarketSuite.d.ts

@@ -1,4 +1,4 @@
-import { Token, UnderlyingToken } from "../../model/primitives.js";
+import { Token, TokenAmount, UnderlyingToken } from "../../model/primitives.js";
 import { Curator } from "../../model/curators.js";
 import { Opportunity, OpportunityFilter, PoolOpportunity, PoolOpportunityDetail, PriceFeedSummary, QuotaAsset } from "../../model/opportunities.js";
 import "../../model/index.js";
@@ -101,6 +101,18 @@ declare class MarketSuite extends SDKConstruct {
    * wrapper itself, e.g. USDC rather than dcUSDC (which will be "wrappedAddress" in this case)
    */
   get underlyingToken(): UnderlyingToken;
+  /**
+   * Prices a figure already denominated in this market's underlying — a debt,
+   * a TVL, a payout — as the read model reports one.
+   *
+   * The token it names is {@link underlyingToken}, so an amount coming out of a
+   * preview or a simulation carries the same identity as the one on a
+   * `StrategyPosition`: USDC on an RWA market, not the dcUSDC wrapper the pool
+   * actually holds. The two convert one-for-one, so the figure is exact either
+   * way; only the label differs, and a caller showing both side by side must
+   * not see two.
+   **/
+  toUnderlyingAmount: (value: bigint) => TokenAmount;
   /**
    * Display name of this market's pool, e.g. `"USDC Pool"`.
    */

package/dist/types/onchain/market/math.d.ts

@@ -26,12 +26,16 @@ declare function bpsToRay(bps: Bps): bigint;
 /**
  * Converts a USD value in the oracle's 8-decimal fixed point to a float.
  *
- * Values below {@link USD_DUST_THRESHOLD} report as `0`.
+ * Values whose magnitude is below {@link USD_DUST_THRESHOLD} report as `0`.
+ * The threshold is weighed on the magnitude because the deltas the model
+ * carries — a debt repaid, a balance sold — are negative, and dust is dust in
+ * either direction.
  *
  * @example
  * ```ts
  * // usd: $1500.50 in 8-decimal fixed point
  * usdToNumber(150_050_000_000n) // 1500.5
+ * usdToNumber(-150_050_000_000n) // -1500.5
  * ```
  **/
 declare function usdToNumber(usd: bigint): number;

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

@@ -1,3 +1,4 @@
+import { Amount, TokenAmount } from "../../model/primitives.js";
 import { PoolPosition } from "../../model/positions.js";
 import "../../model/index.js";
 import { Asset, PermitResult } from "../base/types.js";
@@ -135,11 +136,11 @@ interface PoolSimulation {
   /**
    * Token and amount leaving the wallet — exactly what was asked for.
    **/
-  tokenIn: Asset;
+  tokenIn: TokenAmount;
   /**
    * Token and amount arriving in the wallet at the rate the pool state implies.
    **/
-  tokenOut: Asset;
+  tokenOut: TokenAmount;
   /**
    * Zapper the operation would be routed through; unset for direct pool
    * operations.
@@ -150,9 +151,10 @@ interface PoolSimulation {
    * shaved by a hair so a withdrawal sized against it does not fail on rounding.
    *
    * The conversion is a rate, not a promise that the pool is liquid enough, so
-   * compare `tokenOut.balance` against this to see if the withdrawal fits.
+   * compare `tokenOut.value` against `availableLiquidity.value` to see if the
+   * withdrawal fits.
    **/
-  availableLiquidity?: bigint;
+  availableLiquidity?: Amount;
 }
 /**
  * Props for {@link IPoolsService.listPositions}.

package/dist/types/preview/index.d.ts

@@ -38,7 +38,7 @@ import { previewOperation } from "./preview/previewOperation.js";
 import { ReplayState, makeReplayState, replayInnerOperations } from "./preview/replayInnerOperations.js";
 import { ReplayMulticallResult, ReplayableOperation, replayMulticall } from "./preview/replayMulticall.js";
 import "./preview/index.js";
-import { CheckOperationOptions, checkOperation, collateralIssuesOf } from "./validate/checkOperation.js";
+import { CheckOperationOptions, checkOperation, collateralIssue, marketIssues, quotaCountIssue } from "./validate/checkOperation.js";
 import { checkSimulation } from "./validate/checkSimulation.js";
 import "./validate/index.js";
-export { AdapterOperation, AdapterOperationBase, AddCollateralOp, AllowanceDetail, AllowancePrerequisite, AllowanceResult, BalanceDetail, BalancePrerequisite, BalanceResult, BorrowLimitBinding, CheckOperationOptions, ClassifyInnerOperationsProps, CloseCreditAccountOperation, CloseOrRepayOperation, CompareBalancesOp, CreditAccountOperation, CreditAccountState, CreditAccountStateProps, DecreaseDebtOp, DetectedDelayedClaim, DetectedDelayedOperation, DirectTokenTransferOperation, ExtractTransfersResult, FacadeCallType, FacadeOperationMetadata, FacadeParsedCall, IncreaseDebtOp, InnerFacadeOperation, InnerOperation, IntentPreviewError, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, Operation, OperationMetadata, OuterFacadeOperation, PartialLiquidationOperation, PoolDepositOperation, PoolMintOperation, PoolOperation, PoolRedeemOperation, PoolWithdrawOperation, Prerequisite, PrerequisiteContext, PrerequisiteError, PrerequisiteKind, PrerequisiteOutcome, PrerequisiteResult, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewOperationInput, PreviewOperationOptions, PreviewRefusal, RWAMulticallOperation, RWAOpenCreditAccountOperation, RWAOpenRequirementsDetail, RWAOpenRequirementsPrerequisite, RWAOpenRequirementsResult, RWAOperation, RWAOperationMetadata, ReplayMulticallResult, ReplayState, ReplayableOperation, StoreExpectedBalancesOp, TokenTransfer, TraceAdapterExt, TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, UpdateQuotaOp, WithdrawCollateralAlignmentError, WithdrawCollateralEventInfo, WithdrawCollateralOp, buildDelayedPreview, checkOperation, checkPrerequisites, checkSimulation, classifyCloseOrRepay, classifyInnerOperations, collateralIssuesOf, detectDelayedClaim, detectDelayedOperation, extractAdapterCallTraces, extractTransfers, findFacadeCalls, isCloseOrRepay, isPoolOperation, isRWAOperation, makeReplayState, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, raise, refuse, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };
+export { AdapterOperation, AdapterOperationBase, AddCollateralOp, AllowanceDetail, AllowancePrerequisite, AllowanceResult, BalanceDetail, BalancePrerequisite, BalanceResult, BorrowLimitBinding, CheckOperationOptions, ClassifyInnerOperationsProps, CloseCreditAccountOperation, CloseOrRepayOperation, CompareBalancesOp, CreditAccountOperation, CreditAccountState, CreditAccountStateProps, DecreaseDebtOp, DetectedDelayedClaim, DetectedDelayedOperation, DirectTokenTransferOperation, ExtractTransfersResult, FacadeCallType, FacadeOperationMetadata, FacadeParsedCall, IncreaseDebtOp, InnerFacadeOperation, InnerOperation, IntentPreviewError, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, Operation, OperationMetadata, OuterFacadeOperation, PartialLiquidationOperation, PoolDepositOperation, PoolMintOperation, PoolOperation, PoolRedeemOperation, PoolWithdrawOperation, Prerequisite, PrerequisiteContext, PrerequisiteError, PrerequisiteKind, PrerequisiteOutcome, PrerequisiteResult, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewOperationInput, PreviewOperationOptions, PreviewRefusal, RWAMulticallOperation, RWAOpenCreditAccountOperation, RWAOpenRequirementsDetail, RWAOpenRequirementsPrerequisite, RWAOpenRequirementsResult, RWAOperation, RWAOperationMetadata, ReplayMulticallResult, ReplayState, ReplayableOperation, StoreExpectedBalancesOp, TokenTransfer, TraceAdapterExt, TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, UpdateQuotaOp, WithdrawCollateralAlignmentError, WithdrawCollateralEventInfo, WithdrawCollateralOp, buildDelayedPreview, checkOperation, checkPrerequisites, checkSimulation, classifyCloseOrRepay, classifyInnerOperations, collateralIssue, detectDelayedClaim, detectDelayedOperation, extractAdapterCallTraces, extractTransfers, findFacadeCalls, isCloseOrRepay, isPoolOperation, isRWAOperation, makeReplayState, marketIssues, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, quotaCountIssue, raise, refuse, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };

package/dist/types/preview/preview/buildDelayedPreview.d.ts

@@ -17,7 +17,7 @@ import { Address } from "viem";
  * nothing and set a non-fatal `ERROR_UNPRICEABLE_TOKEN` error on the
  * preview.
  *
- * The changes (e.g. `debtChange`) are reported relative to the account
+ * The changes (e.g. `totalDebtChange`) are reported relative to the account
  * state before the whole transaction.
  *
  * @param afterInstant - Account state after the instant part of the

package/dist/types/preview/validate/checkOperation.d.ts

@@ -1,7 +1,8 @@
 import { Bps } from "../../model/primitives.js";
-import { OperationPreview } from "../../model/previews.js";
+import { AccountProjection, OperationPreview } from "../../model/previews.js";
 import "../../model/index.js";
 import { AddressMap } from "../../onchain/utils/AddressMap.js";
+import { CreditSuite } from "../../onchain/market/credit/CreditSuite.js";
 import { OnchainSDK } from "../../onchain/OnchainSDK.js";
 import { PreviewIssue } from "../../onchain/validation/refusal.js";
 import "../../onchain/index.js";
@@ -37,10 +38,26 @@ declare function checkOperation(input: {
   sdk: OnchainSDK;
   preview: OperationPreview;
 }, options?: CheckOperationOptions): PreviewIssue | null;
-/** The two collateral bars, shared by the preview and the simulation paths. */
-declare function collateralIssuesOf(factors: {
-  healthFactor: Bps | undefined;
-  safeHealthFactor: Bps | undefined;
-}, options: CheckOperationOptions): PreviewIssue | null;
+/** What the market itself refuses, whatever the operation does. */
+declare function marketIssues(suite: CreditSuite): PreviewIssue | null;
+/**
+ * A bar that reads nothing but the projected account, so a parsed transaction
+ * and a simulated one are held to it by the same code.
+ *
+ * These stay separate functions rather than one block because the order the
+ * checks run in is the answer: `checkOperation` interleaves the checks that
+ * need an operation's *delta* between them, and the caller acts on the first
+ * issue reported.
+ */
+declare function quotaCountIssue(suite: CreditSuite, projection: AccountProjection): PreviewIssue | null;
+/**
+ * The account against whichever bars the caller holds it to.
+ *
+ * A loan-free account is nothing to weigh: the health factor reports its
+ * zero-debt sentinel and no bar applies.
+ *
+ * {@inheritDoc quotaCountIssue}
+ */
+declare function collateralIssue(projection: AccountProjection, options: CheckOperationOptions): PreviewIssue | null;
 //#endregion
-export { CheckOperationOptions, checkOperation, collateralIssuesOf };
+export { CheckOperationOptions, checkOperation, collateralIssue, marketIssues, quotaCountIssue };

package/dist/types/preview/validate/checkSimulation.d.ts

@@ -3,7 +3,6 @@ import { PreviewIssue } from "../../onchain/validation/refusal.js";
 import { OperationState } from "../../onchain/accounts/intents/types.js";
 import "../../onchain/index.js";
 import { CheckOperationOptions } from "./checkOperation.js";
-import { Address } from "viem";
 //#region src/preview/validate/checkSimulation.d.ts
 /**
  * Whether a simulated operation clears the caller's own bars.
@@ -28,7 +27,6 @@ import { Address } from "viem";
 declare function checkSimulation(input: {
   sdk: OnchainSDK;
   state: OperationState;
-  creditManager: Address;
 }, options?: CheckOperationOptions): PreviewIssue | null;
 //#endregion
 export { checkSimulation };

package/dist/types/preview/validate/index.d.ts

@@ -1,3 +1,3 @@
-import { CheckOperationOptions, checkOperation, collateralIssuesOf } from "./checkOperation.js";
+import { CheckOperationOptions, checkOperation, collateralIssue, marketIssues, quotaCountIssue } from "./checkOperation.js";
 import { checkSimulation } from "./checkSimulation.js";
-export { CheckOperationOptions, checkOperation, checkSimulation, collateralIssuesOf };
+export { CheckOperationOptions, checkOperation, checkSimulation, collateralIssue, marketIssues, quotaCountIssue };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "16.0.0-next.22",
+  "version": "16.0.0-next.24",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {