viem 2.0.0-alpha.8 → 2.0.0-beta.0

package/actions/public/createPendingTransactionFilter.ts

@@ -1,11 +1,17 @@
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../errors/utils.js'
 import type { Chain } from '../../types/chain.js'
 import type { Filter } from '../../types/filter.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
 import { createFilterRequestScope } from '../../utils/filters/createFilterRequestScope.js'
 
 export type CreatePendingTransactionFilterReturnType = Filter<'transaction'>
 
+export type CreatePendingTransactionFilterErrorType =
+  | RequestErrorType
+  | ErrorType
+
 /**
  * Creates a Filter to listen for new pending transaction hashes that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html).
  *

package/actions/public/estimateContractGas.ts

@@ -1,7 +1,10 @@
 import type { Abi } from 'abitype'
 
 import type { Account } from '../../accounts/types.js'
-import { parseAccount } from '../../accounts/utils/parseAccount.js'
+import {
+  type ParseAccountErrorType,
+  parseAccount,
+} from '../../accounts/utils/parseAccount.js'
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
 import type { BaseError } from '../../errors/base.js'
@@ -13,9 +16,21 @@ import type {
   GetValue,
 } from '../../types/contract.js'
 import type { UnionOmit } from '../../types/utils.js'
-import { encodeFunctionData } from '../../utils/abi/encodeFunctionData.js'
-import { getContractError } from '../../utils/errors/getContractError.js'
-import { type EstimateGasParameters, estimateGas } from './estimateGas.js'
+import {
+  type EncodeFunctionDataErrorType,
+  type EncodeFunctionDataParameters,
+  encodeFunctionData,
+} from '../../utils/abi/encodeFunctionData.js'
+import {
+  type GetContractErrorReturnType,
+  getContractError,
+} from '../../utils/errors/getContractError.js'
+import { getAction } from '../../utils/getAction.js'
+import {
+  type EstimateGasErrorType,
+  type EstimateGasParameters,
+  estimateGas,
+} from './estimateGas.js'
 
 export type EstimateContractGasParameters<
   abi extends Abi | readonly unknown[] = Abi,
@@ -47,6 +62,10 @@ export type EstimateContractGasParameters<
 
 export type EstimateContractGasReturnType = bigint
 
+export type EstimateContractGasErrorType = GetContractErrorReturnType<
+  EncodeFunctionDataErrorType | EstimateGasErrorType | ParseAccountErrorType
+>
+
 /**
  * Estimates the gas required to successfully execute a contract write function call.
  *
@@ -92,9 +111,20 @@ export async function estimateContractGas<
 ): Promise<EstimateContractGasReturnType> {
   const { abi, address, args, functionName, ...request } =
     parameters as EstimateContractGasParameters
-  const data = encodeFunctionData({ abi, args, functionName })
+  const data = encodeFunctionData({
+    abi,
+    args,
+    functionName,
+  } as EncodeFunctionDataParameters)
   try {
-    const gas = await estimateGas(client, { data, to: address, ...request })
+    const gas = await getAction(
+      client,
+      estimateGas,
+    )({
+      data,
+      to: address,
+      ...request,
+    } as unknown as EstimateGasParameters)
     return gas
   } catch (error) {
     const account = request.account ? parseAccount(request.account) : undefined

package/actions/public/estimateFeesPerGas.ts

@@ -2,8 +2,11 @@ import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
 import {
   BaseFeeScalarError,
+  type BaseFeeScalarErrorType,
   Eip1559FeesNotSupportedError,
+  type Eip1559FeesNotSupportedErrorType,
 } from '../../errors/fee.js'
+import type { ErrorType } from '../../errors/utils.js'
 import type { Block } from '../../types/block.js'
 import type {
   Chain,
@@ -16,10 +19,14 @@ import type {
   FeeValuesLegacy,
   FeeValuesType,
 } from '../../types/fee.js'
+import { getAction } from '../../utils/getAction.js'
 import type { PrepareTransactionRequestParameters } from '../wallet/prepareTransactionRequest.js'
-import { internal_estimateMaxPriorityFeePerGas } from './estimateMaxPriorityFeePerGas.js'
+import {
+  type EstimateMaxPriorityFeePerGasErrorType,
+  internal_estimateMaxPriorityFeePerGas,
+} from './estimateMaxPriorityFeePerGas.js'
 import { getBlock } from './getBlock.js'
-import { getGasPrice } from './getGasPrice.js'
+import { type GetGasPriceErrorType, getGasPrice } from './getGasPrice.js'
 
 export type EstimateFeesPerGasParameters<
   chain extends Chain | undefined = Chain | undefined,
@@ -43,6 +50,13 @@ export type EstimateFeesPerGasReturnType<
   | (type extends 'legacy' ? FeeValuesLegacy : never)
   | (type extends 'eip1559' ? FeeValuesEIP1559 : never)
 
+export type EstimateFeesPerGasErrorType =
+  | BaseFeeScalarErrorType
+  | EstimateMaxPriorityFeePerGasErrorType
+  | GetGasPriceErrorType
+  | Eip1559FeesNotSupportedErrorType
+  | ErrorType
+
 /**
  * Returns an estimate for the fees per gas (in wei) for a
  * transaction to be likely included in the next block.
@@ -112,7 +126,7 @@ export async function internal_estimateFeesPerGas<
     (base * BigInt(Math.ceil(baseFeeMultiplier * denominator))) /
     BigInt(denominator)
 
-  const block = block_ ? block_ : await getBlock(client)
+  const block = block_ ? block_ : await getAction(client, getBlock)({})
 
   if (typeof chain?.fees?.estimateFeesPerGas === 'function')
     return chain.fees.estimateFeesPerGas({
@@ -148,7 +162,8 @@ export async function internal_estimateFeesPerGas<
     } as EstimateFeesPerGasReturnType<type>
   }
 
-  const gasPrice = request?.gasPrice ?? multiply(await getGasPrice(client))
+  const gasPrice =
+    request?.gasPrice ?? multiply(await getAction(client, getGasPrice)({}))
   return {
     gasPrice,
   } as EstimateFeesPerGasReturnType<type>

package/actions/public/estimateGas.ts

@@ -1,5 +1,8 @@
 import type { Account } from '../../accounts/types.js'
-import { parseAccount } from '../../accounts/utils/parseAccount.js'
+import {
+  type ParseAccountErrorType,
+  parseAccount,
+} from '../../accounts/utils/parseAccount.js'
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
 import { AccountNotFoundError } from '../../errors/account.js'
@@ -9,14 +12,22 @@ import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
 import type { TransactionRequest } from '../../types/transaction.js'
 import type { UnionOmit } from '../../types/utils.js'
-import { numberToHex } from '../../utils/encoding/toHex.js'
-import { getEstimateGasError } from '../../utils/errors/getEstimateGasError.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import {
+  type NumberToHexErrorType,
+  numberToHex,
+} from '../../utils/encoding/toHex.js'
+import {
+  type GetEstimateGasErrorReturnType,
+  getEstimateGasError,
+} from '../../utils/errors/getEstimateGasError.js'
 import { extract } from '../../utils/formatters/extract.js'
 import {
   type FormattedTransactionRequest,
   formatTransactionRequest,
 } from '../../utils/formatters/transactionRequest.js'
 import {
+  type AssertRequestErrorType,
   type AssertRequestParameters,
   assertRequest,
 } from '../../utils/transaction/assertRequest.js'
@@ -52,6 +63,13 @@ export type EstimateGasParameters<
 
 export type EstimateGasReturnType = bigint
 
+export type EstimateGasErrorType = GetEstimateGasErrorReturnType<
+  | ParseAccountErrorType
+  | NumberToHexErrorType
+  | RequestErrorType
+  | AssertRequestErrorType
+>
+
 /**
  * Estimates the gas necessary to complete a transaction without submitting it to the network.
  *
@@ -118,12 +136,12 @@ export async function estimateGas<
 
     assertRequest(args as AssertRequestParameters)
 
-    const format =
-      client.chain?.formatters?.transactionRequest?.format ||
-      formatTransactionRequest
+    const chainFormat = client.chain?.formatters?.transactionRequest?.format
+    const format = chainFormat || formatTransactionRequest
+
     const request = format({
       // Pick out extra data that might exist on the chain's transaction request type.
-      ...extract(rest, { format }),
+      ...extract(rest, { format: chainFormat }),
       from: account.address,
       accessList,
       data,

package/actions/public/estimateMaxPriorityFeePerGas.ts

@@ -1,21 +1,40 @@
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
-import { Eip1559FeesNotSupportedError } from '../../errors/fee.js'
+import {
+  Eip1559FeesNotSupportedError,
+  type Eip1559FeesNotSupportedErrorType,
+} from '../../errors/fee.js'
+import type { ErrorType } from '../../errors/utils.js'
 import type { Account } from '../../types/account.js'
 import type { Block } from '../../types/block.js'
 import type { Chain, ChainFeesFnParameters } from '../../types/chain.js'
 import type { GetChain } from '../../types/chain.js'
-import { hexToBigInt } from '../../utils/encoding/fromHex.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import {
+  type HexToBigIntErrorType,
+  hexToBigInt,
+} from '../../utils/encoding/fromHex.js'
+import { getAction } from '../../utils/getAction.js'
 import type { PrepareTransactionRequestParameters } from '../wallet/prepareTransactionRequest.js'
-import { getBlock } from './getBlock.js'
-import { getGasPrice } from './getGasPrice.js'
+import { type GetBlockErrorType, getBlock } from './getBlock.js'
+import { type GetGasPriceErrorType, getGasPrice } from './getGasPrice.js'
 
 export type EstimateMaxPriorityFeePerGasParameters<
   chain extends Chain | undefined = Chain | undefined,
   chainOverride extends Chain | undefined = Chain | undefined,
 > = GetChain<chain, chainOverride>
+
 export type EstimateMaxPriorityFeePerGasReturnType = bigint
 
+export type EstimateMaxPriorityFeePerGasErrorType =
+  | GetBlockErrorType
+  | HexToBigIntErrorType
+  | RequestErrorType
+  | GetBlockErrorType
+  | GetGasPriceErrorType
+  | Eip1559FeesNotSupportedErrorType
+  | ErrorType
+
 /**
  * Returns an estimate for the max priority fee per gas (in wei) for a
  * transaction to be likely included in the next block.
@@ -64,13 +83,13 @@ export async function internal_estimateMaxPriorityFeePerGas<
 ): Promise<EstimateMaxPriorityFeePerGasReturnType> {
   const { block: block_, chain = client.chain, request } = args || {}
   if (typeof chain?.fees?.defaultPriorityFee === 'function') {
-    const block = block_ || (await getBlock(client))
+    const block = block_ || (await getAction(client, getBlock)({}))
     return chain.fees.defaultPriorityFee({
       block,
       client,
       request,
     } as ChainFeesFnParameters)
-  } else if (chain?.fees?.defaultPriorityFee)
+  } else if (typeof chain?.fees?.defaultPriorityFee !== 'undefined')
     return chain?.fees?.defaultPriorityFee
 
   try {
@@ -83,8 +102,8 @@ export async function internal_estimateMaxPriorityFeePerGas<
     // fall back to calculating it manually via `gasPrice - baseFeePerGas`.
     // See: https://github.com/ethereum/pm/issues/328#:~:text=eth_maxPriorityFeePerGas%20after%20London%20will%20effectively%20return%20eth_gasPrice%20%2D%20baseFee
     const [block, gasPrice] = await Promise.all([
-      block_ ? Promise.resolve(block_) : getBlock(client),
-      getGasPrice(client),
+      block_ ? Promise.resolve(block_) : getAction(client, getBlock)({}),
+      getAction(client, getGasPrice)({}),
     ])
 
     if (typeof block.baseFeePerGas !== 'bigint')

package/actions/public/getBalance.ts

@@ -2,9 +2,14 @@ import type { Address } from 'abitype'
 
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../errors/utils.js'
 import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
-import { numberToHex } from '../../utils/encoding/toHex.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import {
+  type NumberToHexErrorType,
+  numberToHex,
+} from '../../utils/encoding/toHex.js'
 
 export type GetBalanceParameters = {
   /** The address of the account. */
@@ -24,6 +29,11 @@ export type GetBalanceParameters = {
 
 export type GetBalanceReturnType = bigint
 
+export type GetBalanceErrorType =
+  | NumberToHexErrorType
+  | RequestErrorType
+  | ErrorType
+
 /**
  * Returns the balance of an address in wei.
  *

package/actions/public/getBlock.ts

@@ -1,12 +1,20 @@
 import type { Account } from '../../accounts/types.js'
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
-import { BlockNotFoundError } from '../../errors/block.js'
+import {
+  BlockNotFoundError,
+  type BlockNotFoundErrorType,
+} from '../../errors/block.js'
+import type { ErrorType } from '../../errors/utils.js'
 import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
 import type { Hash } from '../../types/misc.js'
 import type { RpcBlock } from '../../types/rpc.js'
-import { numberToHex } from '../../utils/encoding/toHex.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import {
+  type NumberToHexErrorType,
+  numberToHex,
+} from '../../utils/encoding/toHex.js'
 import {
   type FormattedBlock,
   formatBlock,
@@ -48,6 +56,12 @@ export type GetBlockReturnType<
   TBlockTag extends BlockTag = 'latest',
 > = FormattedBlock<TChain, TIncludeTransactions, TBlockTag>
 
+export type GetBlockErrorType =
+  | BlockNotFoundErrorType
+  | NumberToHexErrorType
+  | RequestErrorType
+  | ErrorType
+
 /**
  * Returns information about a block at a block number, hash, or tag.
  *

package/actions/public/getBlockNumber.ts

@@ -1,6 +1,8 @@
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../errors/utils.js'
 import type { Chain } from '../../types/chain.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
 import { getCache, withCache } from '../../utils/promise/withCache.js'
 
 export type GetBlockNumberParameters = {
@@ -12,6 +14,8 @@ export type GetBlockNumberParameters = {
 
 export type GetBlockNumberReturnType = bigint
 
+export type GetBlockNumberErrorType = RequestErrorType | ErrorType
+
 const cacheKey = (id: string) => `blockNumber.${id}`
 
 export function getBlockNumberCache(id: string) {

package/actions/public/getBlockTransactionCount.ts

@@ -1,11 +1,19 @@
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../errors/utils.js'
 import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
 import type { Hash } from '../../types/misc.js'
 import type { Quantity } from '../../types/rpc.js'
-import { hexToNumber } from '../../utils/encoding/fromHex.js'
-import { numberToHex } from '../../utils/encoding/toHex.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import {
+  type HexToNumberErrorType,
+  hexToNumber,
+} from '../../utils/encoding/fromHex.js'
+import {
+  type NumberToHexErrorType,
+  numberToHex,
+} from '../../utils/encoding/toHex.js'
 
 export type GetBlockTransactionCountParameters =
   | {
@@ -29,6 +37,12 @@ export type GetBlockTransactionCountParameters =
 
 export type GetBlockTransactionCountReturnType = number
 
+export type GetBlockTransactionCountErrorType =
+  | NumberToHexErrorType
+  | HexToNumberErrorType
+  | RequestErrorType
+  | ErrorType
+
 /**
  * Returns the number of Transactions at a block number, hash, or tag.
  *

package/actions/public/getBytecode.ts

@@ -2,10 +2,15 @@ import type { Address } from 'abitype'
 
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../errors/utils.js'
 import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
 import type { Hex } from '../../types/misc.js'
-import { numberToHex } from '../../utils/encoding/toHex.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import {
+  type NumberToHexErrorType,
+  numberToHex,
+} from '../../utils/encoding/toHex.js'
 
 export type GetBytecodeParameters = {
   address: Address
@@ -22,6 +27,11 @@ export type GetBytecodeParameters = {
 
 export type GetBytecodeReturnType = Hex | undefined
 
+export type GetBytecodeErrorType =
+  | NumberToHexErrorType
+  | RequestErrorType
+  | ErrorType
+
 /**
  * Retrieves the bytecode at an address.
  *

package/actions/public/getChainId.ts

@@ -1,11 +1,21 @@
 import type { Account } from '../../accounts/types.js'
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../errors/utils.js'
 import type { Chain } from '../../types/chain.js'
-import { hexToNumber } from '../../utils/encoding/fromHex.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import {
+  type HexToNumberErrorType,
+  hexToNumber,
+} from '../../utils/encoding/fromHex.js'
 
 export type GetChainIdReturnType = number
 
+export type GetChainIdErrorType =
+  | HexToNumberErrorType
+  | RequestErrorType
+  | ErrorType
+
 /**
  * Returns the chain ID associated with the current network.
  *

package/actions/public/getContractEvents.ts

@@ -0,0 +1,169 @@
+import type { Abi, Address } from 'abitype'
+
+import type { Client } from '../../clients/createClient.js'
+import type { Transport } from '../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../errors/utils.js'
+import type { BlockNumber, BlockTag } from '../../types/block.js'
+import type { Chain } from '../../types/chain.js'
+import type {
+  ContractEventArgs,
+  ContractEventName,
+} from '../../types/contract.js'
+import type { Log } from '../../types/log.js'
+import type { Hash } from '../../types/misc.js'
+import {
+  type GetAbiItemErrorType,
+  type GetAbiItemParameters,
+  getAbiItem,
+} from '../../utils/abi/getAbiItem.js'
+import { getAction } from '../../utils/getAction.js'
+import {
+  type GetLogsErrorType,
+  type GetLogsParameters,
+  getLogs,
+} from './getLogs.js'
+
+export type GetContractEventsParameters<
+  abi extends Abi | readonly unknown[] = Abi,
+  eventName extends ContractEventName<abi> | undefined =
+    | ContractEventName<abi>
+    | undefined,
+  strict extends boolean | undefined = undefined,
+  fromBlock extends BlockNumber | BlockTag | undefined = undefined,
+  toBlock extends BlockNumber | BlockTag | undefined = undefined,
+> = {
+  /** The address of the contract. */
+  address?: Address | Address[]
+  /** Contract ABI. */
+  abi: abi
+  args?:
+    | ContractEventArgs<
+        abi,
+        eventName extends ContractEventName<abi>
+          ? eventName
+          : ContractEventName<abi>
+      >
+    | undefined
+  /** Contract event. */
+  eventName?: eventName | ContractEventName<abi> | undefined
+  /**
+   * Whether or not the logs must match the indexed/non-indexed arguments on `event`.
+   * @default false
+   */
+  strict?: strict | boolean | undefined
+} & (
+  | {
+      /** Block number or tag after which to include logs */
+      fromBlock?: fromBlock | BlockNumber | BlockTag
+      /** Block number or tag before which to include logs */
+      toBlock?: toBlock | BlockNumber | BlockTag
+      blockHash?: undefined
+    }
+  | {
+      fromBlock?: undefined
+      toBlock?: undefined
+      /** Hash of block to include logs from */
+      blockHash?: Hash
+    }
+)
+
+export type GetContractEventsReturnType<
+  abi extends Abi | readonly unknown[] = readonly unknown[],
+  eventName extends ContractEventName<abi> | undefined =
+    | ContractEventName<abi>
+    | undefined,
+  strict extends boolean | undefined = undefined,
+  fromBlock extends BlockNumber | BlockTag | undefined = undefined,
+  toBlock extends BlockNumber | BlockTag | undefined = undefined,
+  ///
+  isPending extends boolean =
+    | (fromBlock extends 'pending' ? true : false)
+    | (toBlock extends 'pending' ? true : false),
+> = Log<bigint, number, isPending, undefined, strict, abi, eventName>[]
+
+export type GetContractEventsErrorType =
+  | GetAbiItemErrorType
+  | GetLogsErrorType
+  | ErrorType
+
+/**
+ * Returns a list of event logs emitted by a contract.
+ *
+ * - Docs: https://viem.sh/docs/actions/public/getContractEvents.html
+ * - JSON-RPC Methods: [`eth_getLogs`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getlogs)
+ *
+ * @param client - Client to use
+ * @param parameters - {@link GetContractEventsParameters}
+ * @returns A list of event logs. {@link GetContractEventsReturnType}
+ *
+ * @example
+ * import { createClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { getContractEvents } from 'viem/public'
+ * import { wagmiAbi } from './abi'
+ *
+ * const client = createClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const logs = await getContractEvents(client, {
+ *  address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+ *  abi: wagmiAbi,
+ *  eventName: 'Transfer'
+ * })
+ */
+export async function getContractEvents<
+  chain extends Chain | undefined,
+  const abi extends Abi | readonly unknown[],
+  eventName extends ContractEventName<abi> | undefined = undefined,
+  TStrict extends boolean | undefined = undefined,
+  TFromBlock extends BlockNumber | BlockTag | undefined = undefined,
+  TToBlock extends BlockNumber | BlockTag | undefined = undefined,
+>(
+  client: Client<Transport, chain>,
+  parameters: GetContractEventsParameters<
+    abi,
+    eventName,
+    TStrict,
+    TFromBlock,
+    TToBlock
+  >,
+): Promise<
+  GetContractEventsReturnType<abi, eventName, TStrict, TFromBlock, TToBlock>
+> {
+  const {
+    abi,
+    address,
+    args,
+    blockHash,
+    eventName,
+    fromBlock,
+    toBlock,
+    strict,
+  } = parameters
+  const event = eventName
+    ? getAbiItem({ abi, name: eventName } as GetAbiItemParameters)
+    : undefined
+  const events = !event
+    ? (abi as Abi).filter((x) => x.type === 'event')
+    : undefined
+  return getAction(
+    client,
+    getLogs,
+  )({
+    address,
+    args,
+    blockHash,
+    event,
+    events,
+    fromBlock,
+    toBlock,
+    strict,
+  } as {} as GetLogsParameters) as unknown as GetContractEventsReturnType<
+    abi,
+    eventName,
+    TStrict,
+    TFromBlock,
+    TToBlock
+  >
+}

package/actions/public/getFeeHistory.ts

@@ -3,8 +3,15 @@ import type { Transport } from '../../clients/transports/createTransport.js'
 import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
 import type { FeeHistory } from '../../types/fee.js'
-import { numberToHex } from '../../utils/encoding/toHex.js'
-import { formatFeeHistory } from '../../utils/formatters/feeHistory.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import {
+  type NumberToHexErrorType,
+  numberToHex,
+} from '../../utils/encoding/toHex.js'
+import {
+  type FormatFeeHistoryErrorType,
+  formatFeeHistory,
+} from '../../utils/formatters/feeHistory.js'
 
 export type GetFeeHistoryParameters = {
   /**
@@ -32,6 +39,11 @@ export type GetFeeHistoryParameters = {
 )
 export type GetFeeHistoryReturnType = FeeHistory
 
+export type GetFeeHistoryErrorType =
+  | NumberToHexErrorType
+  | RequestErrorType
+  | FormatFeeHistoryErrorType
+
 /**
  * Returns a collection of historical gas information.
  *