viem 1.2.10 → 1.2.11

package/src/chains/formatters/optimism.ts

@@ -23,6 +23,12 @@ type RpcTransaction = RpcTransaction_ & {
   sourceHash?: undefined
 }
 
+type Transaction = Transaction_ & {
+  isSystemTx?: undefined
+  mint?: undefined
+  sourceHash?: undefined
+}
+
 export type RpcDepositTransaction = TransactionBase<Quantity, Index> &
   FeeValuesEIP1559<Quantity> & {
     isSystemTx?: boolean
@@ -31,12 +37,6 @@ export type RpcDepositTransaction = TransactionBase<Quantity, Index> &
     type: '0x7e'
   }
 
-type Transaction = Transaction_ & {
-  isSystemTx?: undefined
-  mint?: undefined
-  sourceHash?: undefined
-}
-
 export type DepositTransaction = TransactionBase &
   FeeValuesEIP1559 & {
     isSystemTx?: boolean
@@ -45,22 +45,22 @@ export type DepositTransaction = TransactionBase &
     type: 'deposit'
   }
 
-type OptimismOverrides = {
+export type OptimismFormatOverrides = {
   RpcBlock: {
-    transactions: Hash[] | OptimismOverrides['RpcTransaction'][]
+    transactions: Hash[] | OptimismFormatOverrides['RpcTransaction'][]
   }
   RpcTransaction: RpcTransaction | RpcDepositTransaction
   Transaction: Transaction | DepositTransaction
 }
 
-export const optimismFormatters = {
+export const formattersOptimism = {
   block: /*#__PURE__*/ defineBlock({
-    format(args: OptimismOverrides['RpcBlock']) {
+    format(args: OptimismFormatOverrides['RpcBlock']) {
       const transactions = args.transactions?.map((transaction) => {
         if (typeof transaction === 'string') return transaction
         const formatted = formatTransaction(
           transaction as RpcTransaction,
-        ) as OptimismOverrides['Transaction']
+        ) as OptimismFormatOverrides['Transaction']
         if (formatted.typeHex === '0x7e') {
           formatted.isSystemTx = transaction.isSystemTx
           formatted.mint = transaction.mint
@@ -70,15 +70,15 @@ export const optimismFormatters = {
           formatted.type = 'deposit'
         }
         return formatted
-      }) as Hash[] | OptimismOverrides['Transaction'][]
+      }) as Hash[] | OptimismFormatOverrides['Transaction'][]
       return {
         transactions,
       }
     },
   }),
   transaction: /*#__PURE__*/ defineTransaction({
-    format(args: OptimismOverrides['RpcTransaction']) {
-      const transaction = {} as OptimismOverrides['Transaction']
+    format(args: OptimismFormatOverrides['RpcTransaction']) {
+      const transaction = {} as OptimismFormatOverrides['Transaction']
       if (args.type === '0x7e') {
         transaction.isSystemTx = args.isSystemTx
         transaction.mint = args.mint ? hexToBigInt(args.mint) : undefined

package/src/chains/index.ts

@@ -1,9 +1,9 @@
 import * as chains from '@wagmi/chains'
 
 import { defineChain } from '../utils/chain.js'
-import { celoFormatters } from './formatters/celo.js'
-import { optimismFormatters } from './formatters/optimism.js'
-import { celoSerializers } from './serializers/celo.js'
+import { formattersCelo } from './formatters/celo.js'
+import { formattersOptimism } from './formatters/optimism.js'
+import { serializersCelo } from './serializers/celo.js'
 
 export const arbitrum = /*#__PURE__*/ defineChain(chains.arbitrum)
 export const arbitrumGoerli = /*#__PURE__*/ defineChain(chains.arbitrumGoerli)
@@ -19,16 +19,16 @@ export const bsc = /*#__PURE__*/ defineChain(chains.bsc)
 export const bscTestnet = /*#__PURE__*/ defineChain(chains.bscTestnet)
 export const canto = /*#__PURE__*/ defineChain(chains.canto)
 export const celo = /*#__PURE__*/ defineChain(chains.celo, {
-  formatters: celoFormatters,
-  serializers: celoSerializers,
+  formatters: formattersCelo,
+  serializers: serializersCelo,
 })
 export const celoAlfajores = /*#__PURE__*/ defineChain(chains.celoAlfajores, {
-  formatters: celoFormatters,
-  serializers: celoSerializers,
+  formatters: formattersCelo,
+  serializers: serializersCelo,
 })
 export const celoCannoli = /*#__PURE__*/ defineChain(chains.celoCannoli, {
-  formatters: celoFormatters,
-  serializers: celoSerializers,
+  formatters: formattersCelo,
+  serializers: serializersCelo,
 })
 export const cronos = /*#__PURE__*/ defineChain(chains.cronos)
 export const crossbell = /*#__PURE__*/ defineChain(chains.crossbell)
@@ -69,10 +69,10 @@ export const moonriver = /*#__PURE__*/ defineChain(chains.moonriver)
 export const nexi = /*#__PURE__*/ defineChain(chains.nexi)
 export const okc = /*#__PURE__*/ defineChain(chains.okc)
 export const optimism = /*#__PURE__*/ defineChain(chains.optimism, {
-  formatters: optimismFormatters,
+  formatters: formattersOptimism,
 })
 export const optimismGoerli = /*#__PURE__*/ defineChain(chains.optimismGoerli, {
-  formatters: optimismFormatters,
+  formatters: formattersOptimism,
 })
 export const polygon = /*#__PURE__*/ defineChain(chains.polygon)
 export const polygonMumbai = /*#__PURE__*/ defineChain(chains.polygonMumbai)

package/src/chains/serializers/celo.ts

@@ -6,6 +6,7 @@ import { InvalidChainIdError } from '../../errors/chain.js'
 import { FeeCapTooHighError, TipAboveFeeCapError } from '../../errors/node.js'
 import type { FeeValuesEIP1559 } from '../../types/fee.js'
 import type { Signature } from '../../types/misc.js'
+import type { Serializers } from '../../types/serializer.js'
 import type {
   AccessList,
   TransactionSerializable,
@@ -19,30 +20,26 @@ import { toRlp } from '../../utils/encoding/toRlp.js'
 import { serializeAccessList } from '../../utils/transaction/serializeAccessList.js'
 import {
   type SerializeTransactionFn,
-  serializeTransaction as serializeTransaction_,
+  serializeTransaction,
 } from '../../utils/transaction/serializeTransaction.js'
 
-export const serializeTransaction: SerializeTransactionFn<
+export const serializeTransactionCelo: SerializeTransactionFn<
   TransactionSerializableCelo
 > = (tx, signature) => {
-  // Handle Celo's CIP-42 Transactions
-  if (couldBeCIP42(tx))
+  // Handle CIP-42 transactions
+  if (isCIP42(tx))
     return serializeTransactionCIP42(
       tx as TransactionSerializableCIP42,
       signature,
     )
 
   // Handle other transaction types
-  return serializeTransaction_(tx as TransactionSerializable, signature)
+  return serializeTransaction(tx as TransactionSerializable, signature)
 }
 
-export type CeloSerializers = {
-  transaction: typeof serializeTransaction
-}
-
-export const celoSerializers: CeloSerializers = {
-  transaction: serializeTransaction,
-}
+export const serializersCelo = {
+  transaction: serializeTransactionCelo,
+} as const satisfies Serializers
 
 //////////////////////////////////////////////////////////////////////////////
 // Types
@@ -126,14 +123,13 @@ function serializeTransactionCIP42(
 // Utilities
 
 // process as CIP42 if any of these fields are present. realistically gatewayfee is not used but is part of spec
-function couldBeCIP42(tx: TransactionSerializableCelo) {
-  const maybeCIP42 = tx as TransactionSerializableCIP42
+function isCIP42(transaction: TransactionSerializableCelo) {
   if (
-    'maxFeePerGas' in maybeCIP42 &&
-    'maxPriorityFeePerGas' in maybeCIP42 &&
-    ('feeCurrency' in maybeCIP42 ||
-      'gatewayFee' in maybeCIP42 ||
-      'gatewayFeeRecipient' in maybeCIP42)
+    'maxFeePerGas' in transaction &&
+    'maxPriorityFeePerGas' in transaction &&
+    ('feeCurrency' in transaction ||
+      'gatewayFee' in transaction ||
+      'gatewayFeeRecipient' in transaction)
   )
     return true
   return false

package/src/clients/createClient.ts

@@ -1,7 +1,6 @@
-import type { Address, Narrow } from 'abitype'
+import type { Address } from 'abitype'
 
 import type { Account, JsonRpcAccount } from '../accounts/types.js'
-import type { ParseAccount } from '../types/account.js'
 import type { Chain } from '../types/chain.js'
 import type {
   EIP1193RequestFn,
@@ -13,60 +12,82 @@ import { parseAccount } from '../utils/accounts.js'
 import { uid } from '../utils/uid.js'
 import type { Transport } from './transports/createTransport.js'
 
-export type MulticallBatchOptions = {
-  /** The maximum size (in bytes) for each calldata chunk. @default 1_024 */
-  batchSize?: number
-  /** The maximum number of milliseconds to wait before sending a batch. @default 0 */
-  wait?: number
-}
-
 export type ClientConfig<
-  TTransport extends Transport = Transport,
-  TChain extends Chain | undefined = Chain | undefined,
-  TAccountOrAddress extends Account | Address | undefined =
+  transport extends Transport = Transport,
+  chain extends Chain | undefined = Chain | undefined,
+  accountOrAddress extends Account | Address | undefined =
     | Account
     | Address
     | undefined,
 > = {
   /** The Account to use for the Client. This will be used for Actions that require an account as an argument. */
-  account?: TAccountOrAddress
+  account?: accountOrAddress extends Account | Address
+    ? accountOrAddress | Account | Address // `accountOrAddress` defined, add for inference
+    : Account | Address | undefined // `accountOrAddress` undefined, show possible types for autocomplete
   /** Flags for batch settings. */
-  batch?: {
-    /** Toggle to enable `eth_call` multicall aggregation. */
-    multicall?: boolean | MulticallBatchOptions
-  }
+  batch?:
+    | {
+        /** Toggle to enable `eth_call` multicall aggregation. */
+        multicall?: boolean | Prettify<MulticallBatchOptions> | undefined
+      }
+    | undefined
   /** Chain for the client. */
-  chain?: TChain
+  chain?: chain extends Chain
+    ? chain // `chain` defined, add for inference
+    : Chain | undefined // `chain` undefined, show possible types for autocomplete
   /** A key for the client. */
-  key?: string
+  key?: string | undefined
   /** A name for the client. */
-  name?: string
+  name?: string | undefined
   /**
    * Frequency (in ms) for polling enabled actions & events.
    * @default 4_000
    */
-  pollingInterval?: number
+  pollingInterval?: number | undefined
   /** The RPC transport */
-  transport: TTransport
+  transport: transport
   /** The type of client. */
-  type?: string
+  type?: string | undefined
 }
 
+// TODO: Move `transport` to slot index 2 since `chain` and `account` used more frequently.
+// Otherwise, we end up with a lot of `Client<Transport, chain, account>` in actions.
+export type Client<
+  transport extends Transport = Transport,
+  chain extends Chain | undefined = Chain | undefined,
+  account extends Account | undefined = Account | undefined,
+  rpcSchema extends RpcSchema | undefined = undefined,
+  extended extends Extended | undefined = Extended | undefined,
+> = Prettify<
+  Prettify<Client_Base<transport, chain, account, rpcSchema>> & {
+    extend: <const client extends Extended>(
+      fn: (
+        client: Client<transport, chain, account, rpcSchema, extended>,
+      ) => client,
+    ) => Prettify<
+      Client<
+        transport,
+        chain,
+        account,
+        rpcSchema,
+        Prettify<client> & (extended extends Extended ? extended : unknown)
+      >
+    >
+  } & (extended extends Extended ? extended : unknown)
+>
+
 type Client_Base<
-  TTransport extends Transport = Transport,
-  TChain extends Chain | undefined = Chain | undefined,
-  TAccount extends Account | undefined = Account | undefined,
-  TRpcSchema extends RpcSchema | undefined = undefined,
+  transport extends Transport = Transport,
+  chain extends Chain | undefined = Chain | undefined,
+  account extends Account | undefined = Account | undefined,
+  rpcSchema extends RpcSchema | undefined = undefined,
 > = {
   /** The Account of the Client. */
-  account: TAccount
+  account: account
   /** Flags for batch settings. */
-  batch?: {
-    /** Toggle to enable `eth_call` multicall aggregation. */
-    multicall?: boolean | MulticallBatchOptions
-  }
+  batch?: ClientConfig['batch']
   /** Chain for the client. */
-  chain: TChain
+  chain: chain
   /** A key for the client. */
   key: string
   /** A name for the client. */
@@ -74,86 +95,89 @@ type Client_Base<
   /** Frequency (in ms) for polling enabled actions & events. Defaults to 4_000 milliseconds. */
   pollingInterval: number
   /** Request function wrapped with friendly error handling */
-  request: TRpcSchema extends undefined
-    ? EIP1193RequestFn<EIP1474Methods>
-    : EIP1193RequestFn<TRpcSchema>
+  request: EIP1193RequestFn<
+    rpcSchema extends undefined ? EIP1474Methods : rpcSchema
+  >
   /** The RPC transport */
-  transport: ReturnType<TTransport>['config'] & ReturnType<TTransport>['value']
+  transport: ReturnType<transport>['config'] & ReturnType<transport>['value']
   /** The type of client. */
   type: string
   /** A unique ID for the client. */
   uid: string
 }
 
-type Extended = { [K in keyof Client_Base]?: undefined } & {
-  [key: string]: unknown
-}
+type Extended = Prettify<
+  // disallow redefining base properties
+  { [K in keyof Client_Base]?: undefined } & {
+    [key: string]: unknown
+  }
+>
 
-export type Client<
-  TTransport extends Transport = Transport,
-  TChain extends Chain | undefined = Chain | undefined,
-  TAccount extends Account | undefined = Account | undefined,
-  TRpcSchema extends RpcSchema | undefined = undefined,
-  TExtended extends Extended | undefined = Extended | undefined,
-> = Client_Base<TTransport, TChain, TAccount, TRpcSchema> & {
-  extend: <TNextExtended extends Extended = Extended>(
-    fn: (
-      client: Client<TTransport, TChain, TAccount, TRpcSchema, TExtended>,
-    ) => Narrow<TNextExtended>,
-  ) => Client<
-    TTransport,
-    TChain,
-    TAccount,
-    TRpcSchema,
-    (TExtended extends Extended ? TExtended : {}) & TNextExtended
-  >
-} & (TExtended extends Extended ? TExtended : {})
+export type MulticallBatchOptions = {
+  /** The maximum size (in bytes) for each calldata chunk. @default 1_024 */
+  batchSize?: number | undefined
+  /** The maximum number of milliseconds to wait before sending a batch. @default 0 */
+  wait?: number | undefined
+}
 
 /**
- * @description Creates a base client with the given transport.
+ * Creates a base client with the given transport.
  */
 export function createClient<
-  TTransport extends Transport,
-  TChain extends Chain | undefined = undefined,
-  TAccountOrAddress extends Account | Address | undefined = undefined,
->({
-  account,
-  batch,
-  chain,
-  key = 'base',
-  name = 'Base Client',
-  pollingInterval = 4_000,
+  transport extends Transport,
+  chain extends Chain | undefined = undefined,
+  accountOrAddress extends Account | Address | undefined = undefined,
+>(
+  parameters: ClientConfig<transport, chain, accountOrAddress>,
+): Client<
   transport,
-  type = 'base',
-}: ClientConfig<TTransport, TChain, TAccountOrAddress>): Client<
-  TTransport,
-  TChain,
-  TAccountOrAddress extends Address
-    ? Prettify<JsonRpcAccount<TAccountOrAddress>>
-    : TAccountOrAddress
-> {
-  const { config, request, value } = transport({ chain, pollingInterval })
+  chain,
+  accountOrAddress extends Address
+    ? Prettify<JsonRpcAccount<accountOrAddress>>
+    : accountOrAddress
+>
+
+export function createClient(parameters: ClientConfig): Client {
+  const {
+    batch,
+    key = 'base',
+    name = 'Base Client',
+    pollingInterval = 4_000,
+    type = 'base',
+  } = parameters
+
+  const chain = parameters.chain
+  const account = parameters.account
+    ? parseAccount(parameters.account)
+    : undefined
+  const { config, request, value } = parameters.transport({
+    chain,
+    pollingInterval,
+  })
+  const transport = { ...config, ...value }
+
   const client = {
-    account: (account
-      ? parseAccount(account)
-      : undefined) as ParseAccount<TAccountOrAddress>,
+    account,
     batch,
-    chain: chain as TChain,
+    chain,
     key,
     name,
     pollingInterval,
     request,
-    transport: { ...config, ...value },
+    transport,
     type,
     uid: uid(),
   }
-  function extend(client_: typeof client) {
-    return (fn: (_: typeof client) => unknown) => {
-      const extended = fn(client_) as Extended
+
+  function extend(base: typeof client) {
+    type ExtendFn = (base: typeof client) => unknown
+    return (extendFn: ExtendFn) => {
+      const extended = extendFn(base) as Extended
       for (const key in client) delete extended[key]
-      const nextClient = { ...client_, ...extended }
-      return Object.assign(nextClient, { extend: extend(nextClient) })
+      const combined = { ...base, ...extended }
+      return Object.assign(combined, { extend: extend(combined) })
     }
   }
+
   return Object.assign(client, { extend: extend(client) as any })
 }

package/src/clients/createPublicClient.ts

@@ -6,23 +6,25 @@ import { type PublicActions, publicActions } from './decorators/public.js'
 import type { Transport } from './transports/createTransport.js'
 
 export type PublicClientConfig<
-  TTransport extends Transport = Transport,
-  TChain extends Chain | undefined = Chain | undefined,
-> = Pick<
-  ClientConfig<TTransport, TChain>,
-  'batch' | 'chain' | 'key' | 'name' | 'pollingInterval' | 'transport'
+  transport extends Transport = Transport,
+  chain extends Chain | undefined = Chain | undefined,
+> = Prettify<
+  Pick<
+    ClientConfig<transport, chain>,
+    'batch' | 'chain' | 'key' | 'name' | 'pollingInterval' | 'transport'
+  >
 >
 
 export type PublicClient<
-  TTransport extends Transport = Transport,
-  TChain extends Chain | undefined = Chain | undefined,
+  transport extends Transport = Transport,
+  chain extends Chain | undefined = Chain | undefined,
 > = Prettify<
   Client<
-    TTransport,
-    TChain,
+    transport,
+    chain,
     undefined,
     PublicRpcSchema,
-    PublicActions<TTransport, TChain>
+    PublicActions<transport, chain>
   >
 >
 
@@ -46,23 +48,21 @@ export type PublicClient<
  * })
  */
 export function createPublicClient<
-  TTransport extends Transport,
-  TChain extends Chain | undefined = undefined,
->({
-  batch,
-  chain,
-  key = 'public',
-  name = 'Public Client',
-  transport,
-  pollingInterval,
-}: PublicClientConfig<TTransport, TChain>): PublicClient<TTransport, TChain> {
-  return createClient({
-    batch,
-    chain,
+  transport extends Transport,
+  chain extends Chain | undefined = undefined,
+>(
+  parameters: PublicClientConfig<transport, chain>,
+): PublicClient<transport, chain>
+
+export function createPublicClient(
+  parameters: PublicClientConfig,
+): PublicClient {
+  const { key = 'public', name = 'Public Client' } = parameters
+  const client = createClient({
+    ...parameters,
     key,
     name,
-    pollingInterval,
-    transport,
     type: 'publicClient',
-  }).extend(publicActions)
+  })
+  return client.extend(publicActions)
 }

package/src/clients/createTestClient.ts

@@ -2,6 +2,7 @@ import type { Account } from '../accounts/types.js'
 import type { ParseAccount } from '../types/account.js'
 import type { Chain } from '../types/chain.js'
 import type { TestRpcSchema } from '../types/eip1193.js'
+import type { Prettify } from '../types/utils.js'
 import { type Client, type ClientConfig, createClient } from './createClient.js'
 import { type TestActions, testActions } from './decorators/test.js'
 import type { Transport } from './transports/createTransport.js'
@@ -10,36 +11,38 @@ import type { Address } from 'abitype'
 export type TestClientMode = 'anvil' | 'hardhat' | 'ganache'
 
 export type TestClientConfig<
-  TMode extends TestClientMode = TestClientMode,
-  TTransport extends Transport = Transport,
-  TChain extends Chain | undefined = Chain | undefined,
-  TAccountOrAddress extends Account | Address | undefined =
+  mode extends TestClientMode = TestClientMode,
+  transport extends Transport = Transport,
+  chain extends Chain | undefined = Chain | undefined,
+  accountOrAddress extends Account | Address | undefined =
     | Account
     | Address
     | undefined,
-> = Pick<
-  ClientConfig<TTransport, TChain, TAccountOrAddress>,
-  'account' | 'chain' | 'key' | 'name' | 'pollingInterval' | 'transport'
-> & {
-  /** Mode of the test client. Available: "anvil" | "hardhat" | "ganache" */
-  mode: TMode
-}
+> = Prettify<
+  Pick<
+    ClientConfig<transport, chain, accountOrAddress>,
+    'account' | 'chain' | 'key' | 'name' | 'pollingInterval' | 'transport'
+  > & {
+    /** Mode of the test client. */
+    mode: mode | ('anvil' | 'hardhat' | 'ganache') // TODO: Type utility that expands `TestClientMode`
+  }
+>
 
 export type TestClient<
   TMode extends TestClientMode = TestClientMode,
-  TTransport extends Transport = Transport,
-  TChain extends Chain | undefined = Chain | undefined,
+  transport extends Transport = Transport,
+  chain extends Chain | undefined = Chain | undefined,
   TAccount extends Account | undefined = Account | undefined,
   TIncludeActions extends boolean = true,
-> = Client<
-  TTransport,
-  TChain,
-  TAccount,
-  TestRpcSchema<TMode>,
-  TIncludeActions extends true ? TestActions : Record<string, unknown>
-> & {
-  mode: TMode
-}
+> = Prettify<
+  { mode: TMode } & Client<
+    transport,
+    chain,
+    TAccount,
+    TestRpcSchema<TMode>,
+    TIncludeActions extends true ? TestActions : Record<string, unknown>
+  >
+>
 
 /**
  * @description Creates a test client with a given transport.
@@ -65,33 +68,24 @@ export type TestClient<
  * })
  */
 export function createTestClient<
-  TMode extends TestClientMode,
-  TTransport extends Transport,
-  TChain extends Chain | undefined = undefined,
-  TAccountOrAddress extends Account | Address | undefined = undefined,
->({
-  account,
-  chain,
-  key = 'test',
-  name = 'Test Client',
-  mode,
-  pollingInterval,
-  transport,
-}: TestClientConfig<TMode, TTransport, TChain, TAccountOrAddress>): TestClient<
-  TMode,
-  TTransport,
-  TChain,
-  ParseAccount<TAccountOrAddress>
-> {
-  return createClient({
-    account,
-    chain,
+  mode extends 'anvil' | 'hardhat' | 'ganache', // TODO: Type utility that expands `TestClientMode`
+  transport extends Transport,
+  chain extends Chain | undefined = undefined,
+  accountOrAddress extends Account | Address | undefined = undefined,
+>(
+  parameters: TestClientConfig<mode, transport, chain, accountOrAddress>,
+): TestClient<mode, transport, chain, ParseAccount<accountOrAddress>>
+
+export function createTestClient(parameters: TestClientConfig): TestClient {
+  const { key = 'test', name = 'Test Client', mode } = parameters
+  const client = createClient({
+    ...parameters,
     key,
     name,
-    pollingInterval,
-    transport,
     type: 'testClient',
   })
-    .extend(() => ({ mode }))
-    .extend(testActions({ mode }))
+  return client.extend((config) => ({
+    mode,
+    ...testActions({ mode })(config),
+  }))
 }