@gearbox-protocol/sdk 16.0.0-next.9 → 16.1.0

package/dist/types/onchain/market/oracle/collateralPriceInUnderlying.d.ts

@@ -0,0 +1,19 @@
+import { IPriceOracleContract } from "./types.js";
+import { Address } from "viem";
+//#region src/onchain/market/oracle/collateralPriceInUnderlying.d.ts
+/**
+ * What one unit of `collateral` costs in `underlying` right now, in the
+ * oracle's 8-decimal (`PRICE_DECIMALS`) fixed point — the scale and the
+ * denomination `calcLiquidationPrice` answers in, so the two figures are read
+ * as a pair.
+ *
+ * Both sides come from the oracle's **main** feeds: this is the price the
+ * market quotes, not the conservative one a hand-over is weighed at.
+ *
+ * `null` when the oracle cannot answer for either token, or prices the
+ * underlying at zero — a screen shows a gap rather than a number derived from
+ * a missing feed.
+ **/
+declare function collateralPriceInUnderlying(oracle: IPriceOracleContract, collateral: Address, underlying: Address): bigint | null;
+//#endregion
+export { collateralPriceInUnderlying };

package/dist/types/onchain/market/oracle/errors.d.ts

@@ -0,0 +1,19 @@
+import { IGearboxError } from "../../../model/errors.js";
+import { Address } from "viem";
+//#region src/onchain/market/oracle/errors.d.ts
+/**
+ * The oracle has no price for `token`. Preview callers attach this with
+ * `warning ??=` so a malformed-transaction warning already recorded keeps
+ * precedence.
+ **/
+interface UnpriceableTokenError extends IGearboxError {
+  code: "unpriceableToken";
+  /** Token the oracle could not price. */
+  token: Address;
+}
+/**
+ * Builds an {@link UnpriceableTokenError} for `token`.
+ **/
+declare function unpriceableTokenError(token: Address): UnpriceableTokenError;
+//#endregion
+export { UnpriceableTokenError, unpriceableTokenError };

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

@@ -1,4 +1,6 @@
-import { IPriceOracleContract, PriceFeedsForAccountOptions, PriceFeedsForTokensOptions } from "./types.js";
+import { UnpriceableTokenError, unpriceableTokenError } from "./errors.js";
+import { ConvertFn, IPriceOracleContract, PriceFeedsForAccountOptions, PriceFeedsForTokensOptions } from "./types.js";
+import { collateralPriceInUnderlying } from "./collateralPriceInUnderlying.js";
 import { createPriceOracle } from "./createPriceOracle.js";
 import { PriceOracleV310Contract } from "./PriceOracleV310Contract.js";
-export { IPriceOracleContract, PriceFeedsForAccountOptions, PriceFeedsForTokensOptions, PriceOracleV310Contract, createPriceOracle };
+export { ConvertFn, IPriceOracleContract, PriceFeedsForAccountOptions, PriceFeedsForTokensOptions, PriceOracleV310Contract, UnpriceableTokenError, collateralPriceInUnderlying, createPriceOracle, unpriceableTokenError };

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

@@ -1,10 +1,12 @@
 import { Amount, TokenAmount } from "../../../model/primitives.js";
+import { UnpriceableTokenError } from "./errors.js";
 import { PriceFeedData, PriceFeedSummary } from "../../../model/opportunities.js";
+import { SafeValue } from "../../../model/result.js";
 import "../../../model/index.js";
 import { AddressMap } from "../../utils/AddressMap.js";
 import { DelegatedMulticall } from "../../utils/viem/executeDelegatedMulticalls.js";
 import "../../utils/viem/index.js";
-import { CreditAccountTokensSlice, IBaseContract } from "../../base/types.js";
+import { Asset, CreditAccountTokensSlice, IBaseContract } from "../../base/types.js";
 import { PriceOracleStateHuman } from "../../types/state-human.js";
 import { IPriceFeedContract, PriceUpdate, UpdatePriceFeedsResult } from "../pricefeeds/types.js";
 import { PriceFeedRef } from "../pricefeeds/PriceFeedRef.js";
@@ -42,6 +44,10 @@ interface PriceFeedsForAccountOptions extends PriceFeedsForTokensOptions {
    **/
   extraTokens?: Address[];
 }
+/**
+ * Token-to-token conversion at latest known prices, result in `to`-token decimals.
+ */
+type ConvertFn = (from: Address, to: Address, amount: bigint) => bigint;
 /**
  * Public interface for a Gearbox price oracle contract.
  *
@@ -132,14 +138,11 @@ interface IPriceOracleContract extends IBaseContract {
    **/
   convert: (from: Address, to: Address, amount: bigint, reserve?: boolean) => bigint;
   /**
-   * Like {@link convert}, but returns `null` instead of throwing when either
-   * token cannot be priced (missing or unsuccessful feed).
-   *
-   * @param from - Source token address.
-   * @param to - Destination token address.
-   * @param amount - Amount in source-token decimals.
+   * Like {@link convert}, but never throws: main feed, then reserve, else
+   * `{ value: 0n, error }`. Fallback only on a missing or failed feed, not
+   * on a successful 0 price.
    **/
-  safeConvert: (from: Address, to: Address, amount: bigint) => bigint | null;
+  safeConvert: (from: Address, to: Address, amount: bigint) => SafeValue<bigint, UnpriceableTokenError>;
   /**
    * Converts a token amount to its USD value using latest known prices.
    *
@@ -152,13 +155,28 @@ interface IPriceOracleContract extends IBaseContract {
    **/
   convertToUSD: (from: Address, amount: bigint, reserve?: boolean) => bigint;
   /**
-   * Like {@link convertToUSD}, but returns `null` instead of throwing when
-   * the token cannot be priced (missing or unsuccessful feed).
+   * Like {@link convertToUSD}, but never throws: main feed, then reserve,
+   * else `{ value: 0n, error }`. Fallback only on a missing or failed feed,
+   * not on a successful 0 price — not a min of feeds.
+   **/
+  safeConvertToUSD: (token: Address, amount: bigint) => SafeValue<bigint, UnpriceableTokenError>;
+  /**
+   * USD value at the protocol "safe price": `min(main, reserve)`, matching
+   * on-chain `_getSafePrice` / `safeConvertToUSD`. For predicting a collateral
+   * check that runs with `USE_SAFE_PRICES_FLAG` (after `withdrawCollateral`,
+   * or an adapter that asked for safe prices).
    *
-   * @param token - Token address.
-   * @param amount - Amount in token decimals.
+   * On-chain quirks, copied:
+   * - no main feed → `{ value: 0n, error }` (the check would revert);
+   * - main answers, no reserve feed → `{ value: 0n }` with no error (untrusted
+   *   token, the check values it at 0);
+   * - reserve feed present but its answer failed → `{ value: 0n, error }`
+   *   (the check would revert).
+   *
+   * The underlying is exempt on-chain (`CreditManagerV3._safeConvertToUSD`);
+   * callers that weigh a whole account must still price it at the main feed.
    **/
-  safeConvertToUSD: (token: Address, amount: bigint) => bigint | null;
+  safeConvertMinUSD: (token: Address, amount: bigint) => SafeValue<bigint, UnpriceableTokenError>;
   /**
    * Converts a USD amount to a token amount using latest known prices.
    *
@@ -171,19 +189,19 @@ interface IPriceOracleContract extends IBaseContract {
    **/
   convertFromUSD: (to: Address, amount: bigint, reserve?: boolean) => bigint;
   /**
-   * USD value of a token amount as the read model expresses it: plain dollars
-   * rather than {@link convertToUSD}'s 8-decimal fixed point, and `null`
-   * instead of a throw when the token cannot be priced.
-   *
-   * A dead or not-yet-updated feed must degrade one field, not fail a whole
-   * list, which is why {@link Amount.valueUsd} is nullable.
-   *
-   * @param token - Token address.
-   * @param amount - Amount in token decimals.
+   * Like {@link convertFromUSD}, but never throws: main feed, then reserve,
+   * else `{ value: 0n, error }`. Availability only — not a min of feeds.
+   **/
+  safeConvertFromUSD: (token: Address, amount: bigint) => SafeValue<bigint, UnpriceableTokenError>;
+  /**
+   * Sum of {@link safeConvert} over `assets` into `to`. Balances at or below
+   * `DUST_THRESHOLD` are skipped. First unpriceable token wins `error`.
    **/
-  safeUsdValue: (token: Address, amount: bigint) => number | null;
+  safeConvertAssets: (assets: Asset[], to: Address) => SafeValue<bigint, UnpriceableTokenError>;
   /**
-   * Pairs a token amount with its USD value, using {@link safeUsdValue}.
+   * Pairs a token amount with its USD value via {@link safeConvertToUSD}:
+   * main feed, then reserve. `valueUsd` is `null` when neither feed can
+   * price the token — unknown is not `$0`.
    * Syntactic sugar for high-level sdk.
    * @param token - Token address.
    * @param value - Amount in token decimals.
@@ -195,7 +213,7 @@ interface IPriceOracleContract extends IBaseContract {
    * Syntactic sugar for high-level sdk.
    *
    * `NATIVE_ADDRESS` is not in the token registry: it is synthesized from the
-   * chain's native currency. Pricing is delegated to {@link convertToUSD}.
+   * chain's native currency. Pricing is delegated to {@link toAmount}.
    *
    * @param token - Token address.
    * @param value - Amount in token decimals.
@@ -237,4 +255,4 @@ interface IPriceOracleContract extends IBaseContract {
   stateHuman: (raw?: boolean) => PriceOracleStateHuman;
 }
 //#endregion
-export { IPriceOracleContract, PriceFeedsForAccountOptions, PriceFeedsForTokensOptions };
+export { ConvertFn, IPriceOracleContract, PriceFeedsForAccountOptions, PriceFeedsForTokensOptions };

package/dist/types/onchain/market/pool/PoolV310Contract.d.ts

@@ -1149,6 +1149,18 @@ declare class PoolV310Contract extends BaseContract<abi> implements IPoolContrac
    * {@inheritDoc IPoolContract.totalAssets}
    */
   get totalAssets(): bigint;
+  /**
+   * {@inheritDoc IPoolContract.getShareBalance}
+   */
+  getShareBalance(wallet: Address, blockNumber?: bigint): Promise<bigint>;
+  /**
+   * {@inheritDoc IPoolContract.sharesToUnderlying}
+   */
+  sharesToUnderlying(shares: bigint): bigint;
+  /**
+   * {@inheritDoc IPoolContract.underlyingToShares}
+   */
+  underlyingToShares(underlying: bigint, roundUp?: boolean): bigint;
   /**
    * {@inheritDoc IPoolContract.unwrappedUnderlying}
    */

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

@@ -130,6 +130,24 @@ interface IPoolContract extends IBaseContract {
    * rate. Unlike {@link totalSupply}, this is denominated in the underlying.
    */
   readonly totalAssets: bigint;
+  /**
+   * Diesel shares `wallet` holds. The pool contract is its own ERC-20.
+   **/
+  getShareBalance(wallet: Address, blockNumber?: bigint): Promise<bigint>;
+  /**
+   * Underlying `shares` of diesel are worth at the current share rate, with
+   * no withdrawal fee. An empty pool (diesel rate still zero) converts
+   * one-for-one. This is what the shares are worth, not what leaving with
+   * them would pay.
+   */
+  sharesToUnderlying(shares: bigint): bigint;
+  /**
+   * Shares minted (or burned) for this much underlying at the current share
+   * rate, with no withdrawal fee. Rounds down as `previewDeposit`; pass
+   * `true` to round up as `previewWithdraw`'s conversion (fee inflation is
+   * the caller's). An empty pool converts one-for-one.
+   */
+  underlyingToShares(underlying: bigint, roundUp?: boolean): bigint;
   /**
    * The token the pool's underlying wraps, or the underlying itself when it
    * wraps nothing. An RWA market borrows a compliance wrapper that converts

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/market/zapper/ZapperContract.d.ts

@@ -1,4 +1,7 @@
+import { SDKReturn } from "../../../model/result.js";
+import "../../../model/index.js";
 import { ZapperData } from "../types.js";
+import { UnsupportedZapperFunctionError } from "./errors.js";
 import { IZapperContract, ParsedZapperOperation } from "./types.js";
 import { RawTx } from "../../types/transactions.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
@@ -22,10 +25,11 @@ declare class ZapperContract<A extends Abi = Abi> extends BaseContract<A> implem
   readonly tokenOut: ZapperData["tokenOut"];
   constructor(sdk: OnchainSDK, data: ZapperData, abi?: A, namePrefix?: string);
   /**
-   * Decodes zapper calldata into {@link ParsedZapperOperation}.
-   * Throws {@link UnsupportedZapperFunctionError} for unknown selectors.
+   * Decodes zapper calldata into {@link ParsedZapperOperation} behind `ok`,
+   * or refuses with {@link UnsupportedZapperFunctionError} for unknown
+   * selectors.
    */
-  parseOperation(calldata: Hex, value?: bigint): ParsedZapperOperation;
+  parseOperation(calldata: Hex, value?: bigint): SDKReturn<ParsedZapperOperation, UnsupportedZapperFunctionError>;
   /**
    * Redeems pool shares (diesel tokens) for the underlying asset via this zapper.
    */

package/dist/types/onchain/market/zapper/errors.d.ts

@@ -1,13 +1,18 @@
+import { IGearboxError } from "../../../model/errors.js";
+import "../../../model/index.js";
 import { Address } from "viem";
 //#region src/onchain/market/zapper/errors.d.ts
 /**
- * Thrown when a zapper call uses a function other than a known
- * `deposit`/`redeem` variant.
+ * Refusal answered when a zapper call uses a function other than a known
+ * `deposit`/`redeem` variant. A plain returned object per the SDK's refusal
+ * vocabulary — not a thrown `Error`.
  */
-declare class UnsupportedZapperFunctionError extends Error {
-  readonly zapper: Address;
-  readonly functionName: string;
-  constructor(zapper: Address, functionName: string);
+interface UnsupportedZapperFunctionError extends IGearboxError {
+  code: "unsupportedZapperFunction";
+  /** Zapper contract the call targets. */
+  zapper: Address;
+  /** Decoded function name the SDK cannot preview. */
+  functionName: string;
 }
 //#endregion
 export { UnsupportedZapperFunctionError };

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

@@ -1,6 +1,6 @@
+import { UnsupportedZapperFunctionError } from "./errors.js";
 import { IZapperContract, ParsedZapperDeposit, ParsedZapperOperation, ParsedZapperRedeem } from "./types.js";
 import { createZapper } from "./createZapper.js";
-import { UnsupportedZapperFunctionError } from "./errors.js";
 import { ZapperContract } from "./ZapperContract.js";
 import { IERC20ZapperContract } from "./IERC20ZapperContract.js";
 import { IETHZapperContract } from "./IETHZapperContract.js";

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

@@ -1,5 +1,8 @@
+import { SDKReturn } from "../../../model/result.js";
+import "../../../model/index.js";
 import { IBaseContract } from "../../base/types.js";
 import { ZapperData } from "../types.js";
+import { UnsupportedZapperFunctionError } from "./errors.js";
 import { RawTx } from "../../types/transactions.js";
 import "../../types/index.js";
 import "../../base/index.js";
@@ -54,7 +57,7 @@ interface IZapperContract extends IBaseContract, ZapperData {
    * @param calldata - Raw ABI-encoded calldata sent to the zapper.
    * @param value - Transaction `msg.value`, used for native-token deposits.
    */
-  parseOperation(calldata: Hex, value?: bigint): ParsedZapperOperation;
+  parseOperation(calldata: Hex, value?: bigint): SDKReturn<ParsedZapperOperation, UnsupportedZapperFunctionError>;
   /**
    * Redeems pool shares (diesel tokens) for the underlying asset via this zapper.
    */

package/dist/types/onchain/opportunities/MultichainOpportunitiesService.d.ts

@@ -3,6 +3,7 @@ import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { PluginsMap } from "../plugins/types.js";
 import "../plugins/index.js";
+import { IMultichainOpportunitiesService } from "./types.js";
 import { MultichainConstruct } from "../base/MultichainConstruct.js";
 import "../base/index.js";
 //#region src/onchain/opportunities/MultichainOpportunitiesService.d.ts
@@ -12,7 +13,7 @@ import "../base/index.js";
  *
  * @typeParam Plugins - Map of attached plugin types.
  **/
-declare class MultichainOpportunitiesService<const Plugins extends PluginsMap = {}> extends MultichainConstruct<Plugins> {
+declare class MultichainOpportunitiesService<const Plugins extends PluginsMap = {}> extends MultichainConstruct<Plugins> implements IMultichainOpportunitiesService {
   /**
    * Opportunities of all queried chains, see {@link OpportunitiesService.list}.
    * A filter that names chains narrows the fan-out itself, so a chain whose

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

@@ -1,3 +1,4 @@
+import { IMultichainOpportunitiesService } from "./types.js";
 import { MultichainOpportunitiesService } from "./MultichainOpportunitiesService.js";
 import { OpportunitiesService } from "./OpportunitiesService.js";
-export { MultichainOpportunitiesService, OpportunitiesService };
+export { IMultichainOpportunitiesService, MultichainOpportunitiesService, OpportunitiesService };

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

@@ -0,0 +1,27 @@
+import { Opportunity, OpportunityFilter, PoolOpportunityDetail, PoolOpportunityKey, StrategyOpportunityDetail, StrategyOpportunityKey } from "../../model/opportunities.js";
+import { DataResponse } from "../../model/response.js";
+import "../../model/index.js";
+//#region src/onchain/opportunities/types.d.ts
+/**
+ * Cross-chain reads of the opportunities namespace: every pool and strategy
+ * the loaded markets expose.
+ **/
+interface IMultichainOpportunitiesService {
+  /**
+   * Opportunities of all queried chains. A filter that names chains narrows
+   * the fan-out itself, so a chain whose rows would be discarded is never
+   * queried and never appears in the meta.
+   **/
+  list(filter?: OpportunityFilter): Promise<DataResponse<Opportunity[]>>;
+  /**
+   * Detailed view of one pool opportunity. The key names its chain, so there
+   * is no fan-out. Throws when that chain cannot answer.
+   **/
+  getPool(key: PoolOpportunityKey): Promise<DataResponse<PoolOpportunityDetail>>;
+  /**
+   * Detailed view of one strategy opportunity. See {@link getPool}.
+   **/
+  getStrategy(key: StrategyOpportunityKey): Promise<DataResponse<StrategyOpportunityDetail>>;
+}
+//#endregion
+export { IMultichainOpportunitiesService };

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

@@ -1,7 +1,5 @@
 import { PoolPosition } from "../../model/positions.js";
 import "../../model/index.js";
-import { IPoolContract } from "../market/pool/types.js";
-import "../market/index.js";
 import { AddLiquidityProps, DepositMetadata, IPoolsService, ListPoolPositionsProps, PoolServiceCallResult, PoolSimulation, RemoveLiquidityProps, SimulatePoolOperationProps, WithdrawalMetadata } from "./types.js";
 import { SDKConstruct } from "../base/SDKConstruct.js";
 import "../base/index.js";
@@ -58,21 +56,5 @@ declare class PoolService extends SDKConstruct implements IPoolsService {
    */
   listPositions(props: ListPoolPositionsProps): Promise<PoolPosition[]>;
 }
-/**
- * Shares minted for `assets`, as `previewDeposit` would report them.
- *
- * Both directions convert through the diesel rate — underlying per RAY of
- * shares — because that is the rate the pool itself divides by, and the only
- * exact one the SDK holds: `totalAssets` is this rate multiplied out, so
- * converting back through it costs a wei on large amounts. Rounds down, as
- * minting does.
- */
-declare function toShares(pool: IPoolContract, assets: bigint): bigint;
-/**
- * Shares a withdrawal of `assets` burns, as `previewWithdraw` would report
- * them: {@link toShares} rounded the other way, since the burn has to cover
- * the payout the caller asked for.
- */
-declare function toSharesUp(pool: IPoolContract, assets: bigint): bigint;
 //#endregion
-export { PoolService, toShares, toSharesUp };
+export { PoolService };

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

@@ -1,3 +1,3 @@
 import { AddLiquidityProps, DepositMetadata, IPoolsService, ListPoolPositionsProps, MarketType, PoolServiceCall, PoolServiceCallResult, PoolSimulation, RemoveLiquidityProps, SimulatePoolOperationProps, WithdrawalMetadata } from "./types.js";
-import { PoolService, toShares, toSharesUp } from "./PoolService.js";
-export { AddLiquidityProps, DepositMetadata, IPoolsService, ListPoolPositionsProps, MarketType, PoolService, PoolServiceCall, PoolServiceCallResult, PoolSimulation, RemoveLiquidityProps, SimulatePoolOperationProps, WithdrawalMetadata, toShares, toSharesUp };
+import { PoolService } from "./PoolService.js";
+export { AddLiquidityProps, DepositMetadata, IPoolsService, ListPoolPositionsProps, MarketType, PoolService, PoolServiceCall, PoolServiceCallResult, PoolSimulation, RemoveLiquidityProps, SimulatePoolOperationProps, WithdrawalMetadata };

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/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 { 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
@@ -12,12 +13,17 @@ import "../base/index.js";
  *
  * @typeParam Plugins - Map of attached plugin types.
  **/
-declare class MultichainPositionsService<const Plugins extends PluginsMap = {}> extends MultichainConstruct<Plugins> {
+declare class MultichainPositionsService<const Plugins extends PluginsMap = {}> extends MultichainConstruct<Plugins> implements IMultichainPositionsService {
   /**
    * Positions of a wallet on all queried chains, see
    * {@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,7 +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
@@ -40,6 +42,10 @@ declare class PositionsService extends SDKConstruct {
    * @param props - {@link ListStrategyPositionsProps}
    **/
   listStrategyPositions(props: ListStrategyPositionsProps): Promise<StrategyPosition[]>;
+  /**
+   * Returns delayed withdrawals of a strategy position
+   **/
+  getCurrentWithdrawals(props: GetCurrentWithdrawalsProps): Promise<PositionWithdrawals>;
   /**
    * Health factor of an account state, in basis points (`10000` = 1.0).
    **/
@@ -67,6 +73,43 @@ declare class PositionsService extends SDKConstruct {
    * non-underlying assets.
    **/
   liquidationPrice(snapshot: AccountSnapshot): bigint | null;
+  /**
+   * What the collateral {@link liquidationPrice} is quoted for costs in the
+   * market underlying right now, in the same `PRICE_DECIMALS` fixed point —
+   * the pair a form shows beside the liquidation price. `null` under exactly
+   * the conditions that leave the liquidation price `null`, plus an oracle
+   * that cannot answer for either side.
+   **/
+  currentPrice(snapshot: AccountSnapshot): bigint | null;
+  /**
+   * Every derived number of an account state at once — the whole
+   * {@link AccountMetrics} half of a projection.
+   *
+   * This is what both halves of the SDK fill their answers from: `prepare`, for
+   * a state it walked an intent into, and `preview`, for one it replayed out of
+   * calldata. One snapshot in, one set of metrics out, so the two descriptions
+   * of the same operation cannot disagree because one of them grew its own
+   * formula.
+   *
+   * Identical to the four methods above field for field, and cheaper than
+   * calling them one by one: the market data is collected once, and the health
+   * factor and borrow rate the time to liquidation decays at are the very ones
+   * reported beside it.
+   **/
+  metrics(snapshot: AccountSnapshot, options?: ProjectedPoolOptions): AccountMetrics;
+  /**
+   * A projected account state as both halves of the SDK report it: the holdings
+   * priced and named, and the metrics of {@link PositionsService.metrics}.
+   *
+   * The snapshot is taken at its word — what it lists is what comes back, so a
+   * caller that drops dust before the walk reports an account without it, and
+   * one that keeps wei reports them. That is the whole of the policy left to
+   * the caller; everything downstream of the balances is decided here.
+   *
+   * @param options - The operation's effect on the pool, for the rate the
+   * metrics are quoted at, see {@link ProjectedPoolOptions}.
+   **/
+  projection(snapshot: AccountSnapshot, options?: ProjectedPoolOptions): AccountProjection;
 }
 //#endregion
 export { PositionsService, ProjectedPoolOptions };

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

@@ -23,12 +23,16 @@ interface CalcHealthFactorProps {
   prices: Record<Address, bigint>;
   /**
    * Oracle reserve-feed prices, when available. Used with {@link safePrices}
-   * to value collateral at the lower of the two feeds.
+   * to value collateral at the protocol safe price. A token present in
+   * {@link prices} but missing here is untrusted and contributes 0, matching
+   * on-chain `_getSafePrice`.
    **/
   reservePrices?: Record<Address, bigint>;
   /**
-   * Value collateral at safe prices — the lower of each token's main and
-   * reserve feeds. Debt and quota balances always use the main feed.
+   * Value collateral at safe prices — `min(main, reserve)`, or 0 when the
+   * token has no reserve feed. The underlying is exempt and always uses the
+   * main feed, matching `CreditManagerV3._safeConvertToUSD`. Debt and quota
+   * balances always use the main feed.
    **/
   safePrices?: boolean;
   /**