@gearbox-protocol/sdk 14.12.0-next.26 → 14.12.0-next.28

package/dist/types/plugins/adapters/contracts/SecuritizeOnRampAdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import { type AssetsMap, type ConstructOptions } from "../../../sdk/index.js";
+import { type AssetsMap, type OnchainSDK } from "../../../sdk/index.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -434,7 +434,7 @@ declare const protocolAbi: readonly [{
 type protocolAbi = typeof protocolAbi;
 export declare class SecuritizeOnRampAdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     #private;
-    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    constructor(sdk: OnchainSDK, args: ConcreteAdapterContractOptions);
     get dsToken(): Address;
     get liquidityToken(): Address;
     stateHuman(raw?: boolean): {
@@ -446,6 +446,6 @@ export declare class SecuritizeOnRampAdapterContract extends AbstractAdapterCont
         dsToken: string | undefined;
         liquidityToken: string | undefined;
     };
-    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): void;
+    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): Promise<void>;
 }
 export {};

package/dist/types/plugins/adapters/contracts/SecuritizeRedemptionGatewayAdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import { type AssetsMap, type ConstructOptions } from "../../../sdk/index.js";
+import { type AssetsMap, type OnchainSDK } from "../../../sdk/index.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -424,7 +424,7 @@ declare const protocolAbi: readonly [{
 type protocolAbi = typeof protocolAbi;
 export declare class SecuritizeRedemptionGatewayAdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     #private;
-    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    constructor(sdk: OnchainSDK, args: ConcreteAdapterContractOptions);
     get dsToken(): Address;
     get stableCoinToken(): Address;
     get redemptionPhantomToken(): Address;
@@ -438,6 +438,6 @@ export declare class SecuritizeRedemptionGatewayAdapterContract extends Abstract
         stableCoinToken: string | undefined;
         redemptionPhantomToken: string | undefined;
     };
-    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): void;
+    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): Promise<void>;
 }
 export {};

package/dist/types/plugins/adapters/contracts/StakingRewardsAdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import { type AssetsMap, type ConstructOptions } from "../../../sdk/index.js";
+import { type AssetsMap, type OnchainSDK } from "../../../sdk/index.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -264,7 +264,7 @@ declare const protocolAbi: readonly [{
 type protocolAbi = typeof protocolAbi;
 export declare class StakingRewardsAdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     #private;
-    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    constructor(sdk: OnchainSDK, args: ConcreteAdapterContractOptions);
     get stakingToken(): Address;
     get rewardsToken(): Address;
     get stakedPhantomToken(): Address;
@@ -280,6 +280,6 @@ export declare class StakingRewardsAdapterContract extends AbstractAdapterContra
         stakedPhantomToken: string | undefined;
         referral: number | undefined;
     };
-    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): void;
+    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): Promise<void>;
 }
 export {};

package/dist/types/plugins/adapters/contracts/TraderJoeRouterAdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import type { AssetsMap, ConstructOptions } from "../../../sdk/index.js";
+import type { AssetsMap, OnchainSDK } from "../../../sdk/index.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 export declare enum TraderJoePoolVersion {
@@ -468,7 +468,7 @@ declare const protocolAbi: readonly [{
 type protocolAbi = typeof protocolAbi;
 export declare class TraderJoeRouterAdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     #private;
-    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    constructor(sdk: OnchainSDK, args: ConcreteAdapterContractOptions);
     get supportedPools(): TraderJoePool[];
     stateHuman(raw?: boolean): {
         address: string;
@@ -483,6 +483,6 @@ export declare class TraderJoeRouterAdapterContract extends AbstractAdapterContr
             poolVersion: TraderJoePoolVersion;
         }[] | undefined;
     };
-    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): void;
+    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): Promise<void>;
 }
 export {};

package/dist/types/plugins/adapters/contracts/UniswapV2AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import type { AssetsMap, ConstructOptions, ParsedCallV2 } from "../../../sdk/index.js";
+import type { AssetsMap, OnchainSDK, ParsedCallV2 } from "../../../sdk/index.js";
 import type { LegacyAdapterOperation, Transfers } from "../legacyAdapterOperations.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
@@ -946,7 +946,7 @@ declare const protocolAbi: readonly [{
 type protocolAbi = typeof protocolAbi;
 export declare class UniswapV2AdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     #private;
-    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    constructor(sdk: OnchainSDK, args: ConcreteAdapterContractOptions);
     get supportedPairs(): {
         token0: Address;
         token1: Address;
@@ -965,6 +965,6 @@ export declare class UniswapV2AdapterContract extends AbstractAdapterContract<ab
     protected stringifyFunctionParams(params: DecodeFunctionDataReturnType<abi>): string[];
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L81-L91 */
     classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
-    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): void;
+    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): Promise<void>;
 }
 export {};

package/dist/types/plugins/adapters/contracts/UniswapV3AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import type { AssetsMap, ConstructOptions } from "../../../sdk/index.js";
+import type { AssetsMap, OnchainSDK } from "../../../sdk/index.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -538,7 +538,7 @@ declare const protocolAbi: readonly [{
 type protocolAbi = typeof protocolAbi;
 export declare class UniswapV3AdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     #private;
-    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    constructor(sdk: OnchainSDK, args: ConcreteAdapterContractOptions);
     get supportedPools(): {
         token0: Address;
         token1: Address;
@@ -556,7 +556,7 @@ export declare class UniswapV3AdapterContract extends AbstractAdapterContract<ab
             fee: number;
         }[] | undefined;
     };
-    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): void;
+    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): Promise<void>;
     protected stringifyFunctionParams(params: DecodeFunctionDataReturnType<abi>): string[];
     private trackInputPath;
     private trackOutputPath;

package/dist/types/plugins/adapters/contracts/UniswapV4AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import type { AssetsMap, ConstructOptions, ParsedCallV2 } from "../../../sdk/index.js";
+import type { AssetsMap, OnchainSDK, ParsedCallV2 } from "../../../sdk/index.js";
 import type { LegacyAdapterOperation, Transfers } from "../legacyAdapterOperations.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
@@ -397,7 +397,7 @@ declare const protocolAbi: readonly [{
 type protocolAbi = typeof protocolAbi;
 export declare class UniswapV4AdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     #private;
-    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    constructor(sdk: OnchainSDK, args: ConcreteAdapterContractOptions);
     get supportedPoolKeys(): {
         token0: Address;
         token1: Address;
@@ -421,6 +421,6 @@ export declare class UniswapV4AdapterContract extends AbstractAdapterContract<ab
     };
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L81-L91 */
     classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
-    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): void;
+    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): Promise<void>;
 }
 export {};

package/dist/types/plugins/adapters/contracts/UpshiftVaultAdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import { type AssetsMap, type ConstructOptions } from "../../../sdk/index.js";
+import { type AssetsMap, type OnchainSDK } from "../../../sdk/index.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -342,7 +342,7 @@ declare const protocolAbi: readonly [{
 type protocolAbi = typeof protocolAbi;
 export declare class UpshiftVaultAdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     #private;
-    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    constructor(sdk: OnchainSDK, args: ConcreteAdapterContractOptions);
     get vault(): Address;
     get asset(): Address;
     get stakedPhantomToken(): Address;
@@ -356,6 +356,6 @@ export declare class UpshiftVaultAdapterContract extends AbstractAdapterContract
         asset: string | undefined;
         stakedPhantomToken: string | undefined;
     };
-    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): void;
+    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): Promise<void>;
 }
 export {};

package/dist/types/plugins/adapters/contracts/VelodromeV2AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import type { AssetsMap, ConstructOptions } from "../../../sdk/index.js";
+import type { AssetsMap, OnchainSDK } from "../../../sdk/index.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -341,7 +341,7 @@ declare const protocolAbi: readonly [{
 type protocolAbi = typeof protocolAbi;
 export declare class VelodromeV2RouterAdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     #private;
-    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    constructor(sdk: OnchainSDK, args: ConcreteAdapterContractOptions);
     get supportedPools(): {
         token0: Address;
         token1: Address;
@@ -361,6 +361,6 @@ export declare class VelodromeV2RouterAdapterContract extends AbstractAdapterCon
             factory: string;
         }[] | undefined;
     };
-    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): void;
+    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): Promise<void>;
 }
 export {};

package/dist/types/plugins/adapters/contracts/WstETHV1AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import { type AssetsMap, type ConstructOptions, type ParsedCallV2 } from "../../../sdk/index.js";
+import { type AssetsMap, type OnchainSDK, type ParsedCallV2 } from "../../../sdk/index.js";
 import type { LegacyAdapterOperation, Transfers } from "../legacyAdapterOperations.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
@@ -381,7 +381,7 @@ declare const protocolAbi: readonly [{
 type protocolAbi = typeof protocolAbi;
 export declare class WstETHV1AdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     #private;
-    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    constructor(sdk: OnchainSDK, args: ConcreteAdapterContractOptions);
     get stETH(): Address;
     stateHuman(raw?: boolean): {
         address: string;
@@ -393,6 +393,6 @@ export declare class WstETHV1AdapterContract extends AbstractAdapterContract<abi
     };
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L264-L275 */
     classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
-    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): void;
+    protected applyBalanceChanges(balances: AssetsMap, decoded: DecodeFunctionDataReturnType<abi>): Promise<void>;
 }
 export {};

package/dist/types/plugins/adapters/createAdapter.d.ts

@@ -1,5 +1,5 @@
-import type { ConstructOptions, IBaseContract, RelaxedBaseParams } from "../../sdk/index.js";
+import type { IBaseContract, OnchainSDK, RelaxedBaseParams } from "../../sdk/index.js";
 export interface AdapterFactoryArgs {
     baseParams: RelaxedBaseParams;
 }
-export declare function createAdapter(options: ConstructOptions, data: AdapterFactoryArgs, strict?: boolean): IBaseContract;
+export declare function createAdapter(sdk: OnchainSDK, data: AdapterFactoryArgs, strict?: boolean): IBaseContract;

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

@@ -56,4 +56,4 @@ export declare function makeInnerOperationsState(): InnerOperationsState;
  *
  * @returns `undefined` on success, the error on a malformed multicall.
  */
-export declare function applyInnerOperations<P extends PluginsMap>(sdk: SdkWithAdapters<P>, multicall: InnerOperation[], state: InnerOperationsState): OperationPreviewError | undefined;
+export declare function applyInnerOperations<P extends PluginsMap>(sdk: SdkWithAdapters<P>, multicall: InnerOperation[], state: InnerOperationsState): Promise<OperationPreviewError | undefined>;

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

@@ -2,4 +2,4 @@ import { type PluginsMap } from "../../sdk/index.js";
 import type { OpenCreditAccountOperation, RWAOpenCreditAccountOperation } from "../parse/index.js";
 import type { PreviewOperationInput } from "../types.js";
 import { type OpenCreditAccountPreview } from "./types.js";
-export declare function previewOpenCreditAccount<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: OpenCreditAccountOperation | RWAOpenCreditAccountOperation): OpenCreditAccountPreview;
+export declare function previewOpenCreditAccount<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: OpenCreditAccountOperation | RWAOpenCreditAccountOperation): Promise<OpenCreditAccountPreview>;

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

@@ -3,8 +3,8 @@ import type { Asset } from "../../sdk/index.js";
 import type { PoolOperationType } from "../parse/index.js";
 /**
  * Broken `storeExpectedBalances`/`compareBalances` bracket structure:
- * `storeExpectedBalances` without a matching `compareBalances`, more than one
- * bracket, or `compareBalances` without a preceding `storeExpectedBalances`.
+ * `storeExpectedBalances` without a matching `compareBalances`, nested
+ * brackets, or `compareBalances` without a preceding `storeExpectedBalances`.
  * We expect transactions that were generated by our frontend using router/withdrawal compressor
  **/
 export declare const ERROR_MALFORMED_BRACKET = 1001;

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

@@ -370,9 +370,10 @@ export type AssembleStartDelayedWithdrawalCallsProps = {
      */
     creditFacade: Address;
     /**
-     * Withdrawal preview: `outputs` for expected balances, `requestCalls` for the body.
+     * Withdrawal preview: `outputs` for expected balances, `token`/`amountIn`
+     * for the negative source-token delta, `requestCalls` for the body.
      */
-    preview: Pick<RequestableWithdrawal, "outputs" | "requestCalls">;
+    preview: Pick<RequestableWithdrawal, "outputs" | "requestCalls" | "token" | "amountIn">;
 };
 /**
  * Input for {@link ICreditAccountsService.assembleClaimDelayedCalls}.
@@ -383,9 +384,11 @@ export type AssembleClaimDelayedCallsProps = {
      */
     creditFacade: Address;
     /**
-     * Claimable withdrawal: `outputs` for expected balances, `claimCalls` for the body.
+     * Claimable withdrawal: `outputs` for expected balances,
+     * `withdrawalPhantomToken`/`withdrawalTokenSpent` for the negative
+     * phantom-burn delta, `claimCalls` for the body.
      */
-    claimableNow: Pick<ClaimableWithdrawal, "outputs" | "claimCalls">;
+    claimableNow: Pick<ClaimableWithdrawal, "outputs" | "claimCalls" | "withdrawalPhantomToken" | "withdrawalTokenSpent">;
 };
 export interface StartDelayedWithdrawalProps extends PrepareUpdateQuotasProps {
     /**
@@ -905,6 +908,11 @@ export interface ICreditAccountsService extends Construct {
      * Same balance bracket as {@link startDelayedWithdrawal}:
      * `storeExpectedBalances` → `preview.requestCalls` → `compareBalances`.
      *
+     * Besides the positive output deltas, the bracket carries a negative delta
+     * of the spent source token (`preview.token` / `-preview.amountIn`). It
+     * makes the input-side balance decrease previewable from the calldata alone and lets
+     * `compareBalances` assert the balance doesn't drop by more than predicted.
+     *
      * Does not prepend price updates and does not build the facade transaction.
      *
      * @param props - {@link AssembleStartDelayedWithdrawalCallsProps}
@@ -918,6 +926,12 @@ export interface ICreditAccountsService extends Construct {
      * Same balance bracket as {@link claimDelayed}:
      * `storeExpectedBalances` → `claimableNow.claimCalls` → `compareBalances`.
      *
+     * Besides the positive output deltas, the bracket carries a negative delta
+     * of the burned withdrawal phantom token (`claimableNow.withdrawalPhantomToken`
+     * / `-claimableNow.withdrawalTokenSpent`). It makes the phantom burn
+     * previewable from the calldata alone and lets `compareBalances` assert the
+     * balance doesn't drop by more than predicted.
+     *
      * Does not prepend price updates, does not update quotas, and does not build
      * the facade transaction. Use for resume / intent assembly where claim is
      * followed by other ops and quotas/prices are applied separately.

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

@@ -23,6 +23,10 @@ export declare abstract class AbstractWithdrawalCompressorContract<abi extends A
      * {@inheritDoc IWithdrawalCompressorContract.getWithdrawableAssetsBatch}
      **/
     getWithdrawableAssetsBatch(creditManagers?: Address[]): Promise<WithdrawableAsset[]>;
+    /**
+     * {@inheritDoc IWithdrawalCompressorContract.getWithdrawalPhantomToken}
+     **/
+    getWithdrawalPhantomToken(creditManager: Address, token: Address): Promise<Address>;
     /**
      * {@inheritDoc IWithdrawalCompressorContract.getCurrentWithdrawals}
      **/

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

@@ -274,6 +274,12 @@ export interface IWithdrawalCompressorContract extends IBaseContract {
      * Failed per-manager calls are logged and skipped.
      **/
     getWithdrawableAssetsBatch(creditManagers?: Address[]): Promise<WithdrawableAsset[]>;
+    /**
+     * Resolves the withdrawal phantom token for a withdrawable source token
+     * (e.g. a Mellow multivault share) of the given credit manager.
+     * @throws When the token is not withdrawable from the credit manager.
+     **/
+    getWithdrawalPhantomToken(creditManager: Address, token: Address): Promise<Address>;
     /**
      * Returns claimable and pending delayed withdrawals of the given credit account.
      **/

package/package.json

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