@gearbox-protocol/sdk 14.12.0-next.81 → 14.12.0-next.82

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

@@ -1,40 +1,37 @@
-import { MultichainResult } from "../types/multichain.js";
 import { PluginsMap } from "../plugins/types.js";
 import "../plugins/index.js";
 import { Opportunity, OpportunityFilter, PoolOpportunityDetail, PoolOpportunityKey, StrategyOpportunityDetail, StrategyOpportunityKey } from "../../model/opportunities.js";
+import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
-import "../types/index.js";
 import { MultichainConstruct } from "../base/MultichainConstruct.js";
 import "../base/index.js";
 //#region src/sdk/opportunities/MultichainOpportunitiesService.d.ts
 /**
- * Cross-chain counterpart of {@link OpportunitiesService}.
- *
- * Fans out over every chain configured in {@link MultichainSDK}. A chain that
- * fails is logged and skipped so one dead RPC does not empty the list; its
- * failure is reported in {@link MultichainResult.meta}.
- *
- * Detail reads need no fan-out: an opportunity key names its chain.
+ * Cross-chain counterpart of {@link OpportunitiesService}. Every read walks
+ * loaded market state, so the block it reports is the SDK's snapshot.
  *
  * @typeParam Plugins - Map of attached plugin types.
  **/
 declare class MultichainOpportunitiesService<const Plugins extends PluginsMap = {}> extends MultichainConstruct<Plugins> {
-  #private;
   /**
    * Opportunities of all queried chains, see {@link OpportunitiesService.list}.
-   *
-   * A filter that names chains narrows the fan-out itself, so chains whose rows
-   * would be discarded are never queried and never appear in the meta.
+   * 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<MultichainResult<Opportunity[]>>;
+  list(filter?: OpportunityFilter): Promise<DataResponse<Opportunity[]>>;
   /**
    * {@inheritDoc OpportunitiesService.getPool}
+   *
+   * The key names its chain, so there is no fan-out. Throws when that chain
+   * cannot answer.
    **/
-  getPool(key: PoolOpportunityKey): Promise<PoolOpportunityDetail>;
+  getPool(key: PoolOpportunityKey): Promise<DataResponse<PoolOpportunityDetail>>;
   /**
    * {@inheritDoc OpportunitiesService.getStrategy}
+   *
+   * See {@link MultichainOpportunitiesService.getPool}.
    **/
-  getStrategy(key: StrategyOpportunityKey): Promise<StrategyOpportunityDetail>;
+  getStrategy(key: StrategyOpportunityKey): Promise<DataResponse<StrategyOpportunityDetail>>;
 }
 //#endregion
 export { MultichainOpportunitiesService };

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

@@ -1,33 +1,23 @@
-import { MultichainResult } from "../types/multichain.js";
 import { PluginsMap } from "../plugins/types.js";
 import "../plugins/index.js";
 import { Position } from "../../model/positions.js";
+import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { ListPositionsProps } from "./types.js";
-import "../types/index.js";
 import { MultichainConstruct } from "../base/MultichainConstruct.js";
 import "../base/index.js";
 //#region src/sdk/positions/MultichainPositionsService.d.ts
 /**
  * Cross-chain counterpart of {@link PositionsService}.
  *
- * Fans out over every chain configured in {@link MultichainSDK}. A chain that
- * fails is logged and skipped so one dead RPC does not hide the positions a
- * wallet holds elsewhere; its failure is reported in
- * {@link MultichainResult.meta}.
- *
  * @typeParam Plugins - Map of attached plugin types.
  **/
 declare class MultichainPositionsService<const Plugins extends PluginsMap = {}> extends MultichainConstruct<Plugins> {
-  #private;
   /**
    * Positions of a wallet on all queried chains, see
    * {@link PositionsService.list}.
-   *
-   * A filter that names chains narrows the fan-out itself, so chains whose rows
-   * would be discarded are never queried and never appear in the meta.
    **/
-  list(props: ListPositionsProps<true>): Promise<MultichainResult<Position[]>>;
+  list(props: ListPositionsProps<true>): Promise<DataResponse<Position[]>>;
 }
 //#endregion
 export { MultichainPositionsService };

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

@@ -1,6 +1,6 @@
 import { ILogger, LogFn } from "./logger.js";
-import { BlockNumberProps, MultichainNetworkMeta, MultichainNetworkProps, MultichainNetworksProps, MultichainResult, WithBlock, WithMultichain } from "./multichain.js";
+import { BlockNumberProps, MultichainChainIdsProps, MultichainNetworkProps, WithBlock, WithMultichain } from "./multichain.js";
 import { AddressProviderV3StateHuman, AliasLossPolicyStateHuman, AssetPriceFeedStateHuman, BalancerWeightedPriceFeedStateHuman, BaseContractStateHuman, BasePriceFeedStateHuman, BotListStateHuman, BoundedOracleStateHuman, ConstantOracleStateHuman, CoreStateHuman, CreditConfiguratorStateHuman, CreditFacadeStateHuman, CreditManagerDebtParamsHuman, CreditManagerStateHuman, CreditSuiteStateHuman, GaugeParamsHuman, GaugeStateHuman, GearStakingV3StateHuman, GearboxStateHuman, InterestRateModelStateHuman, LPPriceFeedStateHuman, LinearInterestRateModelStateHuman, LossPolicyStateHuman, MarketStateHuman, MultichainStateHuman, PoolQuotaKeeperStateHuman, PoolStateHuman, PoolSuiteStateHuman, PriceFeedStateHuman, PriceOracleStateHuman, QuotaParamsHuman, RateKeeperStateHuman, RedstonePriceFeedStateHuman, TumblerStateHuman, ZapperStateHuman } from "./state-human.js";
 import { ContractMethod, IPriceUpdateTx, MultiCall, RawTx } from "./transactions.js";
 import { GearboxState, MultichainState } from "./state.js";
-export type { AddressProviderV3StateHuman, AliasLossPolicyStateHuman, AssetPriceFeedStateHuman, BalancerWeightedPriceFeedStateHuman, BaseContractStateHuman, BasePriceFeedStateHuman, BlockNumberProps, BotListStateHuman, BoundedOracleStateHuman, ConstantOracleStateHuman, ContractMethod, CoreStateHuman, CreditConfiguratorStateHuman, CreditFacadeStateHuman, CreditManagerDebtParamsHuman, CreditManagerStateHuman, CreditSuiteStateHuman, GaugeParamsHuman, GaugeStateHuman, GearStakingV3StateHuman, GearboxState, GearboxStateHuman, ILogger, IPriceUpdateTx, InterestRateModelStateHuman, LPPriceFeedStateHuman, LinearInterestRateModelStateHuman, LogFn, LossPolicyStateHuman, MarketStateHuman, MultiCall, MultichainNetworkMeta, MultichainNetworkProps, MultichainNetworksProps, MultichainResult, MultichainState, MultichainStateHuman, PoolQuotaKeeperStateHuman, PoolStateHuman, PoolSuiteStateHuman, PriceFeedStateHuman, PriceOracleStateHuman, QuotaParamsHuman, RateKeeperStateHuman, RawTx, RedstonePriceFeedStateHuman, TumblerStateHuman, WithBlock, WithMultichain, ZapperStateHuman };
+export type { AddressProviderV3StateHuman, AliasLossPolicyStateHuman, AssetPriceFeedStateHuman, BalancerWeightedPriceFeedStateHuman, BaseContractStateHuman, BasePriceFeedStateHuman, BlockNumberProps, BotListStateHuman, BoundedOracleStateHuman, ConstantOracleStateHuman, ContractMethod, CoreStateHuman, CreditConfiguratorStateHuman, CreditFacadeStateHuman, CreditManagerDebtParamsHuman, CreditManagerStateHuman, CreditSuiteStateHuman, GaugeParamsHuman, GaugeStateHuman, GearStakingV3StateHuman, GearboxState, GearboxStateHuman, ILogger, IPriceUpdateTx, InterestRateModelStateHuman, LPPriceFeedStateHuman, LinearInterestRateModelStateHuman, LogFn, LossPolicyStateHuman, MarketStateHuman, MultiCall, MultichainChainIdsProps, MultichainNetworkProps, MultichainState, MultichainStateHuman, PoolQuotaKeeperStateHuman, PoolStateHuman, PoolSuiteStateHuman, PriceFeedStateHuman, PriceOracleStateHuman, QuotaParamsHuman, RateKeeperStateHuman, RawTx, RedstonePriceFeedStateHuman, TumblerStateHuman, WithBlock, WithMultichain, ZapperStateHuman };

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

@@ -1,3 +1,4 @@
+import { ChainId } from "../../model/primitives.js";
 import { NetworkType } from "../chain/chains.js";
 //#region src/sdk/types/multichain.d.ts
 /**
@@ -12,12 +13,14 @@ interface MultichainNetworkProps {
 /**
  * Restricts which chains a multichain list method queries.
  **/
-interface MultichainNetworksProps {
+interface MultichainChainIdsProps {
   /**
-   * Networks to query. All chains configured in {@link MultichainSDK} when
-   * omitted.
+   * Chains to query. All chains configured in {@link MultichainSDK} when
+   * omitted, and one the SDK is not configured for is dropped.
+   *
+   * A caller who thinks in network labels converts with {@link toChainIds}.
    **/
-  networks?: NetworkType[];
+  chainIds?: ChainId[];
 }
 /**
  * Adds chain-scoping props `T` only when the service spans multiple chains.
@@ -38,43 +41,5 @@ interface BlockNumberProps {
  * omit it so a caller cannot pass one height to every network.
  **/
 type WithBlock<Multichain extends boolean> = Multichain extends true ? {} : BlockNumberProps;
-/**
- * Outcome of a fan-out request on a single chain.
- **/
-interface MultichainNetworkMeta {
-  /**
-   * Network the request was sent to.
-   **/
-  network: NetworkType;
-  /**
-   * Whether the per-chain request succeeded.
-   **/
-  status: "success" | "error";
-  /**
-   * Rejection reason of the per-chain request. Only set when
-   * {@link status} is `"error"`.
-   **/
-  error?: unknown;
-}
-/**
- * Result of a multichain fan-out request: the combined payload of all
- * successful chains plus the outcome of every queried chain.
- *
- * Methods with no payload use `MultichainResult<void>`, i.e. `result` is
- * `undefined` and only {@link meta} carries information.
- *
- * @typeParam T - Combined payload type.
- **/
-interface MultichainResult<T> {
-  /**
-   * Combined payload of the chains that responded successfully. Chains that
-   * failed contribute nothing and are reported in {@link meta}.
-   **/
-  result: T;
-  /**
-   * Per-chain request outcome, one entry per queried chain.
-   **/
-  meta: MultichainNetworkMeta[];
-}
 //#endregion
-export { BlockNumberProps, MultichainNetworkMeta, MultichainNetworkProps, MultichainNetworksProps, MultichainResult, WithBlock, WithMultichain };
+export { BlockNumberProps, MultichainChainIdsProps, MultichainNetworkProps, WithBlock, WithMultichain };

package/package.json

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