@gearbox-protocol/sdk 13.3.3 → 13.4.0-beta.2

package/dist/cjs/sdk/market/MarketRegister.js

@@ -29,9 +29,6 @@ var import_viem = require("../utils/viem/index.js");
 var import_MarketConfiguratorContract = require("./MarketConfiguratorContract.js");
 var import_MarketSuite = require("./MarketSuite.js");
 class MarketRegister extends import_base.SDKConstruct {
-  /**
-   * Mapping pool.address -> MarketSuite
-   */
   #markets = new import_utils.AddressMap(void 0, "markets");
   #marketFilter;
   #marketConfigurators = new import_utils.AddressMap(
@@ -39,12 +36,21 @@ class MarketRegister extends import_base.SDKConstruct {
     "marketConfigurators"
   );
   #ignoreMarkets;
+  /**
+   * @param sdk - Top-level SDK instance.
+   * @param ignoreMarkets - Pool addresses of markets to exclude from loading.
+   **/
   constructor(sdk, ignoreMarkets = []) {
     super(sdk);
     this.#ignoreMarkets = new Set(
       ignoreMarkets.map((m) => m.toLowerCase())
     );
   }
+  /**
+   * Restores market state from a previously serialized snapshot,
+   * bypassing on-chain reads.
+   * @param state - Array of market data snapshots.
+   **/
   hydrate(state) {
     this.#markets.clear();
     const configurators = new Set(state.map((m) => m.configurator));
@@ -63,6 +69,13 @@ class MarketRegister extends import_base.SDKConstruct {
       );
     }
   }
+  /**
+   * Fetches all markets from the on-chain for the given market configurators.
+   *
+   * @param marketConfigurators - Addresses of market configurator contracts to query.
+   * @param ignoreUpdateablePrices - When `true`, skips generating off-chain
+   *   price updates before loading
+   **/
   async loadMarkets(marketConfigurators, ignoreUpdateablePrices) {
     if (!marketConfigurators.length) {
       this.logger?.warn(
@@ -85,6 +98,10 @@ class MarketRegister extends import_base.SDKConstruct {
       underlying: import_constants.ADDRESS_0X0
     };
   }
+  /**
+   * The active filter used to scope market compressor queries.
+   * @throws If the register has not been hydrated or attached yet.
+   **/
   get marketFilter() {
     if (!this.#marketFilter) {
       throw new Error(
@@ -93,6 +110,15 @@ class MarketRegister extends import_base.SDKConstruct {
     }
     return this.#marketFilter;
   }
+  /**
+   * Re-synchronizes market state with the chain. If during sdk synchronization
+   * we detected that some markets or market configurators were changed,
+   * we reload everything.
+   *
+   * Otherwise only prices are refreshed.
+   *
+   * @param ignoreUpdateablePrices - When `true`, skips off-chain price updates.
+   **/
   async syncState(ignoreUpdateablePrices) {
     const dirty = this.markets.some((m) => m.dirty) || this.marketConfigurators.some((c) => c.dirty);
     if (dirty) {
@@ -203,26 +229,50 @@ class MarketRegister extends import_base.SDKConstruct {
       ...this.marketFilter.configurators
     ]);
   }
+  /**
+   * Serializable snapshot of all loaded markets, suitable for hydration.
+   **/
   get state() {
     return this.markets.map((market) => market.state);
   }
+  /**
+   * Returns a human-readable snapshot of all markets.
+   * @param raw - When `true`, includes raw/unformatted values.
+   **/
   stateHuman(raw = true) {
     return {
       markets: this.markets.map((market) => market.stateHuman(raw))
     };
   }
+  /**
+   * All pool suites across loaded markets.
+   **/
   get pools() {
     return this.markets.map((market) => market.pool);
   }
+  /**
+   * All price oracles across loaded markets.
+   **/
   get priceOracles() {
     return this.markets.map((market) => market.priceOracle);
   }
+  /**
+   * All credit manager suites across loaded markets.
+   **/
   get creditManagers() {
     return this.markets.flatMap((market) => market.creditManagers);
   }
+  /**
+   * All known market configurator contracts.
+   **/
   get marketConfigurators() {
     return this.#marketConfigurators.values();
   }
+  /**
+   * Finds a credit manager suite by its on-chain address.
+   * @param creditManager - Credit manager contract address.
+   * @throws If no loaded market contains the given credit manager.
+   **/
   findCreditManager(creditManager) {
     const addr = creditManager.toLowerCase();
     for (const market of this.markets) {
@@ -234,6 +284,11 @@ class MarketRegister extends import_base.SDKConstruct {
     }
     throw new Error(`cannot find credit manager ${creditManager}`);
   }
+  /**
+   * Finds the market that contains the given credit manager.
+   * @param creditManager - Credit manager contract address.
+   * @throws If no loaded market contains the given credit manager.
+   **/
   findByCreditManager(creditManager) {
     const addr = creditManager.toLowerCase();
     const market = this.markets.find(
@@ -246,6 +301,11 @@ class MarketRegister extends import_base.SDKConstruct {
     }
     return market;
   }
+  /**
+   * Finds the market that uses the given price oracle.
+   * @param address - Price oracle contract address.
+   * @throws If no loaded market uses the given oracle.
+   **/
   findByPriceOracle(address) {
     const addr = address.toLowerCase();
     for (const market of this.markets) {
@@ -255,6 +315,11 @@ class MarketRegister extends import_base.SDKConstruct {
     }
     throw new Error(`cannot find market for price oracle ${address}`);
   }
+  /**
+   * Finds the market associated with the given pool.
+   * @param address - Pool contract address.
+   * @throws If no loaded market uses the given pool.
+   **/
   findByPool(address) {
     const addr = address.toLowerCase();
     for (const market of this.markets) {
@@ -264,9 +329,15 @@ class MarketRegister extends import_base.SDKConstruct {
     }
     throw new Error(`cannot find market for pool ${address}`);
   }
+  /**
+   * Underlying address map of pool address to market suite
+   **/
   get marketsMap() {
     return this.#markets;
   }
+  /**
+   * All loaded market suites.
+   **/
   get markets() {
     return this.#markets.values();
   }

package/dist/cjs/sdk/market/credit/CreditFacadeV310Contract.js

@@ -91,6 +91,12 @@ class CreditFacadeV310Contract extends import_CreditFacadeV310BaseContract.Credi
       args: [ca, calls]
     });
   }
+  botMulticall(ca, calls) {
+    return this.createRawTx({
+      functionName: "botMulticall",
+      args: [ca, calls]
+    });
+  }
   openCreditAccount(to, calls, referralCode) {
     return this.createRawTx({
       functionName: "openCreditAccount",

package/dist/cjs/sdk/market/oracle/PriceOracleBaseContract.js

@@ -43,26 +43,26 @@ const ZERO_PRICE_FEED = (0, import_viem.stringToHex)("PRICE_FEED::ZERO", { size:
 class PriceOracleBaseContract extends import_base.BaseContract {
   sdk;
   /**
-   * Mapping Token => [PriceFeed Address, stalenessPeriod]
-   */
+   * {@inheritDoc IPriceOracleContract.mainPriceFeeds}
+   **/
   mainPriceFeeds = new import_utils.AddressMap(
     void 0,
     "mainPriceFeeds"
   );
   /**
-   * Mapping Token => [PriceFeed Address, stalenessPeriod]
-   */
+   * {@inheritDoc IPriceOracleContract.reservePriceFeeds}
+   **/
   reservePriceFeeds = new import_utils.AddressMap(
     void 0,
     "reservePriceFeeds"
   );
   /**
-   * Mapping Token => Price in USD
-   */
+   * {@inheritDoc IPriceOracleContract.mainPrices}
+   **/
   mainPrices = new import_PriceFeedAnswerMap.default(void 0, "mainPrices");
   /**
-   * Mapping Token => Price in USD
-   */
+   * {@inheritDoc IPriceOracleContract.reservePrices}
+   **/
   reservePrices = new import_PriceFeedAnswerMap.default(
     void 0,
     "reservePrices"
@@ -78,11 +78,8 @@ class PriceOracleBaseContract extends import_base.BaseContract {
     this.#loadState(priceFeedMap, priceFeedTree);
   }
   /**
-   * Returns main and reserve price feeds for given tokens
-   * @param tokens
-   * @param opts Option to include main/reserve feeds only, defaults to both
-   * @returns
-   */
+   * {@inheritDoc IPriceOracleContract.priceFeedsForTokens}
+   **/
   priceFeedsForTokens(tokens, opts) {
     const main = opts?.main ?? true;
     const reserve = opts?.reserve ?? true;
@@ -92,39 +89,26 @@ class PriceOracleBaseContract extends import_base.BaseContract {
     ]).filter((f) => !!f);
   }
   /**
-   * Gets main price for given token
-   * Throws if token price feed is not found or answer is not successful
-   * @param token
-   * @returns
-   */
+   * {@inheritDoc IPriceOracleContract.mainPrice}
+   **/
   mainPrice(token) {
     return this.mainPrices.price(token);
   }
   /**
-   * Gets reserve price for given token
-   * Throws if token price feed is not found or answer is not successful
-   * @param token
-   * @returns
-   */
+   * {@inheritDoc IPriceOracleContract.reservePrice}
+   **/
   reservePrice(token) {
     return this.reservePrices.price(token);
   }
   /**
-   * Returns true if oracle's price feed tree contains given price feed
-   * This feed is not necessary connected to token, but can be a component of composite feed for some token
-   * @param priceFeed
-   * @returns
-   */
+   * {@inheritDoc IPriceOracleContract.usesPriceFeed}
+   **/
   usesPriceFeed(priceFeed) {
     return this.#priceFeedTree.has(priceFeed);
   }
   /**
-   * Tries to convert amount of from one token to another, using latest known prices
-   * @param from
-   * @param to
-   * @param amount
-   * @param reserve use reserve price feed instead of main
-   */
+   * {@inheritDoc IPriceOracleContract.convert}
+   **/
   convert(from, to, amount, reserve = false) {
     if (from === to) {
       return amount;
@@ -136,11 +120,8 @@ class PriceOracleBaseContract extends import_base.BaseContract {
     return amount * fromPrice * toScale / (toPrice * fromScale);
   }
   /**
-   * Tries to convert amount of token to USD, using latest known prices
-   * @param from
-   * @param amount
-   * @param reserve use reserve price feed instead of main
-   */
+   * {@inheritDoc IPriceOracleContract.convertToUSD}
+   **/
   convertToUSD(from, amount, reserve = false) {
     if (amount === 0n) {
       return 0n;
@@ -150,11 +131,8 @@ class PriceOracleBaseContract extends import_base.BaseContract {
     return amount * price / scale;
   }
   /**
-   * Tries to convert amount of USD to token, using latest known prices
-   * @param to
-   * @param amount
-   * @param reserve use reserve price feed instead of main
-   */
+   * {@inheritDoc IPriceOracleContract.convertFromUSD}
+   **/
   convertFromUSD(to, amount, reserve = false) {
     if (amount === 0n) {
       return 0n;
@@ -164,14 +142,14 @@ class PriceOracleBaseContract extends import_base.BaseContract {
     return amount * scale / price;
   }
   /**
-   * All price feed tree nodes known to this oracle
-   */
+   * {@inheritDoc IPriceOracleContract.priceFeeds}
+   **/
   get priceFeeds() {
     return this.#priceFeedTree.values().map((node) => this.sdk.priceFeeds.mustGet(node.baseParams.addr));
   }
   /**
-   * Paired method to updatePrices, helps to update prices on all oracles in one multicall
-   */
+   * {@inheritDoc IPriceOracleContract.syncStateMulticall}
+   **/
   syncStateMulticall() {
     const args = [this.address];
     const [address] = this.sdk.addressProvider.mustGetLatest(
@@ -237,11 +215,14 @@ class PriceOracleBaseContract extends import_base.BaseContract {
     });
   }
   /**
-   * Returns list of addresses that should be watched for events to sync state
-   */
+   * {@inheritDoc IPriceOracleContract.watchAddresses}
+   **/
   get watchAddresses() {
     return /* @__PURE__ */ new Set([this.address]);
   }
+  /**
+   * {@inheritDoc IPriceOracleContract.stateHuman}
+   **/
   stateHuman(raw = true) {
     return {
       ...super.stateHuman(raw),

package/dist/cjs/sdk/market/pricefeeds/PriceFeedRef.js

@@ -24,7 +24,14 @@ module.exports = __toCommonJS(PriceFeedRef_exports);
 var import_base = require("../../base/index.js");
 var import_utils = require("../../utils/index.js");
 class PriceFeedRef extends import_base.Construct {
+  /**
+   * On-chain address of the referenced price feed contract.
+   **/
   address;
+  /**
+   * Maximum allowed age (in seconds) of the feed's answer before the
+   * oracle considers it stale.
+   **/
   stalenessPeriod;
   #priceFeed;
   constructor(options, address, stalenessPeriod) {
@@ -32,6 +39,10 @@ class PriceFeedRef extends import_base.Construct {
     this.address = address;
     this.stalenessPeriod = stalenessPeriod;
   }
+  /**
+   * Lazily resolved price feed contract instance.
+   * @throws If the feed is not registered in the contracts register.
+   **/
   get priceFeed() {
     if (!this.#priceFeed) {
       this.#priceFeed = this.register.mustGetContract(
@@ -40,6 +51,11 @@ class PriceFeedRef extends import_base.Construct {
     }
     return this.#priceFeed;
   }
+  /**
+   * Returns a human-readable snapshot of the feed state, including the
+   * staleness period formatted as a duration string.
+   * @param raw - When `true`, includes raw/unformatted values.
+   **/
   stateHuman(raw = true) {
     return {
       ...this.priceFeed.stateHuman(raw),

package/dist/cjs/sdk/market/pricefeeds/PriceFeedsRegister.js

@@ -49,17 +49,29 @@ var import_YearnPriceFeed = require("./YearnPriceFeed.js");
 var import_ZeroPriceFeed = require("./ZeroPriceFeed.js");
 class PriceFeedRegister extends import_base.SDKConstruct {
   #hooks = new import_internal.Hooks();
+  #updaters;
   #feeds = new import_utils.AddressMap(void 0, "priceFeeds");
   #latestUpdate;
-  updaters;
   constructor(sdk, opts = {}) {
     super(sdk);
-    this.updaters = [
+    this.#updaters = [
       new import_updates.PythUpdater(sdk, opts?.pyth),
       new import_updates.RedstoneUpdater(sdk, opts?.redstone)
     ];
   }
+  /**
+   * @internal
+   * Registers a callback for price-feed register lifecycle events.
+   * @param event - Event name.
+   * @param handler - Callback to invoke.
+   **/
   addHook = this.#hooks.addHook.bind(this.#hooks);
+  /**
+   * @internal
+   * Removes a previously registered hook.
+   * @param event - Event name.
+   * @param handler - Callback to remove.
+   **/
   removeHook = this.#hooks.removeHook.bind(this.#hooks);
   /**
    * Returns all price feeds known to sdk
@@ -68,12 +80,13 @@ class PriceFeedRegister extends import_base.SDKConstruct {
     return this.#feeds.values();
   }
   /**
-   * Returns RawTxs to update price feeds
-   * @param priceFeeds Array oftop-level price feeds, actual updatable price feeds will be derived.
-   * Or filter criteria, that will gather all main or reserve price feeds from all oracles
-   * If not provided will use all price feeds that are attached
-   * @returns
-   */
+   * Generates transactions to push fresh off-chain prices to updatable feeds.
+   *
+   * @param priceFeeds - Top-level price feeds whose updatable dependencies
+   *   will be resolved, or a filter (`{ main: true }` / `{ reserve: true }`)
+   *   to gather feeds from all oracles. When omitted, all registered feeds
+   *   are used.
+   **/
   async generatePriceFeedsUpdateTxs(priceFeeds) {
     let updateables = this.#feeds.values();
     let filterRemark = "";
@@ -94,7 +107,7 @@ class PriceFeedRegister extends import_base.SDKConstruct {
       timestamp: Math.floor(Date.now() / 1e3)
     };
     const updates = (await Promise.all(
-      this.updaters.map((u) => u.getUpdateTxs(updateables).catch(() => []))
+      this.#updaters.map((u) => u.getUpdateTxs(updateables).catch(() => []))
     )).flat();
     let maxTimestamp = 0;
     for (const tx of updates) {
@@ -144,7 +157,7 @@ class PriceFeedRegister extends import_base.SDKConstruct {
     });
   }
   /**
-   * Similar to {@link generatePriceFeedsUpdateTxs}, but will generate necessary price update transactions for external price feeds
+   * Similar to {@link generatePriceFeedsUpdateTxs}, but will generate necessary price update transactions for external price feeds (not known to sdk)
    * This does not add feeds to this register, so they won't be implicitly included in future generatePriceFeedsUpdateTxs calls
    * @param feeds
    * @param block
@@ -181,12 +194,32 @@ class PriceFeedRegister extends import_base.SDKConstruct {
     );
     return (0, import_getRawPriceUpdates.getRawPriceUpdates)(updates);
   }
+  /**
+   * Checks whether a price feed is already registered at the given address.
+   * @param address - On-chain address to look up.
+   **/
   has(address) {
     return this.#feeds.has(address);
   }
+  /**
+   * Returns the cached price feed contract at the given address.
+   * @param address - On-chain address to look up.
+   * @throws If no feed is registered at that address.
+   **/
   mustGet(address) {
     return this.#feeds.mustGet(address);
   }
+  /**
+   * Inserts or updates a price feed from a full tree node.
+   *
+   * If a fully loaded feed already exists at the same address, only the
+   * answer is refreshed. Otherwise a new contract wrapper is created and
+   * cached.
+   *
+   * @param data - Full price feed tree node from the compressor.
+   * @returns The cached (or newly created) feed instance.
+   * @throws If the created feed is only partially initialized.
+   **/
   upsert(data) {
     const existing = this.#feeds.get(data.baseParams.addr);
     if (existing?.loaded) {
@@ -233,6 +266,14 @@ class PriceFeedRegister extends import_base.SDKConstruct {
     );
     return result.map((baseParams) => this.#createUpdatableProxy({ baseParams }));
   }
+  /**
+   * Instantiates the appropriate price feed contract wrapper based on
+   * the `contractType` discriminator in the node's base params.
+   *
+   * @param data - Partial or full price feed tree node.
+   * @returns A new (uncached) feed contract instance.
+   * @throws If the contract type is unsupported and strict mode is enabled.
+   **/
   create(data) {
     const contractType = (0, import_utils.bytes32ToString)(
       data.baseParams.contractType
@@ -296,8 +337,10 @@ class PriceFeedRegister extends import_base.SDKConstruct {
     });
   }
   /**
-   * Information update latest update of updatable price feeds, for diagnostic purposes
-   */
+   * @internal
+   * Diagnostic snapshot of the most recent price-update round, or
+   * `undefined` if no updates have been generated yet.
+   **/
   get latestUpdate() {
     return this.#latestUpdate;
   }

package/dist/cjs/sdk/options.js

@@ -26,50 +26,56 @@ var import_updates = require("./market/pricefeeds/updates/index.js");
 var import_utils = require("./utils/index.js");
 const SDKOptions = import_v4.z.object({
   /**
-   * If not set, address provider address is determinted automatically from networkType
-   */
+   * Override address of the Gearbox AddressProvider contract.
+   * If not set, uses default universal address provider address {@link ADDRESS_PROVIDER_V310}
+   **/
   addressProvider: (0, import_utils.ZodAddress)().optional(),
   /**
-   * Market configurators
-   */
+   * Addresses of market configurator contracts to load.
+   * If not set, all default market configurators for the chain are loaded
+   * (from {@link GearboxChain.defaultMarketConfigurators})
+   **/
   marketConfigurators: import_v4.z.array((0, import_utils.ZodAddress)()).optional(),
   /**
-   * Attach and load state at this specific block number
-   */
+   * Pin SDK to a specific block number during attach.
+   * When set, all on-chain reads use this block instead of `latest`.
+   **/
   blockNumber: import_v4.z.union([import_v4.z.bigint().nonnegative(), import_v4.z.number().int().nonnegative()]).optional(),
   /**
-   * Will skip updateable prices on attach and sync
-   * Makes things faster when your service is not intereseted in prices
-   */
+   * Skip fetching updatable price feeds on attach and sync.
+   * Speeds up initialisation when prices are not needed.
+   **/
   ignoreUpdateablePrices: import_v4.z.boolean().optional(),
   /**
-   * Will skip loading markets for these pools on attach/hydrate/sync
-   */
+   * Pool addresses whose markets should be skipped during attach/hydrate/sync.
+   **/
   ignoreMarkets: import_v4.z.array((0, import_utils.ZodAddress)()).optional(),
   /**
-   * Will throw an error if contract type is not supported, otherwise will try to use generic contract first, if possible
-   */
+   * When `true`, throw on unrecognised contract types instead of falling
+   * back to a generic contract wrapper.
+   **/
   strictContractTypes: import_v4.z.boolean().optional(),
   /**
-   * Plugins to extends SDK functionality
-   */
+   * Plugins that extend SDK functionality.
+   **/
   plugins: import_v4.z.record(import_v4.z.string(), import_v4.z.any()).optional(),
   /**
-   * Bring your own logger
-   */
+   * Custom logger implementation.
+   **/
   logger: import_v4.z.any(),
   /**
-   * Options related to redstone price feeds
-   */
+   * Options for Redstone price-feed updates.
+   **/
   redstone: import_updates.RedstoneOptions.optional(),
   /**
-   * Options related to pyth price feeds
-   */
+   * Options for Pyth price-feed updates.
+   **/
   pyth: import_updates.PythOptions.optional(),
   /**
-   * Explicit gas limit for read eth_calls
-   * Null to disable explicitly setting gas limit, undefined to use default sdk value
-   */
+   * Explicit gas limit for read-only `eth_call` requests.
+   * `null` disables the gas limit entirely; `undefined` uses the SDK default.
+   * Default gas limit is 550_000_000 (550M).
+   **/
   gasLimit: import_v4.z.bigint().nonnegative().nullable().optional()
 });
 // Annotate the CommonJS export names for ESM import in node:

package/dist/cjs/sdk/plugins/BasePlugin.js

@@ -24,11 +24,23 @@ module.exports = __toCommonJS(BasePlugin_exports);
 class BasePlugin {
   #sdk;
   logger;
+  /**
+   * Plugin state version for hydration compatibility checks.
+   * @default 1
+   **/
   version = 1;
+  /**
+   * When `true`, state is fetched eagerly during the `attach` phase
+   * rather than waiting for an explicit `load` call.
+   **/
   loadOnAttach;
   constructor(loadOnAttach = false) {
     this.loadOnAttach = loadOnAttach;
   }
+  /**
+   * Reference to the parent SDK instance.
+   * @throws Error if the SDK has not been attached yet.
+   **/
   get sdk() {
     if (!this.#sdk) {
       throw new Error("SDK is not attached");
@@ -42,17 +54,29 @@ class BasePlugin {
     this.#sdk = sdk;
     this.logger = sdk.logger?.child?.({ name: this.constructor.name }) ?? sdk.logger;
   }
+  /**
+   * {@inheritDoc IGearboxSDKPlugin.attach}
+   **/
   async attach() {
     if (this.loadOnAttach) {
       await this.load(true);
     }
   }
+  /**
+   * {@inheritDoc IGearboxSDKPlugin.syncState}
+   **/
   async syncState() {
     await this.load(false);
   }
+  /**
+   * Network type of the connected chain (e.g. `"Mainnet"`, `"Arbitrum"`).
+   **/
   get network() {
     return this.sdk.networkType;
   }
+  /**
+   * Viem public client for read-only chain interactions.
+   **/
   get client() {
     return this.sdk.client;
   }

package/dist/cjs/sdk/pools/AbstractPoolService.js

@@ -33,6 +33,9 @@ class AbstractPoolService extends import_base.SDKConstruct {
     this.#version = version;
     this.logger?.debug(`Created PoolService with version: ${this.#version}`);
   }
+  /**
+   * {@inheritDoc IPoolsService.addLiquidity}
+   **/
   addLiquidity({
     collateral,
     pool,
@@ -89,6 +92,9 @@ class AbstractPoolService extends import_base.SDKConstruct {
       ];
     }
   }
+  /**
+   * {@inheritDoc IPoolsService.removeLiquidity}
+   **/
   removeLiquidity({
     pool,
     amount,