@exodus/ethereum-api 8.73.6 → 8.74.1

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.74.1](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.74.0...@exodus/ethereum-api@8.74.1) (2026-05-12)
+
+
+### Bug Fixes
+
+* validate polygon unstake state before gas estimation ([#8002](https://github.com/ExodusMovement/assets/issues/8002)) ([f63a244](https://github.com/ExodusMovement/assets/commit/f63a2441868c6226fe14085c0f7d9587131e69e0))
+
+
+
+## [8.74.0](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.73.6...@exodus/ethereum-api@8.74.0) (2026-05-12)
+
+
+### Features
+
+
+* feat: add MoveFunds API for EVM assets (#7868)
+
+
+
 ## [8.73.6](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.73.5...@exodus/ethereum-api@8.73.6) (2026-05-11)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "8.73.6",
+  "version": "8.74.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",
@@ -29,7 +29,7 @@
     "@exodus/bip44-constants": "^195.0.0",
     "@exodus/crypto": "^1.0.0-rc.26",
     "@exodus/currency": "^6.0.1",
-    "@exodus/ethereum-lib": "^5.24.0",
+    "@exodus/ethereum-lib": "^5.24.1",
     "@exodus/ethereum-meta": "^2.9.1",
     "@exodus/ethereumholesky-meta": "^2.0.5",
     "@exodus/ethereumjs": "^1.11.0",
@@ -67,5 +67,5 @@
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
   },
-  "gitHead": "79dabe78d5a3652b509c7cc1d1496ac2404104b8"
+  "gitHead": "7f184588091acba3b358e4af13783ee1e2bab4ba"
 }

package/src/create-asset.js

@@ -37,6 +37,7 @@ import { createFeeData } from './fee-data/index.js'
 import { createGetBalanceForAddress } from './get-balance-for-address.js'
 import { getBalancesFactory } from './get-balances.js'
 import { getFeeFactory } from './get-fee.js'
+import { moveFundsFactory } from './move-funds.js'
 import { estimateL1DataFeeFactory, getL1GetFeeFactory } from './optimism-gas/index.js'
 import { serverBasedFeeMonitorFactoryFactory } from './server-based-fee-monitor.js'
 import { stakingApiFactory } from './staking/api/index.js'
@@ -208,6 +209,7 @@ export const createAssetFactory = ({
       feesApi: true,
       isMaxFeeAsset,
       isTestnet,
+      moveFunds: true,
       nfts,
       noHistory: monitorType === 'no-history',
       signWithSigner: true,
@@ -281,6 +283,13 @@ export const createAssetFactory = ({
 
     const securityChecks = createSecurityChecks({ eip7702Supported })
 
+    const moveFunds = moveFundsFactory({
+      baseAssetName: asset.name,
+      assetClientInterface,
+      createTx,
+      server,
+    })
+
     const api = {
       addressHasHistory,
       broadcastTx: (...args) => server.sendRawTransaction(...args),
@@ -311,6 +320,7 @@ export const createAssetFactory = ({
       getSupportedPurposes: () => [44],
       getTokens,
       hasFeature: (feature) => !!features[feature], // @deprecated use api.features instead
+      moveFunds,
       privateKeyEncodingDefinition: { encoding: 'hex' },
       sendTx,
       signTx: ({ unsignedTx, privateKey, signer }) =>

package/src/error-wrapper.js

@@ -5,6 +5,7 @@ export const EVM_ERROR_TYPES = {
   NODE_STATE_READ: safeString`NODE_STATE_READ`, // RPC-level read operations
   CONTRACT_CALL: safeString`CONTRACT_CALL`, // Smart contract calls (eth_call, estimateGas)
   BROADCAST: safeString`BROADCAST`, // Transaction broadcast errors (includes reverts)
+  PREFLIGHT_VALIDATION: safeString`PREFLIGHT_VALIDATION`, // Logic/state validation before contract gasEstimation & broadcast
 }
 
 // Operation-specific reasons

package/src/exodus-eth-server/ws-gateway.js

@@ -1,5 +1,4 @@
 import { createConsoleLogger } from '@exodus/asset-lib'
-import WebSocket from '@exodus/fetch/websocket'
 import EventEmitter from 'eventemitter3'
 import assert from 'minimalistic-assert'
 

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

@@ -1,4 +1,3 @@
-import WebSocket from '@exodus/fetch/websocket'
 import EventEmitter from 'events/events.js' // forces it to use the module from node_modules
 import ms from 'ms'
 

package/src/index.js

@@ -57,6 +57,7 @@ export {
   isPolygonUndelegate,
   isPolygonReward,
   isPolygonClaimUndelegate,
+  isPendingPolygonUndelegateTxInEthereumTxLog,
 } from './staking/index.js'
 
 export { fetchTxPreview, maybeRemoveDuplicates, retrieveSideEffects } from './simulate-tx/index.js'
@@ -99,6 +100,8 @@ export { txSendFactory } from './tx-send/index.js'
 
 export { createAssetFactory } from './create-asset.js'
 
+export { moveFundsFactory } from './move-funds.js'
+
 export { createContractBlackListCheck } from './create-asset-utils.js'
 
 export {

package/src/move-funds.js

@@ -0,0 +1,120 @@
+import { signUnsignedTx } from '@exodus/ethereum-lib'
+import { addHexPrefix, isValidPrivate, privateToAddress, toBuffer } from '@exodus/ethereumjs/util'
+import assert from 'minimalistic-assert'
+
+import { getNonce, getTokenBalanceFromNode } from './eth-like-util.js'
+import { fetchGasLimit } from './gas-estimation.js'
+
+export const moveFundsFactory = ({ baseAssetName, assetClientInterface, createTx, server }) => {
+  assert(baseAssetName, 'baseAssetName is required')
+  assert(assetClientInterface, 'assetClientInterface is required')
+  assert(createTx, 'createTx is required')
+  assert(server, 'server is required')
+
+  async function prepareSendFundsTx({
+    assetName,
+    input,
+    toAddress,
+    walletAccount,
+    MoveFundsError,
+  }) {
+    assert(assetName, 'assetName is required')
+    assert(input, 'input is required')
+
+    assert(walletAccount, 'walletAccount is required')
+    assert(MoveFundsError, 'MoveFundsError is required')
+
+    const assets = await assetClientInterface.getAssetsForNetwork({ baseAssetName })
+    const asset = assets[assetName]
+    assert(asset, 'asset is required')
+
+    assert(toAddress && asset.baseAsset.address.validate(toAddress), 'valid toAddress is required')
+
+    let privateKey
+    try {
+      const hexKey = addHexPrefix(input.trim())
+      if (typeof hexKey !== 'string' || hexKey.length !== 66) throw new Error('invalid length')
+      privateKey = toBuffer(hexKey)
+      if (!isValidPrivate(privateKey)) throw new Error('invalid key')
+    } catch {
+      throw new MoveFundsError('private-key-invalid')
+    }
+
+    const fromAddress = `0x${privateToAddress(privateKey).toString('hex')}`
+
+    if (fromAddress === toAddress.toLowerCase()) {
+      throw new MoveFundsError('private-key-own-key', { fromAddress })
+    }
+
+    const isToken = asset.name !== baseAssetName
+
+    const [nonce, rawEthBalance] = await Promise.all([
+      getNonce({ asset: asset.baseAsset, address: fromAddress }),
+      server.getBalanceProxied(fromAddress),
+    ])
+
+    const ethBalance = asset.baseAsset.currency.baseUnit(rawEthBalance)
+
+    let amount = ethBalance
+    if (isToken) {
+      const rawTokenBalance = await getTokenBalanceFromNode({ asset, address: fromAddress })
+      amount = asset.currency.baseUnit(rawTokenBalance)
+    }
+
+    if (amount.isZero) {
+      throw new MoveFundsError('balance-zero', { fromAddress })
+    }
+
+    const feeData = await assetClientInterface.getFeeData({ assetName })
+
+    const gasLimit = await fetchGasLimit({
+      asset,
+      feeData,
+      fromAddress,
+      toAddress,
+      amount,
+    })
+
+    const fee = feeData.gasPrice.mul(gasLimit)
+
+    const afterFee = ethBalance.sub(fee)
+    if (isToken) {
+      if (afterFee.isNegative) {
+        throw new MoveFundsError('token-fee-insufficient', { fromAddress })
+      }
+    } else {
+      if (!afterFee.isPositive) {
+        throw new MoveFundsError('balance-negative', { fromAddress })
+      }
+
+      amount = amount.sub(fee)
+    }
+
+    const { unsignedTx } = await createTx({
+      asset,
+      walletAccount,
+      fromAddress,
+      address: toAddress,
+      amount,
+      nonce,
+      gasLimit,
+      gasPrice: feeData.gasPrice,
+      customFee: feeData.gasPrice,
+      isSendAll: true,
+    })
+
+    return { fromAddress, toAddress, amount, fee, privateKey, unsignedTx }
+  }
+
+  const sendFunds = async ({ privateKey, unsignedTx }) => {
+    assert(privateKey, 'privateKey is required')
+    assert(unsignedTx, 'unsignedTx is required')
+
+    const { rawTx } = await signUnsignedTx(unsignedTx, privateKey)
+    const txId = await server.sendRawTransaction(rawTx.toString('hex'))
+
+    return { txId }
+  }
+
+  return { prepareSendFundsTx, sendFunds }
+}

package/src/staking/matic/index.js

@@ -5,4 +5,5 @@ export {
   isPolygonUndelegate,
   isPolygonReward,
   isPolygonClaimUndelegate,
+  isPendingPolygonUndelegateTxInEthereumTxLog,
 } from './matic-staking-utils.js'

package/src/staking/matic/matic-staking-utils.js

@@ -1,5 +1,5 @@
 import NumberUnit from '@exodus/currency'
-import { parseUnsignedTx } from '@exodus/ethereum-lib'
+import { getMethodIdFromEthTx, isPendingTxInLog, parseUnsignedTx } from '@exodus/ethereum-lib'
 import assetsList, { asset as ethereum } from '@exodus/ethereum-meta'
 import { Tx } from '@exodus/models'
 import assert from 'minimalistic-assert'
@@ -52,6 +52,17 @@ const isPolygonUndelegateTxInEthreumTxLog = (tx) =>
 export const isPolygonUndelegateTxInEthereumTxLog = (tx) =>
   isPolygonStakingContractTxInEthereumTxLog(tx) && isPolygonUndelegateTxInEthreumTxLog(tx)
 
+// Pending variant intended for client-side selectors (e.g. "show Unstaking… as
+// soon as the tx hits the log"). Composes the shared tx-log lifecycle and
+// method-ID helpers so this and the asset-side preflight in
+// @exodus/ethereum-plugin/staking/polygon/staking-utils agree on what "pending"
+// means from a single definition.
+export const isPendingPolygonUndelegateTxInEthereumTxLog = (tx) =>
+  !!tx &&
+  isPendingTxInLog(tx) &&
+  tx.to?.toLowerCase() === MaticStakingApi.EVERSTAKE_VALIDATOR_CONTRACT_ADDR &&
+  getMethodIdFromEthTx(tx, UNDELEGATE) === UNDELEGATE
+
 export const createUndelegateTx = (tx) => {
   return Tx.fromJSON({
     ...tx,

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

@@ -15,7 +15,7 @@ export const resolveNonce = async ({
   asset,
   forceFromNode,
   fromAddress,
-  txLog = [],
+  txLog, // TxSet expected. Array only for testing purposes.
   accountState,
   tag = BLOCK_TAG_LATEST,
   useAbsoluteNonce,
@@ -51,13 +51,27 @@ const getLatestTxWithNonceChange = ({ reversedTxLog }) => {
   }
 }
 
+/**
+ * Computes the next nonce from the given `txLog`.
+ *
+ * @param {Object} options
+ * @param {import('@exodus/models').TxSet} options.txLog - A `TxSet` from
+ *     `@exodus/models`, NOT a plain `Array`.
+ * @param {boolean} [options.useAbsoluteNonce]
+ * @param {string} [options.tag]
+ * @returns {number}
+ */
 const getNonceFromTxLog = ({ txLog, useAbsoluteNonce, tag }) => {
+  if (!txLog || txLog.size === 0) return 0
+
   let absoluteNonce = 0
 
   if (useAbsoluteNonce) {
-    // NOTE: Use a copy to avoid mutating the caller's `txLog` array, since
-    //       `Array.prototype.reverse()` reverses in-place.
-    const reversedTxLog = [...txLog].reverse()
+    // NOTE: `TxSet#reverse()` returns a one-shot iterable yielding txs
+    //       in reverse order — it is NOT an in-place reversal like
+    //       `Array.prototype.reverse()`, so the caller's `txLog` is
+    //       left untouched.
+    const reversedTxLog = txLog.reverse()
     const maybeLatestTxWithNonceChange = getLatestTxWithNonceChange({ reversedTxLog })
 
     if (maybeLatestTxWithNonceChange) {
@@ -70,6 +84,7 @@ const getNonceFromTxLog = ({ txLog, useAbsoluteNonce, tag }) => {
     }
   }
 
+  // TODO: can't we iterate in reverse up to the first (few) nonce(s)?
   const nonceFromLog = [...txLog]
     .filter((tx) => tx.sent && !tx.dropped && tx.data.nonce != null)
     // NOTE: If we're only considering the `'latest'` block `tag`,