viem 2.7.16 → 2.7.19

package/chains/index.ts

@@ -1,6 +1,8 @@
 export type { Chain } from '../types/chain.js'
 
 export { acala } from './definitions/acala.js'
+export { ancient8 } from './definitions/ancient8.js'
+export { ancient8Sepolia } from './definitions/ancient8Sepolia.js'
 export { anvil } from './definitions/anvil.js'
 export { apexTestnet } from './definitions/apexTestnet.js'
 export { arbitrum } from './definitions/arbitrum.js'
@@ -11,6 +13,7 @@ export { arbitrumSepolia } from './definitions/arbitrumSepolia.js'
 export { astarZkatana } from './definitions/astarZkatana.js'
 export { aurora } from './definitions/aurora.js'
 export { auroraTestnet } from './definitions/auroraTestnet.js'
+export { auroria } from './definitions/auroria.js'
 export { avalanche } from './definitions/avalanche.js'
 export { avalancheFuji } from './definitions/avalancheFuji.js'
 export { bahamut } from './definitions/bahamut.js'
@@ -22,6 +25,7 @@ export { bearNetworkChainTestnet } from './definitions/bearNetworkChainTestnet.j
 export { berachainTestnet } from './definitions/berachainTestnet.js'
 export { bitTorrent } from './definitions/bitTorrent.js'
 export { bitTorrentTestnet } from './definitions/bitTorrentTestnet.js'
+export { blast } from './definitions/blast.js'
 export { blastSepolia } from './definitions/blastSepolia.js'
 export { boba } from './definitions/boba.js'
 export { bronos } from './definitions/bronos.js'
@@ -107,6 +111,7 @@ export { manta } from './definitions/manta.js'
 export { mantaTestnet } from './definitions/mantaTestnet.js'
 export { mantle } from './definitions/mantle.js'
 export { mantleTestnet } from './definitions/mantleTestnet.js'
+export { merlin } from './definitions/merlin.js'
 export { metachain } from './definitions/metachain.js'
 export { metachainIstanbul } from './definitions/metachainIstanbul.js'
 export { meter } from './definitions/meter.js'

package/chains/opStack/actions/getL1BaseFee.ts

@@ -0,0 +1,81 @@
+import type { Address } from 'abitype'
+
+import {
+  type ReadContractErrorType,
+  readContract,
+} from '../../../actions/public/readContract.js'
+import { type PrepareTransactionRequestErrorType } from '../../../actions/wallet/prepareTransactionRequest.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, type GetChainParameter } from '../../../types/chain.js'
+import type { RequestErrorType } from '../../../utils/buildRequest.js'
+import { getChainContractAddress } from '../../../utils/chain/getChainContractAddress.js'
+import { type HexToNumberErrorType } from '../../../utils/encoding/fromHex.js'
+
+import { gasPriceOracleAbi } from '../abis.js'
+import { contracts } from '../contracts.js'
+
+export type GetL1BaseFeeParameters<
+  TChain extends Chain | undefined = Chain | undefined,
+  TChainOverride extends Chain | undefined = undefined,
+> = GetChainParameter<TChain, TChainOverride> & {
+  /** Gas price oracle address. */
+  gasPriceOracleAddress?: Address
+}
+
+export type GetL1BaseFeeReturnType = bigint
+
+export type GetL1BaseFeeErrorType =
+  | RequestErrorType
+  | PrepareTransactionRequestErrorType
+  | HexToNumberErrorType
+  | ReadContractErrorType
+  | ErrorType
+
+/**
+ * get the L1 base fee
+ *
+ * @param client - Client to use
+ * @param parameters - {@link GetL1BaseFeeParameters}
+ * @returns The basefee (in wei). {@link GetL1BaseFeeReturnType}
+ *
+ * @example
+ * import { createPublicClient, http, parseEther } from 'viem'
+ * import { optimism } from 'viem/chains'
+ * import { getL1BaseFee } from 'viem/chains/optimism'
+ *
+ * const client = createPublicClient({
+ *   chain: optimism,
+ *   transport: http(),
+ * })
+ * const l1BaseFee = await getL1BaseFee(client)
+ */
+export async function getL1BaseFee<
+  TChain extends Chain | undefined,
+  TChainOverride extends Chain | undefined = undefined,
+>(
+  client: Client<Transport, TChain>,
+  args?: GetL1BaseFeeParameters<TChain, TChainOverride>,
+): Promise<GetL1BaseFeeReturnType> {
+  const {
+    chain = client.chain,
+    gasPriceOracleAddress: gasPriceOracleAddress_,
+  } = args || {}
+
+  const gasPriceOracleAddress = (() => {
+    if (gasPriceOracleAddress_) return gasPriceOracleAddress_
+    if (chain)
+      return getChainContractAddress({
+        chain,
+        contract: 'gasPriceOracle',
+      })
+    return contracts.gasPriceOracle.address
+  })()
+
+  return readContract(client, {
+    abi: gasPriceOracleAbi,
+    address: gasPriceOracleAddress,
+    functionName: 'l1BaseFee',
+  })
+}

package/chains/opStack/chains.ts

@@ -1,3 +1,5 @@
+export { ancient8 } from '../definitions/ancient8.js'
+export { ancient8Sepolia } from '../definitions/ancient8Sepolia.js'
 export { base } from '../definitions/base.js'
 export { baseGoerli } from '../definitions/baseGoerli.js'
 export { baseSepolia } from '../definitions/baseSepolia.js'

package/chains/opStack/decorators/publicL2.ts

@@ -62,6 +62,11 @@ import {
   type EstimateTotalGasReturnType,
   estimateTotalGas,
 } from '../actions/estimateTotalGas.js'
+import {
+  type GetL1BaseFeeParameters,
+  type GetL1BaseFeeReturnType,
+  getL1BaseFee,
+} from '../actions/getL1BaseFee.js'
 
 export type PublicActionsL2<
   chain extends Chain | undefined = Chain | undefined,
@@ -364,6 +369,29 @@ export type PublicActionsL2<
   estimateL1Fee: <chainOverride extends Chain | undefined = undefined>(
     parameters: EstimateL1FeeParameters<chain, account, chainOverride>,
   ) => Promise<EstimateL1FeeReturnType>
+
+  /**
+   * Get the L1 basefee
+   *
+   * @param client - Client to use
+   * @param parameters - {@link GetL1BaseFeeParameters}
+   * @returns The fee (in wei). {@link GetL1BaseFeeReturnType}
+   *
+   * @example
+   * import { createPublicClient, http, parseEther } from 'viem'
+   * import { optimism } from 'viem/chains'
+   * import { publicActionsL2 } from 'viem/op-stack'
+   *
+   * const client = createPublicClient({
+   *   chain: optimism,
+   *   transport: http(),
+   * }).extend(publicActionsL2())
+   *
+   * const l1BaseFee = await client.getL1BaseFee()
+   */
+  getL1BaseFee: <chainOverride extends Chain | undefined = undefined>(
+    parameters?: GetL1BaseFeeParameters<chain, chainOverride>,
+  ) => Promise<GetL1BaseFeeReturnType>
   /**
    * Estimates the amount of L1 data gas required to execute an L2 transaction.
    *
@@ -479,6 +507,7 @@ export function publicActionsL2() {
       estimateInitiateWithdrawalGas: (args) =>
         estimateInitiateWithdrawalGas(client, args),
       estimateL1Fee: (args) => estimateL1Fee(client, args),
+      getL1BaseFee: (args) => getL1BaseFee(client, args),
       estimateL1Gas: (args) => estimateL1Gas(client, args),
       estimateTotalFee: (args) => estimateTotalFee(client, args),
       estimateTotalGas: (args) => estimateTotalGas(client, args),

package/chains/opStack/index.ts

@@ -52,6 +52,12 @@ export {
   type EstimateL1FeeParameters,
   type EstimateL1FeeReturnType,
 } from './actions/estimateL1Fee.js'
+export {
+  getL1BaseFee,
+  type GetL1BaseFeeErrorType,
+  type GetL1BaseFeeParameters,
+  type GetL1BaseFeeReturnType,
+} from './actions/getL1BaseFee.js'
 export {
   estimateL1Gas,
   type EstimateL1GasErrorType,

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.7.16'
+export const version = '2.7.19'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.7.16",
+  "version": "2.7.19",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",

package/utils/abi/encodeAbiParameters.ts

@@ -46,6 +46,38 @@ export type EncodeAbiParametersErrorType =
 
 /**
  * @description Encodes a list of primitive values into an ABI-encoded hex value.
+ *
+ * - Docs: https://viem.sh/docs/abi/encodeAbiParameters#encodeabiparameters
+ *
+ *   Generates ABI encoded data using the [ABI specification](https://docs.soliditylang.org/en/latest/abi-spec), given a set of ABI parameters (inputs/outputs) and their corresponding values.
+ *
+ * @param params - a set of ABI Parameters (params), that can be in the shape of the inputs or outputs attribute of an ABI Item.
+ * @param values - a set of values (values) that correspond to the given params.
+ * @example
+ * ```typescript
+ * import { encodeAbiParameters } from 'viem'
+ *
+ * const encodedData = encodeAbiParameters(
+ *   [
+ *     { name: 'x', type: 'string' },
+ *     { name: 'y', type: 'uint' },
+ *     { name: 'z', type: 'bool' }
+ *   ],
+ *   ['wagmi', 420n, true]
+ * )
+ * ```
+ *
+ * You can also pass in Human Readable parameters with the parseAbiParameters utility.
+ *
+ * @example
+ * ```typescript
+ * import { encodeAbiParameters, parseAbiParameters } from 'viem'
+ *
+ * const encodedData = encodeAbiParameters(
+ *   parseAbiParameters('string x, uint y, bool z'),
+ *   ['wagmi', 420n, true]
+ * )
+ * ```
  */
 export function encodeAbiParameters<
   const TParams extends readonly AbiParameter[] | readonly unknown[],