@gearbox-protocol/sdk 11.9.0 → 11.11.0-next.1

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

@@ -1,65 +1,66 @@
-import { decodeFunctionData, getAddress, getContract, isHex } from "viem";
+import {
+  BaseError,
+  decodeFunctionData,
+  getAbiItem,
+  getAddress,
+  getContract,
+  isHex
+} from "viem";
 import { errorAbis } from "../../abi/errors.js";
-import { iVersionAbi } from "../../abi/iVersion.js";
-import { ADDRESS_0X0 } from "../constants/index.js";
 import {
   bytes32ToString,
-  childLogger,
   createRawTx,
+  functionArgsToMap,
   json_stringify
 } from "../utils/index.js";
-import { SDKConstruct } from "./SDKConstruct.js";
-class BaseContract extends SDKConstruct {
+import { Construct } from "./Construct.js";
+class ContractParseError extends 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 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 = getAddress(args.addr);
+    this.address = getAddress(args.addr);
     this.contract = getContract({
       address: this.address,
       // add exceptions for better error decoding
       abi: [...this.abi, ...errorAbis],
-      client: {
-        public: sdk.client
-      }
+      client
     });
     this.version = Number(args.version || 0);
     this.contractType = args.contractType ?? "";
     if (isHex(this.contractType)) {
       this.contractType = bytes32ToString(this.contractType);
     }
-    this.name = this.#name = args.name || this.contractType || this.#address;
-    this.logger = childLogger(this.name, sdk.logger);
-    sdk.contracts.upsert(this.address, this);
-  }
-  get address() {
-    return this.#address;
-  }
-  set address(address) {
-    if (this.#address !== ADDRESS_0X0) {
-      throw new Error(`Address can't be changed, currently: ${this.#address}`);
-    }
-    this.#address = getAddress(address);
-    this.sdk.addressLabels.set(address, this.#name);
-  }
-  get name() {
-    return this.#name;
-  }
-  set name(name) {
-    this.#name = name;
-    if (this.#address !== 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
     };
@@ -71,14 +72,68 @@ class BaseContract extends 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 = 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 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(
@@ -87,59 +142,64 @@ class BaseContract extends 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 = decodeFunctionData({
       abi: this.abi,
       data: calldata
     });
-    const abiItem = this.abi.find(
-      (abiItem2) => abiItem2?.name === decoded.functionName && abiItem2?.type === "function"
-    );
-    if (!abiItem) {
+    const abiItem = 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") ? 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 = decodeFunctionData({
+  stringifyFunctionParams(decoded) {
+    const abiItem = 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") ? json_stringify(v) : `${v}`;
+      });
+    }
+    return Object.entries(decoded.args || {}).map((v) => `${v}`);
   }
-  async getVersion() {
-    this.version = Number(
-      await this.sdk.client.readContract({
-        abi: 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 = createRawTx(
@@ -150,10 +210,71 @@ class BaseContract extends 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;
+    }
+  }
 }
 export {
-  BaseContract
+  BaseContract,
+  ContractParseError
 };

package/dist/esm/sdk/base/ChainContractsRegister.js

@@ -0,0 +1,111 @@
+import { NOT_DEPLOYED } from "../constants/addresses.js";
+import { AddressMap } from "../utils/AddressMap.js";
+import { TokensMeta } from "./TokensMeta.js";
+class ChainContractsRegister {
+  static #chains = /* @__PURE__ */ new Map();
+  static for(client, logger) {
+    const chainId = client.chain.id;
+    let result = ChainContractsRegister.#chains.get(chainId);
+    if (!result) {
+      result = new ChainContractsRegister(client, logger);
+      ChainContractsRegister.#chains.set(chainId, result);
+    }
+    return result;
+  }
+  contracts = new AddressMap(
+    [],
+    "contracts"
+  );
+  labels = new AddressMap([], "labels");
+  client;
+  /**
+   * Token metadata such as symbol and decimals
+   */
+  tokensMeta;
+  logger;
+  constructor(client, logger) {
+    this.client = client;
+    this.tokensMeta = new TokensMeta(client);
+    this.logger = logger;
+  }
+  getContract(address) {
+    return this.contracts.get(address);
+  }
+  mustGetContract(address) {
+    const contract = this.contracts.mustGet(address);
+    if (!contract) {
+      throw new Error(`contract ${address} not found on chain ${this.chainId}`);
+    }
+    return contract;
+  }
+  setContract(address, contract) {
+    this.contracts.upsert(address, contract);
+  }
+  setAddressLabel(address, label) {
+    if (address === NOT_DEPLOYED) {
+      return;
+    }
+    if (typeof label === "string") {
+      this.labels.upsert(address, label);
+    } else {
+      this.labels.upsert(address, label(this.labels.get(address)));
+    }
+  }
+  labelAddress(address) {
+    const label = this.labels.get(address);
+    return label ? `${address} [${label}]` : address;
+  }
+  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
+   */
+  stringifyFunctionData(address, calldata) {
+    const contract = this.contracts.get(address);
+    return contract ? contract.stringifyFunctionData(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
+   */
+  stringifyMultiCall(calls) {
+    return calls.map(
+      (call) => this.stringifyFunctionData(call.target, call.callData)
+    );
+  }
+  /**
+   * Return args, function, type and address name from contract call
+   * @param address
+   * @param calldata
+   * @returns
+   */
+  parseFunctionData(address, calldata) {
+    const contract = this.mustGetContract(address);
+    return contract.parseFunctionData(calldata);
+  }
+  /**
+   * Converts multicalls into call info
+   * @param address
+   * @param calldata
+   * @returns
+   */
+  parseMultiCall(calls) {
+    return calls.map(
+      (call) => this.parseFunctionData(call.target, call.callData)
+    );
+  }
+}
+export {
+  ChainContractsRegister
+};

package/dist/esm/sdk/base/Construct.js

@@ -0,0 +1,63 @@
+import { childLogger } from "../utils/index.js";
+import { ChainContractsRegister } from "./ChainContractsRegister.js";
+class Construct {
+  logger;
+  client;
+  register;
+  /**
+   * Indicates that contract state needs to be updated
+   */
+  #dirty = false;
+  constructor({ client, logger }) {
+    this.client = client;
+    this.register = ChainContractsRegister.for(client, logger);
+    this.logger = childLogger(
+      this.constructor.name,
+      this.register.logger ?? logger
+    );
+  }
+  get chain() {
+    return this.client.chain;
+  }
+  get chainId() {
+    return this.client.chain.id;
+  }
+  get networkType() {
+    if ("network" in this.chain) {
+      return this.chain.network;
+    }
+    throw new Error(`chain ${this.chain.id} is not a Gearbox SDK chain`);
+  }
+  /**
+   * Indicates that contract state diverged from onchain state and needs to be updated
+   */
+  get dirty() {
+    return this.#dirty;
+  }
+  set dirty(value) {
+    this.#dirty = value;
+  }
+  /**
+   * Syntax sugar for rgister.tokensMeta
+   */
+  get tokensMeta() {
+    return this.register.tokensMeta;
+  }
+  /**
+   * Syntax suggar for getting contract labels
+   * @param address
+   * @returns
+   */
+  labelAddress(address) {
+    return this.register.labelAddress(address);
+  }
+  /**
+   * Returns list of addresses that should be watched for events to sync state
+   */
+  get watchAddresses() {
+    return /* @__PURE__ */ new Set();
+  }
+}
+export {
+  Construct
+};

package/dist/esm/sdk/base/SDKConstruct.js

@@ -1,36 +1,10 @@
-class SDKConstruct {
+import { Construct } from "./Construct.js";
+class SDKConstruct extends Construct {
   sdk;
-  /**
-   * Indicates that contract state needs to be updated
-   */
-  #dirty = false;
   constructor(sdk) {
+    super(sdk);
     this.sdk = sdk;
   }
-  get networkType() {
-    return this.sdk.networkType;
-  }
-  get client() {
-    return this.sdk.client;
-  }
-  /**
-   * Indicates that contract state needs to be updated
-   */
-  get dirty() {
-    return this.#dirty;
-  }
-  set dirty(value) {
-    this.#dirty = value;
-  }
-  labelAddress(address) {
-    return this.sdk.labelAddress(address);
-  }
-  /**
-   * Returns list of addresses that should be watched for events to sync state
-   */
-  get watchAddresses() {
-    return /* @__PURE__ */ new Set();
-  }
 }
 export {
   SDKConstruct

package/dist/esm/sdk/base/TokensMeta.js

@@ -2,11 +2,11 @@ import { iVersionAbi } from "../../abi/iVersion.js";
 import { bytes32ToString } from "../index.js";
 import { AddressMap, AddressSet, formatBN } from "../utils/index.js";
 class TokensMeta extends AddressMap {
-  #sdk;
+  #client;
   #phantomTokensLoaded;
-  constructor(sdk) {
+  constructor(client) {
     super(void 0, "tokensMeta");
-    this.#sdk = sdk;
+    this.#client = client;
   }
   symbol(token) {
     return this.mustGet(token).symbol;
@@ -61,7 +61,7 @@ class TokensMeta extends AddressMap {
   async loadPhantomTokens() {
     this.#phantomTokensLoaded = new AddressSet();
     const tokens = this.keys();
-    const resp = await this.#sdk.client.multicall({
+    const resp = await this.#client.multicall({
       contracts: tokens.map(
         (t) => ({
           address: t,

package/dist/esm/sdk/base/index.js

@@ -1,5 +1,6 @@
-export * from "./AddressLabeller.js";
 export * from "./BaseContract.js";
+export * from "./ChainContractsRegister.js";
+export * from "./Construct.js";
 export * from "./PlaceholderContract.js";
 export * from "./SDKConstruct.js";
 export * from "./TokensMeta.js";

package/dist/esm/sdk/core/BotListV3Contract.js

@@ -9,7 +9,7 @@ class BotListContract extends BaseContract {
     super(sdk, { addr: address, name: "BotListV3", abi });
     this.#currentBlock = sdk.chain.firstBlock ?? 0n;
   }
-  parseFunctionParams(params) {
+  stringifyFunctionParams(params) {
     switch (params.functionName) {
       case "setCreditManagerApprovedStatus": {
         const [creditManager, status] = params.args;
@@ -24,7 +24,7 @@ class BotListContract extends BaseContract {
         ];
       }
       default:
-        return void 0;
+        return super.stringifyFunctionParams(params);
     }
   }
   async syncState(toBlock) {

package/dist/esm/sdk/core/GearStakingV3Contract.js

@@ -6,14 +6,14 @@ class GearStakingContract extends BaseContract {
   constructor(sdk, address) {
     super(sdk, { addr: address, name: "GearStakingV3", abi });
   }
-  parseFunctionParams(params) {
+  stringifyFunctionParams(params) {
     switch (params.functionName) {
       case "setVotingContractStatus": {
         const [address, status] = params.args;
         return [this.labelAddress(address), VotingContractStatus[status]];
       }
       default:
-        return void 0;
+        return super.stringifyFunctionParams(params);
     }
   }
   stateHuman(raw = true) {

package/dist/esm/sdk/core/address-provider/AbstractAddressProviderContract.js

@@ -4,8 +4,8 @@ import { NO_VERSION } from "../../constants/index.js";
 import { TypedObjectUtils } from "../../utils/mappers.js";
 class AbstractAddressProviderContract extends BaseContract {
   #addresses = {};
-  constructor(sdk, args, addresses = {}) {
-    super(sdk, args);
+  constructor(options, args, addresses = {}) {
+    super(options, args);
     this.#addresses = addresses;
   }
   setInternalAddress(key, address, version) {

package/dist/esm/sdk/core/address-provider/AddressProviderV300Contract.js

@@ -4,9 +4,9 @@ import { getLogsSafe } from "../../utils/viem/index.js";
 import AbstractAddressProviderContract from "./AbstractAddressProviderContract.js";
 const abi = iAddressProviderV300Abi;
 class AddressProviderV300Contract extends AbstractAddressProviderContract {
-  constructor(sdk, address, version, addresses = {}) {
+  constructor(options, address, version, addresses = {}) {
     super(
-      sdk,
+      options,
       {
         addr: address,
         name: "AddressProviderV300",
@@ -16,7 +16,7 @@ class AddressProviderV300Contract extends AbstractAddressProviderContract {
       addresses
     );
   }
-  parseFunctionParams(params) {
+  stringifyFunctionParams(params) {
     switch (params.functionName) {
       case "setAddress": {
         if (params.args.length !== 3) {
@@ -27,7 +27,7 @@ class AddressProviderV300Contract extends AbstractAddressProviderContract {
         return [bytesToString(toBytes(key)), value, `${saveVersion}`];
       }
       default:
-        return void 0;
+        return super.stringifyFunctionParams(params);
     }
   }
   processLog(log) {
@@ -52,11 +52,16 @@ class AddressProviderV300Contract extends AbstractAddressProviderContract {
     }
   }
   async syncState(blockNumber) {
-    const fromBlock = this.sdk.chain.firstBlock;
+    if (!("firstBlock" in this.chain)) {
+      throw new Error(
+        `address provider v300 requires gearbox chain for ${this.chain.id} `
+      );
+    }
+    const fromBlock = this.chain.firstBlock;
     this.logger?.debug(
       `loading events from block ${fromBlock} to ${blockNumber}`
     );
-    const events = await getLogsSafe(this.sdk.client, {
+    const events = await getLogsSafe(this.client, {
       address: this.address,
       event: getAbiItem({ abi: this.abi, name: "SetAddress" }),
       fromBlock,