viem 2.7.15 → 2.7.18

package/chains/definitions/fraxtalTestnet.ts

@@ -0,0 +1,47 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+import { chainConfig } from '../opStack/chainConfig.js'
+
+const sourceId = 17000 // holesky
+
+export const fraxtalTestnet = /*#__PURE__*/ defineChain({
+  ...chainConfig,
+  id: 2522,
+  name: 'Fraxtal Testnet',
+  nativeCurrency: { name: 'Frax Ether', symbol: 'frxETH', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.testnet.frax.com'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'fraxscan testnet',
+      url: 'https://holesky.fraxscan.com',
+      apiUrl: 'https://api-holesky.fraxscan.com/api',
+    },
+  },
+  contracts: {
+    ...chainConfig.contracts,
+    l2OutputOracle: {
+      [sourceId]: {
+        address: '0x715EA64DA13F4d0831ece4Ad3E8c1aa013167F32',
+      },
+    },
+    multicall3: {
+      address: '0xca11bde05977b3631167028862be2a173976ca11',
+    },
+    portal: {
+      [sourceId]: {
+        address: '0xB9c64BfA498d5b9a8398Ed6f46eb76d90dE5505d',
+        blockCreated: 318416,
+      },
+    },
+    l1StandardBridge: {
+      [sourceId]: {
+        address: '0x0BaafC217162f64930909aD9f2B27125121d6332',
+        blockCreated: 318416,
+      },
+    },
+  },
+  sourceId,
+})

package/chains/definitions/liskSepolia.ts

@@ -0,0 +1,47 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+import { chainConfig } from '../opStack/chainConfig.js'
+
+const sourceId = 11_155_111 // sepolia
+
+export const liskSepolia = /*#__PURE__*/ defineChain({
+  ...chainConfig,
+  id: 4202,
+  network: 'lisk-sepolia',
+  name: 'Lisk Sepolia',
+  nativeCurrency: { name: 'Sepolia Ether', symbol: 'ETH', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.sepolia-api.lisk.com'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Blockscout',
+      url: 'https://sepolia-blockscout.lisk.com',
+      apiUrl: 'https://sepolia-blockscout.lisk.com/api',
+    },
+  },
+  contracts: {
+    ...chainConfig.contracts,
+    l2OutputOracle: {
+      [sourceId]: {
+        address: '0xA0E35F56C318DE1bD5D9ca6A94Fe7e37C5663348',
+      },
+    },
+    multicall3: {
+      address: '0xca11bde05977b3631167028862be2a173976ca11',
+    },
+    portal: {
+      [sourceId]: {
+        address: '0xe3d90F21490686Ec7eF37BE788E02dfC12787264',
+      },
+    },
+    l1StandardBridge: {
+      [sourceId]: {
+        address: '0x1Fb30e446eA791cd1f011675E5F3f5311b70faF5',
+      },
+    },
+  },
+  testnet: true,
+  sourceId,
+})

package/chains/definitions/merlin.ts

@@ -0,0 +1,21 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const merlin = /*#__PURE__*/ defineChain({
+  id: 4200,
+  name: 'Merlin',
+  nativeCurrency: {
+    name: 'BTC',
+    symbol: 'BTC',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['https://rpc.merlinchain.io'] },
+  },
+  blockExplorers: {
+    default: {
+      name: 'blockscout',
+      url: 'https://scan.merlinchain.io',
+      apiUrl: 'https://scan.merlinchain.io/api',
+    },
+  },
+})

package/chains/index.ts

@@ -1,7 +1,10 @@
 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'
 export { arbitrumGoerli } from './definitions/arbitrumGoerli.js'
 export { arbitrumNova } from './definitions/arbitrumNova.js'
@@ -10,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'
@@ -21,12 +25,14 @@ 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'
 export { bronosTestnet } from './definitions/bronosTestnet.js'
 export { bsc } from './definitions/bsc.js'
 export { bscTestnet } from './definitions/bscTestnet.js'
+export { bscGreenfield } from './definitions/bscGreenfield.js'
 export { bxn } from './definitions/bxn.js'
 export { bxnTestnet } from './definitions/bxnTestnet.js'
 export { canto } from './definitions/canto.js'
@@ -64,6 +70,8 @@ export { flare } from './definitions/flare.js'
 export { flareTestnet } from './definitions/flareTestnet.js'
 /** @deprecated Use `anvil` instead. */
 export { foundry } from './definitions/foundry.js'
+export { fraxtal } from './definitions/fraxtal.js'
+export { fraxtalTestnet } from './definitions/fraxtalTestnet.js'
 export { fuse } from './definitions/fuse.js'
 export { fuseSparknet } from './definitions/fuseSparknet.js'
 export { iotex } from './definitions/iotex.js'
@@ -94,6 +102,7 @@ export { lightlinkPegasus } from './definitions/lightlinkPegasus.js'
 export { lightlinkPhoenix } from './definitions/lightlinkPhoenix.js'
 export { linea } from './definitions/linea.js'
 export { lineaTestnet } from './definitions/lineaTestnet.js'
+export { liskSepolia } from './definitions/liskSepolia.js'
 export { localhost } from './definitions/localhost.js'
 export { lukso } from './definitions/lukso.js'
 export { mainnet } from './definitions/mainnet.js'
@@ -102,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,6 +1,10 @@
+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'
+export { fraxtal } from '../definitions/fraxtal.js'
+export { fraxtalTestnet } from '../definitions/fraxtalTestnet.js'
 export { optimism } from '../definitions/optimism.js'
 export { optimismGoerli } from '../definitions/optimismGoerli.js'
 export { optimismSepolia } from '../definitions/optimismSepolia.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.15'
+export const version = '2.7.18'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.7.15",
+  "version": "2.7.18",
   "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[],

package/utils/address/isAddress.ts

@@ -5,7 +5,7 @@ import { checksumAddress } from './getAddress.js'
 
 const addressRegex = /^0x[a-fA-F0-9]{40}$/
 
-const isAddressCache = /*#__PURE__*/ new LruMap<boolean>(8192)
+export const isAddressCache = /*#__PURE__*/ new LruMap<boolean>(8192)
 
 export type IsAddressOptions = {
   /**