@exodus/ethereum-api 8.64.4 → 8.64.6

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.64.6](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.64.5...@exodus/ethereum-api@8.64.6) (2026-02-23)
+
+
+### Bug Fixes
+
+
+* fix: avoid race conditions resulting in a `tipGasPrice` of `0` where possible (#7458)
+
+
+
+## [8.64.5](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.64.4...@exodus/ethereum-api@8.64.5) (2026-02-11)
+
+
+### Bug Fixes
+
+
+* fix: future transaction replaces pending evm transactions (#7406)
+
+
+
 ## [8.64.4](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.64.3...@exodus/ethereum-api@8.64.4) (2026-02-09)
 
 **Note:** Version bump only for package @exodus/ethereum-api

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "8.64.4",
+  "version": "8.64.6",
   "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": "ebcc3fe022dfc1e21e3ccdc00faf0769e8fb3092"
+  "gitHead": "05a14c42a3963199e2b0b11d0a643884ebae8e46"
 }

package/src/exodus-eth-server/api-coin-nodes.js

@@ -6,6 +6,7 @@ import lodash from 'lodash'
 
 import { fromHexToString } from '../number-utils.js'
 import { errorMessageToSafeHint } from './errors.js'
+import { getFallbackGasPriceEstimation } from './utils.js'
 
 const { isEmpty } = lodash
 
@@ -166,6 +167,10 @@ export default class ApiCoinNodesServer extends EventEmitter {
     return this.sendRequest(request)
   }
 
+  async getGasPriceEstimation() {
+    return getFallbackGasPriceEstimation({ server: this })
+  }
+
   // for fee monitor
   getGasPrice = this.gasPrice
 

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

@@ -6,6 +6,7 @@ import SolidityContract from '@exodus/solidity-contract'
 import ms from 'ms'
 
 import { fromHexToString } from '../number-utils.js'
+import { getFallbackGasPriceEstimation } from './utils.js'
 import createWebSocket from './ws.js'
 
 const RETRY_DELAYS = ['10s']
@@ -120,6 +121,10 @@ export function create(defaultURL, ensAssetName) {
       return requestWithRetry('proxy', { method: 'eth_gasPrice' })
     },
 
+    async getGasPriceEstimation() {
+      return getFallbackGasPriceEstimation({ server: this })
+    },
+
     // for fee monitor
     async getGasPrice() {
       return requestWithRetry('proxy', { method: 'eth_gasPrice' })

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

@@ -6,6 +6,7 @@ import io from 'socket.io-client'
 
 import { fromHexToString } from '../number-utils.js'
 import { errorMessageToSafeHint } from './errors.js'
+import { getFallbackGasPriceEstimation } from './utils.js'
 
 export const RPC_REQUEST_TIMEOUT = 'RPC_REQUEST_TIMEOUT'
 
@@ -174,6 +175,10 @@ export default class ClarityServer extends EventEmitter {
     return fee?.gasPrice
   }
 
+  async getGasPriceEstimation() {
+    return getFallbackGasPriceEstimation({ server: this })
+  }
+
   async sendRpcRequest(rpcRequest) {
     const rpcSocket = this.connectRpc()
     return new Promise((resolve, reject) => {

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

@@ -0,0 +1,31 @@
+import assert from 'minimalistic-assert'
+
+const desc = (a, b) => (a > b ? -1 : b > a ? 1 : 0)
+
+export const getFallbackGasPriceEstimation = async ({ server }) => {
+  const [latestBlock, gasPrice] = await Promise.all([server.getLatestBlock(), server.getGasPrice()])
+
+  assert(latestBlock, 'expected latestBlock')
+  assert(gasPrice, 'expected gasPrice')
+
+  const baseFeePerGas = latestBlock.baseFeePerGas
+  if (!baseFeePerGas) return { gasPrice }
+
+  const [max, min] = [BigInt(gasPrice), BigInt(baseFeePerGas)].sort(desc)
+
+  const toHex = (b) => `0x${b.toString(16)}`
+
+  // TODO: Use `eth_feeHistory` or `eth_maxPriorityFeePerGas`
+  //       instead (requires allowlist at the RPC).
+  // HACK: Infer the RPC's implicit `tipGasPrice`:
+  //       https://github.com/ethereum/go-ethereum/blob/d3dd48e59db28ea04bd92e4337cdd488ccb8fbec/internal/ethapi/api.go#L69C1-L79C2
+  const maxPriorityFeePerGas50Percentile = max - min
+
+  const rewardPercentiles = {
+    25: toHex(maxPriorityFeePerGas50Percentile / BigInt(2)),
+    50: toHex(maxPriorityFeePerGas50Percentile),
+    75: toHex((maxPriorityFeePerGas50Percentile * BigInt(3)) / BigInt(2)),
+  }
+
+  return { gasPrice, baseFeePerGas, rewardPercentiles }
+}

package/src/fee-utils.js

@@ -1,14 +1,5 @@
 import assert from 'minimalistic-assert'
 
-export const shouldFetchEthLikeFallbackGasPrices = async ({ eip1559Enabled, server }) => {
-  const [gasPrice, baseFeePerGas] = await Promise.all([
-    server.getGasPrice(),
-    eip1559Enabled ? server.getBaseFeePerGas() : undefined,
-  ])
-
-  return { gasPrice, baseFeePerGas }
-}
-
 export const applyMultiplierToPrice = ({ feeAsset, gasPriceMultiplier, price }) => {
   assert(typeof price === 'string', 'price should be a string')
   return feeAsset.currency

package/src/server-based-fee-monitor.js

@@ -1,10 +1,7 @@
 import { FeeMonitor } from '@exodus/asset-lib'
 import assert from 'minimalistic-assert'
 
-import {
-  calculateEthLikeFeeMonitorUpdate,
-  shouldFetchEthLikeFallbackGasPrices,
-} from './fee-utils.js'
+import { calculateEthLikeFeeMonitorUpdate } from './fee-utils.js'
 
 /**
  * Generic eth server based fee monitor.
@@ -25,11 +22,6 @@ export const serverBasedFeeMonitorFactoryFactory = ({ asset, interval, server, a
   assert(server, 'server is required')
   assert(aci, 'aci is required')
 
-  const shouldFetchGasPrices = async () => {
-    const { eip1559Enabled } = await aci.getFeeConfig({ assetName: asset.name })
-    return shouldFetchEthLikeFallbackGasPrices({ eip1559Enabled, server })
-  }
-
   const FeeMonitorClass = class ServerBaseEthereumFeeMonitor extends FeeMonitor {
     constructor({ updateFee }) {
       assert(updateFee, 'updateFee is required')
@@ -44,7 +36,7 @@ export const serverBasedFeeMonitorFactoryFactory = ({ asset, interval, server, a
       return calculateEthLikeFeeMonitorUpdate({
         assetClientInterface: aci,
         feeAsset: asset,
-        fetchedGasPrices: await shouldFetchGasPrices(),
+        fetchedGasPrices: await server.getGasPriceEstimation(),
       })
     }
   }

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

@@ -6,7 +6,11 @@ import assert from 'minimalistic-assert'
 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'
+import {
+  filterEffects,
+  getLogItemsFromServerTx,
+  normalizeTransactionsResponse,
+} from './clarity-utils/index.js'
 import {
   checkPendingTransactions,
   excludeUnchangedTokenBalances,
@@ -160,7 +164,14 @@ export class ClarityMonitorV2 extends BaseMonitor {
     const { derivedData, tokensByAddress, assets, tokens, assetName } = walletAccountInfo
 
     const response = await this.getHistoryFromServer({ walletAccount, derivedData, refresh })
-    const allTxs = [...response.transactions.pending, ...response.transactions.confirmed]
+
+    const { allTxs } = await normalizeTransactionsResponse({
+      asset: this.asset,
+      fromAddress: derivedData.ourWalletAddress,
+      response,
+      walletAccount,
+    })
+
     const cursor = response.cursor
 
     await this.processAndFillTransactionsToState({

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

@@ -5,7 +5,11 @@ import assert from 'minimalistic-assert'
 
 import { executeEthLikeFeeMonitorUpdate } from '../fee-utils.js'
 import { fromHexToString } from '../number-utils.js'
-import { filterEffects, getLogItemsFromServerTx } from './clarity-utils/index.js'
+import {
+  filterEffects,
+  getLogItemsFromServerTx,
+  normalizeTransactionsResponse,
+} from './clarity-utils/index.js'
 import {
   checkPendingTransactions,
   excludeUnchangedTokenBalances,
@@ -148,10 +152,16 @@ export class ClarityMonitor extends BaseMonitor {
       return map
     }, new Map())
     const assetName = this.asset.name
-
     const derivedData = await this.deriveData({ assetName, walletAccount, tokens })
     const response = await this.getHistoryFromServer({ walletAccount, derivedData, refresh })
-    const allTxs = [...response.transactions.pending, ...response.transactions.confirmed]
+
+    const { allTxs } = await normalizeTransactionsResponse({
+      asset: this.asset,
+      fromAddress: derivedData.ourWalletAddress,
+      response,
+      walletAccount,
+    })
+
     const hasNewTxs = allTxs.length > 0
 
     const logItemsByAsset = this.getAllLogItemsByAsset({

package/src/tx-log/clarity-utils/index.js

@@ -6,3 +6,4 @@ export {
   getLatestCanonicalAbsoluteBalanceTx,
   getLatestCanonicalAbsoluteNonceTx,
 } from './absolute.js'
+export { normalizeTransactionsResponse } from './normalize-transactions-response.js'

package/src/tx-log/clarity-utils/normalize-transactions-response.js

@@ -0,0 +1,59 @@
+import assert from 'minimalistic-assert'
+
+// Converts the `pending` and `confirmed` transactions returned
+// by Clarity into a single contiguous array of transactions.
+//
+// Since it is possible for Clarity to return very old pending
+// transactions that our own RPC has forgotten (see `--txpool.lifetime`),
+// we ensure that all transactions we expose to the consumer have
+// `nonce`s do not exceed the maximum pending nonce that's currently
+// maintained at the RPC.
+//
+// This avoids the "future transaction replaces pending" error.
+export const normalizeTransactionsResponse = async ({
+  asset,
+  fromAddress,
+  response,
+  walletAccount,
+}) => {
+  assert(asset, 'expected asset')
+  assert(fromAddress, 'expected fromAddress')
+  assert(response, 'expected response')
+  assert(walletAccount, 'expected walletAccount')
+
+  const { baseAsset } = asset
+
+  // NOTE: We query the current pending `nonce` from the RPC
+  //       to sanity check the contents of the `txLog`.
+  const pendingNonce = await baseAsset
+    .getNonce({
+      asset: baseAsset,
+      fromAddress,
+      walletAccount,
+      forceFromNode: true,
+    })
+    .catch(() => null)
+
+  const allTxs = [...response.transactions.pending, ...response.transactions.confirmed].filter(
+    (tx) => {
+      // If the transaction isn't one we've sent, then ignore.
+      if (tx.from?.toLowerCase() !== fromAddress.toLowerCase()) return true
+
+      const nonce = parseInt(tx.nonce, 10)
+      if (!Number.isFinite(nonce) || !Number.isInteger(nonce)) return false
+
+      // HACK: If we were unable to determine the `pendingNonce`, then
+      //       allow send transactions through by default without
+      //       further validation.
+      if (pendingNonce === null) return true
+
+      // NOTE: If the `tx` response contains pending transactions at
+      //       a nonce offset that's greater than what's considered
+      //       pending at the RPC, these transactions are no longer
+      //       viable and should be replaced.
+      return nonce < pendingNonce
+    }
+  )
+
+  return { allTxs }
+}

package/src/tx-send/nonce-utils.js

@@ -21,14 +21,11 @@ export const resolveNonce = async ({
 }) => {
   assertValidBlockTag(tag)
 
-  const nonceFromNode =
-    asset.baseAsset?.api?.features?.noHistory || forceFromNode
-      ? await getNonce({ asset: asset.baseAsset, address: fromAddress, tag })
-      : 0
-
-  const nonceFromLog = getNonceFromTxLog({ txLog, useAbsoluteNonce, tag })
+  if (asset.baseAsset?.api?.features?.noHistory || forceFromNode) {
+    return getNonce({ asset: asset.baseAsset, address: fromAddress, tag })
+  }
 
-  return Math.max(nonceFromNode, nonceFromLog)
+  return getNonceFromTxLog({ txLog, useAbsoluteNonce, tag })
 }
 
 const getLatestTxWithNonceChange = ({ reversedTxLog }) => {