@exodus/ethereum-api 8.47.1 → 8.49.0

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.49.0](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.48.0...@exodus/ethereum-api@8.49.0) (2025-09-16)
+
+
+### Features
+
+
+* feat: improve RPC error visibility (#6067)
+
+
+
+## [8.48.0](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.47.1...@exodus/ethereum-api@8.48.0) (2025-09-10)
+
+
+### Features
+
+
+* feat(ethereum): add displayAddess to asset.address (#6363)
+
+
+
 ## [8.47.1](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.47.0...@exodus/ethereum-api@8.47.1) (2025-09-08)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "8.47.1",
+  "version": "8.49.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",
@@ -34,6 +34,7 @@
     "@exodus/ethereumjs": "^1.0.0",
     "@exodus/fetch": "^1.3.0",
     "@exodus/models": "^12.13.0",
+    "@exodus/safe-string": "^1.2.0",
     "@exodus/simple-retry": "^0.0.6",
     "@exodus/solidity-contract": "^1.1.3",
     "@exodus/web3-ethereum-utils": "^4.2.1",
@@ -52,6 +53,7 @@
   "devDependencies": {
     "@exodus/assets-testing": "^1.0.0",
     "@exodus/bsc-meta": "^2.5.1",
+    "@exodus/errors": "^3.3.0",
     "@exodus/ethereumarbone-meta": "^2.1.2",
     "@exodus/fantommainnet-meta": "^2.0.5",
     "@exodus/matic-meta": "^2.2.7",
@@ -64,5 +66,5 @@
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
   },
-  "gitHead": "fbda86007124112138bfe661e1b25655e6107762"
+  "gitHead": "a3e06b6b731dd294513b514786db037f874ced76"
 }

package/src/create-asset.js

@@ -16,6 +16,7 @@ import {
   signUnsignedTxWithSigner,
   validateFactory,
 } from '@exodus/ethereum-lib'
+import { toChecksumAddress } from '@exodus/ethereumjs/util'
 import lodash from 'lodash'
 import assert from 'minimalistic-assert'
 
@@ -131,6 +132,7 @@ export const createAssetFactory = ({
       validate: validateFactory({ chainId, useEip1191ChainIdChecksum }),
       hasChecksum,
       isContract: server.isContract,
+      displayAddress: (addr) => toChecksumAddress(addr),
     }
 
     const bip44 = customBip44 || bip44Constants['ETH']

package/src/exodus-eth-server/api-coin-nodes.js

@@ -1,9 +1,11 @@
 import { bufferToHex } from '@exodus/ethereumjs/util'
+import { safeString } from '@exodus/safe-string'
 import SolidityContract from '@exodus/solidity-contract'
 import EventEmitter from 'events/events.js'
 import lodash from 'lodash'
 
 import { fromHexToString } from '../number-utils.js'
+import { errorMessageToSafeHint } from './errors.js'
 
 const { isEmpty } = lodash
 
@@ -52,8 +54,11 @@ export default class ApiCoinNodesServer extends EventEmitter {
     const result = response?.result
     const error = response?.error
     if (error || result === undefined) {
-      const message = error?.message || error?.code || 'no result'
-      throw new Error(`Bad rpc response: ${message}`)
+      const message = error?.message || error?.code || safeString`no result`
+
+      const revisedError = new Error(`Bad rpc response: ${message}`)
+      revisedError.hint = safeString`Bad rpc response: ${errorMessageToSafeHint(message)}`
+      throw revisedError
     }
 
     return result

package/src/exodus-eth-server/clarity-v2.js

@@ -66,9 +66,6 @@ const fetchHttpRequest = ({ baseApiPath, path, method, body }) => {
   return fetchJson(url, fetchOptions)
 }
 
-const fetchRpcHttpRequest = ({ baseApiPath, body }) =>
-  fetchHttpRequest({ baseApiPath, path: '/rpc', method: 'POST', body })
-
 async function fetchJsonRetry(url, fetchOptions) {
   const waitTimes = ['3s']
   const fetchWithRetry = retry(fetchJson, { delayTimesMs: waitTimes })
@@ -187,6 +184,9 @@ export default class ClarityServerV2 extends ClarityServer {
     }
   }
 
+  fetchRpcHttpRequest = ({ baseApiPath, body }) =>
+    fetchHttpRequest({ baseApiPath, path: '/rpc', method: 'POST', body })
+
   async sendRpcRequest(rpcRequest) {
     try {
       return await super.sendRpcRequest(rpcRequest)
@@ -196,20 +196,24 @@ export default class ClarityServerV2 extends ClarityServer {
       if (err.message !== RPC_REQUEST_TIMEOUT) throw err
 
       const { baseApiPath } = this
-      return fetchRpcHttpRequest({ baseApiPath, body: rpcRequest })
+      return this.fetchRpcHttpRequest({ baseApiPath, body: rpcRequest })
     }
   }
 
   async sendRawTransaction(...params) {
     const { baseApiPath } = this
     const request = this.sendRawTransactionRequest(...params)
-    return this.handleJsonRPCResponse(await fetchRpcHttpRequest({ baseApiPath, body: request }))
+    return this.handleJsonRPCResponse(
+      await this.fetchRpcHttpRequest({ baseApiPath, body: request })
+    )
   }
 
   async getTransactionCount(...params) {
     // nonce is called during tx send, use it in rest api
     const { baseApiPath } = this
     const request = this.getTransactionCountRequest(...params)
-    return this.handleJsonRPCResponse(await fetchRpcHttpRequest({ baseApiPath, body: request }))
+    return this.handleJsonRPCResponse(
+      await this.fetchRpcHttpRequest({ baseApiPath, body: request })
+    )
   }
 }

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

@@ -1,9 +1,11 @@
 import { bufferToHex } from '@exodus/ethereumjs/util'
+import { safeString } from '@exodus/safe-string'
 import SolidityContract from '@exodus/solidity-contract'
 import EventEmitter from 'events/events.js'
 import io from 'socket.io-client'
 
 import { fromHexToString } from '../number-utils.js'
+import { errorMessageToSafeHint } from './errors.js'
 
 export const RPC_REQUEST_TIMEOUT = 'RPC_REQUEST_TIMEOUT'
 
@@ -94,8 +96,11 @@ export default class ClarityServer extends EventEmitter {
     const result = response?.result
     const error = response?.error
     if (error || result === undefined) {
-      const message = error?.message || error?.code || 'no result'
-      throw new Error(`Bad rpc response: ${message}`)
+      const message = error?.message || error?.code || safeString`no result`
+
+      const revisedError = new Error(`Bad rpc response: ${message}`)
+      revisedError.hint = safeString`Bad rpc response: ${errorMessageToSafeHint(message)}`
+      throw revisedError
     }
 
     return result

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

@@ -0,0 +1,36 @@
+import { safeString } from '@exodus/safe-string'
+
+// Transplated from: https://github.com/ethereum/go-ethereum/blob/master/core/txpool/errors.go.
+const TxPoolErrors = {
+  ALREADY_KNOWN: safeString`already known`,
+  INVALID_SENDER: safeString`invalid sender`,
+  UNDERPRICED: safeString`transaction underpriced`,
+  REPLACE_UNDERPRICED: safeString`replacement transaction underpriced`,
+  TX_GAS_PRICE_TOO_LOW: safeString`transaction gas price below minimum`,
+  ACCOUNT_LIMIT_EXCEEDED: safeString`account limit exceeded`,
+  GAS_LIMIT: safeString`exceeds block gas limit`,
+  NEGATIVE_VALUE: safeString`negative value`,
+  OVERSIZED_DATA: safeString`oversized data`,
+  TX_BLOB_LIMIT_EXCEEDED: safeString`transaction blob limit exceeded`,
+  ALREADY_RESERVED: safeString`address already reserved`,
+  INFLIGHT_TX_LIMIT_REACHED: safeString`in-flight transaction limit reached for delegated accounts`,
+}
+
+const DYNAMIC_RPC_ERRORS = {
+  TRANSACTION_TYPE_NOT_SUPPORTED: safeString`transaction type not supported`,
+  ONLY_REPLAY_PROTECTED_TRANSACTIONS: safeString`only replay-protected (EIP-155) transactions allowed over RPC`,
+  TRANSACTION_GAS_PRICE_BELOW_MINIMUM: safeString`transaction gas price below minimum`,
+}
+
+export const KNOWN_RPC_ERRORS = { ...TxPoolErrors, ...DYNAMIC_RPC_ERRORS }
+
+export const tryMappingToRpcErrors = (errorMessage) => {
+  if (typeof errorMessage !== 'string') return
+
+  return Object.values(KNOWN_RPC_ERRORS)
+    .sort((a, b) => b.length - a.length)
+    .find((knownRpcError) => errorMessage.includes(knownRpcError))
+}
+
+export const errorMessageToSafeHint = (messageOrCode) =>
+  tryMappingToRpcErrors(messageOrCode) || messageOrCode