@exodus/ethereum-api 8.64.1 → 8.64.2

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.64.2](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.64.1...@exodus/ethereum-api@8.64.2) (2026-01-23)
+
+**Note:** Version bump only for package @exodus/ethereum-api
+
+
+
+
+
 ## [8.64.1](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.64.0...@exodus/ethereum-api@8.64.1) (2026-01-21)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "8.64.1",
+  "version": "8.64.2",
   "description": "Transaction monitors, fee monitors, RPC with the blockchain node, and other networking code for Ethereum and EVM-based blockchains",
   "type": "module",
   "main": "src/index.js",
@@ -67,5 +67,5 @@
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
   },
-  "gitHead": "d828ba4e4dc9f986cfa563653101410e6e81685a"
+  "gitHead": "d6aa274a62e489f5dd27e11088c56b3a64903779"
 }

package/src/create-asset-utils.js

@@ -1,7 +1,7 @@
 import assert from 'minimalistic-assert'
 import ms from 'ms'
 
-import { createEvmServer, ValidMonitorTypes } from './exodus-eth-server/index.js'
+import { createEvmServer, createWsGateway, ValidMonitorTypes } from './exodus-eth-server/index.js'
 import { createEthereumHooks } from './hooks/index.js'
 import { ClarityMonitor } from './tx-log/clarity-monitor.js'
 import { ClarityMonitorV2 } from './tx-log/clarity-monitor-v2.js'
@@ -18,6 +18,7 @@ export const resolveMonitorSettings = (
     defaultMonitorInterval,
     defaultMonitorType,
     defaultServerUrl,
+    defaultWsGatewayUri,
   } = Object.create(null)
 ) => {
   assert(asset, 'expected asset')
@@ -27,9 +28,17 @@ export const resolveMonitorSettings = (
   )
   assert(defaultServerUrl, `expected default serverUrl for ${asset.name}`)
 
+  // NOTE: When trying to enable `clarity-v3` as an asset
+  //       default config, there must exist a default
+  //       gateway definition.
+  if (defaultMonitorType === 'clarity-v3') {
+    assert(defaultWsGatewayUri, 'expected defaultWsGatewayUri')
+  }
+
   const overrideMonitorType = configWithOverrides?.monitorType
   const overrideServerUrl = configWithOverrides?.serverUrl
   const overrideMonitorInterval = configWithOverrides?.monitorInterval
+  const overrideWsGatewayUri = configWithOverrides?.wsGatewayUri
 
   const defaultResolution = {
     // NOTE: Regardless of the `monitorType`, the `monitorInterval`
@@ -37,13 +46,18 @@ export const resolveMonitorSettings = (
     monitorInterval: overrideMonitorInterval ?? defaultMonitorInterval,
     monitorType: defaultMonitorType,
     serverUrl: defaultServerUrl,
+    wsGatewayUri: defaultWsGatewayUri,
+  }
+
+  const fallbackWithWarning = (msg) => {
+    console.log([msg, `Falling back to ${defaultMonitorType}<${defaultServerUrl}>.`].join(' '))
+    return defaultResolution
   }
 
   if (!overrideMonitorType && overrideServerUrl) {
-    console.warn(
-      `Received an \`overrideServerUrl\`, but not the \`monitorType\` for ${asset.name}. Falling back to ${defaultMonitorType}<${defaultServerUrl}>.`
+    return fallbackWithWarning(
+      `Received an \`overrideServerUrl\`, but not the \`monitorType\` for ${asset.name}.`
     )
-    return defaultResolution
   }
 
   // If we don't attempt to override the `monitorType`, we resort
@@ -51,14 +65,24 @@ export const resolveMonitorSettings = (
   if (!overrideMonitorType) return defaultResolution
 
   if (!ValidMonitorTypes.includes(overrideMonitorType)) {
-    console.warn(
-      `"${overrideMonitorType}" is not a valid \`MonitorType\`. Falling back to ${defaultMonitorType}<${defaultServerUrl}>.`
+    return fallbackWithWarning(`"${overrideMonitorType}" is not a valid \`MonitorType\`.`)
+  }
+
+  const wsGatewayUri = overrideWsGatewayUri || defaultWsGatewayUri
+
+  if (overrideMonitorType === 'clarity-v3' && !wsGatewayUri) {
+    return fallbackWithWarning(
+      "Attempted to use 'clarity-v3' without a defining a supporting wsGatewayUri."
     )
-    return defaultResolution
   }
 
   // Permit the `monitorType` and `serverUrl` to be overrided.
-  return { ...defaultResolution, monitorType: overrideMonitorType, serverUrl: overrideServerUrl }
+  return {
+    ...defaultResolution,
+    monitorType: overrideMonitorType,
+    serverUrl: overrideServerUrl,
+    wsGatewayUri,
+  }
 }
 
 export const stringifyPrivateTx = (tx) => {
@@ -116,6 +140,7 @@ export const createHistoryMonitorFactory = ({
   server,
   stakingAssetNames,
   rpcBalanceAssetNames,
+  wsGatewayUri,
 }) => {
   assert(assetName, 'expected assetName')
   assert(assetClientInterface, 'expected assetClientInterface')
@@ -142,6 +167,7 @@ export const createHistoryMonitorFactory = ({
           interval: ms(monitorInterval || '5m'),
           server,
           rpcBalanceAssetNames,
+          wsGatewayClient: createWsGateway({ uri: wsGatewayUri }),
           ...args,
         })
         break

package/src/create-asset.js

@@ -71,6 +71,7 @@ export const createAssetFactory = ({
   useAbsoluteBalanceAndNonce = false,
   delisted = false,
   privacyRpcUrl: defaultPrivacyRpcUrl,
+  wsGatewayUri: defaultWsGatewayUri,
 }) => {
   assert(assetsList, 'assetsList is required')
   assert(providedFeeData || feeDataConfig, 'feeData or feeDataConfig is required')
@@ -118,12 +119,13 @@ export const createAssetFactory = ({
 
     const asset = assets[base.name]
 
-    const { monitorType, serverUrl, monitorInterval } = resolveMonitorSettings({
+    const { monitorType, serverUrl, monitorInterval, wsGatewayUri } = resolveMonitorSettings({
       asset,
       configWithOverrides,
       defaultMonitorInterval,
       defaultMonitorType,
       defaultServerUrl,
+      defaultWsGatewayUri,
     })
 
     if (overrideUseAbsoluteBalanceAndNonce !== undefined) {
@@ -220,6 +222,7 @@ export const createAssetFactory = ({
       server,
       stakingAssetNames,
       rpcBalanceAssetNames,
+      wsGatewayUri,
     })
 
     const defaultAddressPath = 'm/0/0'

package/src/exodus-eth-server/index.js

@@ -12,6 +12,7 @@ import { create } from './api.js'
 import ApiCoinNodesServer from './api-coin-nodes.js'
 import ClarityServer from './clarity.js'
 import ClarityServerV2 from './clarity-v2.js'
+import WsGateway from './ws-gateway.js'
 
 export const ValidMonitorTypes = ['no-history', 'clarity', 'clarity-v2', 'clarity-v3', 'magnifier']
 
@@ -34,6 +35,39 @@ export function createEvmServer({ assetName, serverUrl, monitorType }) {
   }
 }
 
+const gatewayUriToWsGateway = Object.create(null)
+
+export const createWsGateway = ({ uri } = Object.create(null)) => {
+  assert(typeof uri === 'string', 'expected string uri')
+
+  uri = new URL(uri).toString()
+
+  const wsGateway = gatewayUriToWsGateway[uri]
+  if (wsGateway) return wsGateway
+
+  // NOTE: We disable the ability to `setServer` on the
+  //       `WsGateway`, since we assume a mapping between
+  //       `gatewayUri -> WsGateway`.
+  //
+  //       This is a safe modification since a `WsGateway`
+  //       monitor isn't rigged up to the same life cycle
+  //       as other servers.
+  class FrozenWsGateway extends WsGateway {
+    constructor() {
+      super({ uri })
+    }
+
+    setServer() {
+      assert(false, 'setServer is disabled')
+    }
+  }
+
+  const frozenWsGateway = new FrozenWsGateway()
+  gatewayUriToWsGateway[uri] = frozenWsGateway
+
+  return frozenWsGateway
+}
+
 // @Deprecated
 const serverMap = Object.fromEntries(
   // eslint-disable-next-line @exodus/import/no-deprecated

package/src/exodus-eth-server/ws-gateway.js

@@ -26,15 +26,21 @@ const parseSubscriptionKey = (subscriptionKey) => {
  * @property {string} address
  */
 
-class WsGateway extends EventEmitter {
+export default class WsGateway extends EventEmitter {
   #socket = null
   // Dedup subscriptions to reduce workload on server and resubscribe after closing
   #subscriptions = new Set()
   #reconnectionTimeoutId = null
-  #defaultUri = 'wss://ws-gateway-clarity.a.exodus.io'
   #uri = null
   #logger = createConsoleLogger(`@exodus/ws-gateway`)
 
+  constructor({ uri }) {
+    super()
+    assert(typeof uri === 'string', 'expected string uri')
+
+    this.#uri = uri
+  }
+
   _handlers = {
     message: ({ target, data }) => {
       if (target !== this.#socket) return
@@ -77,7 +83,7 @@ class WsGateway extends EventEmitter {
   }
 
   setServer(uri) {
-    this.#uri = uri || this.#uri || this.#defaultUri
+    this.#uri = uri || this.#uri
   }
 
   start() {
@@ -266,8 +272,3 @@ class WsGateway extends EventEmitter {
     this.#socket = null
   }
 }
-
-const wsGateway = new WsGateway()
-const createWsGateway = () => wsGateway
-
-export { createWsGateway, WsGateway }

package/src/tx-log/clarity-monitor-v2.js

@@ -1,8 +1,9 @@
 import { BaseMonitor } from '@exodus/asset-lib'
 import { getAssetAddresses } from '@exodus/ethereum-lib'
 import lodash from 'lodash'
+import assert from 'minimalistic-assert'
 
-import { createWsGateway } from '../exodus-eth-server/ws-gateway.js'
+import WsGateway from '../exodus-eth-server/ws-gateway.js'
 import { executeEthLikeFeeMonitorUpdate } from '../fee-utils.js'
 import { fromHexToString } from '../number-utils.js'
 import { filterEffects, getLogItemsFromServerTx } from './clarity-utils/index.js'
@@ -23,14 +24,10 @@ export class ClarityMonitorV2 extends BaseMonitor {
   #walletAccountByAddress = new Map()
   #walletAccountInfo = new Map()
   #rpcBalanceAssetNames = []
-  constructor({
-    server,
-    wsGatewayClient = createWsGateway(),
-    rpcBalanceAssetNames,
-    config,
-    ...args
-  } = {}) {
+  constructor({ server, wsGatewayClient, rpcBalanceAssetNames, config, ...args } = {}) {
     super(args)
+    assert(wsGatewayClient instanceof WsGateway, 'expected WsGateway wsGatewayClient')
+
     this.config = { GAS_PRICE_FROM_WEBSOCKET: true, ...config }
     this.server = server
     this.#wsClient = wsGatewayClient
@@ -48,8 +45,6 @@ export class ClarityMonitorV2 extends BaseMonitor {
   setServer(config) {
     const uri = config?.server || this.server.defaultUri
 
-    this.#wsClient.setServer(config.wsGatewayUrl?.v1)
-
     this.#wsClient.on('connected', () => this.subscribeAllWalletAccounts())
     this.#wsClient.start()