@exodus/ethereum-api 8.40.1 → 8.41.0-alpha.0

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.
 
+## [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)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/ethereum-api",
-  "version": "8.40.1",
+  "version": "8.41.0-alpha.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",
@@ -49,7 +49,7 @@
     "ws": "^6.1.0"
   },
   "devDependencies": {
-    "@exodus/assets-testing": "^1.0.0",
+    "@exodus/assets-testing": "workspace:^",
     "@exodus/bsc-meta": "^2.1.2",
     "@exodus/ethereumarbone-meta": "^2.0.3",
     "@exodus/fantommainnet-meta": "^2.0.2",
@@ -62,6 +62,5 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
-  },
-  "gitHead": "48a7c711842748ab188eb6bbbb575d1a13b8a6ab"
+  }
 }

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'
@@ -37,6 +37,7 @@ import getFeeAsyncFactory from './get-fee-async.js'
 import { estimateL1DataFeeFactory, getL1GetFeeFactory } from './optimism-gas/index.js'
 import { serverBasedFeeMonitorFactoryFactory } from './server-based-fee-monitor.js'
 import { createStakingApi } from './staking-api.js'
+import { createTxFactory } from './tx-create.js'
 import { txSendFactory } from './tx-send/index.js'
 import { createWeb3API } from './web3/index.js'
 
@@ -64,6 +65,7 @@ export const createAssetFactory = ({
   stakingConfiguration = {},
   useEip1191ChainIdChecksum = false,
   forceGasLimitEstimation = false,
+  rpcBalanceAssetNames = [],
   supportsCustomFees: defaultSupportsCustomFees = false,
   useAbsoluteBalanceAndNonce = false,
 }) => {
@@ -145,8 +147,8 @@ export const createAssetFactory = ({
 
     const getBalances = getBalancesFactory({
       monitorType,
-      config,
       useAbsoluteBalance: useAbsoluteBalanceAndNonce,
+      rpcBalanceAssetNames,
     })
 
     const { createToken, getTokens } = createTokenFactory(
@@ -170,11 +172,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 +187,6 @@ export const createAssetFactory = ({
       isTestnet,
       nfts,
       noHistory: monitorType === 'no-history',
-      transactionPrivacy: typeof broadcastPrivateTx === 'function',
       signWithSigner: true,
       signMessageWithSigner: true,
       supportsCustomFees,
@@ -214,16 +215,22 @@ export const createAssetFactory = ({
       monitorType,
       server,
       stakingAssetNames,
+      rpcBalanceAssetNames,
     })
 
     const defaultAddressPath = 'm/0/0'
 
     const createUnsignedTx = createUnsignedTxFactory({ chainId })
 
+    const createTx = createTxFactory({
+      chainId,
+      assetClientInterface,
+      useAbsoluteNonce: useAbsoluteBalanceAndNonce,
+    })
+
     const sendTx = txSendFactory({
       assetClientInterface,
-      createUnsignedTx,
-      useAbsoluteBalanceAndNonce,
+      createTx,
     })
 
     const estimateL1DataFee = l1GasOracleAddress
@@ -238,11 +245,12 @@ export const createAssetFactory = ({
 
     const api = {
       addressHasHistory,
-      broadcastTx,
+      broadcastTx: (...args) => server.sendRawTransaction(...args),
       createAccountState: () => accountStateClass,
       createFeeMonitor,
       createHistoryMonitor,
       createToken,
+      createTx,
       createUnsignedTx,
       customFees: createCustomFeesApi({ baseAsset: asset }),
       defaultAddressPath,
@@ -252,7 +260,7 @@ export const createAssetFactory = ({
       getBalanceForAddress: createGetBalanceForAddress({ asset, server }),
       getConfirmationsNumber: () => confirmationsNumber,
       getDefaultAddressPath: () => defaultAddressPath,
-      getFeeAsync: getFeeAsyncFactory({ assetClientInterface, gasLimit, createUnsignedTx }),
+      getFeeAsync: getFeeAsyncFactory({ assetClientInterface, gasLimit, createTx }),
       getFee,
       getFeeData: () => feeData,
       getKeyIdentifier: createGetKeyIdentifier({
@@ -289,8 +297,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

@@ -114,6 +114,7 @@ export async function fetchGasLimit({
   toAddress: providedToAddress,
   txInput: providedTxInput,
   amount: providedAmount,
+  contractAddress,
   bip70,
   throwOnError = true,
 }) {
@@ -146,7 +147,7 @@ export async function fetchGasLimit({
     toAddress: providedToAddress,
   })
 
-  const txToAddress = isToken ? asset.contract.address : toAddress
+  const txToAddress = contractAddress ?? (isToken ? asset.contract.address : toAddress)
   const txAmount = isToken ? asset.baseAsset.currency.ZERO : amount
 
   try {

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/get-fee-async.js

@@ -1,89 +1,21 @@
 import assert from 'minimalistic-assert'
 
-import { ARBITRARY_ADDRESS, fetchGasLimit, resolveDefaultTxInput } from './gas-estimation.js'
-import { getFeeFactory } from './get-fee.js'
-import { getNftArguments } from './nft-utils.js'
+import { getExtraFeeData } from './get-fee.js'
 
-const getFeeAsyncFactory = ({
-  assetClientInterface,
-  gasLimit: defaultGasLimit,
-  createUnsignedTx,
-}) => {
+const getFeeAsyncFactory = ({ assetClientInterface, createTx }) => {
   assert(assetClientInterface, 'assetClientInterface is required')
-  assert(createUnsignedTx, 'createUnsignedTx is required')
-  const getFee = getFeeFactory({ gasLimit: defaultGasLimit })
-  return async ({
-    nft,
-    asset,
-    // provided are values from the UI or other services, they could be undefined
-    fromAddress: providedFromAddress,
-    toAddress: providedToAddress,
-    amount: providedAmount,
-    txInput: providedTxInput,
-    gasLimit: providedGasLimit,
-    bip70,
-    customFee,
-    feeData,
-  }) => {
-    const fromAddress = providedFromAddress || ARBITRARY_ADDRESS // sending from a random address
-    const toAddress = providedToAddress || ARBITRARY_ADDRESS // sending to a random address,
-    const amount = providedAmount ?? asset.currency.ZERO
-    const resolveGasLimit = async () => {
-      if (nft) {
-        return getNftArguments({ asset, nft, fromAddress, toAddress })
-      }
-
-      const txInput = providedTxInput || resolveDefaultTxInput({ asset, toAddress, amount })
-      if (providedGasLimit) return { gasLimit: providedGasLimit, txInput }
-
-      const gasLimit = await fetchGasLimit({
-        asset,
-        fromAddress: providedFromAddress,
-        toAddress: providedToAddress,
-        txInput,
-        amount,
-        bip70,
-        feeData,
-      })
-      return { gasLimit, txInput }
-    }
-
-    const { txInput, gasLimit, contractAddress } = await resolveGasLimit()
-
-    const { fee, gasPrice, ...rest } = getFee({
-      asset,
-      feeData,
-      gasLimit,
-      amount,
-      customFee,
-    })
-
-    const optimismL1DataFee = asset.baseAsset.estimateL1DataFee
-      ? await asset.baseAsset.estimateL1DataFee({
-          unsignedTx: createUnsignedTx({
-            asset,
-            address: contractAddress || toAddress,
-            fromAddress,
-            amount,
-            nonce: 0,
-            txInput,
-            gasPrice,
-            gasLimit,
-          }),
-        })
-      : undefined
-
-    const l1DataFee = optimismL1DataFee
-      ? asset.baseAsset.currency.baseUnit(optimismL1DataFee)
-      : asset.baseAsset.currency.ZERO
-
+  assert(createTx, 'createTx is required')
+
+  return async (params) => {
+    const { asset } = params
+    const { unsignedTx } = params.unsignedTx ? params : await createTx(params)
+    const fee = asset.feeAsset.currency.parse(unsignedTx.txMeta.fee)
+    const coinAmount = asset.currency.parse(unsignedTx.txMeta.amount)
+    const extraFeeData = getExtraFeeData({ asset, amount: coinAmount })
     return {
-      fee: fee.add(l1DataFee),
-      // TODO: Should this be `l1DataFee`?
-      optimismL1DataFee,
-      gasLimit,
-      gasPrice,
-      ...rest,
+      fee,
+      extraFeeData,
+      unsignedTx,
     }
   }
 }

package/src/get-fee.js

@@ -11,7 +11,7 @@ const taxes = {
   paxgold: 0.0002,
 }
 
-const getExtraFeeData = ({ asset, amount }) => {
+export const getExtraFeeData = ({ asset, amount }) => {
   const tax = taxes[asset.name]
   if (!amount || !tax || amount.isZero) {
     return {}

package/src/index.js

@@ -81,9 +81,7 @@ export {
 
 export { reasons as errorReasons, withErrorReason, EthLikeError } from './error-wrapper.js'
 
-// TODO: `getFeeInfo` is not consumed by third parties and should
-//        be considered an internal API.
-export { txSendFactory, getFeeInfo } from './tx-send/index.js'
+export { txSendFactory } from './tx-send/index.js'
 
 export { createAssetFactory } from './create-asset.js'