@gearbox-protocol/sdk 14.12.0-next.42 → 14.12.0-next.43

package/dist/cjs/sdk/accounts/withdrawal-compressor/intent-codec.js

@@ -25,7 +25,7 @@ __export(intent_codec_exports, {
 });
 module.exports = __toCommonJS(intent_codec_exports);
 var import_viem = require("viem");
-const DELAYED_INTENT_VERSION = 2;
+const DELAYED_INTENT_VERSION = 1;
 const DELAYED_INTENT_TYPES = {
   INCREASE_LEVERAGE: 1,
   DEPOSIT: 2,
@@ -51,7 +51,6 @@ function encodeDelayedIntent(intent) {
   const version = DELAYED_INTENT_VERSION;
   const intentType = DELAYED_INTENT_TYPES[intent.type];
   switch (intent.type) {
-    case "INCREASE_LEVERAGE":
     case "CLOSE_ACCOUNT":
       return (0, import_viem.encodeAbiParameters)(TO_PARAMS, [version, intentType, intent.to]);
     case "WITHDRAW_COLLATERAL":
@@ -64,6 +63,7 @@ function encodeDelayedIntent(intent) {
         intent.sourceToken,
         intent.debtRepaid
       ]);
+    case "INCREASE_LEVERAGE":
     case "DEPOSIT":
     case "DEPOSIT_AND_INCREASE_LEVERAGE":
     case "ADD_COLLATERAL":
@@ -76,15 +76,10 @@ function encodeDelayedIntent(intent) {
   }
 }
 function decodeDelayedIntent(data) {
-  const [version, intentType] = (0, import_viem.decodeAbiParameters)(HEADER_PARAMS, data);
-  if (version !== DELAYED_INTENT_VERSION) {
-    throw new Error(`unsupported delayed intent version: ${version}`);
-  }
+  const [_version, intentType] = (0, import_viem.decodeAbiParameters)(HEADER_PARAMS, data);
   switch (intentType) {
-    case DELAYED_INTENT_TYPES.INCREASE_LEVERAGE: {
-      const [, , to] = (0, import_viem.decodeAbiParameters)(TO_PARAMS, data);
-      return { type: "INCREASE_LEVERAGE", to };
-    }
+    case DELAYED_INTENT_TYPES.INCREASE_LEVERAGE:
+      return { type: "INCREASE_LEVERAGE" };
     case DELAYED_INTENT_TYPES.DEPOSIT:
       return { type: "DEPOSIT" };
     case DELAYED_INTENT_TYPES.DEPOSIT_AND_INCREASE_LEVERAGE:

package/dist/cjs/sdk/chain/chains.js

@@ -80,7 +80,9 @@ const chains = {
       },
       testMarketConfigurators: {
         "0x99df7330bf42d596af2e9d9836d4fc2077c574aa": "M11 Credit",
-        "0x610627d8d01a413bdd9b0a0b60070da7dd1e54ad": "Securitize"
+        "0x610627d8d01a413bdd9b0a0b60070da7dd1e54ad": "Securitize",
+        "0xa770ce584adb6491a2138da6eaec33243bdcd248": "Testnet Curator"
+        // without governor, for midas
       },
       rwaFactories: [],
       isPublic: true,

package/dist/esm/sdk/accounts/withdrawal-compressor/intent-codec.js

@@ -1,5 +1,5 @@
 import { decodeAbiParameters, encodeAbiParameters } from "viem";
-const DELAYED_INTENT_VERSION = 2;
+const DELAYED_INTENT_VERSION = 1;
 const DELAYED_INTENT_TYPES = {
   INCREASE_LEVERAGE: 1,
   DEPOSIT: 2,
@@ -25,7 +25,6 @@ function encodeDelayedIntent(intent) {
   const version = DELAYED_INTENT_VERSION;
   const intentType = DELAYED_INTENT_TYPES[intent.type];
   switch (intent.type) {
-    case "INCREASE_LEVERAGE":
     case "CLOSE_ACCOUNT":
       return encodeAbiParameters(TO_PARAMS, [version, intentType, intent.to]);
     case "WITHDRAW_COLLATERAL":
@@ -38,6 +37,7 @@ function encodeDelayedIntent(intent) {
         intent.sourceToken,
         intent.debtRepaid
       ]);
+    case "INCREASE_LEVERAGE":
     case "DEPOSIT":
     case "DEPOSIT_AND_INCREASE_LEVERAGE":
     case "ADD_COLLATERAL":
@@ -50,15 +50,10 @@ function encodeDelayedIntent(intent) {
   }
 }
 function decodeDelayedIntent(data) {
-  const [version, intentType] = decodeAbiParameters(HEADER_PARAMS, data);
-  if (version !== DELAYED_INTENT_VERSION) {
-    throw new Error(`unsupported delayed intent version: ${version}`);
-  }
+  const [_version, intentType] = decodeAbiParameters(HEADER_PARAMS, data);
   switch (intentType) {
-    case DELAYED_INTENT_TYPES.INCREASE_LEVERAGE: {
-      const [, , to] = decodeAbiParameters(TO_PARAMS, data);
-      return { type: "INCREASE_LEVERAGE", to };
-    }
+    case DELAYED_INTENT_TYPES.INCREASE_LEVERAGE:
+      return { type: "INCREASE_LEVERAGE" };
     case DELAYED_INTENT_TYPES.DEPOSIT:
       return { type: "DEPOSIT" };
     case DELAYED_INTENT_TYPES.DEPOSIT_AND_INCREASE_LEVERAGE:

package/dist/esm/sdk/chain/chains.js

@@ -66,7 +66,9 @@ const chains = {
       },
       testMarketConfigurators: {
         "0x99df7330bf42d596af2e9d9836d4fc2077c574aa": "M11 Credit",
-        "0x610627d8d01a413bdd9b0a0b60070da7dd1e54ad": "Securitize"
+        "0x610627d8d01a413bdd9b0a0b60070da7dd1e54ad": "Securitize",
+        "0xa770ce584adb6491a2138da6eaec33243bdcd248": "Testnet Curator"
+        // without governor, for midas
       },
       rwaFactories: [],
       isPublic: true,

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

@@ -256,13 +256,22 @@ export interface RepayCreditAccountProps extends RepayAndLiquidateCreditAccountP
      */
     operation: CloseOptions;
 }
+/**
+ * Quota `Asset.balance` values are denominated in **pool underlying token
+ * units**, not in the quoted token's own units.
+ **/
 export interface PrepareUpdateQuotasProps {
     /**
-     * average quota for desired token
+     * Average quota for desired token, in pool underlying units
+     * (see {@link PrepareUpdateQuotasProps})
      */
     averageQuota: Array<Asset>;
     /**
-     * minimum quota for desired token
+     * Minimum quota for desired token, in pool underlying units.
+     * The credit facade rounds quota changes down to a multiple of
+     * `PERCENTAGE_FACTOR`; the min quota bound must not exceed the rounded
+     * value, otherwise the quota keeper reverts with
+     * `QuotaIsOutOfBoundsException`.
      */
     minQuota: Array<Asset>;
 }

package/dist/types/sdk/accounts/withdrawal-compressor/intent-codec.d.ts

@@ -4,7 +4,7 @@ import type { DelayedIntent } from "./types.js";
  * Current version of the delayed intent encoding schema.
  * Bump when the layout of any intent type changes.
  **/
-export declare const DELAYED_INTENT_VERSION = 2;
+export declare const DELAYED_INTENT_VERSION = 1;
 /**
  * Stable uint8 discriminants for intent types.
  * Starts at 1 so that all-zero data cannot decode as a valid intent.

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

@@ -2,16 +2,11 @@ import type { Address, Hex } from "viem";
 import type { IBaseContract } from "../../base/index.js";
 import type { MultiCall } from "../../types/index.js";
 /**
- * App: 1.1 Deposit and 4.1 Adjust leverage — raise leverage at fixed TVL.
- * Borrow `underlying` -> swap `underlying` into `targetToken` -> [withdraw to wallet].
+ * App: 1.1 Deposit and 4.1 Adjust leverage — raise leverage at fixed collateral.
+ * Borrow `underlying` -> swap `underlying` into `targetToken` (kept on CA).
  **/
 export interface DelayedIncreaseLeverageIntent {
     type: "INCREASE_LEVERAGE";
-    /**
-     * Wallet address that receives tokens withdrawn from the credit account
-     * when the flow is resumed after the claim
-     **/
-    to: Address;
 }
 /**
  * App: 1.2 Deposit — `amount > 0`, leverage = current (grow net value at same L).
@@ -79,8 +74,8 @@ export interface DelayedAddCollateralIntent {
     type: "ADD_COLLATERAL";
 }
 /**
- * App: 4.2 Adjust leverage — lower leverage at fixed TVL.
- * Swap collateral into `underlying` -> [decrease debt with `underlying`].
+ * App: 4.2 Adjust leverage — lower leverage at fixed collateral.
+ * Swap source token into `underlying` -> decrease debt.
  **/
 export interface DelayedDecreaseLeverageIntent {
     type: "DECREASE_LEVERAGE";

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

@@ -136,8 +136,9 @@ export interface CreditAccountDataPayload {
      **/
     underlying: Address;
     /**
-     * Credit account's owner (contract address for RWA accounts, EOA for
-     * normal accounts).
+     * Credit account's owner: for RWA accounts, the per-account vault proxy
+     * created by the RWA factory (use `investor` for the EOA); EOA for
+     * normal accounts.
      **/
     owner: Address;
     /**
@@ -187,6 +188,7 @@ export interface CreditAccountDataPayload {
     success: boolean;
     /**
      * Info on credit account's enabled tokens and tokens with non-zero balance.
+     * Nothing else is present.
      **/
     tokens: readonly TokenInfo[];
 }
@@ -198,8 +200,10 @@ export interface CreditAccountDataPayload {
  **/
 export type CreditAccountData<WithInvestor extends boolean = false> = WithInvestor extends true ? CreditAccountDataPayload & {
     /**
-     * Investor EOA address (the real person behind the account).
-     * - RWA accounts: resolved from RWA factory, always defined.
+     * Investor EOA address (the real person behind the account) —
+     * the tx sender and delayed-intent recipient.
+     * - RWA accounts: resolved from RWA factory, always defined
+     *   (`owner` is the per-account vault proxy, not the EOA).
      * - Normal accounts: `undefined` (owner IS the investor).
      **/
     investor: Address | undefined;

package/dist/types/sdk/chain/chains.d.ts

@@ -4,7 +4,7 @@ import { z } from "zod/v4";
  * Known curator names that manage Gearbox markets.
  *
  **/
-export type Curator = "Chaos Labs" | "K3" | "cp0x" | "Re7" | "Invariant Group" | "Tulipa" | "M11 Credit" | "KPK" | "Hyperithm" | "UltraYield" | "TelosC" | "Gami Labs" | "Securitize";
+export type Curator = "Chaos Labs" | "K3" | "cp0x" | "Re7" | "Invariant Group" | "Tulipa" | "M11 Credit" | "KPK" | "Hyperithm" | "UltraYield" | "TelosC" | "Gami Labs" | "Securitize" | "Testnet Curator";
 /**
  * Extended viem {@link Chain} with Gearbox-specific metadata.
  *

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

@@ -168,8 +168,10 @@ export interface FindBestClosePathProps {
 export interface ClosePathBalances {
     /**
      * List of all credit account balances nominated in their respective tokens.
-     * Current balances or expected balances after some actions (add/withdraw collateral, for example),
-     * if these actions are before router calls
+     * Current balances or expected balances after some actions (e.g. add/withdraw collateral),
+     * if these actions are before router calls — including balances of tokens
+     * not yet on the account (e.g. a claim token about to be received), which
+     * are absent from `creditAccount.tokens` and must be added here explicitly.
      */
     expectedBalances: Array<Asset>;
     /**
@@ -187,10 +189,27 @@ export interface ClosePathBalances {
  * On-chain router contract that finds optimal multi-hop swap paths
  * for credit-account operations: single-token swaps, open-strategy
  * collateral conversion, reward claiming, and full account closure.
+ *
+ * Which finder to use:
+ *
+ * - {@link findOneTokenPath} — full spend of a single token. The on-chain
+ *   `routeOneToOne` reads leftovers from the **live** account balances:
+ *   a full spend emits `leftover=1` diff encodings, while pre-existing dust
+ *   of intermediate tokens is preserved as leftover.
+ * - {@link findOpenStrategyPath} — partial spend: swap a token while keeping
+ *   an exact remainder on the account. `expectedBalances` is the total amount
+ *   available at execution time (may differ from the live balance, e.g. when
+ *   the input token arrives in the same multicall from a delayed-withdrawal
+ *   claim), `leftoverBalances` is the amount to keep; the router swaps the
+ *   difference.
+ * - {@link findBestClosePath} account closure: converts all remaining assets
+ *   (including dust) into underlying.
  **/
 export interface IRouterContract extends IBaseContract {
     /**
      * Find the best path to swap one token into another.
+     * Use for full spends of a single token; to keep an exact remainder
+     * on the account, use {@link findOpenStrategyPath} instead.
      *
      * @param props - {@link FindOneTokenPathProps}
      * @returns The optimal swap result including amount, slippage-adjusted
@@ -200,6 +219,8 @@ export interface IRouterContract extends IBaseContract {
     /**
      * Find the best path for opening a credit account by converting all
      * collateral (except leftovers) into a single target token.
+     * Also the right choice for any partial spend that must keep an exact
+     * remainder on the account (see {@link IRouterContract}).
      *
      * @param props - {@link FindOpenStrategyPathProps}
      * @returns Swap result with projected post-open balances.
@@ -215,7 +236,7 @@ export interface IRouterContract extends IBaseContract {
     findClaimAllRewards: (props: FindClaimAllRewardsProps) => Promise<RouterRewardsResult>;
     /**
      * Find the best path to swap all credit-account assets into the
-     * underlying token. Used for account closure and liquidation.
+     * underlying token. Used for account closure and liquidation
      *
      * @param props - {@link FindBestClosePathProps}
      * @returns Swap result including the total underlying balance

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "14.12.0-next.42",
+  "version": "14.12.0-next.43",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {