@exodus/ethereum-api 8.62.3 → 8.62.4

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.62.4](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.62.3...@exodus/ethereum-api@8.62.4) (2026-01-14)
+
+
+### Bug Fixes
+
+
+* fix: absolute canonical nonce (#7238)
+
+
+
 ## [8.62.3](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.62.2...@exodus/ethereum-api@8.62.3) (2026-01-13)
 
 

package/package.json

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

package/src/custom-fees.js

@@ -51,7 +51,7 @@ export const createCustomFeesApi = ({ baseAsset }) => {
     },
     unit: 'gwei/gas',
     feeUnitPriceToNumber: (feeNumberUnit) => feeNumberUnit.toNumber(Gwei),
-    numberToFeeUnitPrice: (value) => new NumberUnit(value, Gwei),
+    numberToFeeUnitPrice: (value) => NumberUnit.create(value, Gwei),
     isEnabled: ({ feeData }) => Boolean(feeData.rbfEnabled),
   }
 }

package/src/get-balances.js

@@ -5,66 +5,8 @@ import {
   getUnconfirmedSentBalance,
 } from '@exodus/asset-lib'
 import assert from 'minimalistic-assert'
-import ms from 'ms'
-
-const DEFAULT_CANONICAL_ABSOLUTE_BALANCE_SEARCH_DEPTH = ms('5m')
-
-// Defines whether a `Tx` is an absolute balance
-// node that can be sorted in terms of transaction
-// ordering.
-//
-export const isCanonicalAbsoluteBalanceTx = (tx) =>
-  Boolean(
-    tx?.data?.balanceChange &&
-      typeof tx.data.blockNumber === 'number' &&
-      typeof tx.data.transactionIndex === 'number'
-  )
-
-// Attempts to find the most recent `absoluteBalance` Tx for
-// a given `txLog`.
-//
-// NOTE: Returns `null` if nothing is found.
-// NOTE: Uses `tx.data.blockNumber` and `tx.data.transactionIndex`,
-//       which are not guaranteed to exist in older transaction
-//       histories.
-export const getLatestCanonicalAbsoluteBalanceTx = ({
-  // Due to nondeterministic sorting for records in close
-  // proximity to one-another on high TPS chains, the
-  // order of the `reversedTxLog` cannot be trusted to be
-  // exactly precise since two consecutive blocks may share
-  // the same timestamp. Therefore, when finding an absolute
-  // balance node, we use the`searchDepthMs` to take into
-  // account extra nodes chronologically deeper than what we
-  // presume to be the latest to make sure we resolve to the
-  // correct node.
-  searchDepthMs = DEFAULT_CANONICAL_ABSOLUTE_BALANCE_SEARCH_DEPTH,
-  reversedTxLog,
-}) => {
-  assert(reversedTxLog, 'expected reversedTxLog')
-
-  let latest = null
-
-  for (const tx of reversedTxLog) {
-    if (latest) {
-      const diff = +latest.date - +tx.date
-
-      if (diff >= searchDepthMs) break
-    }
 
-    if (!isCanonicalAbsoluteBalanceTx(tx)) continue
-
-    if (
-      !latest ||
-      tx.data.blockNumber > latest.data.blockNumber ||
-      (tx.data.blockNumber === latest.data.blockNumber &&
-        tx.data.transactionIndex > latest.data.transactionIndex)
-    ) {
-      latest = tx
-    }
-  }
-
-  return latest
-}
+import { getLatestCanonicalAbsoluteBalanceTx } from './tx-log/clarity-utils/index.js'
 
 /**
  * TODO: Balance model gaps for EVM staking assets

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

@@ -0,0 +1,92 @@
+import assert from 'minimalistic-assert'
+import ms from 'ms'
+
+const DEFAULT_CANONICAL_ABSOLUTE_TX_SEARCH_DEPTH = ms('5m')
+
+const ABSOLUTE_FIELD_NAME_BALANCE_CHANGE = 'balanceChange'
+const ABSOLUTE_FIELD_NAME_NONCE_CHANGE = 'nonceChange'
+
+const ABSOLUTE_BALANCE_FIELDS = new Set([
+  ABSOLUTE_FIELD_NAME_BALANCE_CHANGE,
+  ABSOLUTE_FIELD_NAME_NONCE_CHANGE,
+])
+
+// Defines whether a `Tx` is an absolute balance
+// node that can be sorted in terms of transaction
+// ordering.
+//
+const isCanonicalAbsoluteTx = (tx, fieldName) => {
+  assert(ABSOLUTE_BALANCE_FIELDS.has(fieldName), `unsupported fieldName, "${fieldName}"`)
+
+  return Boolean(
+    tx?.data?.[fieldName] &&
+      typeof tx.data.blockNumber === 'number' &&
+      typeof tx.data.transactionIndex === 'number'
+  )
+}
+
+export const isCanonicalAbsoluteBalanceTx = (tx) =>
+  isCanonicalAbsoluteTx(tx, ABSOLUTE_FIELD_NAME_BALANCE_CHANGE)
+export const isCanonicalAbsoluteNonceTx = (tx) =>
+  isCanonicalAbsoluteTx(tx, ABSOLUTE_FIELD_NAME_NONCE_CHANGE)
+
+// Attempts to find the most recent absolute Tx for a given
+// `txLog`.
+//
+// NOTE: Returns `null` if nothing is found.
+// NOTE: Uses `tx.data.blockNumber` and `tx.data.transactionIndex`,
+//       which are not guaranteed to exist in older transaction
+//       histories.
+const getLatestCanonicalAbsoluteTx = ({
+  // Due to nondeterministic sorting for records in close
+  // proximity to one-another on high TPS chains, the
+  // order of the `reversedTxLog` cannot be trusted to be
+  // exactly precise since two consecutive blocks may share
+  // the same timestamp. Therefore, when finding an absolute
+  // balance node, we use the`searchDepthMs` to take into
+  // account extra nodes chronologically deeper than what we
+  // presume to be the latest to make sure we resolve to the
+  // correct node.
+  searchDepthMs = DEFAULT_CANONICAL_ABSOLUTE_TX_SEARCH_DEPTH,
+  reversedTxLog,
+  fieldName,
+}) => {
+  assert(reversedTxLog, 'expected reversedTxLog')
+
+  let latest = null
+
+  for (const tx of reversedTxLog) {
+    if (latest) {
+      const diff = +latest.date - +tx.date
+
+      if (diff >= searchDepthMs) break
+    }
+
+    if (!isCanonicalAbsoluteTx(tx, fieldName)) continue
+
+    if (
+      !latest ||
+      tx.data.blockNumber > latest.data.blockNumber ||
+      (tx.data.blockNumber === latest.data.blockNumber &&
+        tx.data.transactionIndex > latest.data.transactionIndex)
+    ) {
+      latest = tx
+    }
+  }
+
+  return latest
+}
+
+export const getLatestCanonicalAbsoluteBalanceTx = ({ searchDepthMs, reversedTxLog }) =>
+  getLatestCanonicalAbsoluteTx({
+    searchDepthMs,
+    reversedTxLog,
+    fieldName: ABSOLUTE_FIELD_NAME_BALANCE_CHANGE,
+  })
+
+export const getLatestCanonicalAbsoluteNonceTx = ({ searchDepthMs, reversedTxLog }) =>
+  getLatestCanonicalAbsoluteTx({
+    searchDepthMs,
+    reversedTxLog,
+    fieldName: ABSOLUTE_FIELD_NAME_NONCE_CHANGE,
+  })

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

@@ -1,2 +1,8 @@
 export { default as getLogItemsFromServerTx } from './get-log-items-from-server-tx.js'
 export { default as filterEffects } from './filter-effects.js'
+export {
+  isCanonicalAbsoluteBalanceTx,
+  isCanonicalAbsoluteNonceTx,
+  getLatestCanonicalAbsoluteBalanceTx,
+  getLatestCanonicalAbsoluteNonceTx,
+} from './absolute.js'

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

@@ -1,4 +1,7 @@
+import assert from 'minimalistic-assert'
+
 import { getNonce } from '../eth-like-util.js'
+import { getLatestCanonicalAbsoluteNonceTx } from '../tx-log/clarity-utils/absolute.js'
 
 export const resolveNonce = async ({
   asset,
@@ -25,15 +28,31 @@ export const resolveNonce = async ({
   )
 }
 
+const getLatestTxWithNonceChange = ({ reversedTxLog }) => {
+  assert(reversedTxLog, 'expected reversedTxLog')
+
+  const maybeLatestAbsoluteNonceTx = getLatestCanonicalAbsoluteNonceTx({
+    reversedTxLog,
+  })
+
+  if (maybeLatestAbsoluteNonceTx) return maybeLatestAbsoluteNonceTx
+
+  for (const tx of reversedTxLog) {
+    if (tx.data.nonceChange) {
+      return tx
+    }
+  }
+}
+
 export const getNonceFromTxLog = ({ txLog, useAbsoluteNonce }) => {
   let absoluteNonce = 0
+
   if (useAbsoluteNonce) {
     const reversedTxLog = txLog.reverse()
-    for (const tx of reversedTxLog) {
-      if (tx.data.nonceChange) {
-        absoluteNonce = parseInt(tx.data.nonceChange.to, 10)
-        break
-      }
+    const maybeLatestTxWithNonceChange = getLatestTxWithNonceChange({ reversedTxLog })
+
+    if (maybeLatestTxWithNonceChange) {
+      absoluteNonce = parseInt(maybeLatestTxWithNonceChange.data.nonceChange.to, 10)
     }
   }