@exodus/ethereum-api 8.62.0 → 8.62.2

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.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)
+
+
+### Bug Fixes
+
+
+* Fix: expose matic 'liquid' rewards (#7151)
+
+
+
 ## [8.62.0](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.61.3...@exodus/ethereum-api@8.62.0) (2025-12-22)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "8.62.0",
+  "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": "5702f44af435bd6781879ba3e9b2f28fba655c6c"
+  "gitHead": "be4898d14d842c79dfcc327501c390dfaf56157b"
 }

package/src/get-balances.js

@@ -5,7 +5,93 @@ 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
+ *
+ * Missing fields that should be added to getBalancesFactory return value:
+ *
+ * 1. `rewards` / `liquidRewards` - Currently, accountState.staking[asset.name] contains
+ *    rewardsBalance and liquidRewards (from getPolygonStakingInfo / getEthereumStakingInfo),
+ *    but getBalancesFactory doesn't read or expose them. Need a getRewards() helper similar
+ *    to getStaked() and getStaking().
+ *
+ * 2. `rewardsBalance` (total lifetime rewards) - Available in accountState but not surfaced.
+ *
+ * 3. `withdrawable` - For Polygon, this represents claimable rewards, distinct from
+ *    unclaimedUndelegatedBalance (unstaked principal). Currently conflated.
+ *
+ * 4. `walletReserve` - Documented in balances-model.md but not implemented.
+ *
+ * 5. `staking` field reads pendingBalance + pendingDepositedBalance, which Polygon staking
+ *    doesn't return (only Ethereum native staking uses these). Needs asset-specific handling.
+ *
+ * The data flow already exists: monitor hooks call getStakingInfo() → accountState.staking[asset.name].
+ * Implementation would add helper functions (getLiquidRewards, getRewardsBalance, etc.) and
+ * include these in the returned balance object, standardized across Ethereum/Polygon/etc.
+ *
+ * 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')
@@ -14,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,
@@ -554,6 +553,7 @@ async function fetchRewardsInfo({ stakingApi, delegator, currency }) {
 
   return {
     rewardsBalance: rewardsBalance.add(lastRewards), // all time accrued rewards
+    liquidRewards: lastRewards, // current pending rewards (on-chain)
     minRewardsToWithdraw,
     withdrawable, // unclaimed rewards
   }
@@ -564,7 +564,7 @@ export async function getPolygonStakingInfo({ address, asset: { currency, baseAs
   const delegator = address.toLowerCase()
   const [
     delegatedBalance,
-    { rewardsBalance, minRewardsToWithdraw, withdrawable },
+    { rewardsBalance, liquidRewards, minRewardsToWithdraw, withdrawable },
     { unbondNonce, withdrawalDelay, currentEpoch, withdrawExchangeRate },
   ] = await Promise.all([
     stakingApi.getTotalStake(delegator),
@@ -586,6 +586,7 @@ export async function getPolygonStakingInfo({ address, asset: { currency, baseAs
 
   return {
     rewardsBalance,
+    liquidRewards,
     withdrawable,
     unbondNonce,
     isDelegating,

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 }),