@exodus/ethereum-api 8.62.4 → 8.63.0

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.63.0](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.62.4...@exodus/ethereum-api@8.63.0) (2026-01-14)
+
+
+### Features
+
+
+* feat: add 'latest' evm nonce support (#7267)
+
+
+
 ## [8.62.4](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.62.3...@exodus/ethereum-api@8.62.4) (2026-01-14)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "8.62.4",
+  "version": "8.63.0",
   "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": "138043f1b7f97c9acc7b7b89b0561f26b80757d5"
+  "gitHead": "db8bd0629b287cd2031a12ff2a3fed3fc765bbab"
 }

package/src/create-asset-utils.js

@@ -7,7 +7,7 @@ import { ClarityMonitor } from './tx-log/clarity-monitor.js'
 import { ClarityMonitorV2 } from './tx-log/clarity-monitor-v2.js'
 import { EthereumMonitor } from './tx-log/ethereum-monitor.js'
 import { EthereumNoHistoryMonitor } from './tx-log/ethereum-no-history-monitor.js'
-import { resolveNonce } from './tx-send/nonce-utils.js'
+import { BLOCK_TAG_PENDING, resolveNonce } from './tx-send/nonce-utils.js'
 
 // Determines the appropriate `monitorType`, `serverUrl` and `monitorInterval`
 // to use for a given config.
@@ -184,7 +184,16 @@ export const getNonceFactory = ({ assetClientInterface, useAbsoluteBalanceAndNon
   assert(assetClientInterface, 'expected assetClientInterface')
   assert(typeof useAbsoluteBalanceAndNonce === 'boolean', 'expected useAbsoluteBalanceAndNonce')
 
-  const getNonce = async ({ asset, fromAddress, walletAccount, triedNonce, forceFromNode }) => {
+  const getNonce = async ({
+    asset,
+    fromAddress,
+    walletAccount,
+    forceFromNode,
+    // NOTE: By default, Exodus assumes the client will by default want
+    //       to send transactions on top of those which are currently
+    //       pending at the public mempool.
+    tag = BLOCK_TAG_PENDING,
+  }) => {
     assert(asset, 'expected asset')
     assert(typeof fromAddress === 'string', 'expected fromAddress')
     assert(walletAccount, 'expected walletAccount')
@@ -198,13 +207,8 @@ export const getNonceFactory = ({ assetClientInterface, useAbsoluteBalanceAndNon
       asset,
       fromAddress,
       txLog,
-      triedNonce,
       forceFromNode,
-      // For assets where we'll fall back to querying the coin node, we
-      // search for pending transactions. For base assets with history,
-      // we'll fall back to the `TxLog` since this also has a knowledge
-      // of which transactions are currently in pending.
-      tag: 'pending',
+      tag,
       useAbsoluteNonce: useAbsoluteBalanceAndNonce,
     })
   }

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

@@ -3,29 +3,32 @@ import assert from 'minimalistic-assert'
 import { getNonce } from '../eth-like-util.js'
 import { getLatestCanonicalAbsoluteNonceTx } from '../tx-log/clarity-utils/absolute.js'
 
+export const BLOCK_TAG_LATEST = 'latest'
+export const BLOCK_TAG_PENDING = 'pending'
+
+const VALID_BLOCK_TAGS = new Set([BLOCK_TAG_LATEST, BLOCK_TAG_PENDING])
+
+// NOTE: We do not yet support tags at arbitrary block heights.
+const assertValidBlockTag = (tag) => assert(VALID_BLOCK_TAGS.has(tag), `invalid tag "${tag}"`)
+
 export const resolveNonce = async ({
   asset,
   forceFromNode,
   fromAddress,
-  providedNonce,
   txLog = [],
-  triedNonce,
-  tag = 'latest', // use 'pending' for unconfirmed txs
+  tag = BLOCK_TAG_LATEST,
   useAbsoluteNonce,
 }) => {
+  assertValidBlockTag(tag)
+
   const nonceFromNode =
     asset.baseAsset?.api?.features?.noHistory || forceFromNode
       ? await getNonce({ asset: asset.baseAsset, address: fromAddress, tag })
       : 0
 
-  const nonceFromLog = getNonceFromTxLog({ txLog, useAbsoluteNonce })
+  const nonceFromLog = getNonceFromTxLog({ txLog, useAbsoluteNonce, tag })
 
-  return Math.max(
-    nonceFromNode,
-    nonceFromLog,
-    providedNonce ?? 0,
-    triedNonce === undefined ? 0 : triedNonce + 1
-  )
+  return Math.max(nonceFromNode, nonceFromLog)
 }
 
 const getLatestTxWithNonceChange = ({ reversedTxLog }) => {
@@ -44,7 +47,7 @@ const getLatestTxWithNonceChange = ({ reversedTxLog }) => {
   }
 }
 
-export const getNonceFromTxLog = ({ txLog, useAbsoluteNonce }) => {
+const getNonceFromTxLog = ({ txLog, useAbsoluteNonce, tag }) => {
   let absoluteNonce = 0
 
   if (useAbsoluteNonce) {
@@ -52,12 +55,21 @@ export const getNonceFromTxLog = ({ txLog, useAbsoluteNonce }) => {
     const maybeLatestTxWithNonceChange = getLatestTxWithNonceChange({ reversedTxLog })
 
     if (maybeLatestTxWithNonceChange) {
+      // NOTE: This is the latest nonce currently confirmed by
+      //       Clarity, which lags behind `CLARITY_MIN_CONFIRMS`
+      //       depth:
+      //
+      //       https://github.com/ExodusMovement/clarity/blob/4a6ea30fce33246d1ef1440e61b0a84b876900d6/deployment/eth-clarity-indexer/values.yaml#L34
       absoluteNonce = parseInt(maybeLatestTxWithNonceChange.data.nonceChange.to, 10)
     }
   }
 
   const nonceFromLog = [...txLog]
     .filter((tx) => tx.sent && !tx.dropped && tx.data.nonce != null)
+    // NOTE: If we're only considering the `'latest'` block `tag`,
+    //       then we should not take into account unconfirmed
+    //       transactions when computing the `nonce`.
+    .filter((tx) => tag !== BLOCK_TAG_LATEST || !tx.pending)
     .reduce((nonce, tx) => Math.max(tx.data.nonce + 1, nonce), 0)
 
   return Math.max(absoluteNonce, nonceFromLog)

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

@@ -83,15 +83,22 @@ const txSendFactory = ({ assetClientInterface, createTx }) => {
         })
       } else if (nonceTooLowErr && !unsignedTx.txMeta.isHardware) {
         console.info('trying to send again...') // inject logger factory from platform
+
         // let's try to fix the nonce issue
-        const newNonce = await baseAsset.getNonce({
+        let newNonce = await baseAsset.getNonce({
           asset,
           fromAddress,
           walletAccount,
-          triedNonce: parsedTx.nonce,
           forceFromNode: true,
         })
 
+        // TODO: We should only do this for non-replacement transactions.
+        const triedNonce = parsedTx.nonce
+
+        if (typeof triedNonce === 'number') {
+          newNonce = Math.max(newNonce, triedNonce + 1)
+        }
+
         // NOTE: An `unsignedTx.txData.transactionBuffer` may be optional
         //       in `unsignedTx`, since a `providedUnsignedTx` may be
         //       truthy but composed only of `legacyParams`: