@gearbox-protocol/sdk 16.0.0-next.34 → 16.0.0-next.36

package/dist/types/onchain/market/rwa/index.d.ts

@@ -3,9 +3,9 @@ import { MidasLiquidatorContract } from "./midas/MidasLiquidatorContract.js";
 import "./midas/index.js";
 import { PHANTOM_TOKEN_SECURITIZE_REDEMPTION, RWA_FACTORY_SECURITIZE, RWA_LIQUIDATOR_SECURITIZE } from "./securitize/constants.js";
 import { SecuritizeLiquidatorContract } from "./securitize/SecuritizeLiquidatorContract.js";
-import { GetOpenAccountRequirementsProps, IRWAFactory, RWACompressorCall, RWACompressorInvestorData, RWACompressorResponse, RWAFactoryData, RWAFactoryStateHuman, RWAFactoryType, RWAInvestorData, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs, RWAState, RWAStateHuman, RWAUnderlyingData, RWA_FACTORY_TYPES, isRWAFactory } from "./types.js";
+import { GetInvestorOptions, GetOpenAccountRequirementsProps, IRWAFactory, RWACompressorCall, RWACompressorInvestorData, RWACompressorResponse, RWAFactoryData, RWAFactoryStateHuman, RWAFactoryType, RWAInvestorData, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs, RWAState, RWAStateHuman, RWAUnderlyingData, RWA_FACTORY_TYPES, isRWAFactory } from "./types.js";
 import { DStokenData, SECURITIZE_REGISTER_VAULT_TYPES, SecuritizeCreditAccountData, SecuritizeInvestorData, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRWAFactoryStateHuman, SecuritizeRegisterMessage, SecuritizeRegisterVaultMessage, SecuritizeSignature } from "./securitize/types.js";
 import { SecuritizeRWAFactory } from "./securitize/SecuritizeRWAFactory.js";
 import "./securitize/index.js";
 import { RWARegistry } from "./RWARegistry.js";
-export { DStokenData, GetOpenAccountRequirementsProps, IRWAFactory, MidasLiquidatorContract, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, RWACompressorCall, RWACompressorInvestorData, RWACompressorResponse, RWAFactoryData, RWAFactoryStateHuman, RWAFactoryType, RWAInvestorData, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs, RWARegistry, RWAState, RWAStateHuman, RWAUnderlyingData, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, SECURITIZE_REGISTER_VAULT_TYPES, SecuritizeCreditAccountData, SecuritizeInvestorData, SecuritizeLiquidatorContract, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRWAFactory, SecuritizeRWAFactoryStateHuman, SecuritizeRegisterMessage, SecuritizeRegisterVaultMessage, SecuritizeSignature, isRWAFactory };
+export { DStokenData, GetInvestorOptions, GetOpenAccountRequirementsProps, IRWAFactory, MidasLiquidatorContract, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, RWACompressorCall, RWACompressorInvestorData, RWACompressorResponse, RWAFactoryData, RWAFactoryStateHuman, RWAFactoryType, RWAInvestorData, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs, RWARegistry, RWAState, RWAStateHuman, RWAUnderlyingData, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, SECURITIZE_REGISTER_VAULT_TYPES, SecuritizeCreditAccountData, SecuritizeInvestorData, SecuritizeLiquidatorContract, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRWAFactory, SecuritizeRWAFactoryStateHuman, SecuritizeRegisterMessage, SecuritizeRegisterVaultMessage, SecuritizeSignature, isRWAFactory };

package/dist/types/onchain/market/rwa/securitize/SecuritizeRWAFactory.d.ts

@@ -1,5 +1,5 @@
 import { RWA_FACTORY_SECURITIZE } from "./constants.js";
-import { GetOpenAccountRequirementsProps, IRWAFactory, RWACompressorInvestorData, RWAFactoryData } from "../types.js";
+import { GetInvestorOptions, GetOpenAccountRequirementsProps, IRWAFactory, RWACompressorInvestorData, RWAFactoryData } from "../types.js";
 import { SecuritizeDegenNFT } from "./SecuritizeDegenNFT.js";
 import { DStokenData, SecuritizeInvestorData, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRWAFactoryStateHuman } from "./types.js";
 import { MultiCall, RawTx } from "../../../types/transactions.js";
@@ -477,7 +477,7 @@ declare class SecuritizeRWAFactory extends BaseContract<abi> implements IRWAFact
   /**
    * {@inheritDoc IRWAFactory.getInvestor}
    */
-  getInvestor(creditAccount: Address, fromCache?: boolean): Promise<Address>;
+  getInvestor(creditAccount: Address, options?: GetInvestorOptions): Promise<Address>;
   /**
    * {@inheritDoc IRWAFactory.getApprovalAddress}
    */

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

@@ -100,6 +100,20 @@ interface GetOpenAccountRequirementsProps {
    */
   tokenOutAddress: Address;
 }
+/**
+ * Options for {@link IRWAFactory.getInvestor}.
+ */
+interface GetInvestorOptions {
+  /**
+   * If true, use and update an in-memory cache (creditAccount → investor).
+   * On cache miss, loads from contract and stores the result.
+   **/
+  fromCache?: boolean;
+  /**
+   * Block to read at, defaults to latest. Only used on a cache miss.
+   **/
+  blockNumber?: bigint;
+}
 /**
  * Shared interface for all RWA factory contracts.
  *
@@ -131,11 +145,9 @@ interface IRWAFactory<T extends RWAFactoryType = RWAFactoryType> extends IBaseCo
   /**
    * Returns the investor address for a credit account.
    * @param creditAccount - credit account address
-   * @param fromCache - if true, use and update an in-memory cache
-   *   (creditAccount → investor). On cache miss, loads from contract and
-   *   stores the result for future calls.
+   * @param options - cache and block-pinning options
    **/
-  getInvestor(creditAccount: Address, fromCache?: boolean): Promise<Address>;
+  getInvestor(creditAccount: Address, options?: GetInvestorOptions): Promise<Address>;
   /**
    *  Returns address to which approval should be given on collateral token
    *
@@ -207,4 +219,4 @@ interface IRWAFactory<T extends RWAFactoryType = RWAFactoryType> extends IBaseCo
  **/
 declare function isRWAFactory<T extends RWAFactoryType = RWAFactoryType>(contract: IBaseContract, type?: T): contract is IRWAFactory<T>;
 //#endregion
-export { GetOpenAccountRequirementsProps, IRWAFactory, RWACompressorCall, RWACompressorInvestorData, RWACompressorResponse, RWAFactoryData, RWAFactoryStateHuman, RWAFactoryType, RWAInvestorData, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs, RWAState, RWAStateHuman, RWAUnderlyingData, RWA_FACTORY_TYPES, isRWAFactory };
+export { GetInvestorOptions, GetOpenAccountRequirementsProps, IRWAFactory, RWACompressorCall, RWACompressorInvestorData, RWACompressorResponse, RWAFactoryData, RWAFactoryStateHuman, RWAFactoryType, RWAInvestorData, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs, RWAState, RWAStateHuman, RWAUnderlyingData, RWA_FACTORY_TYPES, isRWAFactory };

package/dist/types/onchain/positions/MultichainPositionsService.d.ts

@@ -1,9 +1,10 @@
 import { Position } from "../../model/positions.js";
 import { DataResponse } from "../../model/response.js";
+import { PositionWithdrawals } from "../../model/withdrawals.js";
 import "../../model/index.js";
 import { PluginsMap } from "../plugins/types.js";
 import "../plugins/index.js";
-import { IMultichainPositionsService, ListPositionsProps } from "./types.js";
+import { GetCurrentWithdrawalsProps, IMultichainPositionsService, ListPositionsProps } from "./types.js";
 import { MultichainConstruct } from "../base/MultichainConstruct.js";
 import "../base/index.js";
 //#region src/onchain/positions/MultichainPositionsService.d.ts
@@ -18,6 +19,11 @@ declare class MultichainPositionsService<const Plugins extends PluginsMap = {}>
    * {@link PositionsService.list}.
    **/
   list(props: ListPositionsProps<true>): Promise<DataResponse<Position[]>>;
+  /**
+   * Delayed withdrawals of one credit account, see
+   * {@link PositionsService.getCurrentWithdrawals}.
+   **/
+  getCurrentWithdrawals(props: GetCurrentWithdrawalsProps<true>): Promise<DataResponse<PositionWithdrawals>>;
 }
 //#endregion
 export { MultichainPositionsService };

package/dist/types/onchain/positions/PositionsService.d.ts

@@ -1,8 +1,9 @@
 import { Bps } from "../../model/primitives.js";
 import { BorrowRateBreakdown, Position, StrategyPosition } from "../../model/positions.js";
 import { AccountMetrics, AccountProjection } from "../../model/previews.js";
+import { PositionWithdrawals } from "../../model/withdrawals.js";
 import "../../model/index.js";
-import { AccountSnapshot, ListPositionsProps, ListStrategyPositionsProps } from "./types.js";
+import { AccountSnapshot, GetCurrentWithdrawalsProps, ListPositionsProps, ListStrategyPositionsProps } from "./types.js";
 import { SDKConstruct } from "../base/SDKConstruct.js";
 import "../base/index.js";
 //#region src/onchain/positions/PositionsService.d.ts
@@ -41,6 +42,13 @@ declare class PositionsService extends SDKConstruct {
    * @param props - {@link ListStrategyPositionsProps}
    **/
   listStrategyPositions(props: ListStrategyPositionsProps): Promise<StrategyPosition[]>;
+  /**
+   * Returns delayed withdrawals of a strategy position
+   *
+   * Empty when this chain has no withdrawal compressor, or the account does
+   * not exist.
+   **/
+  getCurrentWithdrawals(props: GetCurrentWithdrawalsProps): Promise<PositionWithdrawals>;
   /**
    * Health factor of an account state, in basis points (`10000` = 1.0).
    **/

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

@@ -1,4 +1,4 @@
-import { AccountSnapshot, IMultichainPositionsService, ListPositionsProps, ListPositionsPropsBase, ListStrategyPositionsProps, accountSnapshotFromCreditAccountData } from "./types.js";
+import { AccountSnapshot, GetCurrentWithdrawalsProps, GetCurrentWithdrawalsPropsBase, IMultichainPositionsService, ListPositionsProps, ListPositionsPropsBase, ListStrategyPositionsProps, accountSnapshotFromCreditAccountData } from "./types.js";
 import { CalcBorrowRateProps, calcBorrowRate } from "./calcBorrowRate.js";
 import { CalcHealthFactorProps, calcHealthFactor } from "./calcHealthFactor.js";
 import { CalcLiquidationPriceForTargetProps, CalcLiquidationPriceProps, calcLiquidationPriceForTarget } from "./calcLiquidationPriceForTarget.js";
@@ -6,4 +6,4 @@ import { calcLiquidationPrice, soleNonUnderlyingCollateral } from "./calcLiquida
 import { calcTimeToLiquidationMs } from "./calcTimeToLiquidationMs.js";
 import { MultichainPositionsService } from "./MultichainPositionsService.js";
 import { PositionsService, ProjectedPoolOptions } from "./PositionsService.js";
-export { AccountSnapshot, CalcBorrowRateProps, CalcHealthFactorProps, CalcLiquidationPriceForTargetProps, CalcLiquidationPriceProps, IMultichainPositionsService, ListPositionsProps, ListPositionsPropsBase, ListStrategyPositionsProps, MultichainPositionsService, PositionsService, ProjectedPoolOptions, accountSnapshotFromCreditAccountData, calcBorrowRate, calcHealthFactor, calcLiquidationPrice, calcLiquidationPriceForTarget, calcTimeToLiquidationMs, soleNonUnderlyingCollateral };
+export { AccountSnapshot, CalcBorrowRateProps, CalcHealthFactorProps, CalcLiquidationPriceForTargetProps, CalcLiquidationPriceProps, GetCurrentWithdrawalsProps, GetCurrentWithdrawalsPropsBase, IMultichainPositionsService, ListPositionsProps, ListPositionsPropsBase, ListStrategyPositionsProps, MultichainPositionsService, PositionsService, ProjectedPoolOptions, accountSnapshotFromCreditAccountData, calcBorrowRate, calcHealthFactor, calcLiquidationPrice, calcLiquidationPriceForTarget, calcTimeToLiquidationMs, soleNonUnderlyingCollateral };

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

@@ -1,7 +1,9 @@
+import { ChainId } from "../../model/primitives.js";
 import { Position, PositionFilter } from "../../model/positions.js";
 import { DataResponse } from "../../model/response.js";
+import { PositionWithdrawals } from "../../model/withdrawals.js";
 import "../../model/index.js";
-import { WithBlock } from "../types/multichain.js";
+import { WithBlock, WithMultichain } from "../types/multichain.js";
 import { Asset, CreditAccountData } from "../base/types.js";
 import "../types/index.js";
 import "../base/index.js";
@@ -33,6 +35,28 @@ interface ListPositionsPropsBase {
  * {@link MultichainPositionsService.list}.
  **/
 type ListPositionsProps<Multichain extends boolean = false> = ListPositionsPropsBase & WithBlock<Multichain>;
+/**
+ * Chain-independent part of {@link GetCurrentWithdrawalsProps}.
+ *
+ * {@link GetCurrentWithdrawalsPropsBase.blockNumber} is kept on the
+ * multichain form because the method already targets a single chain.
+ **/
+interface GetCurrentWithdrawalsPropsBase {
+  /**
+   * Credit account whose delayed withdrawals to read.
+   **/
+  creditAccount: Address;
+  /**
+   * Block to read at. Defaults to the latest block.
+   **/
+  blockNumber?: bigint;
+}
+/**
+ * Props for {@link PositionsService.getCurrentWithdrawals}.
+ **/
+type GetCurrentWithdrawalsProps<Multichain extends boolean = false> = GetCurrentWithdrawalsPropsBase & WithMultichain<Multichain, {
+  chainId: ChainId;
+}>;
 /**
  * Cross-chain reads of the positions namespace: everything a wallet holds.
  **/
@@ -41,6 +65,11 @@ interface IMultichainPositionsService {
    * Positions of a wallet on all queried chains.
    **/
   list(props: ListPositionsProps<true>): Promise<DataResponse<Position[]>>;
+  /**
+   * Delayed withdrawals of one credit account, see
+   * {@link PositionsService.getCurrentWithdrawals}.
+   **/
+  getCurrentWithdrawals(props: GetCurrentWithdrawalsProps<true>): Promise<DataResponse<PositionWithdrawals>>;
 }
 /**
  * Props for {@link PositionsService.listStrategyPositions}.
@@ -96,4 +125,4 @@ interface AccountSnapshot {
  **/
 declare function accountSnapshotFromCreditAccountData(ca: CreditAccountData): AccountSnapshot;
 //#endregion
-export { AccountSnapshot, IMultichainPositionsService, ListPositionsProps, ListPositionsPropsBase, ListStrategyPositionsProps, accountSnapshotFromCreditAccountData };
+export { AccountSnapshot, GetCurrentWithdrawalsProps, GetCurrentWithdrawalsPropsBase, IMultichainPositionsService, ListPositionsProps, ListPositionsPropsBase, ListStrategyPositionsProps, accountSnapshotFromCreditAccountData };

package/dist/types/sdk/positions/PositionsNamespace.d.ts

@@ -1,14 +1,16 @@
 import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
 import { PoolPositionRef, Position, PositionFilter, PositionsTotals, StrategyPositionRef } from "../../model/positions.js";
 import { DataResponse } from "../../model/response.js";
+import { PositionWithdrawals } from "../../model/withdrawals.js";
 import "../../model/index.js";
+import { GetCurrentWithdrawalsProps } from "../../onchain/positions/types.js";
 import { MultichainSDK } from "../../onchain/MultichainSDK.js";
 import "../../onchain/index.js";
 import { GearboxAPI } from "../../offchain/GearboxAPI.js";
 import "../../offchain/index.js";
 import { FilterResult } from "../utils/types.js";
 import "../utils/index.js";
-import { IPositionMergers, IPositionsBase, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch } from "./types.js";
+import { IPositionMergers, IPositionsBase, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly } from "./types.js";
 import { NamespaceOptions } from "../types.js";
 import { AbstractNamespace } from "../AbstractNamespace.js";
 import { Address } from "viem";
@@ -17,7 +19,7 @@ import { Address } from "viem";
  * The `positions` namespace of a {@link GearboxSDK}, see
  * {@link IPositionsByMode} for what each mode offers.
  **/
-declare class PositionsNamespace extends AbstractNamespace<MultichainSDK["positions"], GearboxAPI["positions"]> implements IPositionsBase, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOffchainBranch {
+declare class PositionsNamespace extends AbstractNamespace<MultichainSDK["positions"], GearboxAPI["positions"]> implements IPositionsBase, IPositionsOffchainOnly, IPositionsOnchainOnly, IPositionsOnchainBranch, IPositionsOffchainBranch {
   /**
    * {@inheritDoc IPositionsBase.merge}
    **/
@@ -40,6 +42,10 @@ declare class PositionsNamespace extends AbstractNamespace<MultichainSDK["positi
    **/
   charts<const Metrics extends readonly PoolPositionChartMetric[]>(key: PoolPositionRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
   charts<const Metrics extends readonly StrategyPositionChartMetric[]>(key: StrategyPositionRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
+  /**
+   * {@inheritDoc IPositionsOnchainOnly.getCurrentWithdrawals}
+   **/
+  getCurrentWithdrawals(props: GetCurrentWithdrawalsProps<true>): Promise<DataResponse<PositionWithdrawals>>;
 }
 //#endregion
 export { PositionsNamespace };

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

@@ -1,8 +1,9 @@
 import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
 import { PoolPositionRef, Position, PositionFilter, PositionsTotals, StrategyPositionRef } from "../../model/positions.js";
 import { DataResponse } from "../../model/response.js";
+import { PositionWithdrawals } from "../../model/withdrawals.js";
 import "../../model/index.js";
-import { IMultichainPositionsService } from "../../onchain/positions/types.js";
+import { GetCurrentWithdrawalsProps, IMultichainPositionsService } from "../../onchain/positions/types.js";
 import "../../onchain/index.js";
 import { IOffchainPositions } from "../../offchain/positions/types.js";
 import "../../offchain/index.js";
@@ -58,9 +59,16 @@ interface IPositionsOffchainOnly {
   charts<const Metrics extends readonly StrategyPositionChartMetric[]>(key: StrategyPositionRef, metrics: Metrics, range: ChartRange): Promise<DataResponse<ChartBundle<Metrics>>>;
 }
 /**
- * Reads only the chain can answer. Empty for now.
+ * Reads only the chain can answer.
  **/
-interface IPositionsOnchainOnly {}
+interface IPositionsOnchainOnly {
+  /**
+   * Delayed withdrawals of one credit account: claimable rows carry the
+   * adapter call and recorded intent a claim is built from; pending rows
+   * name when they mature. Absent in `offchain` mode.
+   **/
+  getCurrentWithdrawals(props: GetCurrentWithdrawalsProps<true>): Promise<DataResponse<PositionWithdrawals>>;
+}
 /**
  * The chain on its own, for a consumer that shows each source as it arrives.
  * Absent in `offchain` mode.

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

@@ -2,8 +2,8 @@ import { Bps } from "../../model/primitives.js";
 import { PoolOpportunityKey, StrategyOpportunityKey } from "../../model/opportunities.js";
 import { PositionCollateral, StrategyPosition, StrategyPositionKey } from "../../model/positions.js";
 import { DataResponse } from "../../model/response.js";
+import { PositionClaimableWithdrawal } from "../../model/withdrawals.js";
 import "../../model/index.js";
-import { ClaimableWithdrawal } from "../../onchain/accounts/withdrawal-compressor/types.js";
 import { Asset } from "../../onchain/base/types.js";
 import { MultiCall } from "../../onchain/types/transactions.js";
 import { PoolSimulation } from "../../onchain/pools/types.js";
@@ -326,13 +326,14 @@ interface LpRedeemParams {
 interface FinalizeParams extends PrepareOptions {
   /**
    * The matured withdrawal to claim, from
-   * `sdk.onchain.chain(chainId).withdrawalCompressor.getCurrentWithdrawals()`.
+   * `sdk.positions.getCurrentWithdrawals()`.
    **/
-  claimable: ClaimableWithdrawal;
+  claimable: PositionClaimableWithdrawal;
   /**
    * The operation to resume. Defaults to the one the request recorded in the
-   * withdrawal's `extraData`, which is what {@link ClaimableWithdrawal.intent}
-   * decodes; pass it explicitly when the compressor is too old to report it.
+   * withdrawal's `extraData`, which is what
+   * {@link PositionClaimableWithdrawal.intent} decodes; pass it explicitly
+   * when the compressor is too old to report it.
    **/
   intent?: ResumableIntent;
 }

package/package.json

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