@exodus/ethereum-api 8.40.0 → 8.41.0

package/CHANGELOG.md

@@ -3,6 +3,34 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.41.0](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.40.1...@exodus/ethereum-api@8.41.0) (2025-07-01)
+
+
+### Features
+
+
+* feat: transaction bundles and private server gas estimation (#5953)
+
+
+### Bug Fixes
+
+
+* fix: include l1 fee in tx log (#5986)
+
+* fix: remove unused gradientCoords from meta and validation (#5937)
+
+
+
+## [8.40.1](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.40.0...@exodus/ethereum-api@8.40.1) (2025-06-26)
+
+
+### Bug Fixes
+
+
+* fix: activate `currentTipGasPrice` for bumped transactions in `tx-send` (#5950)
+
+
+
 ## [8.40.0](https://github.com/ExodusMovement/assets/compare/@exodus/ethereum-api@8.39.0...@exodus/ethereum-api@8.40.0) (2025-06-26)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "8.40.0",
+  "version": "8.41.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",
@@ -28,7 +28,7 @@
     "@exodus/bip44-constants": "^195.0.0",
     "@exodus/crypto": "^1.0.0-rc.13",
     "@exodus/currency": "^6.0.1",
-    "@exodus/ethereum-lib": "^5.12.0",
+    "@exodus/ethereum-lib": "^5.15.1",
     "@exodus/ethereum-meta": "^2.5.0",
     "@exodus/ethereumholesky-meta": "^2.0.2",
     "@exodus/ethereumjs": "^1.0.0",
@@ -63,5 +63,5 @@
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
   },
-  "gitHead": "8c81c64076e7092e8a1a0d7c9a51f410a94aeec9"
+  "gitHead": "1077a752b60e0b25961613fd007596ab3368188e"
 }

package/src/create-asset-plugin-factory.js

@@ -99,12 +99,6 @@ export const fromAddEthereumChainParameterToFactoryParams = (params) => {
       decimals: params.nativeCurrency.decimals,
       primaryColor: color,
       gradientColors: [color, color],
-      gradientCoords: {
-        x1: '0%',
-        y1: '0%',
-        x2: '100%',
-        y2: '100%',
-      },
     },
     plugin: {
       serverUrl: params.rpcUrls?.[0],

package/src/create-asset-utils.js

@@ -59,14 +59,22 @@ export const resolveMonitorSettings = (
   return { ...defaultResolution, monitorType: overrideMonitorType, serverUrl: overrideServerUrl }
 }
 
-export const createBroadcastTxFactory = ({ assetName, server, privacyRpcUrl }) => {
-  assert(server, 'expected server')
-
-  const defaultResult = {
-    broadcastTx: (...args) => server.sendRawTransaction(...args),
+const broadcastPrivateBundleFactory =
+  ({ privacyServer }) =>
+  async ({ txs }) => {
+    assert(Array.isArray(txs), 'txs must be an array')
+    if (txs.length === 0) return
+
+    await privacyServer.sendRequest(
+      privacyServer.buildRequest({
+        method: 'eth_sendBundle',
+        params: [{ txs }],
+      })
+    )
   }
 
-  if (!privacyRpcUrl) return defaultResult
+export const createTransactionPrivacyFactory = ({ assetName, privacyRpcUrl }) => {
+  if (!privacyRpcUrl) return Object.create(null)
 
   const privacyServer = createEvmServer({
     assetName,
@@ -75,8 +83,9 @@ export const createBroadcastTxFactory = ({ assetName, server, privacyRpcUrl }) =
   })
 
   return {
-    ...defaultResult,
+    broadcastPrivateBundle: broadcastPrivateBundleFactory({ privacyServer }),
     broadcastPrivateTx: (...args) => privacyServer.sendRawTransaction(...args),
+    privacyServer,
   }
 }
 
@@ -87,6 +96,7 @@ export const createHistoryMonitorFactory = ({
   monitorType,
   server,
   stakingAssetNames,
+  rpcBalanceAssetNames,
 }) => {
   assert(assetName, 'expected assetName')
   assert(assetClientInterface, 'expected assetClientInterface')
@@ -103,6 +113,7 @@ export const createHistoryMonitorFactory = ({
           assetClientInterface,
           interval: ms(monitorInterval || '5m'),
           server,
+          rpcBalanceAssetNames,
           ...args,
         })
         break
@@ -119,6 +130,7 @@ export const createHistoryMonitorFactory = ({
           assetClientInterface,
           interval: ms(monitorInterval || '15s'),
           server,
+          rpcBalanceAssetNames,
           ...args,
         })
         break

package/src/create-asset.js

@@ -22,8 +22,8 @@ import assert from 'minimalistic-assert'
 
 import { addressHasHistoryFactory } from './address-has-history.js'
 import {
-  createBroadcastTxFactory,
   createHistoryMonitorFactory,
+  createTransactionPrivacyFactory,
   resolveMonitorSettings,
 } from './create-asset-utils.js'
 import { createTokenFactory } from './create-token-factory.js'
@@ -64,6 +64,7 @@ export const createAssetFactory = ({
   stakingConfiguration = {},
   useEip1191ChainIdChecksum = false,
   forceGasLimitEstimation = false,
+  rpcBalanceAssetNames = [],
   supportsCustomFees: defaultSupportsCustomFees = false,
   useAbsoluteBalanceAndNonce = false,
 }) => {
@@ -145,8 +146,8 @@ export const createAssetFactory = ({
 
     const getBalances = getBalancesFactory({
       monitorType,
-      config,
       useAbsoluteBalance: useAbsoluteBalanceAndNonce,
+      rpcBalanceAssetNames,
     })
 
     const { createToken, getTokens } = createTokenFactory(
@@ -170,11 +171,11 @@ export const createAssetFactory = ({
       server,
     })
 
-    const { broadcastTx, broadcastPrivateTx } = createBroadcastTxFactory({
-      assetName: asset.name,
-      server,
-      privacyRpcUrl,
-    })
+    const { broadcastPrivateBundle, broadcastPrivateTx, privacyServer } =
+      createTransactionPrivacyFactory({
+        assetName: asset.name,
+        privacyRpcUrl,
+      })
 
     const features = {
       accountState: true,
@@ -185,7 +186,6 @@ export const createAssetFactory = ({
       isTestnet,
       nfts,
       noHistory: monitorType === 'no-history',
-      transactionPrivacy: typeof broadcastPrivateTx === 'function',
       signWithSigner: true,
       signMessageWithSigner: true,
       supportsCustomFees,
@@ -214,6 +214,7 @@ export const createAssetFactory = ({
       monitorType,
       server,
       stakingAssetNames,
+      rpcBalanceAssetNames,
     })
 
     const defaultAddressPath = 'm/0/0'
@@ -238,7 +239,7 @@ export const createAssetFactory = ({
 
     const api = {
       addressHasHistory,
-      broadcastTx,
+      broadcastTx: (...args) => server.sendRawTransaction(...args),
       createAccountState: () => accountStateClass,
       createFeeMonitor,
       createHistoryMonitor,
@@ -289,8 +290,10 @@ export const createAssetFactory = ({
       chainId,
       monitorType,
       estimateL1DataFee,
+      broadcastPrivateBundle,
       broadcastPrivateTx,
       forceGasLimitEstimation,
+      privacyServer,
       server,
       ...(erc20FuelBuffer && { erc20FuelBuffer }),
       ...(fuelThreshold && { fuelThreshold: asset.currency.defaultUnit(fuelThreshold) }),

package/src/gas-estimation.js

@@ -50,14 +50,14 @@ export const scaleGasLimitEstimate = ({
 // be calculated with account's balance divided by gasPrice. If user's balance is too low,
 // the gasEstimation will fail. If gasPrice is set to '0x0', the account's balance is not
 // used to estimate gas.
-export async function estimateGasLimit(
+export async function estimateGasLimit({
   asset,
   fromAddress,
   toAddress,
-  amount,
+  amount = asset.currency.ZERO,
   data,
-  gasPrice = '0x'
-) {
+  gasPrice = '0x',
+}) {
   const opts = {
     from: fromAddress,
     to: toAddress,
@@ -150,13 +150,13 @@ export async function fetchGasLimit({
   const txAmount = isToken ? asset.baseAsset.currency.ZERO : amount
 
   try {
-    const estimatedGasLimit = await estimateGasLimit(
+    const estimatedGasLimit = await estimateGasLimit({
       asset,
       fromAddress,
-      txToAddress,
-      txAmount,
-      txInput
-    )
+      toAddress: txToAddress,
+      amount: txAmount,
+      data: txInput,
+    })
 
     return scaleGasLimitEstimate({ estimatedGasLimit, gasLimitMultiplier })
   } catch (err) {

package/src/get-balances.js

@@ -4,7 +4,6 @@ import {
   getUnconfirmedReceivedBalance,
   getUnconfirmedSentBalance,
 } from '@exodus/asset-lib'
-import { isRpcBalanceAsset } from '@exodus/ethereum-lib'
 import assert from 'minimalistic-assert'
 
 export const getAbsoluteBalance = ({ asset, txLog }) => {
@@ -113,13 +112,7 @@ const getSpendable = ({ asset, balance, txLog, unconfirmedReceived }) => {
  * @param accountState the account state when the balance is loaded from RPC
  * @returns {{balance}|null} an object with the balance or null if the balance is unknown
  */
-export const getBalancesFactory = ({
-  monitorType,
-  config = Object.create(null),
-  useAbsoluteBalance,
-}) => {
-  const { useAccountStateBalanceOnly } = config
-
+export const getBalancesFactory = ({ monitorType, useAbsoluteBalance, rpcBalanceAssetNames }) => {
   assert(monitorType, 'monitorType is required')
   return ({ asset, txLog, accountState }) => {
     const unconfirmedReceived = getUnconfirmedReceivedBalance({ asset, txLog })
@@ -139,7 +132,7 @@ export const getBalancesFactory = ({
     let spendable
 
     // Balance from accountState is considered total b/c is fetched from rpc
-    if (useAccountStateBalanceOnly || isRpcBalanceAsset(asset) || monitorType === 'no-history') {
+    if (rpcBalanceAssetNames.includes(asset.name) || monitorType === 'no-history') {
       total = getBalanceFromAccountState({ asset, accountState }).sub(unconfirmedSent)
       spendable = total.sub(staked).sub(staking).sub(unstaking).sub(unstaked)
     } else {

package/src/staking/ethereum/service.js

@@ -359,14 +359,14 @@ export function createEthereumStakingService({
     amount = amount || asset.currency.ZERO
     from = from.toLowerCase()
 
-    const estimatedGasLimit = await estimateGasLimit(
+    const estimatedGasLimit = await estimateGasLimit({
       asset,
-      from,
-      to.toLowerCase(),
+      fromAddress: from,
+      toAddress: to.toLowerCase(),
       amount, // staking contracts does not always require ETH amount to interact with
-      txInput,
-      DISABLE_BALANCE_CHECKS
-    )
+      data: txInput,
+      gasPrice: DISABLE_BALANCE_CHECKS,
+    })
 
     const scaledGasLimit = scaleGasLimitEstimate({ estimatedGasLimit })
 

package/src/staking/matic/service.js

@@ -337,14 +337,14 @@ export function createPolygonStakingService({
 
     const amount = ethereum.currency.ZERO
 
-    const gasLimit = await estimateGasLimit(
-      ethereum,
-      from,
-      to,
+    const gasLimit = await estimateGasLimit({
+      asset: ethereum,
+      fromAddress: from,
+      toAddress: to,
       amount, // staking contracts does not require ETH amount to interact with
-      txInput,
-      DISABLE_BALANCE_CHECKS
-    )
+      data: txInput,
+      gasPrice: DISABLE_BALANCE_CHECKS,
+    })
 
     return ethereum.api.getFee({ asset: ethereum, feeData, gasLimit, amount })
   }

package/src/tx-log/clarity-monitor.js

@@ -1,5 +1,5 @@
 import { BaseMonitor } from '@exodus/asset-lib'
-import { getAssetAddresses, isRpcBalanceAsset } from '@exodus/ethereum-lib'
+import { getAssetAddresses } from '@exodus/ethereum-lib'
 import lodash from 'lodash'
 
 import { executeEthLikeFeeMonitorUpdate } from '../fee-utils.js'
@@ -16,10 +16,11 @@ import {
 const { isEmpty } = lodash
 
 export class ClarityMonitor extends BaseMonitor {
-  constructor({ server, config, ...args }) {
+  constructor({ server, config, rpcBalanceAssetNames, ...args }) {
     super(args)
     this.config = { GAS_PRICE_FROM_WEBSOCKET: true, ...config }
     this.server = server
+    this.rpcBalanceAssetNames = rpcBalanceAssetNames
     this.getAllLogItemsByAsset = getAllLogItemsByAsset
     this.deriveDataNeededForTick = getDeriveDataNeededForTick(this.aci)
     this.deriveTransactionsToCheck = getDeriveTransactionsToCheck({
@@ -201,7 +202,7 @@ export class ClarityMonitor extends BaseMonitor {
     const asset = this.asset
     const newAccountState = Object.create(null)
     const balances = await this.getBalances({ tokens, ourWalletAddress })
-    if (isRpcBalanceAsset(asset)) {
+    if (this.rpcBalanceAssetNames.includes(asset.name)) {
       const balance = balances[asset.name]
       newAccountState.balance = asset.currency.baseUnit(balance)
     }
@@ -244,13 +245,13 @@ export class ClarityMonitor extends BaseMonitor {
 
   async getBalances({ tokens, ourWalletAddress }) {
     const batch = Object.create(null)
-    if (isRpcBalanceAsset(this.asset)) {
+    if (this.rpcBalanceAssetNames.includes(this.asset.name)) {
       const request = this.server.getBalanceRequest(ourWalletAddress)
       batch[this.asset.name] = request
     }
 
     for (const token of tokens) {
-      if (isRpcBalanceAsset(token) && token.contract.address) {
+      if (this.rpcBalanceAssetNames.includes(token.name) && token.contract.address) {
         const request = this.server.balanceOfRequest(ourWalletAddress, token.contract.address)
         batch[token.name] = request
       }

package/src/tx-log/ethereum-monitor.js

@@ -1,5 +1,5 @@
 import { BaseMonitor } from '@exodus/asset-lib'
-import { getAssetAddresses, isRpcBalanceAsset } from '@exodus/ethereum-lib'
+import { getAssetAddresses } from '@exodus/ethereum-lib'
 import lodash from 'lodash'
 
 import { executeEthLikeFeeMonitorUpdate } from '../fee-utils.js'
@@ -25,7 +25,7 @@ const { isEmpty } = lodash
 // formatting, and populating-to-state all ETH/ETC/ERC20 transactions.
 
 export class EthereumMonitor extends BaseMonitor {
-  constructor({ server, config, webSocketEnabled = true, ...args }) {
+  constructor({ server, config, rpcBalanceAssetNames, webSocketEnabled = true, ...args }) {
     super(args)
     this.server = server
     this.config = { GAS_PRICE_FROM_WEBSOCKET: true, ...config }
@@ -38,6 +38,7 @@ export class EthereumMonitor extends BaseMonitor {
     this.addHook('after-stop', (...args) => this.afterStop(...args))
     this.subscribedToGasPriceMap = new Map()
     this._webSocketEnabled = webSocketEnabled
+    this.rpcBalanceAssetNames = rpcBalanceAssetNames
   }
 
   setServer(config = {}) {
@@ -215,7 +216,7 @@ export class EthereumMonitor extends BaseMonitor {
     const asset = this.asset
     const newAccountState = Object.create(null)
     const server = this.server
-    if (isRpcBalanceAsset(asset)) {
+    if (this.rpcBalanceAssetNames.includes(asset.name)) {
       const result = await server.getBalanceProxied(ourWalletAddress)
       const balance = fromHexToString(result)
       newAccountState.balance = asset.currency.baseUnit(balance)
@@ -223,7 +224,7 @@ export class EthereumMonitor extends BaseMonitor {
 
     const tokenBalancePairs = await Promise.all(
       tokens
-        .filter((token) => isRpcBalanceAsset(token) && token.contract.address)
+        .filter((token) => this.rpcBalanceAssetNames.includes(token.name) && token.contract.address)
         .map(async (token) => {
           const { confirmed } = await server.balanceOf(ourWalletAddress, token.contract.address)
           const value = token.currency.baseUnit(confirmed[token.contract.address] || 0)

package/src/tx-log/monitor-utils/get-fee-amount.js

@@ -7,5 +7,8 @@ export default function getFeeAmount(asset, serverTx) {
   // genesis, coinbase, uncles
   if (!gasPrice) return asset.currency.ZERO
 
-  return asset.currency.baseUnit(gasUsed || gasLimit).mul(gasPrice)
+  return asset.currency
+    .baseUnit(gasUsed || gasLimit)
+    .mul(gasPrice)
+    .add(asset.currency.baseUnit(serverTx.extraData?.l1Fee || 0))
 }

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

@@ -158,12 +158,17 @@ const txSendFactory = ({ assetClientInterface, createUnsignedTx, useAbsoluteBala
       amount = (replacedTokenTx || replacedTx).coinAmount.negate()
       feeOpts.gasLimit = replacedTx.data.gasLimit
 
-      const { gasPrice: currentGasPrice, baseFeePerGas: currentBaseFee } = feeData
+      const {
+        gasPrice: currentGasPrice,
+        baseFeePerGas: currentBaseFee,
+        tipGasPrice: currentTipGasPrice,
+      } = feeData
       const { bumpedGasPrice, bumpedTipGasPrice } = calculateBumpedGasPrice({
         baseAsset,
         tx: replacedTx,
         currentGasPrice,
         currentBaseFee,
+        currentTipGasPrice,
         eip1559Enabled,
       })
       feeOpts.gasPrice = bumpedGasPrice
@@ -231,9 +236,9 @@ const txSendFactory = ({ assetClientInterface, createUnsignedTx, useAbsoluteBala
 
     let { txId, rawTx, nonce, gasLimit, tipGasPrice, feeAmount } = await createTx(createTxParams)
 
-    if (isPrivate && !baseAsset.api.features.transactionPrivacy)
+    if (isPrivate && typeof baseAsset.broadcastPrivateTx !== 'function')
       throw new Error(
-        `unable to send private transaction - transactionPrivacy is not enabled for ${baseAsset.name}`
+        `unable to send private transaction - private mempools are not enabled for ${baseAsset.name}`
       )
 
     const broadcastTx = isPrivate ? baseAsset.broadcastPrivateTx : baseAsset.api.broadcastTx