@exodus/ethereum-api 8.62.1 → 8.62.2

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.2](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.62.1...@exodus/ethereum-api@8.62.2) (2026-01-07)
+
+
+### Bug Fixes
+
+
+* fix: when using absolute balances, ensure we process the most recent record (#7127)
+
+
+
 ## [8.62.1](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.62.0...@exodus/ethereum-api@8.62.1) (2026-01-01)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "8.62.1",
+  "version": "8.62.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": "18e9c9aa3976c189bbba24d8cad7c413ddec336d"
+  "gitHead": "be4898d14d842c79dfcc327501c390dfaf56157b"
 }

package/src/get-balances.js

@@ -5,6 +5,66 @@ 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
+}
 
 /**
  * TODO: Balance model gaps for EVM staking assets
@@ -32,7 +92,6 @@ import assert from 'minimalistic-assert'
  *
  * See: docs/balances-model.md for the intended balance model spec.
  */
-
 export const getAbsoluteBalance = ({ asset, txLog }) => {
   assert(asset, 'asset is required')
   assert(txLog, 'txLog is required')
@@ -41,13 +100,26 @@ export const getAbsoluteBalance = ({ asset, txLog }) => {
     return asset.currency.ZERO
   }
 
+  // NOTE: We reverse the `txLog` to prioritize the handling
+  //       of the most recent transactions first. The reason
+  //       we do this is to terminate early if we find an
+  //       absolute balance node.
+  const reversedTxLog = txLog.reverse()
+
+  const maybeLatestAbsoluteBalanceTx = getLatestCanonicalAbsoluteBalanceTx({ reversedTxLog })
+
   let balance = asset.currency.ZERO
   let hasAbsoluteBalance = false
 
-  const reversedTxLog = txLog.reverse()
-
   for (const tx of reversedTxLog) {
     if (tx.data.balanceChange) {
+      // If we are aware of the existence of the most
+      // recent absolute balance, then we can ignore
+      // any competing instances.
+      if (maybeLatestAbsoluteBalanceTx && tx.txId !== maybeLatestAbsoluteBalanceTx.txId) {
+        continue
+      }
+
       hasAbsoluteBalance = true
       balance = balance.add(asset.currency.baseUnit(tx.data.balanceChange.to))
 

package/src/staking/ethereum/service.js

@@ -510,7 +510,6 @@ export function createEthereumStakingService({
       walletAccount,
       address: to,
       amount: amount || asset.currency.ZERO,
-      shouldLog: true,
       txInput,
       gasPrice,
       gasLimit,

package/src/staking/matic/service.js

@@ -430,7 +430,6 @@ export function createPolygonStakingService({
       walletAccount,
       address: to,
       amount: asset.currency.ZERO,
-      shouldLog: true,
       txInput,
       gasPrice,
       gasLimit,

package/src/tx-log/clarity-utils/get-log-items-from-server-tx.js

@@ -24,6 +24,8 @@ export default function getLogItemsFromServerTx({
   const txId = serverTx.hash
   const nonce = parseInt(serverTx.nonce, 10)
   const gasLimit = parseInt(serverTx.gas, 10)
+  const blockNumber = serverTx.blockNumber
+  const transactionIndex = parseInt(serverTx.transactionIndex, 10)
   const error = serverTx.error || (serverTx.status === '0' ? 'Failed' : null)
   const feeAmount = getFeeAmount(asset, serverTx)
   const internalTransfers = filterEffects(serverTx.effects, 'internal') || []
@@ -91,6 +93,8 @@ export default function getLogItemsFromServerTx({
             nonceChange: nonceUpdate,
             ...methodId,
             ...(sent?.length > 0 ? { sent } : undefined),
+            blockNumber,
+            transactionIndex,
           },
           ...(ourWalletWasSender
             ? { from: [], to: toAddress, feeAmount, feeCoinName: asset.feeAsset.name }
@@ -149,7 +153,15 @@ export default function getLogItemsFromServerTx({
         ...logItemCommonProperties,
         coinAmount,
         coinName: tokenName,
-        data: { data, nonce, gasLimit, balanceChange, ...methodId },
+        data: {
+          data,
+          nonce,
+          gasLimit,
+          balanceChange,
+          ...methodId,
+          blockNumber,
+          transactionIndex,
+        },
         ...(isConsideredSent
           ? { from: [], to: tokenTransferToAddress, feeAmount, feeCoinName: token.feeAsset.name }
           : { from: tokenFromAddresses }),