@gearbox-protocol/sdk 11.11.3 → 12.0.0-next.1

package/dist/cjs/sdk/GearboxSDK.js

@@ -70,10 +70,9 @@ async function attachClient(options, network) {
   }
   return createClient(options, { networkType, chainId });
 }
-class GearboxSDK {
+class GearboxSDK extends import_base.ChainContractsRegister {
   #hooks = new import_internal.Hooks();
   plugins;
-  #client;
   // Block which was use for data query
   #currentBlock;
   #timestamp;
@@ -84,29 +83,11 @@ class GearboxSDK {
   // Collection of markets
   #marketRegister;
   #priceFeeds;
-  logger;
   gasLimit;
-  addressLabels = new import_base.AddressLabeller();
-  /**
-   * Interest rate models can be reused across chain (and SDK operates on chain level)
-   * TODO: use whatever interface is necessary for InterestRateModels
-   */
-  interestRateModels = new import_utils.AddressMap();
   /**
    * Will throw an error if contract type is not supported, otherwise will try to use generic contract first, if possible
    */
   strictContractTypes;
-  /**
-   * All contracts known to sdk
-   */
-  contracts = new import_utils.AddressMap(
-    void 0,
-    "contracts"
-  );
-  /**
-   * Token metadata such as symbol and decimals
-   */
-  tokensMeta;
   addHook = this.#hooks.addHook.bind(this.#hooks);
   removeHook = this.#hooks.removeHook.bind(this.#hooks);
   static async attach(options) {
@@ -159,17 +140,16 @@ class GearboxSDK {
     }).#hydrate(rest, state);
   }
   constructor(options) {
-    this.logger = options.logger;
+    super(options.client, options.logger);
     this.strictContractTypes = options.strictContractTypes ?? false;
     this.plugins = options.plugins ?? {};
-    this.#client = options.client;
     for (const plugin of Object.values(this.plugins)) {
       plugin.sdk = this;
     }
     if (options.gasLimit !== null) {
       this.gasLimit = options.gasLimit || 550000000n;
     }
-    this.tokensMeta = new import_base.TokensMeta(this);
+    Object.assign(this, import_base.ChainContractsRegister.for(this.client, this.logger));
   }
   async #attach(opts) {
     const {
@@ -325,74 +305,9 @@ class GearboxSDK {
       timestamp: state.timestamp
     });
   }
-  get client() {
-    return this.#client;
-  }
-  /**
-   * Replaces client inflight
-   * You're responsible for all inconsistencies between new and old client
-   * @param options
-   */
-  replaceClient(options, network) {
-    this.#client = createClient(options, network);
-  }
   get networkType() {
     return this.client.chain.network;
   }
-  get chain() {
-    return this.client.chain;
-  }
-  get chainId() {
-    return this.client.chain.id;
-  }
-  /**
-   * Converts contract call into some human-friendly string
-   * This method is safe and should not throw
-   * @param address
-   * @param calldata
-   * @returns
-   */
-  parseFunctionData(address, calldata) {
-    const contract = this.contracts.get(address);
-    return contract ? contract.parseFunctionData(calldata) : `unknown: ${address}.${calldata.slice(0, 10)}`;
-  }
-  /**
-   * Converts multicalls into some human-friendly strings
-   * This method is safe and should not throw
-   * @param address
-   * @param calldata
-   * @returns
-   */
-  parseMultiCall(calls) {
-    return calls.map(
-      (call) => this.parseFunctionData(call.target, call.callData)
-    );
-  }
-  /**
-   * Return args, function, type and address name from contract call
-   * @param address
-   * @param calldata
-   * @returns
-   */
-  parseFunctionDataToObject(address, calldata) {
-    const contract = this.contracts.get(address);
-    return contract ? {
-      ...contract.parseFunctionDataToObject(calldata),
-      address,
-      type: contract.contractType
-    } : null;
-  }
-  /**
-   * Converts multicalls into call info
-   * @param address
-   * @param calldata
-   * @returns
-   */
-  parseMultiCallToObject(calls) {
-    return calls.map(
-      (call) => this.parseFunctionDataToObject(call.target, call.callData)
-    );
-  }
   stateHuman(raw = true) {
     return {
       block: Number(this.currentBlock),
@@ -484,7 +399,7 @@ class GearboxSDK {
         address: watchAddresses
       });
       for (const log of logs) {
-        const contract = this.contracts.get(log.address);
+        const contract = this.getContract(log.address);
         if (contract) {
           const event = (0, import_viem.parseEventLogs)({
             abi: contract.abi,
@@ -573,17 +488,11 @@ class GearboxSDK {
   }
   get botListContract() {
     const addr = this.addressProvider.getAddress(import_constants.AP_BOT_LIST, import_constants.NO_VERSION);
-    if (!this.contracts.has(addr)) {
-      return new import_core.BotListContract(this, addr);
-    }
-    return this.contracts.get(addr);
+    return this.getContract(addr) ?? new import_core.BotListContract(this, addr);
   }
   get gearStakingContract() {
     const addr = this.addressProvider.getAddress(import_constants.AP_GEAR_STAKING, import_constants.NO_VERSION);
-    if (!this.contracts.has(addr)) {
-      return new import_core.GearStakingContract(this, addr);
-    }
-    return this.contracts.get(addr);
+    return this.getContract(addr) ?? new import_core.GearStakingContract(this, addr);
   }
   get marketRegister() {
     if (this.#marketRegister === void 0) {
@@ -610,7 +519,7 @@ class GearboxSDK {
         );
         facadeAddr = cm.creditFacade.address;
       }
-      const facadeV = this.contracts.mustGet(facadeAddr).version;
+      const facadeV = this.mustGetContract(facadeAddr).version;
       routerRange = (0, import_constants.isV310)(facadeV) ? import_constants.VERSION_RANGE_310 : import_constants.VERSION_RANGE_300;
     }
     const routerEntry = this.addressProvider.getLatest(import_constants.AP_ROUTER, routerRange);
@@ -618,18 +527,7 @@ class GearboxSDK {
       throw new Error(`router not found in version range ${routerRange}`);
     }
     const [routerAddr, routerV] = routerEntry;
-    if (!this.contracts.has(routerAddr)) {
-      return (0, import_router.createRouter)(this, routerAddr, routerV);
-    }
-    return this.contracts.get(routerAddr);
-  }
-  /**
-   * Helper to get human-friendly label for address
-   * @param address
-   * @returns
-   */
-  labelAddress(address) {
-    return this.addressLabels.get(address);
+    return (0, import_router.createRouter)(this, routerAddr, routerV);
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/cjs/sdk/accountMigration/AbstractMigrateCreditAccountsService.js

@@ -27,9 +27,7 @@ var import_createCreditAccountService = require("../accounts/createCreditAccount
 var import_base = require("../base/index.js");
 var import_chains = require("../chain/chains.js");
 var import_versions = require("../constants/versions.js");
-var import_utils = require("../utils/index.js");
 class AbstractMigrateCreditAccountsService extends import_base.SDKConstruct {
-  #logger;
   #version;
   #service;
   // TODO: HARDCODED
@@ -47,8 +45,7 @@ class AbstractMigrateCreditAccountsService extends import_base.SDKConstruct {
     super(sdk);
     this.#version = version;
     this.#service = (0, import_createCreditAccountService.createCreditAccountService)(this.sdk, version);
-    this.#logger = (0, import_utils.childLogger)("MigrateCreditAccountsService", sdk.logger);
-    this.#logger?.debug(
+    this.logger?.debug(
       `Created MigrateCreditAccountsService with version: ${this.#version}`
     );
   }

package/dist/cjs/sdk/accounts/AbstractCreditAccountsService.js

@@ -43,7 +43,6 @@ function getWithdrawalCompressorAddress(chainId) {
 class AbstractCreditAccountService extends import_base.SDKConstruct {
   #compressor;
   #batchSize;
-  #logger;
   constructor(sdk, options) {
     super(sdk);
     [this.#compressor] = sdk.addressProvider.mustGetLatest(
@@ -51,8 +50,7 @@ class AbstractCreditAccountService extends import_base.SDKConstruct {
       import_constants.VERSION_RANGE_310
     );
     this.#batchSize = options?.batchSize;
-    this.#logger = (0, import_utils.childLogger)("CreditAccountsService", sdk.logger);
-    this.#logger?.debug(
+    this.logger?.debug(
       `credit account compressor address: ${this.#compressor}`
     );
   }
@@ -154,7 +152,7 @@ class AbstractCreditAccountService extends import_base.SDKConstruct {
         offset = newOffset;
       } while (offset !== 0n);
     }
-    this.#logger?.debug(
+    this.logger?.debug(
       `loaded ${allCAs.length} credit accounts (${allCAs.length - revertingOffset} reverting)`
     );
     return allCAs.sort((a, b) => Number(a.healthFactor - b.healthFactor));
@@ -288,7 +286,7 @@ class AbstractCreditAccountService extends import_base.SDKConstruct {
       lossPolicyData = await market.lossPolicy.getLiquidationData(
         account.creditAccount
       );
-      this.#logger?.debug({ lossPolicyData }, "loss policy data");
+      this.logger?.debug({ lossPolicyData }, "loss policy data");
     }
     const tx = cm.creditFacade.liquidateCreditAccount(
       account.creditAccount,
@@ -846,7 +844,7 @@ class AbstractCreditAccountService extends import_base.SDKConstruct {
         gas: this.sdk.gasLimit
       });
     }
-    this.#logger?.debug(
+    this.logger?.debug(
       {
         accounts: resp[0]?.length ?? 0,
         nextOffset: Number(resp[1])
@@ -926,7 +924,7 @@ class AbstractCreditAccountService extends import_base.SDKConstruct {
     });
     const tStr = Array.from(tokens).map((t) => this.labelAddress(t)).join(", ");
     const remark = ignoreReservePrices ? " main" : "";
-    this.#logger?.debug(
+    this.logger?.debug(
       { account: creditAccount?.creditAccount, manager: cm.name },
       `generating price feed updates for ${tStr} from ${priceFeeds.length}${remark} price feeds`
     );
@@ -942,7 +940,7 @@ class AbstractCreditAccountService extends import_base.SDKConstruct {
     const market = this.sdk.marketRegister.findByCreditManager(creditManager);
     const cm = this.sdk.marketRegister.findCreditManager(creditManager);
     const update = await this.getUpdateForAccount(options);
-    this.#logger?.debug(
+    this.logger?.debug(
       { account: creditAccount?.creditAccount, manager: cm.name },
       `getting on demand price updates from ${update.txs.length} txs`
     );

package/dist/cjs/sdk/base/BaseContract.js

@@ -18,66 +18,61 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var BaseContract_exports = {};
 __export(BaseContract_exports, {
-  BaseContract: () => BaseContract
+  BaseContract: () => BaseContract,
+  ContractParseError: () => ContractParseError
 });
 module.exports = __toCommonJS(BaseContract_exports);
 var import_viem = require("viem");
 var import_errors = require("../../abi/errors.js");
-var import_iVersion = require("../../abi/iVersion.js");
-var import_constants = require("../constants/index.js");
 var import_utils = require("../utils/index.js");
-var import_SDKConstruct = require("./SDKConstruct.js");
-class BaseContract extends import_SDKConstruct.SDKConstruct {
+var import_Construct = require("./Construct.js");
+class ContractParseError extends import_viem.BaseError {
+  address;
+  callData;
+  selector;
+  constructor(cause, options) {
+    const { address, callData, contractName } = options;
+    const selector = callData.slice(0, 10);
+    super(
+      `failed to parse function data for ${contractName ?? "unknown contract"} at ${address} with selector ${selector}`,
+      {
+        cause
+      }
+    );
+    this.callData = callData;
+    this.selector = selector;
+    this.address = address;
+  }
+}
+class BaseContract extends import_Construct.Construct {
   contract;
   abi;
-  logger;
   contractType;
   version;
-  #name;
-  #address;
-  constructor(sdk, args) {
-    super(sdk);
+  address;
+  name;
+  constructor({ client, logger }, args) {
+    super({ client, logger });
     this.abi = args.abi;
-    this.#address = (0, import_viem.getAddress)(args.addr);
+    this.address = (0, import_viem.getAddress)(args.addr);
     this.contract = (0, import_viem.getContract)({
       address: this.address,
       // add exceptions for better error decoding
       abi: [...this.abi, ...import_errors.errorAbis],
-      client: {
-        public: sdk.client
-      }
+      client
     });
     this.version = Number(args.version || 0);
     this.contractType = args.contractType ?? "";
     if ((0, import_viem.isHex)(this.contractType)) {
       this.contractType = (0, import_utils.bytes32ToString)(this.contractType);
     }
-    this.name = this.#name = args.name || this.contractType || this.#address;
-    this.logger = (0, import_utils.childLogger)(this.name, sdk.logger);
-    sdk.contracts.upsert(this.address, this);
-  }
-  get address() {
-    return this.#address;
-  }
-  set address(address) {
-    if (this.#address !== import_constants.ADDRESS_0X0) {
-      throw new Error(`Address can't be changed, currently: ${this.#address}`);
-    }
-    this.#address = (0, import_viem.getAddress)(address);
-    this.sdk.addressLabels.set(address, this.#name);
-  }
-  get name() {
-    return this.#name;
-  }
-  set name(name) {
-    this.#name = name;
-    if (this.#address !== import_constants.ADDRESS_0X0) {
-      this.sdk.addressLabels.set(this.#address, name);
-    }
+    this.name = args.name || this.contractType || this.address || this.constructor.name;
+    this.register.setContract(this.address, this);
+    this.register.setAddressLabel(this.address, this.name);
   }
   stateHuman(_ = true) {
     return {
-      address: this.sdk.labelAddress(this.address),
+      address: this.labelAddress(this.address),
       version: this.version,
       contractType: this.contractType
     };
@@ -89,14 +84,68 @@ class BaseContract extends import_SDKConstruct.SDKConstruct {
   processLog(_log) {
   }
   /**
-   * Converts contract calldata to some human-friendly string
-   * This is safe function which should not throw
+   * Return parsed args and function name from calldata belonging to this contract
+   * Target of the call is always this contract, but args can be parsed into calls to other contracts (de-facto recursive ParsedCall)
    * @param calldata
    * @returns
    */
   parseFunctionData(calldata) {
     try {
       return this.mustParseFunctionData(calldata);
+    } catch (e) {
+      this.logger?.warn(e);
+      return {
+        chainId: this.chainId,
+        target: this.address,
+        contractType: this.contractType,
+        label: this.name,
+        functionName: `Unknown function: ${calldata}`,
+        args: {}
+      };
+    }
+  }
+  /**
+   * Same as {@link parseFunctionData}, but throws {@link ContractParseError} if error occurs
+   * @param callData
+   * @returns
+   */
+  mustParseFunctionData(callData) {
+    try {
+      const decoded = (0, import_viem.decodeFunctionData)({
+        abi: this.abi,
+        data: callData
+      });
+      return this.wrapParseCall(
+        decoded.functionName,
+        this.parseFunctionParams(decoded)
+      );
+    } catch (e) {
+      throw new ContractParseError(e, {
+        address: this.address,
+        callData,
+        contractName: this.name
+      });
+    }
+  }
+  /**
+   * Parses viem-decoded contract function arguments to a map of named arguments
+   * This default implementation uses abi-based parsing, you can override it,
+   * but use this super implementation as fallback
+   * @param params
+   * @returns
+   */
+  parseFunctionParams(params) {
+    return (0, import_utils.functionArgsToMap)(this.abi, params.functionName, params.args);
+  }
+  /**
+   * Converts contract calldata to some human-friendly string
+   * This is safe function which should not throw
+   * @param calldata
+   * @returns
+   */
+  stringifyFunctionData(calldata) {
+    try {
+      return this.mustStringifyFunctionData(calldata);
     } catch (e) {
       const selector = calldata.slice(0, 10);
       this.logger?.warn(
@@ -105,59 +154,64 @@ class BaseContract extends import_SDKConstruct.SDKConstruct {
       return `unknown: ${this.labelAddress(this.address)}.${selector}`;
     }
   }
-  mustParseFunctionData(calldata) {
+  /**
+   * Same as {@link stingifyFunctionData}, but throws if error occurs
+   * @param calldata
+   * @returns
+   */
+  mustStringifyFunctionData(calldata) {
     const decoded = (0, import_viem.decodeFunctionData)({
       abi: this.abi,
       data: calldata
     });
-    const abiItem = this.abi.find(
-      (abiItem2) => abiItem2?.name === decoded.functionName && abiItem2?.type === "function"
-    );
-    if (!abiItem) {
+    const abiItem = (0, import_viem.getAbiItem)({
+      abi: this.abi,
+      name: decoded.functionName,
+      args: decoded.args
+    });
+    if (!abiItem || abiItem.type !== "function") {
       return `Unknown function: ${decoded.functionName}`;
     }
-    let paramsHuman;
-    const humanParams = this.parseFunctionParams(decoded);
-    if (humanParams) {
-      paramsHuman = humanParams.map((value, i) => {
-        return `${abiItem.inputs[i].name}: ${value}`;
-      });
-    } else if (Array.isArray(decoded.args)) {
-      paramsHuman = decoded.args.map((value, i) => {
-        return `${abiItem.inputs[i].name}: ${abiItem.inputs[i].type === "address" ? this.labelAddress(value) : abiItem.inputs[i].type.startsWith("tuple") ? (0, import_utils.json_stringify)(value) : value}`;
-      });
-    } else {
-      paramsHuman = Object.entries(decoded.args || {}).map(
-        ([key, value]) => `${key}: ${value}`
-      );
-    }
-    return `${this.name}.${decoded.functionName}({${paramsHuman.join(", ")}})`;
+    const params = this.stringifyFunctionParams(decoded).map(
+      (v, i) => `${abiItem.inputs[i].name}: ${v}`
+    );
+    return `${this.name}.${decoded.functionName}({${params.join(", ")}})`;
   }
   /**
-   * Return args and function name from calldata
-   * @param calldata
+   * Pretty-prints values of function arguments (do not include parameter names)
+   * Can be overriden in classes, but use this super implementation as fallback
+   *
+   * @param decoded - Function arguments decoded by viem
    * @returns
    */
-  parseFunctionDataToObject(calldata) {
-    const decoded = (0, import_viem.decodeFunctionData)({
+  stringifyFunctionParams(decoded) {
+    const abiItem = (0, import_viem.getAbiItem)({
       abi: this.abi,
-      data: calldata
+      name: decoded.functionName,
+      args: decoded.args
     });
-    return decoded;
-  }
-  parseFunctionParams(_params) {
-    return void 0;
+    if (Array.isArray(decoded.args)) {
+      return decoded.args.map((v, i) => {
+        return abiItem.inputs[i].type === "address" ? this.labelAddress(v) : abiItem.inputs[i].type.startsWith("tuple") ? (0, import_utils.json_stringify)(v) : `${v}`;
+      });
+    }
+    return Object.entries(decoded.args || {}).map((v) => `${v}`);
   }
-  async getVersion() {
-    this.version = Number(
-      await this.sdk.client.readContract({
-        abi: import_iVersion.iVersionAbi,
-        functionName: "version",
-        address: this.address
-      })
-    );
-    return this.version;
+  wrapParseCall(functionName, args) {
+    return {
+      chainId: this.chainId,
+      target: this.address,
+      contractType: this.contractType,
+      label: this.register.labelAddress(this.address),
+      functionName,
+      args
+    };
   }
+  /**
+   * Creates a raw transaction for a function in this contract
+   * @param parameters
+   * @returns
+   */
   createRawTx(parameters) {
     const { description: argsDescription } = parameters;
     const tx = (0, import_utils.createRawTx)(
@@ -168,11 +222,72 @@ class BaseContract extends import_SDKConstruct.SDKConstruct {
       },
       argsDescription
     );
-    tx.description = argsDescription || this.parseFunctionData(tx.callData);
+    tx.description = argsDescription || this.stringifyFunctionData(tx.callData);
     return tx;
   }
+  /**
+   * Get events in safe manner, by bisecting block range if needed
+   *
+   * @deprecated TODO: this should be moved to viem transport
+   *
+   * @param eventName
+   * @param fromBlock
+   * @param toBlock
+   * @param args
+   * @param chunkSize
+   * @returns
+   */
+  async getEvents(eventName, fromBlock, toBlock, args, chunkSize) {
+    if (chunkSize) {
+      const chunkSizeBigint = BigInt(chunkSize);
+      const getEventPromises = [];
+      for (let i = fromBlock; i < toBlock; i += chunkSizeBigint) {
+        getEventPromises.push(
+          this.client.getContractEvents({
+            address: this.address,
+            fromBlock: i,
+            toBlock: i + chunkSizeBigint,
+            abi: this.abi,
+            eventName,
+            args
+          })
+        );
+      }
+      const events = (await Promise.all(getEventPromises)).flat();
+      return events;
+    }
+    try {
+      const events = await this.client.getContractEvents({
+        address: this.address,
+        fromBlock,
+        toBlock,
+        abi: this.abi,
+        eventName,
+        args
+      });
+      return events;
+    } catch (e) {
+      const blockRangeErrors = [
+        "query exceeds max block",
+        "range is too large",
+        "eth_getLogs is limited to",
+        "Unable to perform request",
+        "Block range limit exceeded"
+      ];
+      if (e instanceof Error && blockRangeErrors.some((errorText) => e.message.includes(errorText))) {
+        const middle = (fromBlock + toBlock) / 2n;
+        const [firstHalfEvents, secondHalfEvents] = await Promise.all([
+          this.getEvents(eventName, fromBlock, middle, args),
+          this.getEvents(eventName, middle + 1n, toBlock, args)
+        ]);
+        return [...firstHalfEvents, ...secondHalfEvents];
+      }
+      throw e;
+    }
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  BaseContract
+  BaseContract,
+  ContractParseError
 });