viem 2.21.59 → 2.22.0

package/_types/types/multicall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multicall.d.ts","sourceRoot":"","sources":["../../types/multicall.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"multicall.d.ts","sourceRoot":"","sources":["../../types/multicall.ts"],"names":[],"mappings":"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"}

package/actions/index.ts

@@ -46,6 +46,12 @@ export {
   type CallReturnType,
   call,
 } from './public/call.js'
+export {
+  type CreateAccessListErrorType,
+  type CreateAccessListParameters,
+  type CreateAccessListReturnType,
+  createAccessList,
+} from './public/createAccessList.js'
 export {
   type CreateBlockFilterErrorType,
   type CreateBlockFilterReturnType,
@@ -243,6 +249,12 @@ export {
   type MulticallReturnType,
   multicall,
 } from './public/multicall.js'
+export {
+  type SimulateErrorType,
+  type SimulateParameters,
+  type SimulateReturnType,
+  simulate,
+} from './public/simulate.js'
 export {
   type OnBlock,
   type OnBlockParameter,

package/actions/public/createAccessList.ts

@@ -0,0 +1,159 @@
+import type { Address } from 'abitype'
+
+import type { Account } from '../../accounts/types.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 { ErrorType } from '../../errors/utils.js'
+import type { BlockTag } from '../../types/block.js'
+import type { Chain } from '../../types/chain.js'
+import type { RpcTransactionRequest } from '../../types/rpc.js'
+import type { AccessList, TransactionRequest } from '../../types/transaction.js'
+import type { ExactPartial, Prettify, UnionOmit } from '../../types/utils.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import {
+  type NumberToHexErrorType,
+  numberToHex,
+} from '../../utils/encoding/toHex.js'
+import {
+  type GetCallErrorReturnType,
+  getCallError,
+} from '../../utils/errors/getCallError.js'
+import { extract } from '../../utils/formatters/extract.js'
+import {
+  type FormatTransactionRequestErrorType,
+  type FormattedTransactionRequest,
+  formatTransactionRequest,
+} from '../../utils/formatters/transactionRequest.js'
+import { assertRequest } from '../../utils/transaction/assertRequest.js'
+import type {
+  AssertRequestErrorType,
+  AssertRequestParameters,
+} from '../../utils/transaction/assertRequest.js'
+
+export type CreateAccessListParameters<
+  chain extends Chain | undefined = Chain | undefined,
+> = UnionOmit<
+  FormattedTransactionRequest<chain>,
+  'from' | 'nonce' | 'accessList'
+> & {
+  /** Account attached to the call (msg.sender). */
+  account?: Account | Address | undefined
+} & (
+    | {
+        /** The balance of the account at a block number. */
+        blockNumber?: bigint | undefined
+        blockTag?: undefined
+      }
+    | {
+        blockNumber?: undefined
+        /**
+         * The balance of the account at a block tag.
+         * @default 'latest'
+         */
+        blockTag?: BlockTag | undefined
+      }
+  )
+
+export type CreateAccessListReturnType = Prettify<{
+  accessList: AccessList
+  gasUsed: bigint
+}>
+
+export type CreateAccessListErrorType = GetCallErrorReturnType<
+  | ParseAccountErrorType
+  | AssertRequestErrorType
+  | NumberToHexErrorType
+  | FormatTransactionRequestErrorType
+  | RequestErrorType
+>
+
+/**
+ * Creates an EIP-2930 access list.
+ *
+ * - Docs: https://viem.sh/docs/actions/public/createAccessList
+ * - JSON-RPC Methods: `eth_createAccessList`
+ *
+ * @param client - Client to use
+ * @param parameters - {@link CreateAccessListParameters}
+ * @returns The access list. {@link CreateAccessListReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { createAccessList } from 'viem/public'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const data = await createAccessList(client, {
+ *   account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+ *   data: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
+ *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ * })
+ */
+export async function createAccessList<chain extends Chain | undefined>(
+  client: Client<Transport, chain>,
+  args: CreateAccessListParameters<chain>,
+): Promise<CreateAccessListReturnType> {
+  const {
+    account: account_ = client.account,
+    blockNumber,
+    blockTag = 'latest',
+    blobs,
+    data,
+    gas,
+    gasPrice,
+    maxFeePerBlobGas,
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    to,
+    value,
+    ...rest
+  } = args
+  const account = account_ ? parseAccount(account_) : undefined
+
+  try {
+    assertRequest(args as AssertRequestParameters)
+
+    const blockNumberHex = blockNumber ? numberToHex(blockNumber) : undefined
+    const block = blockNumberHex || blockTag
+
+    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: chainFormat }),
+      from: account?.address,
+      blobs,
+      data,
+      gas,
+      gasPrice,
+      maxFeePerBlobGas,
+      maxFeePerGas,
+      maxPriorityFeePerGas,
+      to,
+      value,
+    } as TransactionRequest) as TransactionRequest
+
+    const response = await client.request({
+      method: 'eth_createAccessList',
+      params: [request as ExactPartial<RpcTransactionRequest>, block],
+    })
+    return {
+      accessList: response.accessList,
+      gasUsed: BigInt(response.gasUsed),
+    }
+  } catch (err) {
+    throw getCallError(err as ErrorType, {
+      ...args,
+      account,
+      chain: client.chain,
+    })
+  }
+}

package/actions/public/simulate.ts

@@ -0,0 +1,290 @@
+import type { Abi, AbiStateMutability, Address, Narrow } from 'abitype'
+import * as BlockOverrides from 'ox/BlockOverrides'
+
+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 { AbiDecodingZeroDataError } from '../../errors/abi.js'
+import type { BaseError } from '../../errors/base.js'
+import { RawContractError } from '../../errors/contract.js'
+import { UnknownNodeError } from '../../errors/node.js'
+import type { ErrorType } from '../../errors/utils.js'
+import type { Account } from '../../types/account.js'
+import type { Block, BlockTag } from '../../types/block.js'
+import type { Call, Calls } from '../../types/calls.js'
+import type { Chain } from '../../types/chain.js'
+import type { Log } from '../../types/log.js'
+import type { Hex } from '../../types/misc.js'
+import type { MulticallResults } from '../../types/multicall.js'
+import type { StateOverride } from '../../types/stateOverride.js'
+import type { TransactionRequest } from '../../types/transaction.js'
+import type { ExactPartial, UnionOmit } from '../../types/utils.js'
+import {
+  type DecodeFunctionResultErrorType,
+  decodeFunctionResult,
+} from '../../utils/abi/decodeFunctionResult.js'
+import {
+  type EncodeFunctionDataErrorType,
+  encodeFunctionData,
+} from '../../utils/abi/encodeFunctionData.js'
+import {
+  type NumberToHexErrorType,
+  numberToHex,
+} from '../../utils/encoding/toHex.js'
+import { getContractError } from '../../utils/errors/getContractError.js'
+import {
+  type GetNodeErrorReturnType,
+  getNodeError,
+} from '../../utils/errors/getNodeError.js'
+import {
+  type FormatBlockErrorType,
+  formatBlock,
+} from '../../utils/formatters/block.js'
+import { formatLog } from '../../utils/formatters/log.js'
+import {
+  type FormatTransactionRequestErrorType,
+  formatTransactionRequest,
+} from '../../utils/formatters/transactionRequest.js'
+import {
+  type SerializeStateOverrideErrorType,
+  serializeStateOverride,
+} from '../../utils/stateOverride.js'
+import {
+  type AssertRequestErrorType,
+  assertRequest,
+} from '../../utils/transaction/assertRequest.js'
+
+type CallExtraProperties = ExactPartial<
+  UnionOmit<
+    TransactionRequest,
+    'blobs' | 'data' | 'kzg' | 'to' | 'sidecars' | 'value'
+  >
+> & {
+  /** Account attached to the call (msg.sender). */
+  account?: Account | Address | undefined
+}
+
+export type SimulateParameters<
+  calls extends readonly unknown[] = readonly unknown[],
+> = {
+  /** Blocks to simulate. */
+  blocks: readonly {
+    /** Block overrides. */
+    blockOverrides?: BlockOverrides.BlockOverrides | undefined
+    /** Calls to execute. */
+    calls: Calls<Narrow<calls>, CallExtraProperties>
+    /** State overrides. */
+    stateOverrides?: StateOverride | undefined
+  }[]
+  /** Whether to return the full transactions. */
+  returnFullTransactions?: boolean
+  /** Whether to trace transfers. */
+  traceTransfers?: boolean
+  /** Whether to enable validation mode. */
+  validation?: boolean
+} & (
+  | {
+      /** The balance of the account at a block number. */
+      blockNumber?: bigint | undefined
+      blockTag?: undefined
+    }
+  | {
+      blockNumber?: undefined
+      /**
+       * The balance of the account at a block tag.
+       * @default 'latest'
+       */
+      blockTag?: BlockTag | undefined
+    }
+)
+
+export type SimulateReturnType<
+  calls extends readonly unknown[] = readonly unknown[],
+> = readonly (Block & {
+  calls: MulticallResults<
+    Narrow<calls>,
+    true,
+    {
+      extraProperties: {
+        data: Hex
+        gasUsed: bigint
+        logs?: Log[] | undefined
+      }
+      error: Error
+      mutability: AbiStateMutability
+    }
+  >
+})[]
+
+export type SimulateErrorType =
+  | AssertRequestErrorType
+  | DecodeFunctionResultErrorType
+  | EncodeFunctionDataErrorType
+  | FormatBlockErrorType
+  | FormatTransactionRequestErrorType
+  | GetNodeErrorReturnType
+  | ParseAccountErrorType
+  | SerializeStateOverrideErrorType
+  | NumberToHexErrorType
+  | ErrorType
+
+/**
+ * Simulates a set of calls on block(s) with optional block and state overrides.
+ *
+ * @example
+ * ```ts
+ * import { createClient, http, parseEther } from 'viem'
+ * import { simulate } from 'viem/actions'
+ * import { mainnet } from 'viem/chains'
+ *
+ * const client = createClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ *
+ * const result = await simulate(client, {
+ *   blocks: [{
+ *     blockOverrides: {
+ *       number: 69420n,
+ *     },
+ *     calls: [{
+ *       {
+ *         account: '0x5a0b54d5dc17e482fe8b0bdca5320161b95fb929',
+ *         data: '0xdeadbeef',
+ *         to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *       },
+ *       {
+ *         account: '0x5a0b54d5dc17e482fe8b0bdca5320161b95fb929',
+ *         to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *         value: parseEther('1'),
+ *       },
+ *     }],
+ *     stateOverrides: [{
+ *       address: '0x5a0b54d5dc17e482fe8b0bdca5320161b95fb929',
+ *       balance: parseEther('10'),
+ *     }],
+ *   }]
+ * })
+ * ```
+ *
+ * @param client - Client to use.
+ * @param parameters - {@link SimulateParameters}
+ * @returns Simulated blocks. {@link SimulateReturnType}
+ */
+export async function simulate<
+  chain extends Chain | undefined,
+  const calls extends readonly unknown[],
+>(
+  client: Client<Transport, chain>,
+  parameters: SimulateParameters<calls>,
+): Promise<SimulateReturnType<calls>> {
+  const {
+    blockNumber,
+    blockTag = 'latest',
+    blocks,
+    returnFullTransactions,
+    traceTransfers,
+    validation,
+  } = parameters
+
+  try {
+    const blockStateCalls = []
+    for (const block of blocks) {
+      const blockOverrides = block.blockOverrides
+        ? BlockOverrides.toRpc(block.blockOverrides)
+        : undefined
+      const calls = block.calls.map((call_) => {
+        const call = call_ as Call<unknown, CallExtraProperties>
+        const account = call.account ? parseAccount(call.account) : undefined
+        const request = {
+          ...call,
+          data: call.abi ? encodeFunctionData(call) : call.data,
+          from: call.from ?? account?.address,
+        } as const
+        assertRequest(request)
+        return formatTransactionRequest(request)
+      })
+      const stateOverrides = block.stateOverrides
+        ? serializeStateOverride(block.stateOverrides)
+        : undefined
+
+      blockStateCalls.push({
+        blockOverrides,
+        calls,
+        stateOverrides,
+      })
+    }
+
+    const blockNumberHex = blockNumber ? numberToHex(blockNumber) : undefined
+    const block = blockNumberHex || blockTag
+
+    const result = await client.request({
+      method: 'eth_simulateV1',
+      params: [
+        { blockStateCalls, returnFullTransactions, traceTransfers, validation },
+        block,
+      ],
+    })
+
+    return result.map((block, i) => ({
+      ...formatBlock(block),
+      calls: block.calls.map((call, j) => {
+        const { abi, args, functionName, to } = blocks[i].calls[j] as Call<
+          unknown,
+          CallExtraProperties
+        >
+
+        const data = call.error?.data ?? call.returnData
+        const gasUsed = BigInt(call.gasUsed)
+        const logs = call.logs?.map((log) => formatLog(log))
+        const status = call.status === '0x1' ? 'success' : 'failure'
+
+        const result = abi
+          ? decodeFunctionResult({
+              abi,
+              data,
+              functionName,
+            })
+          : null
+
+        const error = (() => {
+          if (status === 'success') return undefined
+
+          let error = undefined
+          if (call.error?.data === '0x') error = new AbiDecodingZeroDataError()
+          else if (call.error) error = new RawContractError(call.error)
+
+          if (!error) return undefined
+          return getContractError(error, {
+            abi: (abi ?? []) as Abi,
+            address: to,
+            args,
+            functionName: functionName ?? '<unknown>',
+          })
+        })()
+
+        return {
+          data,
+          gasUsed,
+          logs,
+          status,
+          ...(status === 'success'
+            ? {
+                result,
+              }
+            : {
+                error,
+              }),
+        }
+      }),
+    })) as unknown as SimulateReturnType<calls>
+  } catch (e) {
+    const cause = e as BaseError
+    const error = getNodeError(cause, {})
+    if (error instanceof UnknownNodeError) throw cause
+    throw error
+  }
+}

package/chains/definitions/mainnet.ts

@@ -6,7 +6,7 @@ export const mainnet = /*#__PURE__*/ defineChain({
   nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
   rpcUrls: {
     default: {
-      http: ['https://cloudflare-eth.com'],
+      http: ['https://eth.merkle.io'],
     },
   },
   blockExplorers: {

package/clients/decorators/public.ts

@@ -30,6 +30,11 @@ import {
   type CallReturnType,
   call,
 } from '../../actions/public/call.js'
+import {
+  type CreateAccessListParameters,
+  type CreateAccessListReturnType,
+  createAccessList,
+} from '../../actions/public/createAccessList.js'
 import {
   type CreateBlockFilterReturnType,
   createBlockFilter,
@@ -175,6 +180,11 @@ import {
   type ReadContractReturnType,
   readContract,
 } from '../../actions/public/readContract.js'
+import {
+  type SimulateParameters,
+  type SimulateReturnType,
+  simulate,
+} from '../../actions/public/simulate.js'
 import {
   type SimulateContractParameters,
   type SimulateContractReturnType,
@@ -285,6 +295,32 @@ export type PublicActions<
    * })
    */
   call: (parameters: CallParameters<chain>) => Promise<CallReturnType>
+  /**
+   * Creates an EIP-2930 access list that you can include in a transaction.
+   *
+   * - Docs: https://viem.sh/docs/actions/public/createAccessList
+   * - JSON-RPC Methods: `eth_createAccessList`
+   *
+   * @param args - {@link CreateAccessListParameters}
+   * @returns The call data. {@link CreateAccessListReturnType}
+   *
+   * @example
+   * import { createPublicClient, http } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createPublicClient({
+   *   chain: mainnet,
+   *   transport: http(),
+   * })
+   *
+   * const data = await client.createAccessList({
+   *   data: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
+   *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+   * })
+   */
+  createAccessList: (
+    parameters: CreateAccessListParameters<chain>,
+  ) => Promise<CreateAccessListReturnType>
   /**
    * Creates a Filter to listen for new block hashes that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges).
    *
@@ -1489,6 +1525,51 @@ export type PublicActions<
   sendRawTransaction: (
     args: SendRawTransactionParameters,
   ) => Promise<SendRawTransactionReturnType>
+  /**
+   * Simulates a set of calls on block(s) with optional block and state overrides.
+   *
+   * @example
+   * ```ts
+   * import { createPublicClient, http, parseEther } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createPublicClient({
+   *   chain: mainnet,
+   *   transport: http(),
+   * })
+   *
+   * const result = await client.simulate({
+   *   blocks: [{
+   *     blockOverrides: {
+   *       number: 69420n,
+   *     },
+   *     calls: [{
+   *       {
+   *         account: '0x5a0b54d5dc17e482fe8b0bdca5320161b95fb929',
+   *         data: '0xdeadbeef',
+   *         to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+   *       },
+   *       {
+   *         account: '0x5a0b54d5dc17e482fe8b0bdca5320161b95fb929',
+   *         to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+   *         value: parseEther('1'),
+   *       },
+   *     }],
+   *     stateOverrides: [{
+   *       address: '0x5a0b54d5dc17e482fe8b0bdca5320161b95fb929',
+   *       balance: parseEther('10'),
+   *     }],
+   *   }]
+   * })
+   * ```
+   *
+   * @param client - Client to use.
+   * @param parameters - {@link SimulateParameters}
+   * @returns Simulated blocks. {@link SimulateReturnType}
+   */
+  simulate: <const calls extends readonly unknown[]>(
+    args: SimulateParameters<calls>,
+  ) => Promise<SimulateReturnType<calls>>
   /**
    * Simulates/validates a contract interaction. This is useful for retrieving **return data** and **revert reasons** of contract write functions.
    *
@@ -1833,6 +1914,7 @@ export function publicActions<
 ): PublicActions<transport, chain, account> {
   return {
     call: (args) => call(client, args),
+    createAccessList: (args) => createAccessList(client, args),
     createBlockFilter: () => createBlockFilter(client),
     createContractEventFilter: (args) =>
       createContractEventFilter(client, args),
@@ -1876,6 +1958,7 @@ export function publicActions<
       prepareTransactionRequest(client as any, args as any) as any,
     readContract: (args) => readContract(client, args),
     sendRawTransaction: (args) => sendRawTransaction(client, args),
+    simulate: (args) => simulate(client, args),
     simulateContract: (args) => simulateContract(client, args),
     verifyMessage: (args) => verifyMessage(client, args),
     verifySiweMessage: (args) => verifySiweMessage(client, args),

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.21.59'
+export const version = '2.22.0'

package/index.ts

@@ -36,6 +36,10 @@ export {
   parseAbiParameter,
   parseAbiParameters,
 } from 'abitype'
+export type {
+  BlockOverrides,
+  Rpc as RpcBlockOverrides,
+} from 'ox/BlockOverrides'
 
 export {
   getContract,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.21.59",
+  "version": "2.22.0",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -177,7 +177,7 @@
     "@scure/bip39": "1.5.0",
     "abitype": "1.0.7",
     "isows": "1.0.6",
-    "ox": "0.4.4",
+    "ox": "0.6.0",
     "webauthn-p256": "0.0.10",
     "ws": "8.18.0"
   },