@exodus/ethereum-api 8.73.1 → 8.73.3

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.73.3](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.73.2...@exodus/ethereum-api@8.73.3) (2026-05-06)
+
+
+### Bug Fixes
+
+
+* fix: correct misleading assertion and error messages (#7965)
+
+* fix(ethereum-api): avoid mutating caller's txLog in resolveNonce (#7996)
+
+* fix(ethereum-api): filter hints before pushing to stack in EthLikeError (#7991)
+
+* fix: missing matic claim unstake transactions (#8006)
+
+
+
+## [8.73.2](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.73.1...@exodus/ethereum-api@8.73.2) (2026-05-05)
+
+**Note:** Version bump only for package @exodus/ethereum-api
+
+
+
+
+
 ## [8.73.1](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.73.0...@exodus/ethereum-api@8.73.1) (2026-05-04)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "8.73.1",
+  "version": "8.73.3",
   "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",
@@ -39,7 +39,7 @@
     "@exodus/simple-retry": "^0.0.6",
     "@exodus/solidity-contract": "^1.3.0",
     "@exodus/traceparent": "^3.0.1",
-    "@exodus/web3-ethereum-utils": "^4.6.0",
+    "@exodus/web3-ethereum-utils": "^4.7.4",
     "bn.js": "^5.2.1",
     "delay": "^4.0.1",
     "eventemitter3": "^4.0.7",
@@ -49,8 +49,7 @@
     "make-concurrent": "^4.0.0",
     "minimalistic-assert": "^1.0.1",
     "ms": "^2.1.1",
-    "socket.io-client": "^2.1.1",
-    "ws": "^6.1.0"
+    "socket.io-client": "^2.1.1"
   },
   "devDependencies": {
     "@exodus/assets-testing": "^1.0.0",
@@ -68,5 +67,5 @@
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
   },
-  "gitHead": "f6149536adebc3030321af18ba3c986a5d8a1bef"
+  "gitHead": "fe7c27f31aa14bf777660af02300c92def4b4a8c"
 }

package/src/error-wrapper.js

@@ -293,9 +293,12 @@ export class EthLikeError extends Error {
   constructor({ message, errorReasonInfo, hint, traceId, baseAssetName }) {
     super(message)
     this.name = safeString`EthLikeError`
-    this.#hintStack = [hint] // NOTE: we can add more hints to the stack
+    const filteredHint = this.#extractHint(hint)
+    // Only filtered hints are kept on the stack so that subsequent joins via
+    // `addHint` cannot leak sensitive info or untruncated content.
+    this.#hintStack = filteredHint ? [filteredHint] : []
     this.reason = errorReasonInfo.reason
-    this.hint = this.#extractHint(hint)
+    this.hint = filteredHint
     this.type = errorReasonInfo.type
     this.traceId = traceId
     this.baseAssetName = baseAssetName
@@ -307,8 +310,8 @@ export class EthLikeError extends Error {
       return this
     }
 
-    this.#hintStack.push(hint)
-    this.hint = `${this.#hintStack.join(':')}`
+    this.#hintStack.push(filteredHint)
+    this.hint = this.#hintStack.join(':')
     return this
   }
 

package/src/staking/ethereum/api.js

@@ -12,6 +12,11 @@ const RETRY_DELAYS = ['10s']
 
 const EVERSTAKE_API_URL = 'https://eth-clarity.a.exodus.io/everstake-rewards'
 
+export const UNSTAKE_DEFAULTS = {
+  allowedInterchangeNum: 0,
+  source: '2',
+}
+
 export class EthereumStaking {
   static addresses = {
     ethereum: {
@@ -229,8 +234,22 @@ export class EthereumStaking {
     throw new Error(`Min Amount ${this.minAmount}`)
   }
 
-  /* Unstake funds that are staked into the validator. Once unstaked they need to be claimed (once ready to withdraw) */
-  async unstake({ address, amount, allowedInterchangeNum = 0, source = '2' }) {
+  /**
+   * Unstake funds from the validator. The unstaked amount enters a withdrawal
+   * queue and must be claimed via `claimWithdrawRequest` after the validator exits.
+   *
+   * @param {number} allowedInterchangeNum - Max number of incoming stake requests
+   *   the contract may use to immediately return ETH to the unstaker (interchange).
+   *   When 0 (default), no interchange occurs and the full amount is queued.
+   *   When > 0, the contract may match up to N new stakers' deposits against this
+   *   unstake, returning ETH immediately without waiting for validator exit.
+   */
+  async unstake({
+    address,
+    amount,
+    allowedInterchangeNum = UNSTAKE_DEFAULTS.allowedInterchangeNum,
+    source = UNSTAKE_DEFAULTS.source,
+  }) {
     const amountWei = amount.toBaseString()
     const balance = await this.autocompoundBalanceOf(address) // amount staked into the validator (active balance)
 
@@ -281,7 +300,7 @@ export class EthereumStaking {
         throw new Error(err)
       }
     } else {
-      throw new Error(`Min Amount ${this.minAmount}`)
+      throw new Error(`Max Amount for unstakePending ${pendingBalance}`)
     }
   }
 }

package/src/staking/ethereum/everstake.js

@@ -2,7 +2,10 @@ import { fetch as exodusFetch } from '@exodus/fetch'
 import { TraceId } from '@exodus/traceparent'
 import assert from 'minimalistic-assert'
 
+import { UNSTAKE_DEFAULTS } from './api.js'
+
 const BASE_URL = 'https://eth-clarity.a.exodus.io/api/v2/ethereum/proxy/everstake/'
+const WALLET_SDK_BASE_URL = 'https://wallet-sdk-api.everstake.one/'
 
 const fetch = async (path, config = Object.create(null)) => {
   const url = new URL(path, BASE_URL).toString()
@@ -26,6 +29,56 @@ const fetch = async (path, config = Object.create(null)) => {
 
 const isFiniteInteger = (e) => Number.isInteger(e) && Number.isFinite(e)
 
+// Simulate an unstake to predict how much ETH the interchange pool returns instantly.
+// https://wallet-sdk-api.everstake.one/swagger/#/Ethereum/post_ethereum_pool_simulate_unstake
+//
+// Inputs:
+//   address: staker address (0x...)
+//   amount:  unstake amount in ETH (default units), e.g. "1.5" — NOT wei
+//   allowedInterchangeNum: interchange pool parameter (default from UNSTAKE_DEFAULTS)
+//   source: source identifier (default from UNSTAKE_DEFAULTS)
+//
+// Success (200): { result: <number> } — ETH returned instantly (capped by pool liquidity)
+// Error   (500): { "Internal Server Error": "Error: Max Amount For Unstake <max_eth>" }
+//                 when amount exceeds the staker's active balance
+export const simulateEverstakeUnstake = async ({
+  address,
+  amount,
+  allowedInterchangeNum = UNSTAKE_DEFAULTS.allowedInterchangeNum,
+  source = UNSTAKE_DEFAULTS.source,
+}) => {
+  try {
+    assert(typeof address === 'string' && address.startsWith('0x'), 'expected valid address')
+    assert(typeof amount === 'string' && amount.length > 0, 'expected amount in ETH as string')
+
+    const url = new URL('ethereum/pool/simulate_unstake', WALLET_SDK_BASE_URL).toString()
+
+    const response = await exodusFetch(url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ address, amount, allowedInterchangeNum, source }),
+    })
+
+    if (!response.ok) {
+      const body = await response.json().catch(() => null)
+      const serverMsg = body?.['Internal Server Error'] || response.statusText
+      console.warn(`simulate_unstake failed: ${serverMsg}`)
+      return null
+    }
+
+    const data = await response.json()
+    if (!data || typeof data.result !== 'number') {
+      console.warn('simulate_unstake: malformed response', data)
+      return null
+    }
+
+    return { instantReturnEth: data.result }
+  } catch (e) {
+    console.warn('simulate_unstake error:', e.message)
+    return null
+  }
+}
+
 export const getEverstakeValidatorsQueue = async () => {
   // https://swagger.eth-api-b2c.everstake.one/#/Staking/validatorsQueue
   const result = await fetch('v1/validators/queue')