@exodus/ethereum-api 9.0.3 → 10.1.0

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [10.1.0](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@10.0.0...@exodus/ethereum-api@10.1.0) (2026-10-05)
+
+
+### Features
+
+* **ethereum:** add evm staking api core with Everstake ETH and polygon adapters ([#8775](https://github.com/ExodusMovement/assets/issues/8775)) ([2d90106](https://github.com/ExodusMovement/assets/commit/2d901069989be82eb56aa253d5171e4f6af97356))
+
+
+
+## [10.0.0](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@9.0.3...@exodus/ethereum-api@10.0.0) (2026-10-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* **ethereum-api:** remove magnifier evm monitor (#8828)
+
+### Code Refactoring
+
+* **ethereum-api:** remove magnifier evm monitor ([#8828](https://github.com/ExodusMovement/assets/issues/8828)) ([d179ae1](https://github.com/ExodusMovement/assets/commit/d179ae145410f2a8033718a1889a7ea6676001e1))
+
+
+
 ## [9.0.3](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@9.0.2...@exodus/ethereum-api@9.0.3) (2026-10-05)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "9.0.3",
+  "version": "10.1.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",
@@ -66,5 +66,5 @@
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
   },
-  "gitHead": "e783e7a31c40807698ae2b9629e1c2dd5c03c228"
+  "gitHead": "f5c81fc2962e5d2836794149870fb9aaf094ddc9"
 }

package/src/create-asset-utils.js

@@ -15,7 +15,6 @@ import {
 } from './multicall3/index.js'
 import { ClarityMonitor } from './tx-log/clarity-monitor.js'
 import { ClarityTruncatedHistoryMonitor } from './tx-log/clarity-truncated-history-monitor.js'
-import { EthereumMonitor } from './tx-log/ethereum-monitor.js'
 import { EthereumNoHistoryMonitor } from './tx-log/ethereum-no-history-monitor.js'
 import { getOptimisticTxLogEffects } from './tx-log/get-optimistic-txlog-effects.js'
 import { BLOCK_TAG_LATEST, BLOCK_TAG_PENDING, resolveNonce } from './tx-send/nonce-utils.js'
@@ -177,7 +176,7 @@ export const createTransactionPrivacyResult = ({
     return { nonce, txId }
   }
 
-  const sendPrivateBundle = async ({ unsignedTxBundle }) => {
+  const sendPrivateBundle = async ({ unsignedTxBundle, onBeforeSign }) => {
     assert(
       Array.isArray(unsignedTxBundle) && unsignedTxBundle.length > 0,
       'expected non-empty unsignedTxBundle'
@@ -189,11 +188,11 @@ export const createTransactionPrivacyResult = ({
       await assertNonZeroTipGasPrice({ asset, assetClientInterface, unsignedTx })
     }
 
-    const signTxResults = await Promise.all(
-      unsignedTxBundle.map(({ asset, unsignedTx, walletAccount }) =>
-        signTx({ assetClientInterface, asset, unsignedTx, walletAccount })
-      )
-    )
+    const signTxResults = []
+    for (const [index, { asset, unsignedTx, walletAccount }] of unsignedTxBundle.entries()) {
+      onBeforeSign?.({ index, total: unsignedTxBundle.length })
+      signTxResults.push(await signTx({ assetClientInterface, asset, unsignedTx, walletAccount }))
+    }
 
     const maybeBundleResult = await broadcastPrivateBundle({
       txs: signTxResults.map(({ rawTx }) => rawTx.toString('hex')),
@@ -355,15 +354,6 @@ export const createHistoryMonitorFactory = ({
           ...args,
         })
         break
-      case 'magnifier':
-        monitor = new EthereumMonitor({
-          assetClientInterface,
-          interval: ms(monitorInterval || '15s'),
-          server,
-          rpcBalanceAssetNames,
-          ...args,
-        })
-        break
       default:
         throw new Error(`Monitor type ${monitorType} of evm asset ${assetName} is unknown`)
     }

package/src/create-asset.js

@@ -49,6 +49,11 @@ import { estimateL1DataFeeFactory, getL1GetFeeFactory } from './optimism-gas/ind
 import { createSendValidations } from './send-validations.js'
 import { serverBasedFeeMonitorFactoryFactory } from './server-based-fee-monitor.js'
 import { stakingApiFactory } from './staking/api/index.js'
+import {
+  applyStakingApiOverrides,
+  composeStakingApi,
+  isStakingApiEnabled,
+} from './staking/evm/compose-staking-api.js'
 import { createTxFactory } from './tx-create.js'
 import { txSendFactory } from './tx-send/index.js'
 import { createWeb3API } from './web3/index.js'
@@ -135,8 +140,14 @@ export const createAssetFactory = ({
       supportsTransactionPrivacy,
       transactionAssessment,
       multicall3Address,
+      stakingApiEnabled: stakingApiOverrides,
     } = configWithOverrides
 
+    const assetStakingDependencies = applyStakingApiOverrides({
+      stakingDependencies,
+      overrides: stakingApiOverrides,
+    })
+
     const asset = assets[base.name]
 
     const { monitorType, serverUrl, monitorInterval } = resolveMonitorSettings({
@@ -206,7 +217,7 @@ export const createAssetFactory = ({
         assetClientInterface,
         server,
         stakingConfiguration,
-        stakingDependencies,
+        stakingDependencies: assetStakingDependencies,
         createRpcRequestAccumulator,
       },
       assets
@@ -236,6 +247,23 @@ export const createAssetFactory = ({
         supportsTransactionPrivacy,
       })
 
+    const stakingApiEnabled =
+      supportsStaking && isStakingApiEnabled(assetStakingDependencies[asset.name])
+
+    const createAssetStakingApi = () =>
+      composeStakingApi({
+        assetClientInterface,
+        stakingDependencies: assetStakingDependencies[asset.name],
+        legacyStakingApi: stakingApiFactory({
+          assetName: asset.name,
+          currency: asset.currency,
+          assetClientInterface,
+          server,
+          stakingConfiguration: stakingConfiguration[asset.name],
+          stakingDependencies: assetStakingDependencies[asset.name],
+        }),
+      })
+
     const features = {
       accountState: true,
       customTokens,
@@ -254,6 +282,7 @@ export const createAssetFactory = ({
       supportsCustomFees,
       supportsTransactionPrivacy: Boolean(supportsTransactionPrivacy),
       ...(supportsStaking && { staking: {} }),
+      ...(stakingApiEnabled && { stakingApi: true }),
       ...(delisted && { delisted }),
     }
 
@@ -393,15 +422,8 @@ export const createAssetFactory = ({
         signer ? signMessageWithSigner({ message, signer }) : signMessage({ privateKey, message }),
       ...(checkTx && { checkTx }),
       ...(supportsStaking &&
-        stakingDependencies[asset.name] && {
-          staking: stakingApiFactory({
-            assetName: asset.name,
-            currency: asset.currency,
-            assetClientInterface,
-            server,
-            stakingConfiguration: stakingConfiguration[asset.name],
-            stakingDependencies: stakingDependencies[asset.name],
-          }),
+        assetStakingDependencies[asset.name] && {
+          staking: createAssetStakingApi(),
         }),
       validateAssetId: address.validate,
       web3,

package/src/create-token-factory.js

@@ -3,6 +3,7 @@ import { createContract } from '@exodus/ethereum-lib'
 import assert from 'minimalistic-assert'
 
 import { stakingApiFactory } from './staking/api/index.js'
+import { composeStakingApi, isStakingApiEnabled } from './staking/evm/compose-staking-api.js'
 import {
   isPolygonClaimUndelegate,
   isPolygonDelegate,
@@ -48,7 +49,13 @@ const getCreateBaseToken =
   }) =>
   ({ name, contract, features, ...tokenDef }) => {
     assert(getBalances, 'getBalances is required')
-    const tokenSpecificFeatures = name === 'polygon' ? { staking: {} } : {}
+    const tokenSpecificFeatures =
+      name === 'polygon'
+        ? {
+            staking: {},
+            ...(isStakingApiEnabled(stakingDependencies[name]) && { stakingApi: true }),
+          }
+        : {}
 
     const tokenFeatures = { ...defaultTokenFeatures, ...features, ...tokenSpecificFeatures }
     const baseApi = {
@@ -72,14 +79,18 @@ const getCreateBaseToken =
     }
 
     if (name === 'polygon' && stakingDependencies[name]) {
-      baseApi.staking = stakingApiFactory({
-        assetName: tokenAsset.name,
-        currency: tokenAsset.currency,
+      baseApi.staking = composeStakingApi({
         assetClientInterface,
-        server,
-        stakingConfiguration: stakingConfiguration[name],
         stakingDependencies: stakingDependencies[name],
-        createRpcRequestAccumulator,
+        legacyStakingApi: stakingApiFactory({
+          assetName: tokenAsset.name,
+          currency: tokenAsset.currency,
+          assetClientInterface,
+          server,
+          stakingConfiguration: stakingConfiguration[name],
+          stakingDependencies: stakingDependencies[name],
+          createRpcRequestAccumulator,
+        }),
       })
     }
 

package/src/error-wrapper.js

@@ -281,6 +281,13 @@ export function getEvmErrorReason(errorMessage) {
   return null
 }
 
+export function getFetchGasLimitErrorReason(errorMessage) {
+  const reason = getEvmErrorReason(errorMessage)?.reason
+  return reason && reason !== EVM_ERROR_REASONS.executionReverted.reason
+    ? { reason, type: EVM_ERROR_TYPES.CONTRACT_CALL }
+    : EVM_ERROR_REASONS.fetchGasLimitFailed
+}
+
 const MAX_HINT_LENGTH = 100
 // TODO: move this to be a generic error for all assets
 export class EthLikeError extends Error {
@@ -374,7 +381,8 @@ export const withErrorReason = async ({ promise, errorReasonInfo, hint, baseAsse
 
     throw new EthLikeError({
       message: err.message,
-      errorReasonInfo,
+      errorReasonInfo:
+        typeof errorReasonInfo === 'function' ? errorReasonInfo(err.message) : errorReasonInfo,
       hint,
       traceId: err.traceId,
       baseAssetName,

package/src/eth-like-util.js

@@ -4,7 +4,12 @@ import { safeString } from '@exodus/safe-string'
 import SolidityContract from '@exodus/solidity-contract'
 import assert from 'minimalistic-assert'
 
-import { EthLikeError, EVM_ERROR_REASONS, withErrorReason } from './error-wrapper.js'
+import {
+  EthLikeError,
+  EVM_ERROR_REASONS,
+  getFetchGasLimitErrorReason,
+  withErrorReason,
+} from './error-wrapper.js'
 import { getServer } from './exodus-eth-server/index.js'
 import { fromHexToString } from './number-utils.js'
 
@@ -60,7 +65,7 @@ export async function getNonce({ asset, address, tag = 'latest' }) {
 export async function estimateGas({ asset, ...args }) {
   return withErrorReason({
     promise: getServer(asset).estimateGas(args),
-    errorReasonInfo: EVM_ERROR_REASONS.fetchGasLimitFailed,
+    errorReasonInfo: getFetchGasLimitErrorReason,
     hint: safeString`estimateGas`,
     baseAssetName: asset.baseAsset.name,
   })

package/src/exodus-eth-server/index.js

@@ -1,6 +1,5 @@
 import assert from 'minimalistic-assert'
 
-import { create } from './api.js'
 import ApiCoinNodesServer from './api-coin-nodes.js'
 import ClarityServer from './clarity.js'
 import ClarityServerV2 from './clarity-v2.js'
@@ -12,7 +11,6 @@ export const ValidMonitorTypes = [
   'clarity-v2',
   'clarity-truncated-history',
   'clarity-v3',
-  'magnifier',
 ]
 
 export function createEvmServer({ assetName, serverUrl, monitorType }) {
@@ -30,8 +28,6 @@ export function createEvmServer({ assetName, serverUrl, monitorType }) {
     case 'clarity-truncated-history':
     case 'clarity-v3':
       return new ClarityServerV2({ baseAssetName: assetName, uri: serverUrl })
-    case 'magnifier':
-      return create(serverUrl, assetName)
     default:
       throw new Error(`No server API found for ${assetName} and type ${monitorType}`)
   }

package/src/get-balance-for-address.js

@@ -11,7 +11,7 @@ export const createGetBalanceForAddress = ({ asset, server }) => {
     }
 
     if (balance && typeof balance === 'object' && typeof balance.confirmed?.value === 'string') {
-      // Magnifier/Clarity reponse
+      // Clarity response
       return asset.currency.baseUnit(balance.confirmed.value)
     }
 

package/src/index.js

@@ -31,7 +31,6 @@ export {
 export { createEvmServer, getServer } from './exodus-eth-server/index.js'
 
 export {
-  EthereumMonitor,
   EthereumNoHistoryMonitor,
   ClarityMonitor,
   getOptimisticTxLogEffects,
@@ -44,6 +43,20 @@ export { createEncodeMultisigContract } from './multisig-address.js'
 export { FantomStaking, stakingProviderClientFactory } from './staking/index.js'
 export { EthLikeRpcRequestAccumulator } from './multicall3/index.js'
 export { createCachedStakingRead } from './staking/cached-read.js'
+export { createStakingTxs, sendStakingTxs, STAKING_TX_MODE } from './staking/evm/staking-txs.js'
+export { createEvmStakingApi } from './staking/evm/create-evm-staking-api.js'
+export {
+  createRejectionError as createStakingRejectionError,
+  createSubmitError as createStakingSubmitError,
+  fail as failStakingCheck,
+  pass as passStakingCheck,
+  sumOperationFees as sumStakingOperationFees,
+  warnIfBelow as warnIfStakingBalanceBelow,
+} from './staking/evm/staking-errors.js'
+export {
+  createEverstakeStakingAdapter,
+  ETH_STAKING_GAS_LIMITS,
+} from './staking/ethereum/staking-adapter.js'
 export { ethereumStakingDeps } from './staking/ethereum/deps.js'
 export { getEthereumStakingInfo, createEthereumStakingService } from './staking/ethereum/service.js'
 export { EthereumStaking } from './staking/ethereum/api.js'
@@ -66,6 +79,7 @@ export {
   isPolygonReward,
   isPolygonClaimUndelegate,
   isPendingPolygonUndelegateTxInEthereumTxLog,
+  isPolygonUndelegateTxInEthereumTxLog,
 } from './staking/matic/matic-staking-utils.js'
 
 export { fetchTxPreview } from './simulate-tx/fetch-tx-preview.js'

package/src/nft-utils.js

@@ -2,7 +2,7 @@ import { safeString } from '@exodus/safe-string'
 import SolidityContract from '@exodus/solidity-contract'
 import assert from 'minimalistic-assert'
 
-import { EthLikeError, EVM_ERROR_REASONS } from './error-wrapper.js'
+import { EthLikeError, EVM_ERROR_REASONS, getFetchGasLimitErrorReason } from './error-wrapper.js'
 import { fetchGasLimit } from './gas-estimation.js'
 
 export const getNftArguments = async ({ asset, nft, fromAddress, toAddress }) => {
@@ -45,9 +45,13 @@ export const getNftArguments = async ({ asset, nft, fromAddress, toAddress }) =>
       }
     })
   ).catch((e) => {
+    const [first, ...rest] = e.errors.map((err) => getFetchGasLimitErrorReason(err.message))
     throw new EthLikeError({
       message: errors.join('\n'),
-      errorReasonInfo: EVM_ERROR_REASONS.fetchGasLimitFailed,
+      errorReasonInfo:
+        first && rest.every(({ reason }) => reason === first.reason)
+          ? first
+          : EVM_ERROR_REASONS.fetchGasLimitFailed,
       hint: safeString`getNftArguments`,
       traceId: e.traceId,
     })

package/src/server-based-fee-monitor.js

@@ -6,7 +6,7 @@ import { calculateEthLikeFeeMonitorUpdate } from './fee-utils.js'
 /**
  * Generic eth server based fee monitor.
  *
- * Compatible with all servers, clarity, magnifier and api-coin (they all implement the gasPrice method).
+ * Compatible with all servers, clarity and api-coin (they all implement the gasPrice method).
  *
  * Usage in the index files:
  *

package/src/staking/api/index.js

@@ -36,8 +36,9 @@ export const stakingApiFactory = ({
 
   return {
     ...stakingService,
+    // @deprecated legacy staking api, remove once evm staking unification is done
     isStaking: async ({ isDelegating }) => isDelegating,
     isUnstaking: async ({ isUndelegateInProgress }) => isUndelegateInProgress,
-    isUnstaked: async ({ canClaimUndelegateBalance }) => canClaimUndelegateBalance,
+    isUnstaked: async ({ canClaimUndelegatedBalance }) => canClaimUndelegatedBalance,
   }
 }

package/src/staking/ethereum/api.js

@@ -7,9 +7,8 @@ import assert from 'minimalistic-assert'
 import { EVM_ERROR_REASONS, withErrorReason } from '../../error-wrapper.js'
 import { EthLikeRpcRequestAccumulator } from '../../multicall3/index.js'
 import { createCachedStakingRead } from '../cached-read.js'
+import { ETH_STAKING_MIN_AMOUNT } from './min-amount.js'
 
-// TODO: Shouldn't this be a function of `ethereumStakingState.minDelegateAmount`?
-const MIN_AMOUNT = '0.1'
 const RETRY_DELAYS = ['10s']
 
 const EVERSTAKE_API_URL = 'https://eth-clarity.a.exodus.io/everstake-rewards'
@@ -46,7 +45,7 @@ export class EthereumStaking {
     return txInputHex.toLowerCase().startsWith(EthereumStaking.METHODS_IDS.DELEGATE)
   }
 
-  constructor(assetName, currency, minAmount = MIN_AMOUNT, server) {
+  constructor(assetName, currency, minAmount = ETH_STAKING_MIN_AMOUNT, server) {
     this.asset = { name: assetName, currency }
     const accountingAddress =
       EthereumStaking.addresses[assetName].EVERSTAKE_ADDRESS_CONTRACT_ACCOUNTING

package/src/staking/ethereum/deps.js

@@ -1,5 +1,6 @@
 import { EthereumStaking } from './api.js'
 import { createEthereumStakingService, getEthereumStakingInfo } from './service.js'
+import { createEverstakeStakingAdapter } from './staking-adapter.js'
 
 /** Staking server factory for ethereum (used by stakingApiFactory). */
 export const stakingServerFactory = ({ assetName, currency, server, minAmount }) =>
@@ -24,6 +25,7 @@ export const stakingServiceFactory = ({ assetClientInterface, server, stakingSer
         useQueueCache,
         background,
       }),
+    // @deprecated legacy staking api, remove once evm staking unification is done
     stake: service.delegate,
     unstake: service.undelegate,
     claimUnstaked: service.claimUndelegatedBalance,
@@ -34,4 +36,5 @@ export const stakingServiceFactory = ({ assetClientInterface, server, stakingSer
 export const ethereumStakingDeps = {
   stakingServerFactory,
   stakingServiceFactory,
+  createStakingAdapter: ({ service }) => createEverstakeStakingAdapter({ service }),
 }

package/src/staking/ethereum/min-amount.js

@@ -0,0 +1 @@
+export const ETH_STAKING_MIN_AMOUNT = '0.1'