@exodus/ethereum-api 10.0.0 → 10.1.1

package/CHANGELOG.md

@@ -3,6 +3,24 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [10.1.1](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@10.1.0...@exodus/ethereum-api@10.1.1) (2026-10-09)
+
+
+### Bug Fixes
+
+* migrate to @exodus/basic-utils 5 ([#8894](https://github.com/ExodusMovement/assets/issues/8894)) ([ed125f3](https://github.com/ExodusMovement/assets/commit/ed125f3257785c92a3b8f8239a2e9eefe5dc6772))
+
+
+
+## [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)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "10.0.0",
+  "version": "10.1.1",
   "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",
@@ -23,7 +23,7 @@
     "@exodus/asset": "^2.0.4",
     "@exodus/asset-lib": "^5.9.2",
     "@exodus/assets": "^11.4.0",
-    "@exodus/basic-utils": "^3.0.1",
+    "@exodus/basic-utils": "^5.1.0",
     "@exodus/bip44-constants": "^195.0.0",
     "@exodus/crypto": "^1.0.0-rc.26",
     "@exodus/currency": "^6.0.1",
@@ -66,5 +66,5 @@
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
   },
-  "gitHead": "83a0e678debb92fbfcefd92e7bd0453d1a92136b"
+  "gitHead": "41e6c1bb6a3d919f08cc3ee38068159259b335be"
 }

package/src/create-asset-utils.js

@@ -176,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'
@@ -188,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')),

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/index.js

@@ -43,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'
@@ -65,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/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'