@metamask-previews/assets-controller 0.0.0-preview-766f7065 → 0.0.0-preview-cd0d0950

package/dist/data-sources/TokenDataSource.cjs

@@ -25,6 +25,18 @@ const log = (0, logger_1.createModuleLogger)(logger_1.projectLogger, CONTROLLER_
 // ============================================================================
 // HELPER FUNCTIONS
 // ============================================================================
+/**
+ * Transform V3 API response to FungibleAssetMetadata for state storage.
+ *
+ * Mapping:
+ * - assetId → used to derive `type` (native/erc20/spl)
+ * - iconUrl → image
+ * - All other fields map directly
+ *
+ * @param assetId - CAIP-19 asset ID used to derive token type.
+ * @param assetData - V3 API response data.
+ * @returns FungibleAssetMetadata for state storage.
+ */
 function transformV3AssetResponseToMetadata(assetId, assetData) {
     const parsed = (0, utils_1.parseCaipAssetType)(assetId);
     let tokenType = 'erc20';
@@ -34,13 +46,27 @@ function transformV3AssetResponseToMetadata(assetId, assetData) {
     else if (parsed.assetNamespace === 'spl') {
         tokenType = 'spl';
     }
-    return {
+    const metadata = {
+        // Type derived from assetId
         type: tokenType,
+        // BaseAssetMetadata fields
         name: assetData.name,
         symbol: assetData.symbol,
         decimals: assetData.decimals,
-        image: assetData.iconUrl ?? assetData.iconUrlThumbnail,
+        image: assetData.iconUrl,
+        // Direct mapping fields
+        coingeckoId: assetData.coingeckoId,
+        occurrences: assetData.occurrences,
+        aggregators: assetData.aggregators,
+        labels: assetData.labels,
+        erc20Permit: assetData.erc20Permit,
+        fees: assetData.fees,
+        honeypotStatus: assetData.honeypotStatus,
+        storage: assetData.storage,
+        isContractVerified: assetData.isContractVerified,
+        description: assetData.description,
     };
+    return metadata;
 }
 // ============================================================================
 // TOKEN DATA SOURCE
@@ -121,7 +147,13 @@ class TokenDataSource {
             try {
                 // Use ApiPlatformClient for fetching asset metadata
                 // API returns an array with assetId as a property on each item
-                const metadataResponse = await __classPrivateFieldGet(this, _TokenDataSource_apiClient, "f").tokens.fetchV3Assets(supportedAssetIds);
+                const metadataResponse = await __classPrivateFieldGet(this, _TokenDataSource_apiClient, "f").tokens.fetchV3Assets(supportedAssetIds, {
+                    includeIconUrl: true,
+                    includeMarketData: true,
+                    includeMetadata: true,
+                    includeLabels: true,
+                    includeRwaData: true,
+                });
                 response.assetsMetadata ?? (response.assetsMetadata = {});
                 for (const assetData of metadataResponse) {
                     const caipAssetId = assetData.assetId;

package/dist/data-sources/TokenDataSource.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"TokenDataSource.cjs","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"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","sourcesContent":["import type { V3AssetResponse } from '@metamask/core-backend';\nimport { ApiPlatformClient } from '@metamask/core-backend';\nimport type { Messenger } from '@metamask/messenger';\nimport { parseCaipAssetType } from '@metamask/utils';\nimport type { CaipAssetType } from '@metamask/utils';\n\nimport { projectLogger, createModuleLogger } from '../logger';\nimport { forDataTypes } from '../types';\nimport type { Caip19AssetId, AssetMetadata, Middleware } from '../types';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'TokenDataSource';\n\nconst log = createModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * Action to get the TokenDataSource middleware.\n */\nexport type TokenDataSourceGetAssetsMiddlewareAction = {\n  type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;\n  handler: () => Middleware;\n};\n\n/**\n * All actions exposed by TokenDataSource.\n */\nexport type TokenDataSourceActions = TokenDataSourceGetAssetsMiddlewareAction;\n\n/**\n * TokenDataSource no longer needs external BackendApiClient actions.\n * It uses ApiPlatformClient directly.\n */\nexport type TokenDataSourceAllowedActions = never;\n\nexport type TokenDataSourceMessenger = Messenger<\n  typeof CONTROLLER_NAME,\n  TokenDataSourceActions,\n  never\n>;\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport type TokenDataSourceOptions = {\n  messenger: TokenDataSourceMessenger;\n  /** ApiPlatformClient for API calls with caching */\n  queryApiClient: ApiPlatformClient;\n};\n\n// ============================================================================\n// HELPER FUNCTIONS\n// ============================================================================\n\nfunction transformV3AssetResponseToMetadata(\n  assetId: string,\n  assetData: V3AssetResponse,\n): AssetMetadata {\n  const parsed = parseCaipAssetType(assetId as CaipAssetType);\n  let tokenType: 'native' | 'erc20' | 'spl' = 'erc20';\n\n  if (parsed.assetNamespace === 'slip44') {\n    tokenType = 'native';\n  } else if (parsed.assetNamespace === 'spl') {\n    tokenType = 'spl';\n  }\n\n  return {\n    type: tokenType,\n    name: assetData.name,\n    symbol: assetData.symbol,\n    decimals: assetData.decimals,\n    image: assetData.iconUrl ?? assetData.iconUrlThumbnail,\n  };\n}\n\n// ============================================================================\n// TOKEN DATA SOURCE\n// ============================================================================\n\n/**\n * TokenDataSource enriches responses with token metadata from the Tokens API.\n *\n * This middleware-based data source:\n * - Checks detected assets for missing metadata/images\n * - Fetches metadata from Tokens API v3 for assets needing enrichment\n * - Merges fetched metadata into the response\n *\n * Usage:\n * ```typescript\n * // Create and initialize (registers messenger actions)\n * const tokenDataSource = new TokenDataSource({ messenger, queryApiClient });\n *\n * // Later, get middleware via messenger\n * const middleware = messenger.call('TokenDataSource:getAssetsMiddleware');\n * ```\n */\nexport class TokenDataSource {\n  readonly name = CONTROLLER_NAME;\n\n  readonly #messenger: TokenDataSourceMessenger;\n\n  /** ApiPlatformClient for cached API calls */\n  readonly #apiClient: ApiPlatformClient;\n\n  constructor(options: TokenDataSourceOptions) {\n    this.#messenger = options.messenger;\n    this.#apiClient = options.queryApiClient;\n    this.#registerActionHandlers();\n  }\n\n  /**\n   * Gets the supported networks from the API.\n   * Caching is handled by ApiPlatformClient.\n   *\n   * @returns Set of supported chain IDs in CAIP format\n   */\n  async #getSupportedNetworks(): Promise<Set<string>> {\n    try {\n      // Use v2/supportedNetworks which returns CAIP chain IDs\n      // ApiPlatformClient handles caching\n      const response =\n        await this.#apiClient.tokens.fetchTokenV2SupportedNetworks();\n\n      // Combine full and partial support networks\n      const allNetworks = [...response.fullSupport, ...response.partialSupport];\n\n      return new Set(allNetworks);\n    } catch (error) {\n      log('Failed to fetch supported networks', { error });\n      return new Set();\n    }\n  }\n\n  /**\n   * Filters asset IDs to only include those from supported networks.\n   *\n   * @param assetIds - Array of CAIP-19 asset IDs\n   * @param supportedNetworks - Set of supported chain IDs\n   * @returns Array of asset IDs from supported networks\n   */\n  #filterAssetsByNetwork(\n    assetIds: string[],\n    supportedNetworks: Set<string>,\n  ): string[] {\n    return assetIds.filter((assetId) => {\n      try {\n        const parsed = parseCaipAssetType(assetId as CaipAssetType);\n        // chainId is in format \"eip155:1\" or \"tron:728126428\"\n        // parsed.chain has namespace and reference properties\n        const chainId = `${parsed.chain.namespace}:${parsed.chain.reference}`;\n        return supportedNetworks.has(chainId);\n      } catch {\n        // If we can't parse the asset ID, filter it out\n        return false;\n      }\n    });\n  }\n\n  #registerActionHandlers(): void {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#messenger as any).registerActionHandler(\n      'TokenDataSource:getAssetsMiddleware',\n      () => this.assetsMiddleware,\n    );\n  }\n\n  /**\n   * Get the middleware for enriching responses with token metadata.\n   *\n   * This middleware:\n   * 1. Extracts the response from context\n   * 2. Fetches metadata for detected assets (assets without metadata)\n   * 3. Enriches the response with fetched metadata\n   * 4. Calls next() at the end to continue the middleware chain\n   *\n   * @returns The middleware function for the assets pipeline.\n   */\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['metadata'], async (ctx, next) => {\n      // Extract response from context\n      const { response } = ctx;\n\n      // Only fetch metadata for detected assets (assets without metadata)\n      if (!response.detectedAssets) {\n        return next(ctx);\n      }\n\n      const { assetsMetadata: stateMetadata } = ctx.getAssetsState();\n      const assetIdsNeedingMetadata = new Set<string>();\n\n      for (const detectedIds of Object.values(response.detectedAssets)) {\n        for (const assetId of detectedIds) {\n          // Skip if response already has metadata with image\n          const responseMetadata = response.assetsMetadata?.[assetId];\n          if (responseMetadata?.image) {\n            continue;\n          }\n\n          // Skip if state already has metadata with image\n          const existingMetadata = stateMetadata[assetId];\n          if (existingMetadata?.image) {\n            continue;\n          }\n\n          assetIdsNeedingMetadata.add(assetId);\n        }\n      }\n\n      if (assetIdsNeedingMetadata.size === 0) {\n        return next(ctx);\n      }\n\n      // Filter asset IDs to only include supported networks\n      const supportedNetworks = await this.#getSupportedNetworks();\n      const supportedAssetIds = this.#filterAssetsByNetwork(\n        [...assetIdsNeedingMetadata],\n        supportedNetworks,\n      );\n\n      if (supportedAssetIds.length === 0) {\n        return next(ctx);\n      }\n\n      try {\n        // Use ApiPlatformClient for fetching asset metadata\n        // API returns an array with assetId as a property on each item\n        const metadataResponse =\n          await this.#apiClient.tokens.fetchV3Assets(supportedAssetIds);\n\n        response.assetsMetadata ??= {};\n\n        for (const assetData of metadataResponse) {\n          const caipAssetId = assetData.assetId as Caip19AssetId;\n          response.assetsMetadata[caipAssetId] =\n            transformV3AssetResponseToMetadata(assetData.assetId, assetData);\n        }\n      } catch (error) {\n        log('Failed to fetch metadata', { error });\n      }\n\n      // Call next() at the end to continue the middleware chain\n      return next(ctx);\n    });\n  }\n}\n"]}
+{"version":3,"file":"TokenDataSource.cjs","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"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","sourcesContent":["import type { V3AssetResponse } from '@metamask/core-backend';\nimport { ApiPlatformClient } from '@metamask/core-backend';\nimport type { Messenger } from '@metamask/messenger';\nimport { parseCaipAssetType } from '@metamask/utils';\nimport type { CaipAssetType } from '@metamask/utils';\n\nimport { projectLogger, createModuleLogger } from '../logger';\nimport { forDataTypes } from '../types';\nimport type {\n  Caip19AssetId,\n  AssetMetadata,\n  Middleware,\n  FungibleAssetMetadata,\n} from '../types';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'TokenDataSource';\n\nconst log = createModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * Action to get the TokenDataSource middleware.\n */\nexport type TokenDataSourceGetAssetsMiddlewareAction = {\n  type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;\n  handler: () => Middleware;\n};\n\n/**\n * All actions exposed by TokenDataSource.\n */\nexport type TokenDataSourceActions = TokenDataSourceGetAssetsMiddlewareAction;\n\n/**\n * TokenDataSource no longer needs external BackendApiClient actions.\n * It uses ApiPlatformClient directly.\n */\nexport type TokenDataSourceAllowedActions = never;\n\nexport type TokenDataSourceMessenger = Messenger<\n  typeof CONTROLLER_NAME,\n  TokenDataSourceActions,\n  never\n>;\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport type TokenDataSourceOptions = {\n  messenger: TokenDataSourceMessenger;\n  /** ApiPlatformClient for API calls with caching */\n  queryApiClient: ApiPlatformClient;\n};\n\n// ============================================================================\n// HELPER FUNCTIONS\n// ============================================================================\n\n/**\n * Transform V3 API response to FungibleAssetMetadata for state storage.\n *\n * Mapping:\n * - assetId → used to derive `type` (native/erc20/spl)\n * - iconUrl → image\n * - All other fields map directly\n *\n * @param assetId - CAIP-19 asset ID used to derive token type.\n * @param assetData - V3 API response data.\n * @returns FungibleAssetMetadata for state storage.\n */\nfunction transformV3AssetResponseToMetadata(\n  assetId: string,\n  assetData: V3AssetResponse,\n): AssetMetadata {\n  const parsed = parseCaipAssetType(assetId as CaipAssetType);\n  let tokenType: 'native' | 'erc20' | 'spl' = 'erc20';\n\n  if (parsed.assetNamespace === 'slip44') {\n    tokenType = 'native';\n  } else if (parsed.assetNamespace === 'spl') {\n    tokenType = 'spl';\n  }\n\n  const metadata: FungibleAssetMetadata = {\n    // Type derived from assetId\n    type: tokenType,\n    // BaseAssetMetadata fields\n    name: assetData.name,\n    symbol: assetData.symbol,\n    decimals: assetData.decimals,\n    image: assetData.iconUrl,\n    // Direct mapping fields\n    coingeckoId: assetData.coingeckoId,\n    occurrences: assetData.occurrences,\n    aggregators: assetData.aggregators,\n    labels: assetData.labels,\n    erc20Permit: assetData.erc20Permit,\n    fees: assetData.fees,\n    honeypotStatus: assetData.honeypotStatus,\n    storage: assetData.storage,\n    isContractVerified: assetData.isContractVerified,\n    description: assetData.description,\n  };\n\n  return metadata;\n}\n\n// ============================================================================\n// TOKEN DATA SOURCE\n// ============================================================================\n\n/**\n * TokenDataSource enriches responses with token metadata from the Tokens API.\n *\n * This middleware-based data source:\n * - Checks detected assets for missing metadata/images\n * - Fetches metadata from Tokens API v3 for assets needing enrichment\n * - Merges fetched metadata into the response\n *\n * Usage:\n * ```typescript\n * // Create and initialize (registers messenger actions)\n * const tokenDataSource = new TokenDataSource({ messenger, queryApiClient });\n *\n * // Later, get middleware via messenger\n * const middleware = messenger.call('TokenDataSource:getAssetsMiddleware');\n * ```\n */\nexport class TokenDataSource {\n  readonly name = CONTROLLER_NAME;\n\n  readonly #messenger: TokenDataSourceMessenger;\n\n  /** ApiPlatformClient for cached API calls */\n  readonly #apiClient: ApiPlatformClient;\n\n  constructor(options: TokenDataSourceOptions) {\n    this.#messenger = options.messenger;\n    this.#apiClient = options.queryApiClient;\n    this.#registerActionHandlers();\n  }\n\n  /**\n   * Gets the supported networks from the API.\n   * Caching is handled by ApiPlatformClient.\n   *\n   * @returns Set of supported chain IDs in CAIP format\n   */\n  async #getSupportedNetworks(): Promise<Set<string>> {\n    try {\n      // Use v2/supportedNetworks which returns CAIP chain IDs\n      // ApiPlatformClient handles caching\n      const response =\n        await this.#apiClient.tokens.fetchTokenV2SupportedNetworks();\n\n      // Combine full and partial support networks\n      const allNetworks = [...response.fullSupport, ...response.partialSupport];\n\n      return new Set(allNetworks);\n    } catch (error) {\n      log('Failed to fetch supported networks', { error });\n      return new Set();\n    }\n  }\n\n  /**\n   * Filters asset IDs to only include those from supported networks.\n   *\n   * @param assetIds - Array of CAIP-19 asset IDs\n   * @param supportedNetworks - Set of supported chain IDs\n   * @returns Array of asset IDs from supported networks\n   */\n  #filterAssetsByNetwork(\n    assetIds: string[],\n    supportedNetworks: Set<string>,\n  ): string[] {\n    return assetIds.filter((assetId) => {\n      try {\n        const parsed = parseCaipAssetType(assetId as CaipAssetType);\n        // chainId is in format \"eip155:1\" or \"tron:728126428\"\n        // parsed.chain has namespace and reference properties\n        const chainId = `${parsed.chain.namespace}:${parsed.chain.reference}`;\n        return supportedNetworks.has(chainId);\n      } catch {\n        // If we can't parse the asset ID, filter it out\n        return false;\n      }\n    });\n  }\n\n  #registerActionHandlers(): void {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#messenger as any).registerActionHandler(\n      'TokenDataSource:getAssetsMiddleware',\n      () => this.assetsMiddleware,\n    );\n  }\n\n  /**\n   * Get the middleware for enriching responses with token metadata.\n   *\n   * This middleware:\n   * 1. Extracts the response from context\n   * 2. Fetches metadata for detected assets (assets without metadata)\n   * 3. Enriches the response with fetched metadata\n   * 4. Calls next() at the end to continue the middleware chain\n   *\n   * @returns The middleware function for the assets pipeline.\n   */\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['metadata'], async (ctx, next) => {\n      // Extract response from context\n      const { response } = ctx;\n\n      // Only fetch metadata for detected assets (assets without metadata)\n      if (!response.detectedAssets) {\n        return next(ctx);\n      }\n\n      const { assetsMetadata: stateMetadata } = ctx.getAssetsState();\n      const assetIdsNeedingMetadata = new Set<string>();\n\n      for (const detectedIds of Object.values(response.detectedAssets)) {\n        for (const assetId of detectedIds) {\n          // Skip if response already has metadata with image\n          const responseMetadata = response.assetsMetadata?.[assetId];\n          if (responseMetadata?.image) {\n            continue;\n          }\n\n          // Skip if state already has metadata with image\n          const existingMetadata = stateMetadata[assetId];\n          if (existingMetadata?.image) {\n            continue;\n          }\n\n          assetIdsNeedingMetadata.add(assetId);\n        }\n      }\n\n      if (assetIdsNeedingMetadata.size === 0) {\n        return next(ctx);\n      }\n\n      // Filter asset IDs to only include supported networks\n      const supportedNetworks = await this.#getSupportedNetworks();\n      const supportedAssetIds = this.#filterAssetsByNetwork(\n        [...assetIdsNeedingMetadata],\n        supportedNetworks,\n      );\n\n      if (supportedAssetIds.length === 0) {\n        return next(ctx);\n      }\n\n      try {\n        // Use ApiPlatformClient for fetching asset metadata\n        // API returns an array with assetId as a property on each item\n        const metadataResponse = await this.#apiClient.tokens.fetchV3Assets(\n          supportedAssetIds,\n          {\n            includeIconUrl: true,\n            includeMarketData: true,\n            includeMetadata: true,\n            includeLabels: true,\n            includeRwaData: true,\n          },\n        );\n\n        response.assetsMetadata ??= {};\n\n        for (const assetData of metadataResponse) {\n          const caipAssetId = assetData.assetId as Caip19AssetId;\n          response.assetsMetadata[caipAssetId] =\n            transformV3AssetResponseToMetadata(assetData.assetId, assetData);\n        }\n      } catch (error) {\n        log('Failed to fetch metadata', { error });\n      }\n\n      // Call next() at the end to continue the middleware chain\n      return next(ctx);\n    });\n  }\n}\n"]}

package/dist/data-sources/TokenDataSource.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"TokenDataSource.d.cts","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,+BAA+B;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAMrD,OAAO,KAAK,EAAgC,UAAU,EAAE,qBAAiB;AAMzE,QAAA,MAAM,eAAe,oBAAoB,CAAC;AAQ1C;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,GAAG,OAAO,eAAe,sBAAsB,CAAC;IACtD,OAAO,EAAE,MAAM,UAAU,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,wCAAwC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAC9C,OAAO,eAAe,EACtB,sBAAsB,EACtB,KAAK,CACN,CAAC;AAMF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,wBAAwB,CAAC;IACpC,mDAAmD;IACnD,cAAc,EAAE,iBAAiB,CAAC;CACnC,CAAC;AAgCF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;;IAC1B,QAAQ,CAAC,IAAI,qBAAmB;gBAOpB,OAAO,EAAE,sBAAsB;IA8D3C;;;;;;;;;;OAUG;IACH,IAAI,gBAAgB,IAAI,UAAU,CAkEjC;CACF"}
+{"version":3,"file":"TokenDataSource.d.cts","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,+BAA+B;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAMrD,OAAO,KAAK,EAGV,UAAU,EAEX,qBAAiB;AAMlB,QAAA,MAAM,eAAe,oBAAoB,CAAC;AAQ1C;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,GAAG,OAAO,eAAe,sBAAsB,CAAC;IACtD,OAAO,EAAE,MAAM,UAAU,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,wCAAwC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAC9C,OAAO,eAAe,EACtB,sBAAsB,EACtB,KAAK,CACN,CAAC;AAMF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,wBAAwB,CAAC;IACpC,mDAAmD;IACnD,cAAc,EAAE,iBAAiB,CAAC;CACnC,CAAC;AA2DF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;;IAC1B,QAAQ,CAAC,IAAI,qBAAmB;gBAOpB,OAAO,EAAE,sBAAsB;IA8D3C;;;;;;;;;;OAUG;IACH,IAAI,gBAAgB,IAAI,UAAU,CA0EjC;CACF"}

package/dist/data-sources/TokenDataSource.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"TokenDataSource.d.mts","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,+BAA+B;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAMrD,OAAO,KAAK,EAAgC,UAAU,EAAE,qBAAiB;AAMzE,QAAA,MAAM,eAAe,oBAAoB,CAAC;AAQ1C;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,GAAG,OAAO,eAAe,sBAAsB,CAAC;IACtD,OAAO,EAAE,MAAM,UAAU,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,wCAAwC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAC9C,OAAO,eAAe,EACtB,sBAAsB,EACtB,KAAK,CACN,CAAC;AAMF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,wBAAwB,CAAC;IACpC,mDAAmD;IACnD,cAAc,EAAE,iBAAiB,CAAC;CACnC,CAAC;AAgCF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;;IAC1B,QAAQ,CAAC,IAAI,qBAAmB;gBAOpB,OAAO,EAAE,sBAAsB;IA8D3C;;;;;;;;;;OAUG;IACH,IAAI,gBAAgB,IAAI,UAAU,CAkEjC;CACF"}
+{"version":3,"file":"TokenDataSource.d.mts","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,+BAA+B;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAMrD,OAAO,KAAK,EAGV,UAAU,EAEX,qBAAiB;AAMlB,QAAA,MAAM,eAAe,oBAAoB,CAAC;AAQ1C;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,GAAG,OAAO,eAAe,sBAAsB,CAAC;IACtD,OAAO,EAAE,MAAM,UAAU,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,wCAAwC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAC9C,OAAO,eAAe,EACtB,sBAAsB,EACtB,KAAK,CACN,CAAC;AAMF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,wBAAwB,CAAC;IACpC,mDAAmD;IACnD,cAAc,EAAE,iBAAiB,CAAC;CACnC,CAAC;AA2DF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;;IAC1B,QAAQ,CAAC,IAAI,qBAAmB;gBAOpB,OAAO,EAAE,sBAAsB;IA8D3C;;;;;;;;;;OAUG;IACH,IAAI,gBAAgB,IAAI,UAAU,CA0EjC;CACF"}

package/dist/data-sources/TokenDataSource.mjs

@@ -22,6 +22,18 @@ const log = createModuleLogger(projectLogger, CONTROLLER_NAME);
 // ============================================================================
 // HELPER FUNCTIONS
 // ============================================================================
+/**
+ * Transform V3 API response to FungibleAssetMetadata for state storage.
+ *
+ * Mapping:
+ * - assetId → used to derive `type` (native/erc20/spl)
+ * - iconUrl → image
+ * - All other fields map directly
+ *
+ * @param assetId - CAIP-19 asset ID used to derive token type.
+ * @param assetData - V3 API response data.
+ * @returns FungibleAssetMetadata for state storage.
+ */
 function transformV3AssetResponseToMetadata(assetId, assetData) {
     const parsed = parseCaipAssetType(assetId);
     let tokenType = 'erc20';
@@ -31,13 +43,27 @@ function transformV3AssetResponseToMetadata(assetId, assetData) {
     else if (parsed.assetNamespace === 'spl') {
         tokenType = 'spl';
     }
-    return {
+    const metadata = {
+        // Type derived from assetId
         type: tokenType,
+        // BaseAssetMetadata fields
         name: assetData.name,
         symbol: assetData.symbol,
         decimals: assetData.decimals,
-        image: assetData.iconUrl ?? assetData.iconUrlThumbnail,
+        image: assetData.iconUrl,
+        // Direct mapping fields
+        coingeckoId: assetData.coingeckoId,
+        occurrences: assetData.occurrences,
+        aggregators: assetData.aggregators,
+        labels: assetData.labels,
+        erc20Permit: assetData.erc20Permit,
+        fees: assetData.fees,
+        honeypotStatus: assetData.honeypotStatus,
+        storage: assetData.storage,
+        isContractVerified: assetData.isContractVerified,
+        description: assetData.description,
     };
+    return metadata;
 }
 // ============================================================================
 // TOKEN DATA SOURCE
@@ -118,7 +144,13 @@ export class TokenDataSource {
             try {
                 // Use ApiPlatformClient for fetching asset metadata
                 // API returns an array with assetId as a property on each item
-                const metadataResponse = await __classPrivateFieldGet(this, _TokenDataSource_apiClient, "f").tokens.fetchV3Assets(supportedAssetIds);
+                const metadataResponse = await __classPrivateFieldGet(this, _TokenDataSource_apiClient, "f").tokens.fetchV3Assets(supportedAssetIds, {
+                    includeIconUrl: true,
+                    includeMarketData: true,
+                    includeMetadata: true,
+                    includeLabels: true,
+                    includeRwaData: true,
+                });
                 response.assetsMetadata ?? (response.assetsMetadata = {});
                 for (const assetData of metadataResponse) {
                     const caipAssetId = assetData.assetId;

package/dist/data-sources/TokenDataSource.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"TokenDataSource.mjs","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"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","sourcesContent":["import type { V3AssetResponse } from '@metamask/core-backend';\nimport { ApiPlatformClient } from '@metamask/core-backend';\nimport type { Messenger } from '@metamask/messenger';\nimport { parseCaipAssetType } from '@metamask/utils';\nimport type { CaipAssetType } from '@metamask/utils';\n\nimport { projectLogger, createModuleLogger } from '../logger';\nimport { forDataTypes } from '../types';\nimport type { Caip19AssetId, AssetMetadata, Middleware } from '../types';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'TokenDataSource';\n\nconst log = createModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * Action to get the TokenDataSource middleware.\n */\nexport type TokenDataSourceGetAssetsMiddlewareAction = {\n  type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;\n  handler: () => Middleware;\n};\n\n/**\n * All actions exposed by TokenDataSource.\n */\nexport type TokenDataSourceActions = TokenDataSourceGetAssetsMiddlewareAction;\n\n/**\n * TokenDataSource no longer needs external BackendApiClient actions.\n * It uses ApiPlatformClient directly.\n */\nexport type TokenDataSourceAllowedActions = never;\n\nexport type TokenDataSourceMessenger = Messenger<\n  typeof CONTROLLER_NAME,\n  TokenDataSourceActions,\n  never\n>;\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport type TokenDataSourceOptions = {\n  messenger: TokenDataSourceMessenger;\n  /** ApiPlatformClient for API calls with caching */\n  queryApiClient: ApiPlatformClient;\n};\n\n// ============================================================================\n// HELPER FUNCTIONS\n// ============================================================================\n\nfunction transformV3AssetResponseToMetadata(\n  assetId: string,\n  assetData: V3AssetResponse,\n): AssetMetadata {\n  const parsed = parseCaipAssetType(assetId as CaipAssetType);\n  let tokenType: 'native' | 'erc20' | 'spl' = 'erc20';\n\n  if (parsed.assetNamespace === 'slip44') {\n    tokenType = 'native';\n  } else if (parsed.assetNamespace === 'spl') {\n    tokenType = 'spl';\n  }\n\n  return {\n    type: tokenType,\n    name: assetData.name,\n    symbol: assetData.symbol,\n    decimals: assetData.decimals,\n    image: assetData.iconUrl ?? assetData.iconUrlThumbnail,\n  };\n}\n\n// ============================================================================\n// TOKEN DATA SOURCE\n// ============================================================================\n\n/**\n * TokenDataSource enriches responses with token metadata from the Tokens API.\n *\n * This middleware-based data source:\n * - Checks detected assets for missing metadata/images\n * - Fetches metadata from Tokens API v3 for assets needing enrichment\n * - Merges fetched metadata into the response\n *\n * Usage:\n * ```typescript\n * // Create and initialize (registers messenger actions)\n * const tokenDataSource = new TokenDataSource({ messenger, queryApiClient });\n *\n * // Later, get middleware via messenger\n * const middleware = messenger.call('TokenDataSource:getAssetsMiddleware');\n * ```\n */\nexport class TokenDataSource {\n  readonly name = CONTROLLER_NAME;\n\n  readonly #messenger: TokenDataSourceMessenger;\n\n  /** ApiPlatformClient for cached API calls */\n  readonly #apiClient: ApiPlatformClient;\n\n  constructor(options: TokenDataSourceOptions) {\n    this.#messenger = options.messenger;\n    this.#apiClient = options.queryApiClient;\n    this.#registerActionHandlers();\n  }\n\n  /**\n   * Gets the supported networks from the API.\n   * Caching is handled by ApiPlatformClient.\n   *\n   * @returns Set of supported chain IDs in CAIP format\n   */\n  async #getSupportedNetworks(): Promise<Set<string>> {\n    try {\n      // Use v2/supportedNetworks which returns CAIP chain IDs\n      // ApiPlatformClient handles caching\n      const response =\n        await this.#apiClient.tokens.fetchTokenV2SupportedNetworks();\n\n      // Combine full and partial support networks\n      const allNetworks = [...response.fullSupport, ...response.partialSupport];\n\n      return new Set(allNetworks);\n    } catch (error) {\n      log('Failed to fetch supported networks', { error });\n      return new Set();\n    }\n  }\n\n  /**\n   * Filters asset IDs to only include those from supported networks.\n   *\n   * @param assetIds - Array of CAIP-19 asset IDs\n   * @param supportedNetworks - Set of supported chain IDs\n   * @returns Array of asset IDs from supported networks\n   */\n  #filterAssetsByNetwork(\n    assetIds: string[],\n    supportedNetworks: Set<string>,\n  ): string[] {\n    return assetIds.filter((assetId) => {\n      try {\n        const parsed = parseCaipAssetType(assetId as CaipAssetType);\n        // chainId is in format \"eip155:1\" or \"tron:728126428\"\n        // parsed.chain has namespace and reference properties\n        const chainId = `${parsed.chain.namespace}:${parsed.chain.reference}`;\n        return supportedNetworks.has(chainId);\n      } catch {\n        // If we can't parse the asset ID, filter it out\n        return false;\n      }\n    });\n  }\n\n  #registerActionHandlers(): void {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#messenger as any).registerActionHandler(\n      'TokenDataSource:getAssetsMiddleware',\n      () => this.assetsMiddleware,\n    );\n  }\n\n  /**\n   * Get the middleware for enriching responses with token metadata.\n   *\n   * This middleware:\n   * 1. Extracts the response from context\n   * 2. Fetches metadata for detected assets (assets without metadata)\n   * 3. Enriches the response with fetched metadata\n   * 4. Calls next() at the end to continue the middleware chain\n   *\n   * @returns The middleware function for the assets pipeline.\n   */\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['metadata'], async (ctx, next) => {\n      // Extract response from context\n      const { response } = ctx;\n\n      // Only fetch metadata for detected assets (assets without metadata)\n      if (!response.detectedAssets) {\n        return next(ctx);\n      }\n\n      const { assetsMetadata: stateMetadata } = ctx.getAssetsState();\n      const assetIdsNeedingMetadata = new Set<string>();\n\n      for (const detectedIds of Object.values(response.detectedAssets)) {\n        for (const assetId of detectedIds) {\n          // Skip if response already has metadata with image\n          const responseMetadata = response.assetsMetadata?.[assetId];\n          if (responseMetadata?.image) {\n            continue;\n          }\n\n          // Skip if state already has metadata with image\n          const existingMetadata = stateMetadata[assetId];\n          if (existingMetadata?.image) {\n            continue;\n          }\n\n          assetIdsNeedingMetadata.add(assetId);\n        }\n      }\n\n      if (assetIdsNeedingMetadata.size === 0) {\n        return next(ctx);\n      }\n\n      // Filter asset IDs to only include supported networks\n      const supportedNetworks = await this.#getSupportedNetworks();\n      const supportedAssetIds = this.#filterAssetsByNetwork(\n        [...assetIdsNeedingMetadata],\n        supportedNetworks,\n      );\n\n      if (supportedAssetIds.length === 0) {\n        return next(ctx);\n      }\n\n      try {\n        // Use ApiPlatformClient for fetching asset metadata\n        // API returns an array with assetId as a property on each item\n        const metadataResponse =\n          await this.#apiClient.tokens.fetchV3Assets(supportedAssetIds);\n\n        response.assetsMetadata ??= {};\n\n        for (const assetData of metadataResponse) {\n          const caipAssetId = assetData.assetId as Caip19AssetId;\n          response.assetsMetadata[caipAssetId] =\n            transformV3AssetResponseToMetadata(assetData.assetId, assetData);\n        }\n      } catch (error) {\n        log('Failed to fetch metadata', { error });\n      }\n\n      // Call next() at the end to continue the middleware chain\n      return next(ctx);\n    });\n  }\n}\n"]}
+{"version":3,"file":"TokenDataSource.mjs","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"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","sourcesContent":["import type { V3AssetResponse } from '@metamask/core-backend';\nimport { ApiPlatformClient } from '@metamask/core-backend';\nimport type { Messenger } from '@metamask/messenger';\nimport { parseCaipAssetType } from '@metamask/utils';\nimport type { CaipAssetType } from '@metamask/utils';\n\nimport { projectLogger, createModuleLogger } from '../logger';\nimport { forDataTypes } from '../types';\nimport type {\n  Caip19AssetId,\n  AssetMetadata,\n  Middleware,\n  FungibleAssetMetadata,\n} from '../types';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'TokenDataSource';\n\nconst log = createModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * Action to get the TokenDataSource middleware.\n */\nexport type TokenDataSourceGetAssetsMiddlewareAction = {\n  type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;\n  handler: () => Middleware;\n};\n\n/**\n * All actions exposed by TokenDataSource.\n */\nexport type TokenDataSourceActions = TokenDataSourceGetAssetsMiddlewareAction;\n\n/**\n * TokenDataSource no longer needs external BackendApiClient actions.\n * It uses ApiPlatformClient directly.\n */\nexport type TokenDataSourceAllowedActions = never;\n\nexport type TokenDataSourceMessenger = Messenger<\n  typeof CONTROLLER_NAME,\n  TokenDataSourceActions,\n  never\n>;\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport type TokenDataSourceOptions = {\n  messenger: TokenDataSourceMessenger;\n  /** ApiPlatformClient for API calls with caching */\n  queryApiClient: ApiPlatformClient;\n};\n\n// ============================================================================\n// HELPER FUNCTIONS\n// ============================================================================\n\n/**\n * Transform V3 API response to FungibleAssetMetadata for state storage.\n *\n * Mapping:\n * - assetId → used to derive `type` (native/erc20/spl)\n * - iconUrl → image\n * - All other fields map directly\n *\n * @param assetId - CAIP-19 asset ID used to derive token type.\n * @param assetData - V3 API response data.\n * @returns FungibleAssetMetadata for state storage.\n */\nfunction transformV3AssetResponseToMetadata(\n  assetId: string,\n  assetData: V3AssetResponse,\n): AssetMetadata {\n  const parsed = parseCaipAssetType(assetId as CaipAssetType);\n  let tokenType: 'native' | 'erc20' | 'spl' = 'erc20';\n\n  if (parsed.assetNamespace === 'slip44') {\n    tokenType = 'native';\n  } else if (parsed.assetNamespace === 'spl') {\n    tokenType = 'spl';\n  }\n\n  const metadata: FungibleAssetMetadata = {\n    // Type derived from assetId\n    type: tokenType,\n    // BaseAssetMetadata fields\n    name: assetData.name,\n    symbol: assetData.symbol,\n    decimals: assetData.decimals,\n    image: assetData.iconUrl,\n    // Direct mapping fields\n    coingeckoId: assetData.coingeckoId,\n    occurrences: assetData.occurrences,\n    aggregators: assetData.aggregators,\n    labels: assetData.labels,\n    erc20Permit: assetData.erc20Permit,\n    fees: assetData.fees,\n    honeypotStatus: assetData.honeypotStatus,\n    storage: assetData.storage,\n    isContractVerified: assetData.isContractVerified,\n    description: assetData.description,\n  };\n\n  return metadata;\n}\n\n// ============================================================================\n// TOKEN DATA SOURCE\n// ============================================================================\n\n/**\n * TokenDataSource enriches responses with token metadata from the Tokens API.\n *\n * This middleware-based data source:\n * - Checks detected assets for missing metadata/images\n * - Fetches metadata from Tokens API v3 for assets needing enrichment\n * - Merges fetched metadata into the response\n *\n * Usage:\n * ```typescript\n * // Create and initialize (registers messenger actions)\n * const tokenDataSource = new TokenDataSource({ messenger, queryApiClient });\n *\n * // Later, get middleware via messenger\n * const middleware = messenger.call('TokenDataSource:getAssetsMiddleware');\n * ```\n */\nexport class TokenDataSource {\n  readonly name = CONTROLLER_NAME;\n\n  readonly #messenger: TokenDataSourceMessenger;\n\n  /** ApiPlatformClient for cached API calls */\n  readonly #apiClient: ApiPlatformClient;\n\n  constructor(options: TokenDataSourceOptions) {\n    this.#messenger = options.messenger;\n    this.#apiClient = options.queryApiClient;\n    this.#registerActionHandlers();\n  }\n\n  /**\n   * Gets the supported networks from the API.\n   * Caching is handled by ApiPlatformClient.\n   *\n   * @returns Set of supported chain IDs in CAIP format\n   */\n  async #getSupportedNetworks(): Promise<Set<string>> {\n    try {\n      // Use v2/supportedNetworks which returns CAIP chain IDs\n      // ApiPlatformClient handles caching\n      const response =\n        await this.#apiClient.tokens.fetchTokenV2SupportedNetworks();\n\n      // Combine full and partial support networks\n      const allNetworks = [...response.fullSupport, ...response.partialSupport];\n\n      return new Set(allNetworks);\n    } catch (error) {\n      log('Failed to fetch supported networks', { error });\n      return new Set();\n    }\n  }\n\n  /**\n   * Filters asset IDs to only include those from supported networks.\n   *\n   * @param assetIds - Array of CAIP-19 asset IDs\n   * @param supportedNetworks - Set of supported chain IDs\n   * @returns Array of asset IDs from supported networks\n   */\n  #filterAssetsByNetwork(\n    assetIds: string[],\n    supportedNetworks: Set<string>,\n  ): string[] {\n    return assetIds.filter((assetId) => {\n      try {\n        const parsed = parseCaipAssetType(assetId as CaipAssetType);\n        // chainId is in format \"eip155:1\" or \"tron:728126428\"\n        // parsed.chain has namespace and reference properties\n        const chainId = `${parsed.chain.namespace}:${parsed.chain.reference}`;\n        return supportedNetworks.has(chainId);\n      } catch {\n        // If we can't parse the asset ID, filter it out\n        return false;\n      }\n    });\n  }\n\n  #registerActionHandlers(): void {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#messenger as any).registerActionHandler(\n      'TokenDataSource:getAssetsMiddleware',\n      () => this.assetsMiddleware,\n    );\n  }\n\n  /**\n   * Get the middleware for enriching responses with token metadata.\n   *\n   * This middleware:\n   * 1. Extracts the response from context\n   * 2. Fetches metadata for detected assets (assets without metadata)\n   * 3. Enriches the response with fetched metadata\n   * 4. Calls next() at the end to continue the middleware chain\n   *\n   * @returns The middleware function for the assets pipeline.\n   */\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['metadata'], async (ctx, next) => {\n      // Extract response from context\n      const { response } = ctx;\n\n      // Only fetch metadata for detected assets (assets without metadata)\n      if (!response.detectedAssets) {\n        return next(ctx);\n      }\n\n      const { assetsMetadata: stateMetadata } = ctx.getAssetsState();\n      const assetIdsNeedingMetadata = new Set<string>();\n\n      for (const detectedIds of Object.values(response.detectedAssets)) {\n        for (const assetId of detectedIds) {\n          // Skip if response already has metadata with image\n          const responseMetadata = response.assetsMetadata?.[assetId];\n          if (responseMetadata?.image) {\n            continue;\n          }\n\n          // Skip if state already has metadata with image\n          const existingMetadata = stateMetadata[assetId];\n          if (existingMetadata?.image) {\n            continue;\n          }\n\n          assetIdsNeedingMetadata.add(assetId);\n        }\n      }\n\n      if (assetIdsNeedingMetadata.size === 0) {\n        return next(ctx);\n      }\n\n      // Filter asset IDs to only include supported networks\n      const supportedNetworks = await this.#getSupportedNetworks();\n      const supportedAssetIds = this.#filterAssetsByNetwork(\n        [...assetIdsNeedingMetadata],\n        supportedNetworks,\n      );\n\n      if (supportedAssetIds.length === 0) {\n        return next(ctx);\n      }\n\n      try {\n        // Use ApiPlatformClient for fetching asset metadata\n        // API returns an array with assetId as a property on each item\n        const metadataResponse = await this.#apiClient.tokens.fetchV3Assets(\n          supportedAssetIds,\n          {\n            includeIconUrl: true,\n            includeMarketData: true,\n            includeMetadata: true,\n            includeLabels: true,\n            includeRwaData: true,\n          },\n        );\n\n        response.assetsMetadata ??= {};\n\n        for (const assetData of metadataResponse) {\n          const caipAssetId = assetData.assetId as Caip19AssetId;\n          response.assetsMetadata[caipAssetId] =\n            transformV3AssetResponseToMetadata(assetData.assetId, assetData);\n        }\n      } catch (error) {\n        log('Failed to fetch metadata', { error });\n      }\n\n      // Call next() at the end to continue the middleware chain\n      return next(ctx);\n    });\n  }\n}\n"]}

package/dist/data-sources/evm-rpc-services/clients/MulticallClient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MulticallClient.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/MulticallClient.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,+BAAgE;AAUhE,8CAAmD;AAEnD,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,cAAc,GAAG;IACrB;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;oBACnC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE;oBACtC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;iBACpC;aACF;SACF;QACD,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;oBACjC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE;iBACtC;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAChD;CACqB,CAAC;AAEzB;;GAEG;AACH,MAAM,SAAS,GAAG;IAChB;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAChD;CACqB,CAAC;AAEzB,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACH,MAAM,YAAY,GAChB,4CAAuD,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,2BAA2B,GAAqB;IACpD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,KAAK,EAAE,4CAA4C;IACnD,UAAU,EAAE,4CAA4C;IACxD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,SAAS,EAAE,4CAA4C;IACvD,UAAU,EAAE,4CAA4C;IACxD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,UAAU,EAAE,4CAA4C;IACxD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,WAAW,EAAE,4CAA4C;IACzD,MAAM,EAAE,4CAA4C;IACpD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;IACtD,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;IACtD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,aAAa,EAAE,4CAA4C;IAC3D,aAAa,EAAE,4CAA4C;IAC3D,YAAY,EAAE,4CAA4C;IAC1D,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,WAAW,EAAE,4CAA4C;IACzD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,4CAA4C;IACpD,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,YAAY,EAAE,4CAA4C;IAC1D,OAAO,EAAE,4CAA4C;IACrD,UAAU,EAAE,4CAA4C;IACxD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,WAAW,EAAE,4CAA4C;IACzD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,UAAU,EAAE,4CAA4C;IACxD,YAAY,EAAE,4CAA4C;IAC1D,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,YAAY,EAAE,4CAA4C;IAC1D,YAAY,EAAE,4CAA4C;IAC1D,WAAW,EAAE,4CAA4C;IACzD,YAAY,EAAE,4CAA4C;IAC1D,YAAY,EAAE,4CAA4C;IAC1D,YAAY,EAAE,4CAA4C;IAC1D,YAAY,EAAE,4CAA4C;IAC1D,YAAY,EAAE,4CAA4C;IAC1D,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,WAAW,EAAE,4CAA4C;IACzD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,MAAM,EAAE,4CAA4C;IACpD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,OAAO,EAAE,4CAA4C;IACrD,SAAS,EAAE,4CAA4C;IACvD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,aAAa,EAAE,4CAA4C;IAC3D,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,4CAA4C;IACpD,WAAW,EAAE,4CAA4C;IACzD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,MAAM,EAAE,4CAA4C;IACpD,SAAS,EAAE,4CAA4C;IACvD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,WAAW,EAAE,4CAA4C;IACzD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,UAAU,EAAE,4CAA4C;IACxD,QAAQ,EAAE,4CAA4C;IACtD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,UAAU,EAAE,4CAA4C;IACxD,OAAO,EAAE,4CAA4C;IACrD,SAAS,EAAE,4CAA4C;IACvD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,WAAW,EAAE,4CAA4C;IACzD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,OAAO,EAAE,4CAA4C;IACrD,SAAS,EAAE,4CAA4C;IACvD,SAAS,EAAE,4CAA4C;IACvD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,WAAW,EAAE,4CAA4C;IACzD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,aAAa,EAAE,4CAA4C;IAC3D,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,WAAW,EAAE,4CAA4C;IACzD,cAAc,EAAE,4CAA4C;IAC5D,UAAU,EAAE,4CAA4C;IACxD,SAAS,EAAE,4CAA4C;IACvD,QAAQ,EAAE,4CAA4C;IACtD,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,MAAM,EAAE,4CAA4C;IACpD,UAAU,EAAE,4CAA4C;IACxD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,SAAS,EAAE,4CAA4C;IACvD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,MAAM,EAAE,4CAA4C;IACpD,SAAS,EAAE,4CAA4C;IACvD,MAAM,EAAE,4CAA4C;IACpD,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,4CAA4C;IACtD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;CACxD,CAAC;AAEF,gFAAgF;AAChF,2CAA2C;AAC3C,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAS,eAAe,CAAC,cAAuB;IAC9C,OAAO,IAAA,yBAAkB,EAAC;QACxB,GAAG,EAAE,SAAS;QACd,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,cAAc,CAAC;KACvB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,cAAuB;IAClD,OAAO,IAAA,yBAAkB,EAAC;QACxB,GAAG,EAAE,cAAc;QACnB,YAAY,EAAE,eAAe;QAC7B,IAAI,EAAE,CAAC,cAAc,CAAC;KACvB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAC9B,KAA2E;IAE3E,OAAO,IAAA,yBAAkB,EAAC;QACxB,GAAG,EAAE,cAAc;QACnB,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE;YACJ,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;SACJ;KACF,CAAC,CAAC;AACL,CAAC;AAdD,4CAcC;AAED;;;;;;;GAOG;AACH,SAAgB,wBAAwB,CACtC,IAAS,EACT,SAAiB;IAEjB,MAAM,OAAO,GAAG,IAAA,2BAAoB,EAAC;QACnC,GAAG,EAAE,cAAc;QACnB,YAAY,EAAE,YAAY;QAC1B,IAAI;KACL,CAAC,CAAC;IAEH,yEAAyE;IACzE,MAAM,OAAO,GAAG,OAGb,CAAC;IAEJ,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,iBAAiB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC,CAAC;AACN,CAAC;AAxBD,4DAwBC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAAS;IAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,6CAA6C;IAC7C,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3E,OAAO,MAAM,CAAC,KAAK,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;AACjD,CAAC;AAWD;;;GAGG;AACH,MAAa,eAAe;IAK1B,YACE,WAAgC,EAChC,MAA8B;;QANvB,+CAAkC;QAElC,0CAAyC;QAMhD,uBAAA,IAAI,gCAAgB,WAAW,MAAA,CAAC;QAChC,uEAAuE;QACvE,gDAAgD;QAChD,MAAM,gBAAgB,GACpB,MAAM,EAAE,gBAAgB,KAAK,SAAS,IAAI,MAAM,CAAC,gBAAgB,GAAG,CAAC;YACnE,CAAC,CAAC,MAAM,CAAC,gBAAgB;YACzB,CAAC,CAAC,GAAG,CAAC;QACV,MAAM,SAAS,GACb,MAAM,EAAE,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC;YACrD,CAAC,CAAC,MAAM,CAAC,SAAS;YAClB,CAAC,CAAC,KAAK,CAAC;QACZ,uBAAA,IAAI,2BAAW;YACb,gBAAgB;YAChB,SAAS;SACV,MAAA,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAClB,OAAgB,EAChB,QAA4B;QAE5B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,gBAAgB,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,uBAAA,IAAI,oCAAa,MAAjB,IAAI,EAAc,OAAO,CAAC,CAAC;QAE5C,gEAAgE;QAChE,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,OAAO,uBAAA,IAAI,2EAAwB,MAA5B,IAAI,EAAyB,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC1D,CAAC;QAED,iBAAiB;QACjB,OAAO,uBAAA,IAAI,4EAAyB,MAA7B,IAAI,EAA0B,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAC7E,CAAC;CAiLF;AArOD,0CAqOC;;AA/KC;;;;;;;GAOG;AACH,KAAK,mDACH,QAAkB,EAClB,gBAAqB,EACrB,QAA4B;IAE5B,MAAM,SAAS,GAAG,uBAAA,IAAI,+BAAQ,CAAC,gBAAgB,CAAC;IAEhD,MAAM,SAAS,GAAG,MAAM,IAAA,+BAAuB,EAG7C;QACA,MAAM,EAAE,QAAQ;QAChB,SAAS;QACT,aAAa,EAAE,EAAE;QACjB,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE;YACxC,IAAI,CAAC;gBACH,yBAAyB;gBACzB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;oBAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,KAAK,YAAY,CAAC;oBACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;oBAC9D,OAAO;wBACL,MAAM;wBACN,YAAY,EAAE,IAAI;wBAClB,QAAQ,EAAE,QAAQ;4BAChB,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,cAAc,CAAC;4BACzC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC;qBACxC,CAAC;gBACJ,CAAC,CAAC,CAAC;gBAEH,kCAAkC;gBAClC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBACzC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;oBACjC,EAAE,EAAE,gBAAgB;oBACpB,IAAI,EAAE,QAAQ;iBACf,CAAC,CAAC;gBAEH,kBAAkB;gBAClB,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAEtE,gCAAgC;gBAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACtC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBAClD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;oBAE3C,IAAI,OAAO,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACnD,aAAa,CAAC,IAAI,CAAC;4BACjB,YAAY;4BACZ,cAAc;4BACd,OAAO,EAAE,IAAI;4BACb,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC;yBACnC,CAAC,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACN,aAAa,CAAC,IAAI,CAAC;4BACjB,YAAY;4BACZ,cAAc;4BACd,OAAO,EAAE,KAAK;yBACf,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;gBACrE,uEAAuE;gBACvE,6DAA6D;gBAC7D,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,GAAG,CACvC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAA,IAAI,uEAAoB,MAAxB,IAAI,EAAqB,QAAQ,EAAE,GAAG,CAAC,CAAC,CAC5D,CAAC;gBAEF,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;oBACrC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;YAED,OAAO,aAAa,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,kDACH,QAAkB,EAClB,QAA4B;IAE5B,iFAAiF;IACjF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,uBAAA,IAAI,+BAAQ,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAE9D,MAAM,SAAS,GAAG,MAAM,IAAA,+BAAuB,EAG7C;QACA,MAAM,EAAE,QAAQ;QAChB,SAAS;QACT,aAAa,EAAE,EAAE;QACjB,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE;YACxC,uEAAuE;YACvE,6DAA6D;YAC7D,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAA,IAAI,uEAAoB,MAAxB,IAAI,EAAqB,QAAQ,EAAE,GAAG,CAAC,CAAC,CAC5D,CAAC;YAEF,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;gBAClC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;YAED,OAAO,aAAa,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,8CACH,QAAkB,EAClB,OAAyB;IAEzB,+DAA+D;IAC/D,gEAAgE;IAChE,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;QAEjD,8BAA8B;QAC9B,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YAC1D,OAAO;gBACL,YAAY;gBACZ,cAAc;gBACd,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;aAC5B,CAAC;QACJ,CAAC;QAED,eAAe;QACf,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;YACjC,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAa,CAAC,CAAC;QAC7C,OAAO;YACL,YAAY;YACZ,cAAc;YACd,OAAO,EAAE,IAAI;YACb,OAAO;SACR,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import type { Hex } from '@metamask/utils';\nimport type { Abi } from 'viem';\nimport { decodeFunctionResult, encodeFunctionData } from 'viem';\n\nimport type {\n  Address,\n  BalanceOfRequest,\n  BalanceOfResponse,\n  ChainId,\n  GetProviderFunction,\n  Provider,\n} from '../types';\nimport { reduceInBatchesSerially } from '../utils';\n\n// =============================================================================\n// ABI DEFINITIONS\n// =============================================================================\n\n/**\n * Multicall3 contract ABI (subset for aggregate3 and getEthBalance).\n *\n * @see https://github.com/mds1/multicall\n */\nconst MULTICALL3_ABI = [\n  {\n    name: 'aggregate3',\n    type: 'function',\n    stateMutability: 'payable',\n    inputs: [\n      {\n        name: 'calls',\n        type: 'tuple[]',\n        components: [\n          { name: 'target', type: 'address' },\n          { name: 'allowFailure', type: 'bool' },\n          { name: 'callData', type: 'bytes' },\n        ],\n      },\n    ],\n    outputs: [\n      {\n        name: 'returnData',\n        type: 'tuple[]',\n        components: [\n          { name: 'success', type: 'bool' },\n          { name: 'returnData', type: 'bytes' },\n        ],\n      },\n    ],\n  },\n  {\n    name: 'getEthBalance',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'addr', type: 'address' }],\n    outputs: [{ name: 'balance', type: 'uint256' }],\n  },\n] as const satisfies Abi;\n\n/**\n * ERC-20 ABI (subset for balanceOf).\n */\nconst ERC20_ABI = [\n  {\n    name: 'balanceOf',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'account', type: 'address' }],\n    outputs: [{ name: 'balance', type: 'uint256' }],\n  },\n] as const satisfies Abi;\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\n\n/**\n * Zero address constant for native token.\n */\nconst ZERO_ADDRESS: Address =\n  '0x0000000000000000000000000000000000000000' as Address;\n\n/**\n * Multicall3 contract addresses by chain ID.\n * Source: https://github.com/mds1/multicall/blob/main/deployments.json\n *\n * TODO: try to find service to use here instead of hardcoding the addresses\n */\nconst MULTICALL3_ADDRESS_BY_CHAIN: Record<Hex, Hex> = {\n  '0x1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xaa36a7': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4268': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5e9': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1b6e6': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x18fc4a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x45': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1a4': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xaa37dc': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa4b1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa4ba': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x66eed': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x66eee': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x66eeb': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15f2249': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x89': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13881': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13882': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x44d': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x5a2': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x98a': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x64': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x27d8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa86a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa869': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xfa2': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xfa': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xfaf0': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x38': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x61': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15eb': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xcc': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x504': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x505': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x507': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2a15c308d': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x2a15c3083': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x63564c40': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x19': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x152': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5535072': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6c1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x7a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x10': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x72': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x120': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4e454152': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x250': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5c2359': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xec0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x42': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x80': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x440': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x257': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe9fe': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xd3a0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x84444': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1e': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2329': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2328': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6c': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x12': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa516': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5afe': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa4ec': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xaef3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x116ea': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x116e9': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2019': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3e9': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x7d1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x141': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x28': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4d2': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1e14': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1e15': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1251': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x7f08': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8ae': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x138b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1389': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1388': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1f92': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x14a33': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x14a34': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2105': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x936': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xff': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x46a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x46b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x14f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xd2af': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe9ac0ce': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe705': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0xe704': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe708': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2b6f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x39': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x23a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1644': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xdea8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3af': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x171': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3e7': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x76adf1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3b9ac9ff': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2c': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x2e': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x15b3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x82751': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8274f': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x82750': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x96f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3cc5': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4571': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe99': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x7d0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1297': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1d5e': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3a14269b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x561bf78b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x235ddd0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3cd156dc': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5d456c62': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x79f99296': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x585eb4b1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x507aaa2a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1fc3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x32d': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8a73': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8a72': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8a71': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe9ac0d6': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x1069': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x7e5': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x53': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x52': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0xe298': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1a8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x94': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2c6': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2803': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2802': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa9': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x28c5f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x28c60': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4cb2f': '0xdbfa261cd7d17bb40479a0493ad6c0fee435859e',\n  '0x7f93': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xb660': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xb02113d3f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xdad': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xdae': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15b38': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15b32': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x45c': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x45b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3d': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x41a6ace': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa729': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1f47b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1b59': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x1b58': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xc3': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x16fd8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xc7': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x405': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x334': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1ce': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x1cf': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0xa70e': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x868b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa0c71fd': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13e31': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa1337': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1f2b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xf63': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x144': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0x118': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0x12c': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0x18995f': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0x2b74': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0xfc': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x9da': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x137': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13ed': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x24b1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xba9302': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x7c8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x138d5': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6d': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x343b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x34a1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3109': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x91b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa96': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x22c3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2be3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xbf03': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1b254': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa7b14': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2276': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1b9e': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6a63bb8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15af3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15af1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xae3f3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x531': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x28c61': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x28c58': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x1d88': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5b9b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4c7e1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa53b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1a2b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x406': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x2cef': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x18b2': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x182a9': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xc4': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xfdd': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xfde': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x99c0a0f': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x22cf': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x310c5': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x46f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x659': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x139c968f9': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xed88': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xd036': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1f3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x31bf8c3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1cbc67bfdc': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x98967f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4f588': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x16db': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x3a': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x59': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x1e0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2eb': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x221': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6f0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa867': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2611': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa6': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15f900': '0x6B5eFbC0C82eBb26CA13a4F11836f36Fc6fdBC5D',\n  '0x74c': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x407b': '0x90a2377F233E3461BACa6080d4837837d8762927',\n  '0xa3c3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xab5': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0x138de': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x18c6': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8173': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2ba': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x279f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xb67d2': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x18232': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x32': '0x0B1795ccA8E4eC4df02346a082df54D437F8D9aF',\n  '0x18c7': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x10e6': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x10b3e': '0x99423C88EB5723A590b4C644426069042f137B9e',\n};\n\n// =============================================================================\n// ENCODING/DECODING UTILITIES (using viem)\n// =============================================================================\n\n/**\n * Encode a balanceOf call for an ERC-20 token.\n *\n * @param accountAddress - The account address.\n * @returns The encoded call data.\n */\nfunction encodeBalanceOf(accountAddress: Address): Hex {\n  return encodeFunctionData({\n    abi: ERC20_ABI,\n    functionName: 'balanceOf',\n    args: [accountAddress],\n  });\n}\n\n/**\n * Encode a getEthBalance call for native token via Multicall3.\n *\n * @param accountAddress - The account address.\n * @returns The encoded call data.\n */\nfunction encodeGetEthBalance(accountAddress: Address): Hex {\n  return encodeFunctionData({\n    abi: MULTICALL3_ABI,\n    functionName: 'getEthBalance',\n    args: [accountAddress],\n  });\n}\n\n/**\n * Encode a Multicall3 aggregate3 call.\n *\n * @param calls - Array of calls with target, allowFailure, and callData.\n * @returns The encoded aggregate3 call data.\n */\nexport function encodeAggregate3(\n  calls: readonly { target: Address; allowFailure: boolean; callData: Hex }[],\n): Hex {\n  return encodeFunctionData({\n    abi: MULTICALL3_ABI,\n    functionName: 'aggregate3',\n    args: [\n      calls.map((call) => ({\n        target: call.target,\n        allowFailure: call.allowFailure,\n        callData: call.callData,\n      })),\n    ],\n  });\n}\n\n/**\n * Decode the response from aggregate3.\n * Returns array of (success, returnData) tuples.\n *\n * @param data - The raw response data.\n * @param callCount - Number of calls made (used for validation).\n * @returns Array of success and return data.\n */\nexport function decodeAggregate3Response(\n  data: Hex,\n  callCount: number,\n): { success: boolean; returnData: Hex }[] {\n  const decoded = decodeFunctionResult({\n    abi: MULTICALL3_ABI,\n    functionName: 'aggregate3',\n    data,\n  });\n\n  // decoded is an array of { success: boolean, returnData: `0x${string}` }\n  const results = decoded as readonly {\n    success: boolean;\n    returnData: Hex;\n  }[];\n\n  if (results.length !== callCount) {\n    throw new Error(`Expected ${callCount} results, got ${results.length}`);\n  }\n\n  return results.map((result) => ({\n    success: result.success,\n    returnData: result.returnData,\n  }));\n}\n\n/**\n * Decode a uint256 balance from return data.\n *\n * @param data - The hex return data.\n * @returns The decoded balance as a string.\n */\nfunction decodeUint256(data: Hex): string {\n  const hexData = data.slice(2);\n  if (hexData.length === 0) {\n    return '0';\n  }\n  // Take first 64 chars (32 bytes) for uint256\n  const normalizedHex = hexData.length > 64 ? hexData.slice(0, 64) : hexData;\n  return BigInt(`0x${normalizedHex}`).toString();\n}\n\n// =============================================================================\n// MULTICALL CLIENT\n// =============================================================================\n\nexport type MulticallClientConfig = {\n  maxCallsPerBatch?: number;\n  timeoutMs?: number;\n};\n\n/**\n * Client for batching RPC calls using Multicall3.\n * Falls back to individual calls on chains without Multicall3 support.\n */\nexport class MulticallClient {\n  readonly #getProvider: GetProviderFunction;\n\n  readonly #config: Required<MulticallClientConfig>;\n\n  constructor(\n    getProvider: GetProviderFunction,\n    config?: MulticallClientConfig,\n  ) {\n    this.#getProvider = getProvider;\n    // Use default values for invalid (non-positive) batch sizes to prevent\n    // infinite loops or errors in divideIntoBatches\n    const maxCallsPerBatch =\n      config?.maxCallsPerBatch !== undefined && config.maxCallsPerBatch > 0\n        ? config.maxCallsPerBatch\n        : 300;\n    const timeoutMs =\n      config?.timeoutMs !== undefined && config.timeoutMs > 0\n        ? config.timeoutMs\n        : 30000;\n    this.#config = {\n      maxCallsPerBatch,\n      timeoutMs,\n    };\n  }\n\n  /**\n   * Fetch ERC-20 and native token balances using Multicall3.\n   * Falls back to individual RPC calls on unsupported chains.\n   *\n   * @param chainId - The chain ID.\n   * @param requests - Array of balance requests.\n   * @returns Array of balance responses.\n   */\n  async batchBalanceOf(\n    chainId: ChainId,\n    requests: BalanceOfRequest[],\n  ): Promise<BalanceOfResponse[]> {\n    if (requests.length === 0) {\n      return [];\n    }\n\n    const multicallAddress = MULTICALL3_ADDRESS_BY_CHAIN[chainId];\n    const provider = this.#getProvider(chainId);\n\n    // If Multicall3 is not supported, fall back to individual calls\n    if (!multicallAddress) {\n      return this.#fallbackBatchBalanceOf(provider, requests);\n    }\n\n    // Use Multicall3\n    return this.#multicallBatchBalanceOf(provider, multicallAddress, requests);\n  }\n\n  /**\n   * Fetch balances using Multicall3 aggregate3.\n   *\n   * @param provider - The RPC provider.\n   * @param multicallAddress - The Multicall3 contract address.\n   * @param requests - Array of balance requests.\n   * @returns Array of balance responses.\n   */\n  async #multicallBatchBalanceOf(\n    provider: Provider,\n    multicallAddress: Hex,\n    requests: BalanceOfRequest[],\n  ): Promise<BalanceOfResponse[]> {\n    const batchSize = this.#config.maxCallsPerBatch;\n\n    const responses = await reduceInBatchesSerially<\n      BalanceOfRequest,\n      BalanceOfResponse[]\n    >({\n      values: requests,\n      batchSize,\n      initialResult: [],\n      eachBatch: async (workingResult, batch) => {\n        try {\n          // Build aggregate3 calls\n          const calls = batch.map((req) => {\n            const isNative = req.tokenAddress === ZERO_ADDRESS;\n            const target = isNative ? multicallAddress : req.tokenAddress;\n            return {\n              target,\n              allowFailure: true,\n              callData: isNative\n                ? encodeGetEthBalance(req.accountAddress)\n                : encodeBalanceOf(req.accountAddress),\n            };\n          });\n\n          // Encode and send aggregate3 call\n          const callData = encodeAggregate3(calls);\n          const result = await provider.call({\n            to: multicallAddress,\n            data: callData,\n          });\n\n          // Decode response\n          const decoded = decodeAggregate3Response(result as Hex, batch.length);\n\n          // Map results back to responses\n          for (let i = 0; i < batch.length; i++) {\n            const { tokenAddress, accountAddress } = batch[i];\n            const { success, returnData } = decoded[i];\n\n            if (success && returnData && returnData.length > 2) {\n              workingResult.push({\n                tokenAddress,\n                accountAddress,\n                success: true,\n                balance: decodeUint256(returnData),\n              });\n            } else {\n              workingResult.push({\n                tokenAddress,\n                accountAddress,\n                success: false,\n              });\n            }\n          }\n        } catch {\n          // On aggregate3 error, fall back to individual calls for this batch.\n          // #fetchSingleBalance never rejects - it catches all errors internally\n          // and returns a failed response, so we use Promise.all here.\n          const fallbackResults = await Promise.all(\n            batch.map((req) => this.#fetchSingleBalance(provider, req)),\n          );\n\n          for (const result of fallbackResults) {\n            workingResult.push(result);\n          }\n        }\n\n        return workingResult;\n      },\n    });\n\n    return responses;\n  }\n\n  /**\n   * Fallback: fetch balances using individual RPC calls.\n   *\n   * @param provider - The RPC provider.\n   * @param requests - Array of balance requests.\n   * @returns Array of balance responses.\n   */\n  async #fallbackBatchBalanceOf(\n    provider: Provider,\n    requests: BalanceOfRequest[],\n  ): Promise<BalanceOfResponse[]> {\n    // Use smaller batch size for parallel individual calls to avoid overwhelming RPC\n    const batchSize = Math.min(this.#config.maxCallsPerBatch, 50);\n\n    const responses = await reduceInBatchesSerially<\n      BalanceOfRequest,\n      BalanceOfResponse[]\n    >({\n      values: requests,\n      batchSize,\n      initialResult: [],\n      eachBatch: async (workingResult, batch) => {\n        // #fetchSingleBalance never rejects - it catches all errors internally\n        // and returns a failed response, so we use Promise.all here.\n        const batchResults = await Promise.all(\n          batch.map((req) => this.#fetchSingleBalance(provider, req)),\n        );\n\n        for (const result of batchResults) {\n          workingResult.push(result);\n        }\n\n        return workingResult;\n      },\n    });\n\n    return responses;\n  }\n\n  /**\n   * Fetch a single token balance (fallback method).\n   *\n   * @param provider - The RPC provider.\n   * @param request - The balance request.\n   * @returns The balance response.\n   */\n  async #fetchSingleBalance(\n    provider: Provider,\n    request: BalanceOfRequest,\n  ): Promise<BalanceOfResponse> {\n    // Destructure inside try block to ensure any errors are caught\n    // and don't cause promise rejections that bypass error handling\n    try {\n      const { tokenAddress, accountAddress } = request;\n\n      // Native token (zero address)\n      if (tokenAddress === ZERO_ADDRESS) {\n        const balance = await provider.getBalance(accountAddress);\n        return {\n          tokenAddress,\n          accountAddress,\n          success: true,\n          balance: balance.toString(),\n        };\n      }\n\n      // ERC-20 token\n      const callData = encodeBalanceOf(accountAddress);\n      const result = await provider.call({\n        to: tokenAddress,\n        data: callData,\n      });\n\n      const balance = decodeUint256(result as Hex);\n      return {\n        tokenAddress,\n        accountAddress,\n        success: true,\n        balance,\n      };\n    } catch {\n      return {\n        tokenAddress: request.tokenAddress,\n        accountAddress: request.accountAddress,\n        success: false,\n      };\n    }\n  }\n}\n"]}

package/dist/data-sources/evm-rpc-services/clients/MulticallClient.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MulticallClient.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/MulticallClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAI3C,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,mBAAmB,EAEpB,2BAAiB;AAiYlB;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,EAAE,GAC1E,GAAG,CAYL;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,GAAG,EACT,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,GAAG,CAAA;CAAE,EAAE,CAqBzC;AAsBD,MAAM,MAAM,qBAAqB,GAAG;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,qBAAa,eAAe;;gBAMxB,WAAW,EAAE,mBAAmB,EAChC,MAAM,CAAC,EAAE,qBAAqB;IAmBhC;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAgMhC"}

package/dist/data-sources/evm-rpc-services/clients/MulticallClient.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MulticallClient.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/MulticallClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAI3C,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,mBAAmB,EAEpB,2BAAiB;AAiYlB;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,EAAE,GAC1E,GAAG,CAYL;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,GAAG,EACT,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,GAAG,CAAA;CAAE,EAAE,CAqBzC;AAsBD,MAAM,MAAM,qBAAqB,GAAG;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,qBAAa,eAAe;;gBAMxB,WAAW,EAAE,mBAAmB,EAChC,MAAM,CAAC,EAAE,qBAAqB;IAmBhC;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAgMhC"}

package/dist/data-sources/evm-rpc-services/clients/MulticallClient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MulticallClient.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/MulticallClient.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Hex } from '@metamask/utils';\nimport type { Abi } from 'viem';\nimport { decodeFunctionResult, encodeFunctionData } from 'viem';\n\nimport type {\n  Address,\n  BalanceOfRequest,\n  BalanceOfResponse,\n  ChainId,\n  GetProviderFunction,\n  Provider,\n} from '../types';\nimport { reduceInBatchesSerially } from '../utils';\n\n// =============================================================================\n// ABI DEFINITIONS\n// =============================================================================\n\n/**\n * Multicall3 contract ABI (subset for aggregate3 and getEthBalance).\n *\n * @see https://github.com/mds1/multicall\n */\nconst MULTICALL3_ABI = [\n  {\n    name: 'aggregate3',\n    type: 'function',\n    stateMutability: 'payable',\n    inputs: [\n      {\n        name: 'calls',\n        type: 'tuple[]',\n        components: [\n          { name: 'target', type: 'address' },\n          { name: 'allowFailure', type: 'bool' },\n          { name: 'callData', type: 'bytes' },\n        ],\n      },\n    ],\n    outputs: [\n      {\n        name: 'returnData',\n        type: 'tuple[]',\n        components: [\n          { name: 'success', type: 'bool' },\n          { name: 'returnData', type: 'bytes' },\n        ],\n      },\n    ],\n  },\n  {\n    name: 'getEthBalance',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'addr', type: 'address' }],\n    outputs: [{ name: 'balance', type: 'uint256' }],\n  },\n] as const satisfies Abi;\n\n/**\n * ERC-20 ABI (subset for balanceOf).\n */\nconst ERC20_ABI = [\n  {\n    name: 'balanceOf',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'account', type: 'address' }],\n    outputs: [{ name: 'balance', type: 'uint256' }],\n  },\n] as const satisfies Abi;\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\n\n/**\n * Zero address constant for native token.\n */\nconst ZERO_ADDRESS: Address =\n  '0x0000000000000000000000000000000000000000' as Address;\n\n/**\n * Multicall3 contract addresses by chain ID.\n * Source: https://github.com/mds1/multicall/blob/main/deployments.json\n *\n * TODO: try to find service to use here instead of hardcoding the addresses\n */\nconst MULTICALL3_ADDRESS_BY_CHAIN: Record<Hex, Hex> = {\n  '0x1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xaa36a7': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4268': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5e9': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1b6e6': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x18fc4a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x45': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1a4': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xaa37dc': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa4b1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa4ba': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x66eed': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x66eee': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x66eeb': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15f2249': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x89': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13881': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13882': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x44d': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x5a2': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x98a': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x64': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x27d8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa86a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa869': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xfa2': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xfa': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xfaf0': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x38': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x61': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15eb': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xcc': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x504': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x505': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x507': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2a15c308d': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x2a15c3083': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x63564c40': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x19': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x152': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5535072': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6c1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x7a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x10': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x72': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x120': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4e454152': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x250': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5c2359': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xec0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x42': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x80': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x440': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x257': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe9fe': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xd3a0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x84444': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1e': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2329': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2328': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6c': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x12': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa516': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5afe': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa4ec': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xaef3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x116ea': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x116e9': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2019': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3e9': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x7d1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x141': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x28': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4d2': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1e14': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1e15': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1251': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x7f08': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8ae': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x138b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1389': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1388': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1f92': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x14a33': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x14a34': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2105': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x936': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xff': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x46a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x46b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x14f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xd2af': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe9ac0ce': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe705': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0xe704': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe708': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2b6f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x39': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x23a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1644': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xdea8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3af': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x171': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3e7': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x76adf1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3b9ac9ff': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2c': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x2e': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x15b3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x82751': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8274f': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x82750': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x96f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3cc5': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4571': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe99': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x7d0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1297': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1d5e': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3a14269b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x561bf78b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x235ddd0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3cd156dc': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5d456c62': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x79f99296': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x585eb4b1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x507aaa2a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1fc3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x32d': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8a73': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8a72': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8a71': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe9ac0d6': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x1069': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x7e5': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x53': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x52': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0xe298': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1a8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x94': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2c6': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2803': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2802': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa9': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x28c5f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x28c60': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13a': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4cb2f': '0xdbfa261cd7d17bb40479a0493ad6c0fee435859e',\n  '0x7f93': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xb660': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xb02113d3f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xdad': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xdae': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15b38': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15b32': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x45c': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x45b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3d': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x41a6ace': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa729': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1f47b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1b59': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x1b58': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xc3': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x16fd8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xc7': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x405': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x334': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1ce': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x1cf': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0xa70e': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x868b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa0c71fd': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13e31': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa1337': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1f2b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xf63': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x144': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0x118': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0x12c': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0x18995f': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0x2b74': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0xfc': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x9da': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x137': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x13ed': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x24b1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xba9302': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x7c8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x138d5': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6d': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x343b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x34a1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x3109': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x91b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa96': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x22c3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2be3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xbf03': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1b254': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa7b14': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2276': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1b9e': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6a63bb8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15af3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15af1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xae3f3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x531': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x28c61': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x28c58': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x1d88': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x5b9b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4c7e1': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa53b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1a2b': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x406': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x2cef': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x18b2': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x182a9': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xc4': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xfdd': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xfde': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x99c0a0f': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x22cf': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x310c5': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x46f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x659': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x139c968f9': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xed88': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xd036': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1f3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x31bf8c3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x1cbc67bfdc': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x98967f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x4f588': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x16db': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x3a': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x59': '0xca11bde05977b3631167028862be2a173976ca11',\n  '0x1e0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2eb': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x221': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x6f0': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa867': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2611': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xa6': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x15f900': '0x6B5eFbC0C82eBb26CA13a4F11836f36Fc6fdBC5D',\n  '0x74c': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x407b': '0x90a2377F233E3461BACa6080d4837837d8762927',\n  '0xa3c3': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xab5': '0xF9cda624FBC7e059355ce98a31693d299FACd963',\n  '0x138de': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x18c6': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8173': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x2ba': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x279f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xb67d2': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0xe8': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x18232': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x8f': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x32': '0x0B1795ccA8E4eC4df02346a082df54D437F8D9aF',\n  '0x18c7': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x10e6': '0xcA11bde05977b3631167028862bE2a173976CA11',\n  '0x10b3e': '0x99423C88EB5723A590b4C644426069042f137B9e',\n};\n\n// =============================================================================\n// ENCODING/DECODING UTILITIES (using viem)\n// =============================================================================\n\n/**\n * Encode a balanceOf call for an ERC-20 token.\n *\n * @param accountAddress - The account address.\n * @returns The encoded call data.\n */\nfunction encodeBalanceOf(accountAddress: Address): Hex {\n  return encodeFunctionData({\n    abi: ERC20_ABI,\n    functionName: 'balanceOf',\n    args: [accountAddress],\n  });\n}\n\n/**\n * Encode a getEthBalance call for native token via Multicall3.\n *\n * @param accountAddress - The account address.\n * @returns The encoded call data.\n */\nfunction encodeGetEthBalance(accountAddress: Address): Hex {\n  return encodeFunctionData({\n    abi: MULTICALL3_ABI,\n    functionName: 'getEthBalance',\n    args: [accountAddress],\n  });\n}\n\n/**\n * Encode a Multicall3 aggregate3 call.\n *\n * @param calls - Array of calls with target, allowFailure, and callData.\n * @returns The encoded aggregate3 call data.\n */\nexport function encodeAggregate3(\n  calls: readonly { target: Address; allowFailure: boolean; callData: Hex }[],\n): Hex {\n  return encodeFunctionData({\n    abi: MULTICALL3_ABI,\n    functionName: 'aggregate3',\n    args: [\n      calls.map((call) => ({\n        target: call.target,\n        allowFailure: call.allowFailure,\n        callData: call.callData,\n      })),\n    ],\n  });\n}\n\n/**\n * Decode the response from aggregate3.\n * Returns array of (success, returnData) tuples.\n *\n * @param data - The raw response data.\n * @param callCount - Number of calls made (used for validation).\n * @returns Array of success and return data.\n */\nexport function decodeAggregate3Response(\n  data: Hex,\n  callCount: number,\n): { success: boolean; returnData: Hex }[] {\n  const decoded = decodeFunctionResult({\n    abi: MULTICALL3_ABI,\n    functionName: 'aggregate3',\n    data,\n  });\n\n  // decoded is an array of { success: boolean, returnData: `0x${string}` }\n  const results = decoded as readonly {\n    success: boolean;\n    returnData: Hex;\n  }[];\n\n  if (results.length !== callCount) {\n    throw new Error(`Expected ${callCount} results, got ${results.length}`);\n  }\n\n  return results.map((result) => ({\n    success: result.success,\n    returnData: result.returnData,\n  }));\n}\n\n/**\n * Decode a uint256 balance from return data.\n *\n * @param data - The hex return data.\n * @returns The decoded balance as a string.\n */\nfunction decodeUint256(data: Hex): string {\n  const hexData = data.slice(2);\n  if (hexData.length === 0) {\n    return '0';\n  }\n  // Take first 64 chars (32 bytes) for uint256\n  const normalizedHex = hexData.length > 64 ? hexData.slice(0, 64) : hexData;\n  return BigInt(`0x${normalizedHex}`).toString();\n}\n\n// =============================================================================\n// MULTICALL CLIENT\n// =============================================================================\n\nexport type MulticallClientConfig = {\n  maxCallsPerBatch?: number;\n  timeoutMs?: number;\n};\n\n/**\n * Client for batching RPC calls using Multicall3.\n * Falls back to individual calls on chains without Multicall3 support.\n */\nexport class MulticallClient {\n  readonly #getProvider: GetProviderFunction;\n\n  readonly #config: Required<MulticallClientConfig>;\n\n  constructor(\n    getProvider: GetProviderFunction,\n    config?: MulticallClientConfig,\n  ) {\n    this.#getProvider = getProvider;\n    // Use default values for invalid (non-positive) batch sizes to prevent\n    // infinite loops or errors in divideIntoBatches\n    const maxCallsPerBatch =\n      config?.maxCallsPerBatch !== undefined && config.maxCallsPerBatch > 0\n        ? config.maxCallsPerBatch\n        : 300;\n    const timeoutMs =\n      config?.timeoutMs !== undefined && config.timeoutMs > 0\n        ? config.timeoutMs\n        : 30000;\n    this.#config = {\n      maxCallsPerBatch,\n      timeoutMs,\n    };\n  }\n\n  /**\n   * Fetch ERC-20 and native token balances using Multicall3.\n   * Falls back to individual RPC calls on unsupported chains.\n   *\n   * @param chainId - The chain ID.\n   * @param requests - Array of balance requests.\n   * @returns Array of balance responses.\n   */\n  async batchBalanceOf(\n    chainId: ChainId,\n    requests: BalanceOfRequest[],\n  ): Promise<BalanceOfResponse[]> {\n    if (requests.length === 0) {\n      return [];\n    }\n\n    const multicallAddress = MULTICALL3_ADDRESS_BY_CHAIN[chainId];\n    const provider = this.#getProvider(chainId);\n\n    // If Multicall3 is not supported, fall back to individual calls\n    if (!multicallAddress) {\n      return this.#fallbackBatchBalanceOf(provider, requests);\n    }\n\n    // Use Multicall3\n    return this.#multicallBatchBalanceOf(provider, multicallAddress, requests);\n  }\n\n  /**\n   * Fetch balances using Multicall3 aggregate3.\n   *\n   * @param provider - The RPC provider.\n   * @param multicallAddress - The Multicall3 contract address.\n   * @param requests - Array of balance requests.\n   * @returns Array of balance responses.\n   */\n  async #multicallBatchBalanceOf(\n    provider: Provider,\n    multicallAddress: Hex,\n    requests: BalanceOfRequest[],\n  ): Promise<BalanceOfResponse[]> {\n    const batchSize = this.#config.maxCallsPerBatch;\n\n    const responses = await reduceInBatchesSerially<\n      BalanceOfRequest,\n      BalanceOfResponse[]\n    >({\n      values: requests,\n      batchSize,\n      initialResult: [],\n      eachBatch: async (workingResult, batch) => {\n        try {\n          // Build aggregate3 calls\n          const calls = batch.map((req) => {\n            const isNative = req.tokenAddress === ZERO_ADDRESS;\n            const target = isNative ? multicallAddress : req.tokenAddress;\n            return {\n              target,\n              allowFailure: true,\n              callData: isNative\n                ? encodeGetEthBalance(req.accountAddress)\n                : encodeBalanceOf(req.accountAddress),\n            };\n          });\n\n          // Encode and send aggregate3 call\n          const callData = encodeAggregate3(calls);\n          const result = await provider.call({\n            to: multicallAddress,\n            data: callData,\n          });\n\n          // Decode response\n          const decoded = decodeAggregate3Response(result as Hex, batch.length);\n\n          // Map results back to responses\n          for (let i = 0; i < batch.length; i++) {\n            const { tokenAddress, accountAddress } = batch[i];\n            const { success, returnData } = decoded[i];\n\n            if (success && returnData && returnData.length > 2) {\n              workingResult.push({\n                tokenAddress,\n                accountAddress,\n                success: true,\n                balance: decodeUint256(returnData),\n              });\n            } else {\n              workingResult.push({\n                tokenAddress,\n                accountAddress,\n                success: false,\n              });\n            }\n          }\n        } catch {\n          // On aggregate3 error, fall back to individual calls for this batch.\n          // #fetchSingleBalance never rejects - it catches all errors internally\n          // and returns a failed response, so we use Promise.all here.\n          const fallbackResults = await Promise.all(\n            batch.map((req) => this.#fetchSingleBalance(provider, req)),\n          );\n\n          for (const result of fallbackResults) {\n            workingResult.push(result);\n          }\n        }\n\n        return workingResult;\n      },\n    });\n\n    return responses;\n  }\n\n  /**\n   * Fallback: fetch balances using individual RPC calls.\n   *\n   * @param provider - The RPC provider.\n   * @param requests - Array of balance requests.\n   * @returns Array of balance responses.\n   */\n  async #fallbackBatchBalanceOf(\n    provider: Provider,\n    requests: BalanceOfRequest[],\n  ): Promise<BalanceOfResponse[]> {\n    // Use smaller batch size for parallel individual calls to avoid overwhelming RPC\n    const batchSize = Math.min(this.#config.maxCallsPerBatch, 50);\n\n    const responses = await reduceInBatchesSerially<\n      BalanceOfRequest,\n      BalanceOfResponse[]\n    >({\n      values: requests,\n      batchSize,\n      initialResult: [],\n      eachBatch: async (workingResult, batch) => {\n        // #fetchSingleBalance never rejects - it catches all errors internally\n        // and returns a failed response, so we use Promise.all here.\n        const batchResults = await Promise.all(\n          batch.map((req) => this.#fetchSingleBalance(provider, req)),\n        );\n\n        for (const result of batchResults) {\n          workingResult.push(result);\n        }\n\n        return workingResult;\n      },\n    });\n\n    return responses;\n  }\n\n  /**\n   * Fetch a single token balance (fallback method).\n   *\n   * @param provider - The RPC provider.\n   * @param request - The balance request.\n   * @returns The balance response.\n   */\n  async #fetchSingleBalance(\n    provider: Provider,\n    request: BalanceOfRequest,\n  ): Promise<BalanceOfResponse> {\n    // Destructure inside try block to ensure any errors are caught\n    // and don't cause promise rejections that bypass error handling\n    try {\n      const { tokenAddress, accountAddress } = request;\n\n      // Native token (zero address)\n      if (tokenAddress === ZERO_ADDRESS) {\n        const balance = await provider.getBalance(accountAddress);\n        return {\n          tokenAddress,\n          accountAddress,\n          success: true,\n          balance: balance.toString(),\n        };\n      }\n\n      // ERC-20 token\n      const callData = encodeBalanceOf(accountAddress);\n      const result = await provider.call({\n        to: tokenAddress,\n        data: callData,\n      });\n\n      const balance = decodeUint256(result as Hex);\n      return {\n        tokenAddress,\n        accountAddress,\n        success: true,\n        balance,\n      };\n    } catch {\n      return {\n        tokenAddress: request.tokenAddress,\n        accountAddress: request.accountAddress,\n        success: false,\n      };\n    }\n  }\n}\n"]}

package/dist/data-sources/evm-rpc-services/clients/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/index.ts"],"names":[],"mappings":";;;AAAA,yDAK2B;AAJzB,2HAAA,wBAAwB,OAAA;AACxB,mHAAA,gBAAgB,OAAA;AAChB,kHAAA,eAAe,OAAA","sourcesContent":["export {\n  decodeAggregate3Response,\n  encodeAggregate3,\n  MulticallClient,\n  type MulticallClientConfig,\n} from './MulticallClient';\n\n// Re-export provider types from types module\nexport type { GetProviderFunction, Provider } from '../types';\n"]}

package/dist/data-sources/evm-rpc-services/clients/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,KAAK,qBAAqB,GAC3B,8BAA0B;AAG3B,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,2BAAiB"}

package/dist/data-sources/evm-rpc-services/clients/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,KAAK,qBAAqB,GAC3B,8BAA0B;AAG3B,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,2BAAiB"}

package/dist/data-sources/evm-rpc-services/clients/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EAEhB,8BAA0B","sourcesContent":["export {\n  decodeAggregate3Response,\n  encodeAggregate3,\n  MulticallClient,\n  type MulticallClientConfig,\n} from './MulticallClient';\n\n// Re-export provider types from types module\nexport type { GetProviderFunction, Provider } from '../types';\n"]}

package/dist/data-sources/evm-rpc-services/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/data-sources/evm-rpc-services/index.ts"],"names":[],"mappings":";;;AAYA,+CAAwE;AAA/D,0GAAA,eAAe,OAAA;AACxB,iDAOoB;AANlB,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AAMf,2CAAqE;AAA5D,0GAAA,iBAAiB,OAAA;AAAE,gHAAA,uBAAuB,OAAA","sourcesContent":["export type {\n  Address,\n  ChainId,\n  GetProviderFunction,\n  Provider,\n  BalanceOfRequest,\n  BalanceOfResponse,\n  TokenListState,\n  UserTokensState,\n  BalanceFetchResult,\n  TokenDetectionResult,\n} from './types';\nexport { MulticallClient, type MulticallClientConfig } from './clients';\nexport {\n  BalanceFetcher,\n  TokenDetector,\n  type BalancePollingInput,\n  type DetectionPollingInput,\n  type OnBalanceUpdateCallback,\n  type OnDetectionUpdateCallback,\n} from './services';\nexport { divideIntoBatches, reduceInBatchesSerially } from './utils';\n"]}

package/dist/data-sources/evm-rpc-services/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/data-sources/evm-rpc-services/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,OAAO,EACP,mBAAmB,EACnB,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,0BAAgB;AACjB,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,4BAAkB;AACxE,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,GAC/B,6BAAmB;AACpB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,0BAAgB"}

package/dist/data-sources/evm-rpc-services/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/data-sources/evm-rpc-services/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,OAAO,EACP,mBAAmB,EACnB,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,0BAAgB;AACjB,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,4BAAkB;AACxE,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,GAC/B,6BAAmB;AACpB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,0BAAgB"}

package/dist/data-sources/evm-rpc-services/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/data-sources/evm-rpc-services/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAA8B,4BAAkB;AACxE,OAAO,EACL,cAAc,EACd,aAAa,EAKd,6BAAmB;AACpB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,0BAAgB","sourcesContent":["export type {\n  Address,\n  ChainId,\n  GetProviderFunction,\n  Provider,\n  BalanceOfRequest,\n  BalanceOfResponse,\n  TokenListState,\n  UserTokensState,\n  BalanceFetchResult,\n  TokenDetectionResult,\n} from './types';\nexport { MulticallClient, type MulticallClientConfig } from './clients';\nexport {\n  BalanceFetcher,\n  TokenDetector,\n  type BalancePollingInput,\n  type DetectionPollingInput,\n  type OnBalanceUpdateCallback,\n  type OnDetectionUpdateCallback,\n} from './services';\nexport { divideIntoBatches, reduceInBatchesSerially } from './utils';\n"]}

package/dist/data-sources/evm-rpc-services/services/BalanceFetcher.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BalanceFetcher.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/BalanceFetcher.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,qEAAmF;AAiBnF,8CAAmD;AAEnD,MAAM,wBAAwB,GAAG,KAAM,CAAC,CAAC,aAAa;AAEtD,MAAM,YAAY,GAChB,4CAAuD,CAAC;AA2B1D;;;GAGG;AACH,MAAa,cAAe,SAAQ,IAAA,wDAAmC,GAAuB;IAS5F,YAAY,eAAgC,EAAE,MAA6B;QACzE,KAAK,EAAE,CAAC;;QATD,kDAAkC;QAElC,yCAAiE;QAE1E,qDAAyD;QAEzD,kDAAsD;QAIpD,uBAAA,IAAI,mCAAoB,eAAe,MAAA,CAAC;QACxC,uBAAA,IAAI,0BAAW;YACb,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,IAAI,GAAG;YACjD,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,IAAI,KAAK;YACnD,sBAAsB,EAAE,MAAM,EAAE,sBAAsB,IAAI,IAAI;SAC/D,MAAA,CAAC;QAEF,2BAA2B;QAC3B,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,eAAe,IAAI,wBAAwB,CAAC,CAAC;IAC9E,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,QAAiC;QAClD,uBAAA,IAAI,mCAAoB,QAAQ,MAAA,CAAC;IACnC,CAAC;IAED,wBAAwB,CAAC,kBAAyC;QAChE,uBAAA,IAAI,sCAAuB,kBAAkB,MAAA,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,KAA0B;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CACrC,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,cAAc,CACrB,CAAC;QAEF,IAAI,uBAAA,IAAI,uCAAiB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,uBAAA,IAAI,uCAAiB,MAArB,IAAI,EAAkB,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,gBAAgB,CACd,OAAgB,EAChB,cAAuB;QAEvB,MAAM,eAAe,GAAG,uBAAA,IAAI,0CAAoB,EAAE,KAA1B,IAAI,CAAwB,CAAC;QAErD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;QAEnD,MAAM,QAAQ,GAAG,CAAC,KAAgB,EAAQ,EAAE;YAC1C,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACjD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE;oBACzB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,cAAc,GAClB,eAAe,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC7D,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,cAAc,GAClB,eAAe,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QACrE,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,OAAgB,EAChB,SAAoB,EACpB,cAAuB,EACvB,OAA6B;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC9D,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE5D,OAAO,IAAI,CAAC,sBAAsB,CAChC,OAAO,EACP,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,MAAM,CACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,sBAAsB,CAC1B,OAAgB,EAChB,SAAoB,EACpB,cAAuB,EACvB,cAAyB,EACzB,OAA6B,EAC7B,UAA6B;QAE7B,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,uBAAA,IAAI,8BAAQ,CAAC,gBAAgB,CAAC;QACtE,MAAM,aAAa,GACjB,OAAO,EAAE,aAAa,IAAI,uBAAA,IAAI,8BAAQ,CAAC,sBAAsB,CAAC;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,YAAY,GAAG,IAAI,GAAG,EAA0B,CAAC;QACvD,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,MAAM,eAAe,GAAuB,EAAE,CAAC;QAE/C,IAAI,aAAa,EAAE,CAAC;YAClB,eAAe,CAAC,IAAI,CAAC;gBACnB,YAAY,EAAE,YAAY;gBAC1B,cAAc;aACf,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,YAAY,IAAI,cAAc,EAAE,CAAC;YAC1C,eAAe,CAAC,IAAI,CAAC;gBACnB,YAAY;gBACZ,cAAc;aACf,CAAC,CAAC;QACL,CAAC;QAED,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO;gBACP,SAAS;gBACT,cAAc;gBACd,QAAQ,EAAE,EAAE;gBACZ,eAAe,EAAE,EAAE;gBACnB,SAAS;aACV,CAAC;QACJ,CAAC;QAOD,MAAM,MAAM,GAAG,MAAM,IAAA,+BAAuB,EAG1C;YACA,MAAM,EAAE,eAAe;YACvB,SAAS;YACT,aAAa,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,eAAe,EAAE,EAAE;aACpB;YACD,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE;gBACxC,MAAM,SAAS,GAAG,MAAM,uBAAA,IAAI,uCAAiB,CAAC,cAAc,CAC1D,OAAO,EACP,KAAK,CACN,CAAC;gBAEF,OAAO,uBAAA,IAAI,0EAAyB,MAA7B,IAAI,EACT,SAAS,EACT,aAAiC,EACjC,OAAO,EACP,SAAS,EACT,SAAS,EACT,YAAY,CACb,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;QAEH,OAAO;YACL,OAAO;YACP,SAAS;YACT,cAAc;YACd,GAAG,MAAM;YACT,SAAS;SACV,CAAC;IACJ,CAAC;CAyEF;AA7QD,wCA6QC;oUAtEG,SAA8B,EAC9B,WAGC,EACD,OAAgB,EAChB,SAAoB,EACpB,SAAiB,EACjB,YAAyC;IAKzC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,WAAW,CAAC;IAElD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,GAAG,CAAC;QACxC,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,SAAS,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC3C,MAAM,gBAAgB,GAAG,uBAAA,IAAI,gEAAe,MAAnB,IAAI,EAAgB,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEhE,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,QAAQ,GACZ,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,CAAC;QACrE,MAAM,OAAO,GAAkB,QAAQ;YACrC,CAAC,CAAE,UAAU,cAAc,YAA8B;YACzD,CAAC,CAAE,UAAU,cAAc,UAAU,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,EAAoB,CAAC;QAE/F,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO;YACP,SAAS;YACT,OAAO;YACP,OAAO;YACP,gBAAgB;YAChB,QAAQ;YACR,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;AACvC,CAAC,yEAEc,UAAkB,EAAE,QAAgB;IACjD,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC;QAEvC,MAAM,WAAW,GAAG,aAAa,GAAG,OAAO,CAAC;QAC5C,MAAM,SAAS,GAAG,aAAa,GAAG,OAAO,CAAC;QAC1C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACnE,MAAM,iBAAiB,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAE5D,IAAI,iBAAiB,KAAK,EAAE,EAAE,CAAC;YAC7B,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAC;QAChC,CAAC;QAED,OAAO,GAAG,WAAW,IAAI,iBAAiB,EAAE,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC","sourcesContent":["import { StaticIntervalPollingControllerOnly } from '@metamask/polling-controller';\nimport type { CaipAssetType } from '@metamask/utils';\n\nimport type { MulticallClient } from '../clients';\nimport type {\n  AccountId,\n  Address,\n  AssetBalance,\n  BalanceFetchOptions,\n  BalanceFetchResult,\n  BalanceOfRequest,\n  BalanceOfResponse,\n  ChainId,\n  TokenFetchInfo,\n  UserToken,\n  UserTokensState,\n} from '../types';\nimport { reduceInBatchesSerially } from '../utils';\n\nconst DEFAULT_BALANCE_INTERVAL = 30_000; // 30 seconds\n\nconst ZERO_ADDRESS: Address =\n  '0x0000000000000000000000000000000000000000' as Address;\n\nexport type BalanceFetcherConfig = {\n  defaultBatchSize?: number;\n  defaultTimeoutMs?: number;\n  includeNativeByDefault?: boolean;\n  /** Polling interval in ms (default: 30s) */\n  pollingInterval?: number;\n};\n\n/**\n * Polling input for BalanceFetcher - identifies what to poll for.\n */\nexport type BalancePollingInput = {\n  /** Chain ID (hex format) */\n  chainId: ChainId;\n  /** Account ID */\n  accountId: AccountId;\n  /** Account address */\n  accountAddress: Address;\n};\n\n/**\n * Callback type for balance updates.\n */\nexport type OnBalanceUpdateCallback = (result: BalanceFetchResult) => void;\n\n/**\n * BalanceFetcher - Fetches token balances via multicall.\n * Extends StaticIntervalPollingControllerOnly for built-in polling support.\n */\nexport class BalanceFetcher extends StaticIntervalPollingControllerOnly<BalancePollingInput>() {\n  readonly #multicallClient: MulticallClient;\n\n  readonly #config: Required<Omit<BalanceFetcherConfig, 'pollingInterval'>>;\n\n  #getUserTokensState: (() => UserTokensState) | undefined;\n\n  #onBalanceUpdate: OnBalanceUpdateCallback | undefined;\n\n  constructor(multicallClient: MulticallClient, config?: BalanceFetcherConfig) {\n    super();\n    this.#multicallClient = multicallClient;\n    this.#config = {\n      defaultBatchSize: config?.defaultBatchSize ?? 300,\n      defaultTimeoutMs: config?.defaultTimeoutMs ?? 30000,\n      includeNativeByDefault: config?.includeNativeByDefault ?? true,\n    };\n\n    // Set the polling interval\n    this.setIntervalLength(config?.pollingInterval ?? DEFAULT_BALANCE_INTERVAL);\n  }\n\n  /**\n   * Set the callback to receive balance updates during polling.\n   *\n   * @param callback - Function to call with balance results.\n   */\n  setOnBalanceUpdate(callback: OnBalanceUpdateCallback): void {\n    this.#onBalanceUpdate = callback;\n  }\n\n  setUserTokensStateGetter(getUserTokensState: () => UserTokensState): void {\n    this.#getUserTokensState = getUserTokensState;\n  }\n\n  /**\n   * Execute a poll cycle (required by base class).\n   * Fetches balances and calls the update callback.\n   *\n   * @param input - The polling input.\n   */\n  async _executePoll(input: BalancePollingInput): Promise<void> {\n    const result = await this.fetchBalances(\n      input.chainId,\n      input.accountId,\n      input.accountAddress,\n    );\n\n    if (this.#onBalanceUpdate && result.balances.length > 0) {\n      this.#onBalanceUpdate(result);\n    }\n  }\n\n  getTokensToFetch(\n    chainId: ChainId,\n    accountAddress: Address,\n  ): TokenFetchInfo[] {\n    const userTokensState = this.#getUserTokensState?.();\n\n    if (!userTokensState) {\n      return [];\n    }\n\n    const tokenMap = new Map<string, TokenFetchInfo>();\n\n    const addToken = (token: UserToken): void => {\n      const lowerAddress = token.address.toLowerCase();\n      if (!tokenMap.has(lowerAddress)) {\n        tokenMap.set(lowerAddress, {\n          address: token.address,\n          decimals: token.decimals,\n          symbol: token.symbol,\n        });\n      }\n    };\n\n    const importedTokens =\n      userTokensState.allTokens[chainId]?.[accountAddress] ?? [];\n    for (const token of importedTokens) {\n      addToken(token);\n    }\n\n    const detectedTokens =\n      userTokensState.allDetectedTokens[chainId]?.[accountAddress] ?? [];\n    for (const token of detectedTokens) {\n      addToken(token);\n    }\n\n    return Array.from(tokenMap.values());\n  }\n\n  async fetchBalances(\n    chainId: ChainId,\n    accountId: AccountId,\n    accountAddress: Address,\n    options?: BalanceFetchOptions,\n  ): Promise<BalanceFetchResult> {\n    const tokens = this.getTokensToFetch(chainId, accountAddress);\n    const tokenAddresses = tokens.map((token) => token.address);\n\n    return this.fetchBalancesForTokens(\n      chainId,\n      accountId,\n      accountAddress,\n      tokenAddresses,\n      options,\n      tokens,\n    );\n  }\n\n  async fetchBalancesForTokens(\n    chainId: ChainId,\n    accountId: AccountId,\n    accountAddress: Address,\n    tokenAddresses: Address[],\n    options?: BalanceFetchOptions,\n    tokenInfos?: TokenFetchInfo[],\n  ): Promise<BalanceFetchResult> {\n    const batchSize = options?.batchSize ?? this.#config.defaultBatchSize;\n    const includeNative =\n      options?.includeNative ?? this.#config.includeNativeByDefault;\n    const timestamp = Date.now();\n\n    const tokenInfoMap = new Map<string, TokenFetchInfo>();\n    if (tokenInfos) {\n      for (const info of tokenInfos) {\n        tokenInfoMap.set(info.address.toLowerCase(), info);\n      }\n    }\n\n    const balanceRequests: BalanceOfRequest[] = [];\n\n    if (includeNative) {\n      balanceRequests.push({\n        tokenAddress: ZERO_ADDRESS,\n        accountAddress,\n      });\n    }\n\n    for (const tokenAddress of tokenAddresses) {\n      balanceRequests.push({\n        tokenAddress,\n        accountAddress,\n      });\n    }\n\n    if (balanceRequests.length === 0) {\n      return {\n        chainId,\n        accountId,\n        accountAddress,\n        balances: [],\n        failedAddresses: [],\n        timestamp,\n      };\n    }\n\n    type FetchAccumulator = {\n      balances: AssetBalance[];\n      failedAddresses: Address[];\n    };\n\n    const result = await reduceInBatchesSerially<\n      BalanceOfRequest,\n      FetchAccumulator\n    >({\n      values: balanceRequests,\n      batchSize,\n      initialResult: {\n        balances: [],\n        failedAddresses: [],\n      },\n      eachBatch: async (workingResult, batch) => {\n        const responses = await this.#multicallClient.batchBalanceOf(\n          chainId,\n          batch,\n        );\n\n        return this.#processBalanceResponses(\n          responses,\n          workingResult as FetchAccumulator,\n          chainId,\n          accountId,\n          timestamp,\n          tokenInfoMap,\n        );\n      },\n    });\n\n    return {\n      chainId,\n      accountId,\n      accountAddress,\n      ...result,\n      timestamp,\n    };\n  }\n\n  #processBalanceResponses(\n    responses: BalanceOfResponse[],\n    accumulator: {\n      balances: AssetBalance[];\n      failedAddresses: Address[];\n    },\n    chainId: ChainId,\n    accountId: AccountId,\n    timestamp: number,\n    tokenInfoMap: Map<string, TokenFetchInfo>,\n  ): {\n    balances: AssetBalance[];\n    failedAddresses: Address[];\n  } {\n    const { balances, failedAddresses } = accumulator;\n\n    for (const response of responses) {\n      if (!response.success) {\n        failedAddresses.push(response.tokenAddress);\n        continue;\n      }\n\n      const balance = response.balance ?? '0';\n      const tokenInfo = tokenInfoMap.get(response.tokenAddress.toLowerCase());\n      const decimals = tokenInfo?.decimals ?? 18;\n      const formattedBalance = this.#formatBalance(balance, decimals);\n\n      const chainIdDecimal = parseInt(chainId, 16);\n      const isNative =\n        response.tokenAddress.toLowerCase() === ZERO_ADDRESS.toLowerCase();\n      const assetId: CaipAssetType = isNative\n        ? (`eip155:${chainIdDecimal}/slip44:60` as CaipAssetType)\n        : (`eip155:${chainIdDecimal}/erc20:${response.tokenAddress.toLowerCase()}` as CaipAssetType);\n\n      balances.push({\n        assetId,\n        accountId,\n        chainId,\n        balance,\n        formattedBalance,\n        decimals,\n        timestamp,\n      });\n    }\n\n    return { balances, failedAddresses };\n  }\n\n  #formatBalance(rawBalance: string, decimals: number): string {\n    if (rawBalance === '0') {\n      return '0';\n    }\n\n    try {\n      const balanceBigInt = BigInt(rawBalance);\n      const divisor = BigInt(10 ** decimals);\n\n      const integerPart = balanceBigInt / divisor;\n      const remainder = balanceBigInt % divisor;\n      const fractionalStr = remainder.toString().padStart(decimals, '0');\n      const trimmedFractional = fractionalStr.replace(/0+$/u, '');\n\n      if (trimmedFractional === '') {\n        return integerPart.toString();\n      }\n\n      return `${integerPart}.${trimmedFractional}`;\n    } catch {\n      return rawBalance;\n    }\n  }\n}\n"]}

package/dist/data-sources/evm-rpc-services/services/BalanceFetcher.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BalanceFetcher.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/BalanceFetcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,6BAAmB;AAClD,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EAEP,mBAAmB,EACnB,kBAAkB,EAGlB,OAAO,EACP,cAAc,EAEd,eAAe,EAChB,2BAAiB;AAQlB,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,sBAAsB;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;;;;;;;;;;;;;2DATzE,iBAAiB;;;;;AAWnB;;;GAGG;AACH,qBAAa,cAAe,SAAQ,mBAA0D;;gBAShF,eAAe,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,oBAAoB;IAa3E;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAI3D,wBAAwB,CAAC,kBAAkB,EAAE,MAAM,eAAe,GAAG,IAAI;IAIzE;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7D,gBAAgB,CACd,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,OAAO,GACtB,cAAc,EAAE;IAmCb,aAAa,CACjB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAcxB,sBAAsB,CAC1B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,OAAO,EACvB,cAAc,EAAE,OAAO,EAAE,EACzB,OAAO,CAAC,EAAE,mBAAmB,EAC7B,UAAU,CAAC,EAAE,cAAc,EAAE,GAC5B,OAAO,CAAC,kBAAkB,CAAC;CAwJ/B"}