@exodus/ethereum-api 8.64.4 → 8.64.5

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [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.5",
   "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": "12e4eb3740319bb74eaedcc04b53c0dc056ad1a1"
 }

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 }) => {