@gearbox-protocol/sdk 18.2.0-next.1 → 18.2.0-next.3

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

@@ -15,7 +15,7 @@ export interface IAdapterContract extends IBaseContract {
   openingCalls(): Promise<MultiCall[]>;
 }
 export type VersionedAbi = Record<number, readonly AbiParameter[]>;
-export type AdapterContractType = "ADAPTER::ACCOUNT_MIGRATOR" | "ADAPTER::BALANCER_V3_ROUTER" | "ADAPTER::BALANCER_V3_WRAPPER" | "ADAPTER::CAMELOT_V3_ROUTER" | "ADAPTER::CURVE_STABLE_NG" | "ADAPTER::CURVE_V1_2ASSETS" | "ADAPTER::CURVE_V1_3ASSETS" | "ADAPTER::CURVE_V1_4ASSETS" | "ADAPTER::CURVE_V1_STECRV_POOL" | "ADAPTER::CVX_V1_BASE_REWARD_POOL" | "ADAPTER::CVX_V1_BOOSTER" | "ADAPTER::DAI_USDS_EXCHANGE" | "ADAPTER::ERC4626_VAULT" | "ADAPTER::ERC4626_VAULT_REFERRAL" | "ADAPTER::FLUID_DEX" | "ADAPTER::INFINIFI_GATEWAY" | "ADAPTER::INFINIFI_UNWINDING" | "ADAPTER::KELP_DEPOSIT_POOL" | "ADAPTER::KELP_WITHDRAWAL" | "ADAPTER::LIDO_V1" | "ADAPTER::LIDO_WSTETH_V1" | "ADAPTER::MELLOW_CLAIMER" | "ADAPTER::MELLOW_DVV" | "ADAPTER::MELLOW_ERC4626_VAULT" | "ADAPTER::MELLOW_WRAPPER" | "ADAPTER::MIDAS_GATEWAY" | "ADAPTER::MIDAS_ISSUANCE_VAULT" | "ADAPTER::MIDAS_REDEMPTION_VAULT" | "ADAPTER::PENDLE_ROUTER" | "ADAPTER::SECURITIZE_ONRAMP" | "ADAPTER::SECURITIZE_REDEMPTION" | "ADAPTER::STAKING_REWARDS" | "ADAPTER::TRADERJOE_ROUTER" | "ADAPTER::UNISWAP_V2_ROUTER" | "ADAPTER::UNISWAP_V3_ROUTER" | "ADAPTER::UNISWAP_V4_GATEWAY" | "ADAPTER::UPSHIFT_VAULT" | "ADAPTER::VELODROME_V2_ROUTER";
+export type AdapterContractType = "ADAPTER::ACCOUNT_MIGRATOR" | "ADAPTER::BALANCER_V3_ROUTER" | "ADAPTER::BALANCER_V3_WRAPPER" | "ADAPTER::CAMELOT_V3_ROUTER" | "ADAPTER::CURVE_STABLE_NG" | "ADAPTER::CURVE_V1_2ASSETS" | "ADAPTER::CURVE_V1_3ASSETS" | "ADAPTER::CURVE_V1_4ASSETS" | "ADAPTER::CURVE_V1_STECRV_POOL" | "ADAPTER::CVX_V1_BASE_REWARD_POOL" | "ADAPTER::CVX_V1_BOOSTER" | "ADAPTER::DAI_USDS_EXCHANGE" | "ADAPTER::ERC4626_VAULT" | "ADAPTER::ERC4626_VAULT_REFERRAL" | "ADAPTER::FLUID_DEX" | "ADAPTER::INFINIFI_GATEWAY" | "ADAPTER::INFINIFI_UNWINDING" | "ADAPTER::KELP_DEPOSIT_POOL" | "ADAPTER::KELP_WITHDRAWAL" | "ADAPTER::LIDO_V1" | "ADAPTER::LIDO_WSTETH_V1" | "ADAPTER::MELLOW_CLAIMER" | "ADAPTER::MELLOW_DVV" | "ADAPTER::MELLOW_ERC4626_VAULT" | "ADAPTER::MELLOW_WRAPPER" | "ADAPTER::MIDAS_GATEWAY" | "ADAPTER::MIDAS_ISSUANCE_VAULT" | "ADAPTER::MIDAS_REDEMPTION_VAULT" | "ADAPTER::PENDLE_ROUTER" | "ADAPTER::SECURITIZE_ONRAMP" | "ADAPTER::SECURITIZE_REDEMPTION" | "ADAPTER::STAKING_REWARDS" | "ADAPTER::TRADERJOE_ROUTER" | "ADAPTER::TREEHOUSE_FASTLANE" | "ADAPTER::TREEHOUSE_GATEWAY" | "ADAPTER::TREEHOUSE_ROUTER" | "ADAPTER::UNISWAP_V2_ROUTER" | "ADAPTER::UNISWAP_V3_ROUTER" | "ADAPTER::UNISWAP_V4_GATEWAY" | "ADAPTER::UPSHIFT_VAULT" | "ADAPTER::VELODROME_V2_ROUTER";
 export declare enum AdapterType {
   ACCOUNT_MIGRATOR = "ACCOUNT_MIGRATOR",
   BALANCER_V3_ROUTER = "BALANCER_V3_ROUTER",
@@ -50,6 +50,9 @@ export declare enum AdapterType {
   SECURITIZE_REDEMPTION = "SECURITIZE_REDEMPTION",
   STAKING_REWARDS = "STAKING_REWARDS",
   TRADERJOE_ROUTER = "TRADERJOE_ROUTER",
+  TREEHOUSE_FASTLANE = "TREEHOUSE_FASTLANE",
+  TREEHOUSE_GATEWAY = "TREEHOUSE_GATEWAY",
+  TREEHOUSE_ROUTER = "TREEHOUSE_ROUTER",
   UNISWAP_V2_ROUTER = "UNISWAP_V2_ROUTER",
   UNISWAP_V3_ROUTER = "UNISWAP_V3_ROUTER",
   UNISWAP_V4_GATEWAY = "UNISWAP_V4_GATEWAY",

package/dist/types/permissionless/api/index.d.ts

@@ -5,7 +5,7 @@ import { AttachChainsArgs, ChainScope, ChainSummaryArgs, PermissionlessChain, Pe
 import { ChainsNamespace } from "./chains/ChainsNamespace.js";
 import { DeployArgs, DeployContractArgs, DeployPriceFeedArgs, PreparedDeployment, PreparedPriceFeedDeployment } from "./deploy/types.js";
 import { DEFAULT_DEPLOY_SALT, PermissionlessDeploy, priceFeedSalt } from "./deploy/PermissionlessDeploy.js";
-import { GetPricesArgs, PermissionlessAsset, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./oracles/types.js";
+import { AssetArgs, GetPricesArgs, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetPrices, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./oracles/types.js";
 import { GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, PermissionlessOracles } from "./oracles/PermissionlessOracles.js";
 import { AddFeedsArgs, ChangeNamesArgs, ChangeStalenessPeriodsArgs, ForbidFeedsArgs, InstanceTxsArgs, PriceFeedPair } from "./transactions/types.js";
 import { InstanceOwnerTransactions } from "./transactions/InstanceOwnerTransactions.js";
@@ -17,4 +17,4 @@ import "./deploy/index.js";
 import { PermissionlessChainUnreachableError, PermissionlessNotAttachedError, PriceFeedNotInStoreError, PriceFeedSaltMissingError, PriceFeedStalenessUnknownError } from "./errors.js";
 import "./oracles/index.js";
 import "./transactions/index.js";
-export { AddFeedsArgs, AttachChainsArgs, ChainScope, ChainSummaryArgs, ChainsNamespace, ChangeNamesArgs, ChangeStalenessPeriodsArgs, DEFAULT_DEPLOY_SALT, DeployArgs, DeployContractArgs, DeployPriceFeedArgs, ForbidFeedsArgs, GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, GearboxPermissionless, GearboxPermissionlessOptions, GetPricesArgs, InstanceOwnerTransactions, InstanceTxsArgs, PermissionlessAnalytics, PermissionlessAsset, PermissionlessChain, PermissionlessChainSummary, PermissionlessChainUnreachableError, PermissionlessDeploy, PermissionlessNotAttachedError, PermissionlessOracles, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PreparedDeployment, PreparedPriceFeedDeployment, PriceChartArgs, PriceFeedArgs, PriceFeedChartPoint, PriceFeedNotInStoreError, PriceFeedPair, PriceFeedPriceChart, PriceFeedSaltMissingError, PriceFeedStalenessUnknownError, deriveEffectiveStalenessPeriod, priceFeedSalt };
+export { AddFeedsArgs, AssetArgs, AttachChainsArgs, ChainScope, ChainSummaryArgs, ChainsNamespace, ChangeNamesArgs, ChangeStalenessPeriodsArgs, DEFAULT_DEPLOY_SALT, DeployArgs, DeployContractArgs, DeployPriceFeedArgs, ForbidFeedsArgs, GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, GearboxPermissionless, GearboxPermissionlessOptions, GetPricesArgs, InstanceOwnerTransactions, InstanceTxsArgs, PermissionlessAnalytics, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetPrices, PermissionlessChain, PermissionlessChainSummary, PermissionlessChainUnreachableError, PermissionlessDeploy, PermissionlessNotAttachedError, PermissionlessOracles, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PreparedDeployment, PreparedPriceFeedDeployment, PriceChartArgs, PriceFeedArgs, PriceFeedChartPoint, PriceFeedNotInStoreError, PriceFeedPair, PriceFeedPriceChart, PriceFeedSaltMissingError, PriceFeedStalenessUnknownError, deriveEffectiveStalenessPeriod, priceFeedSalt };

package/dist/types/permissionless/api/oracles/PermissionlessOracles.d.ts

@@ -2,7 +2,7 @@ import { PriceFeedData } from "../../../model/opportunities.js";
 import { AbstractOffchainNamespace } from "../../../offchain/AbstractOffchainNamespace.js";
 import { GearboxPermissionlessOptions } from "../types.js";
 import { ChainsNamespace } from "../chains/ChainsNamespace.js";
-import { GetPricesArgs, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./types.js";
+import { AssetArgs, GetPricesArgs, PermissionlessAssetDetails, PermissionlessAssetPrices, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./types.js";
 import { Address } from "viem";
 //#region src/permissionless/api/oracles/PermissionlessOracles.d.ts
 export declare const GET_PRICES_GAS_LIMIT_BY_CHAIN_ID: Record<number, bigint>;
@@ -48,6 +48,43 @@ export declare class PermissionlessOracles extends AbstractOffchainNamespace {
    * here — it lives in whichever app wrote it.
    **/
   feed({ chainId, address }: PriceFeedArgs): Promise<PermissionlessPriceFeedDetails>;
+  /**
+   * One asset of the store: the feeds allowed for it, and the markets that
+   * take it as collateral.
+   *
+   * The mirror of {@link feed}, and the call to reach for when the question is
+   * "what prices this token and what is it backing" rather than "where is this
+   * feed used". Both read the same market slots; which end they are indexed
+   * from is the difference.
+   *
+   * ```ts
+   * const { priceFeeds, markets, quotaUsedUsd } =
+   *   await permissionless.oracles.asset({ chainId: 1, address: token });
+   * ```
+   *
+   * @throws When the chain has no metadata for the address. An asset nothing
+   * was indexed for has no symbol or decimals, so there is no row to answer.
+   **/
+  asset({ chainId, address }: AssetArgs): Promise<PermissionlessAssetDetails>;
+  /**
+   * What each of one asset's feeds prices it at, and the market cap each of
+   * them implies.
+   *
+   * The asset-side counterpart of {@link feedMarketCaps}, and priced the same
+   * way: one `totalSupply` read for the asset and one price per feed, rather
+   * than the chain-wide pass {@link prices} makes.
+   *
+   * Several feeds for one asset do not have to agree — that is the point of
+   * having a reserve feed — so this answers per feed rather than picking one.
+   *
+   * ```ts
+   * const { prices, marketCaps } = await permissionless.oracles.assetPrices({
+   *   chainId: 1,
+   *   address: token,
+   * });
+   * ```
+   **/
+  assetPrices({ chainId, address }: AssetArgs): Promise<PermissionlessAssetPrices>;
   /**
    * The feeds one feed reads from, recursively.
    *

package/dist/types/permissionless/api/oracles/index.d.ts

@@ -1,3 +1,3 @@
-import { GetPricesArgs, PermissionlessAsset, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./types.js";
+import { AssetArgs, GetPricesArgs, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetPrices, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./types.js";
 import { GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, PermissionlessOracles } from "./PermissionlessOracles.js";
-export { GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, GetPricesArgs, PermissionlessAsset, PermissionlessOracles, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs };
+export { AssetArgs, GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, GetPricesArgs, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetPrices, PermissionlessOracles, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs };

package/dist/types/permissionless/api/oracles/schemas.d.ts

@@ -89,6 +89,8 @@ export declare const priceFeedMarketSchema: z.ZodObject<{
   reserve: z.ZodBoolean;
   isUnderlying: z.ZodBoolean;
   quotaLimit: z.ZodNullable<z.ZodNumber>;
+  quotaUsed: z.ZodNullable<z.ZodNumber>;
+  marketStalenessPeriod: z.ZodNullable<z.ZodNumber>;
 }, z.core.$loose>;
 /** {@link PermissionlessPriceFeedDetails} */
 export declare const priceFeedDetailsSchema: z.ZodObject<{
@@ -118,6 +120,8 @@ export declare const priceFeedDetailsSchema: z.ZodObject<{
     reserve: z.ZodBoolean;
     isUnderlying: z.ZodBoolean;
     quotaLimit: z.ZodNullable<z.ZodNumber>;
+    quotaUsed: z.ZodNullable<z.ZodNumber>;
+    marketStalenessPeriod: z.ZodNullable<z.ZodNumber>;
   }, z.core.$loose>>;
 }, z.core.$loose>;
 /** {@link PermissionlessPriceFeedMarketCaps} */
@@ -125,4 +129,81 @@ export declare const priceFeedMarketCapsSchema: z.ZodObject<{
   marketCaps: z.ZodType<Record<`0x${string}`, string | null>, unknown, z.core.$ZodTypeInternals<Record<`0x${string}`, string | null>, unknown>>;
   time: z.ZodNumber;
 }, z.core.$loose>;
+/** {@link PermissionlessAssetMarketFeed} */
+export declare const assetMarketFeedSchema: z.ZodObject<{
+  address: z.ZodCustom<`0x${string}`, `0x${string}`>;
+  name: z.ZodNullable<z.ZodString>;
+  inStore: z.ZodBoolean;
+}, z.core.$loose>;
+/** {@link PermissionlessAssetMarket} */
+export declare const assetMarketSchema: z.ZodObject<{
+  market: z.ZodCustom<`0x${string}`, `0x${string}`>;
+  marketConfigurator: z.ZodCustom<`0x${string}`, `0x${string}`>;
+  curatorName: z.ZodNullable<z.ZodString>;
+  marketName: z.ZodNullable<z.ZodString>;
+  underlyingToken: z.ZodCustom<`0x${string}`, `0x${string}`>;
+  underlyingSymbol: z.ZodNullable<z.ZodString>;
+  isUnderlying: z.ZodBoolean;
+  isShutdown: z.ZodBoolean;
+  mainFeed: z.ZodNullable<z.ZodObject<{
+    address: z.ZodCustom<`0x${string}`, `0x${string}`>;
+    name: z.ZodNullable<z.ZodString>;
+    inStore: z.ZodBoolean;
+  }, z.core.$loose>>;
+  reserveFeed: z.ZodNullable<z.ZodObject<{
+    address: z.ZodCustom<`0x${string}`, `0x${string}`>;
+    name: z.ZodNullable<z.ZodString>;
+    inStore: z.ZodBoolean;
+  }, z.core.$loose>>;
+  quotaLimit: z.ZodNullable<z.ZodNumber>;
+  quotaUsed: z.ZodNullable<z.ZodNumber>;
+}, z.core.$loose>;
+/** {@link PermissionlessAssetDetails} */
+export declare const assetDetailsSchema: z.ZodObject<{
+  chainId: z.ZodNumber;
+  asset: z.ZodObject<{
+    address: z.ZodCustom<`0x${string}`, `0x${string}`>;
+    symbol: z.ZodString;
+    name: z.ZodString;
+    decimals: z.ZodNumber;
+  }, z.core.$loose>;
+  priceFeeds: z.ZodArray<z.ZodObject<{
+    address: z.ZodCustom<`0x${string}`, `0x${string}`>;
+    contractType: z.ZodString;
+    version: z.ZodNumber;
+    deployedBy: z.ZodCustom<`0x${string}`, `0x${string}`>;
+    stalenessPeriod: z.ZodNumber;
+    name: z.ZodString;
+  }, z.core.$loose>>;
+  markets: z.ZodArray<z.ZodObject<{
+    market: z.ZodCustom<`0x${string}`, `0x${string}`>;
+    marketConfigurator: z.ZodCustom<`0x${string}`, `0x${string}`>;
+    curatorName: z.ZodNullable<z.ZodString>;
+    marketName: z.ZodNullable<z.ZodString>;
+    underlyingToken: z.ZodCustom<`0x${string}`, `0x${string}`>;
+    underlyingSymbol: z.ZodNullable<z.ZodString>;
+    isUnderlying: z.ZodBoolean;
+    isShutdown: z.ZodBoolean;
+    mainFeed: z.ZodNullable<z.ZodObject<{
+      address: z.ZodCustom<`0x${string}`, `0x${string}`>;
+      name: z.ZodNullable<z.ZodString>;
+      inStore: z.ZodBoolean;
+    }, z.core.$loose>>;
+    reserveFeed: z.ZodNullable<z.ZodObject<{
+      address: z.ZodCustom<`0x${string}`, `0x${string}`>;
+      name: z.ZodNullable<z.ZodString>;
+      inStore: z.ZodBoolean;
+    }, z.core.$loose>>;
+    quotaLimit: z.ZodNullable<z.ZodNumber>;
+    quotaUsed: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$loose>>;
+  quotaLimitUsd: z.ZodNullable<z.ZodNumber>;
+  quotaUsedUsd: z.ZodNullable<z.ZodNumber>;
+}, z.core.$loose>;
+/** {@link PermissionlessAssetPrices} */
+export declare const assetPricesSchema: z.ZodObject<{
+  prices: z.ZodType<Record<`0x${string}`, string | null>, unknown, z.core.$ZodTypeInternals<Record<`0x${string}`, string | null>, unknown>>;
+  marketCaps: z.ZodType<Record<`0x${string}`, string | null>, unknown, z.core.$ZodTypeInternals<Record<`0x${string}`, string | null>, unknown>>;
+  time: z.ZodNumber;
+}, z.core.$loose>;
 //#endregion

package/dist/types/permissionless/api/oracles/types.d.ts

@@ -88,6 +88,33 @@ export interface PermissionlessPriceFeedMarket {
    * answers.
    */
   quotaLimit: number | null;
+  /**
+   * How much of {@link quotaLimit} the market's borrowers have actually taken,
+   * in the same units.
+   *
+   * The sum of every open credit account's current quota for this token across
+   * the credit managers borrowing from the market, so it is what the token is
+   * backing right now rather than what it is allowed to back.
+   *
+   * `null` only where {@link quotaLimit} is: a token nobody quotes reads as a
+   * zero against a limit, which is a different answer from a token the keeper
+   * holds no entry for at all.
+   */
+  quotaUsed: number | null;
+  /**
+   * Staleness period this market's own price oracle holds for the slot, in
+   * seconds.
+   *
+   * The market's figure rather than the store's: a curator sets one per slot
+   * in their price oracle, and nothing obliges it to agree with the period the
+   * PriceFeedStore carries for the feed. A reader comparing the two is
+   * comparing two contracts, which is why both are reported.
+   *
+   * Read off the oracle when the route is answered rather than taken from the
+   * index — the slot's period is not indexed — so `null` means the oracle
+   * would not answer, not that it holds no period.
+   */
+  marketStalenessPeriod: number | null;
 }
 /**
  * One feed of the store, with everywhere the store lets it be used.
@@ -107,6 +134,133 @@ export interface PermissionlessPriceFeedDetails {
    */
   markets: PermissionlessPriceFeedMarket[];
 }
+/**
+ * One feed as a market slot holds it.
+ *
+ * The store's view of the feed and not the feed itself: a market keeps
+ * pricing with whatever it was last pointed at, and nothing removes it from a
+ * market when the store drops it. {@link inStore} is what tells those apart,
+ * and the name survives either way because the store recorded it before.
+ **/
+export interface PermissionlessAssetMarketFeed {
+  address: Address;
+  /**
+   * Display name the store recorded, or `null` for a feed it never carried —
+   * an aggregator a curator pointed a market straight at, say.
+   */
+  name: string | null;
+  /**
+   * Whether the PriceFeedStore still carries the feed.
+   *
+   * `false` is the case worth showing: the market goes on pricing the asset
+   * with a feed the store has removed, or never had. Nothing on chain forbids
+   * that, which is exactly why it has to be visible.
+   */
+  inStore: boolean;
+}
+/**
+ * One market that prices an asset, with both of the slots it may fill.
+ *
+ * A row per market rather than per `(market, role)`: the two roles are two
+ * columns of the same market's row, and the quota is the market's whatever
+ * feed holds which slot.
+ **/
+export interface PermissionlessAssetMarket {
+  market: Address;
+  marketConfigurator: Address;
+  /** The configurator's own name, as the backend's sync recorded it. */
+  curatorName: string | null;
+  /** The market's own name, which is the name of its pool token. */
+  marketName: string | null;
+  /** The market's underlying, which its quota figures are denominated in. */
+  underlyingToken: Address;
+  /** `null` for an underlying the backend has no metadata row for. */
+  underlyingSymbol: string | null;
+  /** The asset is this market's own underlying, so it is not quota-managed. */
+  isUnderlying: boolean;
+  /**
+   * The market has been shut down.
+   *
+   * Still reported, and still counted in {@link
+   * PermissionlessAssetDetails.quotaUsedUsd}: a shut down market carries no
+   * new borrowing but its open accounts are quoting all the same.
+   */
+  isShutdown: boolean;
+  /** The feed the market prices the asset with, or `null` if it has none. */
+  mainFeed: PermissionlessAssetMarketFeed | null;
+  /** The feed the market falls back to, or `null` if it has none. */
+  reserveFeed: PermissionlessAssetMarketFeed | null;
+  /**
+   * What the pool will take of the asset, in units of {@link underlyingToken}.
+   *
+   * `null` for an asset the quota keeper was never told a limit for, which the
+   * market's own underlying always is. A zero is a limit set to zero, and the
+   * two are different answers.
+   */
+  quotaLimit: number | null;
+  /** How much of {@link quotaLimit} is actually taken, in the same units. */
+  quotaUsed: number | null;
+}
+/**
+ * One asset of the store: what prices it, and what it is used as collateral
+ * for.
+ *
+ * The counterpart of {@link PermissionlessPriceFeedDetails} — the same corner
+ * of the chain read from the asset's end instead of the feed's.
+ **/
+export interface PermissionlessAssetDetails {
+  chainId: number;
+  asset: PermissionlessPriceFeedAsset;
+  /**
+   * Feeds the store currently allows for the asset.
+   *
+   * Only the store's. A feed a market still prices the asset with but the
+   * store has dropped is not here — it is on its market's row, flagged.
+   */
+  priceFeeds: PriceFeed[];
+  /** Ordered by curator, then by market. */
+  markets: PermissionlessAssetMarket[];
+  /**
+   * Total quota limit across the markets still running, in USD.
+   *
+   * In USD and not in token units because there is no token to state it in: a
+   * limit is denominated in its own market's underlying, and an asset is
+   * routinely collateral in markets underlain by different tokens, so the
+   * figures are not comparable until each is priced. Each market's limit is
+   * converted at the price that market's own oracle holds for its underlying.
+   *
+   * Shut down markets are left out — their limits are not borrowable — and so
+   * are markets whose underlying could not be priced, which makes this a floor
+   * rather than an estimate. `null` when no market contributed at all.
+   */
+  quotaLimitUsd: number | null;
+  /**
+   * Total quota actually taken across every market, in USD, converted the same
+   * way as {@link quotaLimitUsd}.
+   *
+   * Every market, including the shut down ones: debt outstanding is exposure
+   * whether or not the market still takes new borrowers.
+   */
+  quotaUsedUsd: number | null;
+}
+/**
+ * What each of one asset's feeds says the asset is worth, and what the market
+ * values the asset at through each.
+ *
+ * Keyed by the lowercased feed address throughout. The asset is the one asked
+ * for, so a cap here is that feed's price times the asset's supply — the same
+ * figure {@link PermissionlessPriceFeedMarketCaps} answers from the other
+ * side, and the reason both exist is that a page shows one row per feed or one
+ * row per asset, never the full cross product.
+ *
+ * `null` is a read that failed, not a zero.
+ **/
+export interface PermissionlessAssetPrices {
+  prices: Record<Address, string | null>;
+  marketCaps: Record<Address, string | null>;
+  /** When the backend computed the figures; they are read live, not indexed. */
+  time: number;
+}
 /**
  * Market caps of one feed's assets, keyed by the lowercased asset address.
  *
@@ -129,6 +283,11 @@ export interface PriceFeedArgs {
   chainId: number;
   address: Address;
 }
+/** Args of a read scoped to one asset. */
+export interface AssetArgs {
+  chainId: number;
+  address: Address;
+}
 /** Args of {@link PermissionlessOracles.getPrices}. */
 export interface GetPricesArgs {
   chainId: number;

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

@@ -13,7 +13,7 @@ import "./core/index.js";
 import { FunctionParams, ValueParams, encodeFunctionParams } from "./utils/abi-encoder.js";
 import { DeployArgs, DeployContractArgs, DeployPriceFeedArgs, PreparedDeployment, PreparedPriceFeedDeployment } from "./api/deploy/types.js";
 import { DEFAULT_DEPLOY_SALT, PermissionlessDeploy, priceFeedSalt } from "./api/deploy/PermissionlessDeploy.js";
-import { GetPricesArgs, PermissionlessAsset, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./api/oracles/types.js";
+import { AssetArgs, GetPricesArgs, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetPrices, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PriceFeedArgs } from "./api/oracles/types.js";
 import { GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, PermissionlessOracles } from "./api/oracles/PermissionlessOracles.js";
 import { AddressProviderContract } from "./bindings/address-provider.js";
 import { BytecodeRepositoryContract } from "./bindings/bytecode-repository.js";
@@ -54,4 +54,4 @@ import { getPrices } from "./utils/price-update/get-prices.js";
 import { GetUpdatablePriceFeedsArgs, getUpdatablePriceFeeds } from "./utils/price-update/get-updatable-feeds.js";
 import { normalizeSignature } from "./utils/signature.js";
 import "./utils/index.js";
-export { AccessMode, AddAssetParams, AddFeedsArgs, AddressProviderContract, Addresses, AllowTokenParams, ArchiveTransport, ArchiveTransportConfig, AttachChainsArgs, AuditEvent, Auditor, BYTECODE_REPOSITORY, Batch, Bytecode, BytecodeRepositoryContract, CCMConstructorParams, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, ChainScope, ChainSummaryArgs, ChainsNamespace, ChangeNamesArgs, ChangeStalenessPeriodsArgs, ConstructorParams, CreditManagerFees, CrossChainCall, CrossChainMultisigContract, DEFAULT_DEPLOY_SALT, DeployArgs, DeployContractArgs, DeployParams, DeployPriceFeedArgs, Deployment, DeploymentExtended, ForbidAdapterParams, ForbidFeedsArgs, ForbidTokenParams, FunctionParams, GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, GearboxPermissionless, GearboxPermissionlessOptions, GetPricesArgs, GetUpdatablePriceFeedsArgs, GovernorContract, INSTANCE_MANAGER, InputValueParams, InstanceManagerContract, InstanceOwnerTransactions, InstanceTxs, InstanceTxsArgs, MAINNET_CCM_CONSTRUCTOR_PARAMS, MAINNET_DEPLOYMENT_BLOCK, MAINNET_DEPLOYMENT_CCM_SALT, MAINNET_DEPLOYMENT_IM_SALT, MARKET_CONFIGURATOR_FACTORY, Market, MarketConfiguratorContract, MarketConfiguratorFactoryContract, PRICE_FEED_STORE, PUBLIC_CREATE2_FACTORY, PauseCreditManagerParams, PeripheryDomain, PermissionlessAnalytics, PermissionlessAsset, PermissionlessChain, PermissionlessChainSummary, PermissionlessChainUnreachableError, PermissionlessDeploy, PermissionlessNotAttachedError, PermissionlessOracles, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PreparedDeployment, PreparedPriceFeedDeployment, PriceChartArgs, PriceFeed, PriceFeedArgs, PriceFeedChartPoint, PriceFeedConstructorParam, PriceFeedNotInStoreError, PriceFeedPair, PriceFeedParamType, PriceFeedParams, PriceFeedPriceChart, PriceFeedSaltMissingError, PriceFeedSetupParams, PriceFeedStalenessUnknownError, PriceFeedStoreContract, Proposal, QueuedAndExecutedTransaction, RecoveryMessage, RoutingManagerContract, SafeBatch, SafeMeta, SafeTx, SetExpirationDateParams, SetFeesParams, SetPriceFeedParams, SetReservePriceFeedParams, SetTokenQuotaIncreaseFeeParams, Signature, TOKEN_COMPRESSOR, TimeLockContract, TimelockTransaction, TimelockTxParams, TimelockTxs, TokenCompressorContract, TreasurySplitterContract, UnpauseCreditManagerParams, ValueParams, WithdrawalCompressorContract, calculateChecksum, checkCreate2Deployment, checkCreate2DeploymentAddress, chunkedLogsTransport, convertPercent, convertQueueBatchToExecuteTx, convertRawTxToSafeMultisigTx, createCallData, createCreate2DeployRawTx, deepJsonParse, deployUsingPublicCreate2, deriveEffectiveStalenessPeriod, encodeFunctionParams, formatBytecodeSize, formatBytecodeVersion, getBlockNumberByTimestamp, getCreate2AddressPublicFactory, getCreate2DeploymentAddress, getPriceUpdateTx, getPrices, getSafeBatch, getSafeBatches, getUpdatablePriceFeeds, handleSalt, normalizeSignature, priceFeedSalt, priceFeedSetupParams, shortenHash, significantTrunc };
+export { AccessMode, AddAssetParams, AddFeedsArgs, AddressProviderContract, Addresses, AllowTokenParams, ArchiveTransport, ArchiveTransportConfig, AssetArgs, AttachChainsArgs, AuditEvent, Auditor, BYTECODE_REPOSITORY, Batch, Bytecode, BytecodeRepositoryContract, CCMConstructorParams, CROSS_CHAIN_GOVERNANCE, CROSS_CHAIN_MULTISIG, ChainScope, ChainSummaryArgs, ChainsNamespace, ChangeNamesArgs, ChangeStalenessPeriodsArgs, ConstructorParams, CreditManagerFees, CrossChainCall, CrossChainMultisigContract, DEFAULT_DEPLOY_SALT, DeployArgs, DeployContractArgs, DeployParams, DeployPriceFeedArgs, Deployment, DeploymentExtended, ForbidAdapterParams, ForbidFeedsArgs, ForbidTokenParams, FunctionParams, GET_PRICES_CHUNK_SIZE, GET_PRICES_GAS_LIMIT_BY_CHAIN_ID, GearboxPermissionless, GearboxPermissionlessOptions, GetPricesArgs, GetUpdatablePriceFeedsArgs, GovernorContract, INSTANCE_MANAGER, InputValueParams, InstanceManagerContract, InstanceOwnerTransactions, InstanceTxs, InstanceTxsArgs, MAINNET_CCM_CONSTRUCTOR_PARAMS, MAINNET_DEPLOYMENT_BLOCK, MAINNET_DEPLOYMENT_CCM_SALT, MAINNET_DEPLOYMENT_IM_SALT, MARKET_CONFIGURATOR_FACTORY, Market, MarketConfiguratorContract, MarketConfiguratorFactoryContract, PRICE_FEED_STORE, PUBLIC_CREATE2_FACTORY, PauseCreditManagerParams, PeripheryDomain, PermissionlessAnalytics, PermissionlessAsset, PermissionlessAssetDetails, PermissionlessAssetMarket, PermissionlessAssetMarketFeed, PermissionlessAssetPrices, PermissionlessChain, PermissionlessChainSummary, PermissionlessChainUnreachableError, PermissionlessDeploy, PermissionlessNotAttachedError, PermissionlessOracles, PermissionlessPriceFeedAsset, PermissionlessPriceFeedDetails, PermissionlessPriceFeedMarket, PermissionlessPriceFeedMarketCaps, PermissionlessPriceFeedStore, PermissionlessPrices, PreparedDeployment, PreparedPriceFeedDeployment, PriceChartArgs, PriceFeed, PriceFeedArgs, PriceFeedChartPoint, PriceFeedConstructorParam, PriceFeedNotInStoreError, PriceFeedPair, PriceFeedParamType, PriceFeedParams, PriceFeedPriceChart, PriceFeedSaltMissingError, PriceFeedSetupParams, PriceFeedStalenessUnknownError, PriceFeedStoreContract, Proposal, QueuedAndExecutedTransaction, RecoveryMessage, RoutingManagerContract, SafeBatch, SafeMeta, SafeTx, SetExpirationDateParams, SetFeesParams, SetPriceFeedParams, SetReservePriceFeedParams, SetTokenQuotaIncreaseFeeParams, Signature, TOKEN_COMPRESSOR, TimeLockContract, TimelockTransaction, TimelockTxParams, TimelockTxs, TokenCompressorContract, TreasurySplitterContract, UnpauseCreditManagerParams, ValueParams, WithdrawalCompressorContract, calculateChecksum, checkCreate2Deployment, checkCreate2DeploymentAddress, chunkedLogsTransport, convertPercent, convertQueueBatchToExecuteTx, convertRawTxToSafeMultisigTx, createCallData, createCreate2DeployRawTx, deepJsonParse, deployUsingPublicCreate2, deriveEffectiveStalenessPeriod, encodeFunctionParams, formatBytecodeSize, formatBytecodeVersion, getBlockNumberByTimestamp, getCreate2AddressPublicFactory, getCreate2DeploymentAddress, getPriceUpdateTx, getPrices, getSafeBatch, getSafeBatches, getUpdatablePriceFeeds, handleSalt, normalizeSignature, priceFeedSalt, priceFeedSetupParams, shortenHash, significantTrunc };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "18.2.0-next.1",
+  "version": "18.2.0-next.3",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {
@@ -69,8 +69,9 @@
     "dev": "tsdown --watch",
     "example": "tsx scripts/example.ts | pino-pretty",
     "list-opportunities": "tsx scripts/list-opportunities.ts",
-    "test:watch": "vitest --project unit",
-    "test:unit": "vitest run --project unit",
+    "test:watch": "vitest --project unit --project api",
+    "test:unit": "vitest run --project unit --project api",
+    "test:api": "vitest run --project api",
     "test:e2e": "vitest run --project e2e",
     "test:all": "vitest run",
     "test": "vitest run",