wagmi 2.0.0-beta.8 → 2.0.0-rc.0

package/dist/types/hooks/useWriteContract.d.ts

@@ -10,6 +10,6 @@ export type UseWriteContractReturnType<config extends Config = Config, context =
     writeContract: WriteContractMutate<config, context>;
     writeContractAsync: WriteContractMutateAsync<config, context>;
 };
-/** https://beta.wagmi.sh/react/api/hooks/useWriteContract */
+/** https://rc.wagmi.sh/react/api/hooks/useWriteContract */
 export declare function useWriteContract<config extends Config = ResolvedRegister['config'], context = unknown>(parameters?: UseWriteContractParameters<config, context>): UseWriteContractReturnType<config, context>;
 //# sourceMappingURL=useWriteContract.d.ts.map

package/dist/types/hooks/useWriteContract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWriteContract.d.ts","sourceRoot":"","sources":["../../../src/hooks/useWriteContract.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,MAAM,EACN,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAE5B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,mBAAmB,CAAA;AAG1B,MAAM,MAAM,0BAA0B,CACpC,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,OAAO,GAAG,OAAO,IACf,eAAe,CAAC,MAAM,CAAC,GAAG;IAC5B,QAAQ,CAAC,EACL,qBAAqB,CACnB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,CACpB,GAAG,EACH,MAAM,EACN,SAAS,OAAO,EAAE,EAClB,MAAM,EACN,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAC/B,EACD,OAAO,CACR,GACD,SAAS,CAAA;CACd,CAAA;AAED,MAAM,MAAM,0BAA0B,CACpC,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,OAAO,GAAG,OAAO,IACf,qBAAqB,CACvB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,CACpB,GAAG,EACH,MAAM,EACN,SAAS,OAAO,EAAE,EAClB,MAAM,EACN,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAC/B,EACD,OAAO,CACR,GAAG;IACF,aAAa,EAAE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnD,kBAAkB,EAAE,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9D,CAAA;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAC9B,MAAM,SAAS,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,EAClD,OAAO,GAAG,OAAO,EAEjB,UAAU,GAAE,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAM,GAC3D,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB7C"}
+{"version":3,"file":"useWriteContract.d.ts","sourceRoot":"","sources":["../../../src/hooks/useWriteContract.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,MAAM,EACN,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAE5B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,mBAAmB,CAAA;AAG1B,MAAM,MAAM,0BAA0B,CACpC,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,OAAO,GAAG,OAAO,IACf,eAAe,CAAC,MAAM,CAAC,GAAG;IAC5B,QAAQ,CAAC,EACL,qBAAqB,CACnB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,CACpB,GAAG,EACH,MAAM,EACN,SAAS,OAAO,EAAE,EAClB,MAAM,EACN,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAC/B,EACD,OAAO,CACR,GACD,SAAS,CAAA;CACd,CAAA;AAED,MAAM,MAAM,0BAA0B,CACpC,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,OAAO,GAAG,OAAO,IACf,qBAAqB,CACvB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,CACpB,GAAG,EACH,MAAM,EACN,SAAS,OAAO,EAAE,EAClB,MAAM,EACN,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAC/B,EACD,OAAO,CACR,GAAG;IACF,aAAa,EAAE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnD,kBAAkB,EAAE,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9D,CAAA;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAC9B,MAAM,SAAS,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,EAClD,OAAO,GAAG,OAAO,EAEjB,UAAU,GAAE,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAM,GAC3D,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB7C"}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "2.0.0-beta.8";
+export declare const version = "2.0.0-rc.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/types/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,iBAAiB,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,eAAe,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wagmi",
   "description": "React Hooks for Ethereum",
-  "version": "2.0.0-beta.8",
+  "version": "2.0.0-rc.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -75,7 +75,7 @@
     "@tanstack/react-query": ">=5.0.0",
     "react": ">=18",
     "typescript": ">=5.0.4",
-    "viem": "2.0.0-beta.15"
+    "viem": "2.0.0-rc.0"
   },
   "peerDependenciesMeta": {
     "typescript": {
@@ -83,9 +83,9 @@
     }
   },
   "dependencies": {
-    "use-sync-external-store": "^1.2.0",
-    "@wagmi/connectors": "4.0.0-beta.8",
-    "@wagmi/core": "2.0.0-beta.8"
+    "use-sync-external-store": "1.2.0",
+    "@wagmi/connectors": "4.0.0-rc.0",
+    "@wagmi/core": "2.0.0-rc.0"
   },
   "contributors": [
     "awkweb.eth <t@wevm.dev>",

package/src/errors/base.ts

@@ -6,7 +6,7 @@ export type BaseErrorType = BaseError & { name: 'WagmiError' }
 export class BaseError extends CoreError {
   override name = 'WagmiError'
   override get docsBaseUrl() {
-    return 'https://beta.wagmi.sh/react'
+    return 'https://rc.wagmi.sh/react'
   }
   override get version() {
     return getVersion()

package/src/errors/context.ts

@@ -7,7 +7,7 @@ export class WagmiProviderNotFoundError extends BaseError {
   override name = 'WagmiProviderNotFoundError'
   constructor() {
     super('`useConfig` must be used within `WagmiProvider`.', {
-      docsPath: 'https://beta.wagmi.sh/react/api/WagmiProvider',
+      docsPath: 'https://rc.wagmi.sh/react/api/WagmiProvider',
     })
   }
 }

package/src/exports/actions.ts

@@ -1,4 +1,5 @@
 ////////////////////////////////////////////////////////////////////////////////
-// @wagmi/core/api/actions
+// @wagmi/core/actions
+////////////////////////////////////////////////////////////////////////////////
 
 export * from '@wagmi/core/actions'

package/src/exports/chains.ts

@@ -1,4 +1,5 @@
 ////////////////////////////////////////////////////////////////////////////////
 // viem/chains
+////////////////////////////////////////////////////////////////////////////////
 
 export * from 'viem/chains'

package/src/exports/codegen.ts

@@ -1,3 +1,17 @@
-export { createReadContract } from '../hooks/codegen/createReadContract.js'
+////////////////////////////////////////////////////////////////////////////////
+// @wagmi/core/codegen
+////////////////////////////////////////////////////////////////////////////////
 
-export { createWriteContract } from '../hooks/codegen/createWriteContract.js'
+export * from '@wagmi/core/codegen'
+
+////////////////////////////////////////////////////////////////////////////////
+// Hooks
+////////////////////////////////////////////////////////////////////////////////
+
+export { createUseSimulateContract } from '../hooks/codegen/createUseSimulateContract.js'
+
+export { createUseReadContract } from '../hooks/codegen/createUseReadContract.js'
+
+export { createUseWatchContractEvent } from '../hooks/codegen/createUseWatchContractEvent.js'
+
+export { createUseWriteContract } from '../hooks/codegen/createUseWriteContract.js'

package/src/exports/connectors.ts

@@ -1,4 +1,5 @@
 ////////////////////////////////////////////////////////////////////////////////
 // @wagmi/connectors
+////////////////////////////////////////////////////////////////////////////////
 
 export * from '@wagmi/connectors'

package/src/exports/index.ts

@@ -1,5 +1,6 @@
 ////////////////////////////////////////////////////////////////////////////////
 // Context
+////////////////////////////////////////////////////////////////////////////////
 
 export {
   type WagmiProviderProps,
@@ -13,6 +14,7 @@ export {
 
 ////////////////////////////////////////////////////////////////////////////////
 // Errors
+////////////////////////////////////////////////////////////////////////////////
 
 export { type BaseErrorType, BaseError } from '../errors/base.js'
 
@@ -23,6 +25,7 @@ export {
 
 ////////////////////////////////////////////////////////////////////////////////
 // Hooks
+////////////////////////////////////////////////////////////////////////////////
 
 export {
   type UseAccountParameters,
@@ -53,6 +56,12 @@ export {
   useBlockNumber,
 } from '../hooks/useBlockNumber.js'
 
+export {
+  type UseBlockTransactionCountParameters,
+  type UseBlockTransactionCountReturnType,
+  useBlockTransactionCount,
+} from '../hooks/useBlockTransactionCount.js'
+
 export {
   type UseChainIdParameters,
   type UseChainIdReturnType,
@@ -139,6 +148,24 @@ export {
   useEstimateGas,
 } from '../hooks/useEstimateGas.js'
 
+export {
+  type UseEstimateMaxPriorityFeePerGasParameters,
+  type UseEstimateMaxPriorityFeePerGasReturnType,
+  useEstimateMaxPriorityFeePerGas,
+} from '../hooks/useEstimateMaxPriorityFeePerGas.js'
+
+export {
+  type UseFeeHistoryParameters,
+  type UseFeeHistoryReturnType,
+  useFeeHistory,
+} from '../hooks/useFeeHistory.js'
+
+export {
+  type UseGasPriceParameters,
+  type UseGasPriceReturnType,
+  useGasPrice,
+} from '../hooks/useGasPrice.js'
+
 export {
   type UseInfiniteContractReadsParameters,
   type UseInfiniteContractReadsReturnType,
@@ -230,6 +257,18 @@ export {
   useTransactionCount,
 } from '../hooks/useTransactionCount.js'
 
+export {
+  type UseVerifyMessageParameters,
+  type UseVerifyMessageReturnType,
+  useVerifyMessage,
+} from '../hooks/useVerifyMessage.js'
+
+export {
+  type UseVerifyTypedDataParameters,
+  type UseVerifyTypedDataReturnType,
+  useVerifyTypedData,
+} from '../hooks/useVerifyTypedData.js'
+
 export {
   type UseWalletClientParameters,
   type UseWalletClientReturnType,
@@ -275,7 +314,8 @@ export {
 } from '../hooks/useWriteContract.js'
 
 ////////////////////////////////////////////////////////////////////////////////
-// hydrate
+// Hydrate
+////////////////////////////////////////////////////////////////////////////////
 
 export {
   type HydrateProps,
@@ -284,6 +324,7 @@ export {
 
 ////////////////////////////////////////////////////////////////////////////////
 // @wagmi/core
+////////////////////////////////////////////////////////////////////////////////
 
 export {
   // Config
@@ -336,5 +377,6 @@ export {
 
 ////////////////////////////////////////////////////////////////////////////////
 // Version
+////////////////////////////////////////////////////////////////////////////////
 
 export { version } from '../version.js'

package/src/exports/query.ts

@@ -1,4 +1,5 @@
 ////////////////////////////////////////////////////////////////////////////////
 // @wagmi/core/query
+////////////////////////////////////////////////////////////////////////////////
 
 export * from '@wagmi/core/query'

package/src/hooks/codegen/{createReadContract.ts → createUseReadContract.ts}

@@ -22,7 +22,10 @@ import {
   type ContractFunctionName,
 } from 'viem'
 
-import type { ConfigParameter, QueryParameter } from '../../types/properties.js'
+import {
+  type ConfigParameter,
+  type QueryParameter,
+} from '../../types/properties.js'
 import { useAccount } from '../useAccount.js'
 import { useChainId } from '../useChainId.js'
 import {
@@ -32,58 +35,72 @@ import {
 
 type stateMutability = 'pure' | 'view'
 
-export type CreateReadContractParameters<
+export type CreateUseReadContractParameters<
   abi extends Abi | readonly unknown[],
   address extends Address | Record<number, Address> | undefined = undefined,
+  functionName extends
+    | ContractFunctionName<abi, stateMutability>
+    | undefined = undefined,
 > = {
   abi: abi | Abi | readonly unknown[]
   address?: address | Address | Record<number, Address> | undefined
+  functionName?:
+    | functionName
+    | ContractFunctionName<abi, stateMutability>
+    | undefined
 }
 
-export type CreateReadContractReturnType<
+export type CreateUseReadContractReturnType<
   abi extends Abi | readonly unknown[],
   address extends Address | Record<number, Address> | undefined,
+  functionName extends ContractFunctionName<abi, stateMutability> | undefined,
   ///
-  omittedProperties extends 'abi' | 'address' | 'chainId' =
+  omittedProperties extends 'abi' | 'address' | 'chainId' | 'functionName' =
     | 'abi'
     | (address extends undefined ? never : 'address')
-    | (address extends Record<number, Address> ? 'chainId' : never),
+    | (address extends Record<number, Address> ? 'chainId' : never)
+    | (functionName extends undefined ? never : 'functionName'),
 > = <
-  functionName extends ContractFunctionName<abi, stateMutability>,
-  args extends ContractFunctionArgs<abi, stateMutability, functionName>,
+  name extends functionName extends ContractFunctionName<abi, stateMutability>
+    ? functionName
+    : ContractFunctionName<abi, stateMutability>,
+  args extends ContractFunctionArgs<abi, stateMutability, name>,
   config extends Config = ResolvedRegister['config'],
-  selectData = ReadContractData<abi, functionName, args>,
+  selectData = ReadContractData<abi, name, args>,
 >(
   parameters?: UnionEvaluate<
     UnionPartial<
       UnionOmit<
-        ReadContractParameters<abi, functionName, args, config>,
+        ReadContractParameters<abi, name, args, config>,
         omittedProperties
       >
     > &
       ScopeKeyParameter &
       ConfigParameter<config> &
       QueryParameter<
-        ReadContractQueryFnData<abi, functionName, args>,
+        ReadContractQueryFnData<abi, name, args>,
         ReadContractErrorType,
         selectData,
-        ReadContractQueryKey<abi, functionName, args, config>
+        ReadContractQueryKey<abi, name, args, config>
       >
   > &
     (address extends Record<number, Address>
       ? { chainId?: keyof address | undefined }
       : unknown),
-) => UseReadContractReturnType<abi, functionName, args, selectData>
+) => UseReadContractReturnType<abi, name, args, selectData>
 
-export function createReadContract<
+export function createUseReadContract<
   const abi extends Abi | readonly unknown[],
   const address extends
     | Address
     | Record<number, Address>
     | undefined = undefined,
+  functionName extends
+    | ContractFunctionName<abi, stateMutability>
+    | undefined = undefined,
 >(
-  config: CreateReadContractParameters<abi, address>,
-): CreateReadContractReturnType<abi, address> {
+  config: CreateUseReadContractParameters<abi, address, functionName>,
+): CreateUseReadContractReturnType<abi, address, functionName> {
   if (config.address !== undefined && typeof config.address === 'object')
     return (parameters) => {
       const configChainId = useChainId()
@@ -92,11 +109,20 @@ export function createReadContract<
         (parameters as { chainId?: number })?.chainId ??
         account.chainId ??
         configChainId
-      const address = config.address?.[chainId]
-      return useReadContract({ ...(parameters as any), ...config, address })
+      return useReadContract({
+        ...(parameters as any),
+        ...(config.functionName ? { functionName: config.functionName } : {}),
+        address: config.address?.[chainId],
+        abi: config.abi,
+      })
     }
 
   return (parameters) => {
-    return useReadContract({ ...(parameters as any), ...config })
+    return useReadContract({
+      ...(parameters as any),
+      ...(config.address ? { address: config.address } : {}),
+      ...(config.functionName ? { functionName: config.functionName } : {}),
+      abi: config.abi,
+    })
   }
 }

package/src/hooks/codegen/createUseSimulateContract.ts

@@ -0,0 +1,121 @@
+import {
+  type Config,
+  type ResolvedRegister,
+  type SimulateContractErrorType,
+  type SimulateContractParameters,
+} from '@wagmi/core'
+import { type ScopeKeyParameter, type UnionPartial } from '@wagmi/core/internal'
+import {
+  type SimulateContractData,
+  type SimulateContractQueryFnData,
+  type SimulateContractQueryKey,
+} from '@wagmi/core/query'
+import {
+  type Abi,
+  type Address,
+  type ContractFunctionArgs,
+  type ContractFunctionName,
+} from 'viem'
+
+import {
+  type ConfigParameter,
+  type QueryParameter,
+} from '../../types/properties.js'
+import { useAccount } from '../useAccount.js'
+import { useChainId } from '../useChainId.js'
+import {
+  type UseSimulateContractReturnType,
+  useSimulateContract,
+} from '../useSimulateContract.js'
+
+type stateMutability = 'nonpayable' | 'payable'
+
+export type CreateUseSimulateContractParameters<
+  abi extends Abi | readonly unknown[],
+  address extends Address | Record<number, Address> | undefined = undefined,
+  functionName extends
+    | ContractFunctionName<abi, stateMutability>
+    | undefined = undefined,
+> = {
+  abi: abi | Abi | readonly unknown[]
+  address?: address | Address | Record<number, Address> | undefined
+  functionName?:
+    | functionName
+    | ContractFunctionName<abi, stateMutability>
+    | undefined
+}
+
+export type CreateUseSimulateContractReturnType<
+  abi extends Abi | readonly unknown[],
+  address extends Address | Record<number, Address> | undefined,
+  functionName extends ContractFunctionName<abi, stateMutability> | undefined,
+> = <
+  name extends functionName extends ContractFunctionName<abi, stateMutability>
+    ? functionName
+    : ContractFunctionName<abi, stateMutability>,
+  args extends ContractFunctionArgs<abi, stateMutability, name>,
+  config extends Config = ResolvedRegister['config'],
+  chainId extends config['chains'][number]['id'] | undefined = undefined,
+  selectData = SimulateContractData<abi, name, args, config, chainId>,
+>(
+  parameters?: {
+    abi?: undefined
+    address?: address extends undefined ? Address : undefined
+    functionName?: functionName extends undefined ? name : undefined
+    chainId?: address extends Record<number, Address>
+      ?
+          | keyof address
+          | (chainId extends keyof address ? chainId : never)
+          | undefined
+      : chainId | number | undefined
+  } & UnionPartial<
+    // TODO: Take `abi` and `address` from above and omit from below (currently breaks inference)
+    SimulateContractParameters<abi, name, args, config, chainId>
+  > &
+    ScopeKeyParameter &
+    ConfigParameter<config> &
+    QueryParameter<
+      SimulateContractQueryFnData<abi, name, args, config, chainId>,
+      SimulateContractErrorType,
+      selectData,
+      SimulateContractQueryKey<abi, name, args, config, chainId>
+    >,
+) => UseSimulateContractReturnType<abi, name, args, config, chainId, selectData>
+
+export function createUseSimulateContract<
+  const abi extends Abi | readonly unknown[],
+  const address extends
+    | Address
+    | Record<number, Address>
+    | undefined = undefined,
+  functionName extends
+    | ContractFunctionName<abi, stateMutability>
+    | undefined = undefined,
+>(
+  config: CreateUseSimulateContractParameters<abi, address, functionName>,
+): CreateUseSimulateContractReturnType<abi, address, functionName> {
+  if (config.address !== undefined && typeof config.address === 'object')
+    return (parameters) => {
+      const configChainId = useChainId()
+      const account = useAccount()
+      const chainId =
+        (parameters as { chainId?: number })?.chainId ??
+        account.chainId ??
+        configChainId
+      return useSimulateContract({
+        ...(parameters as any),
+        ...(config.functionName ? { functionName: config.functionName } : {}),
+        address: config.address?.[chainId],
+        abi: config.abi,
+      })
+    }
+
+  return (parameters) => {
+    return useSimulateContract({
+      ...(parameters as any),
+      ...(config.address ? { address: config.address } : {}),
+      ...(config.functionName ? { functionName: config.functionName } : {}),
+      abi: config.abi,
+    })
+  }
+}

package/src/hooks/codegen/createUseWatchContractEvent.ts

@@ -0,0 +1,98 @@
+import {
+  type Config,
+  type ResolvedRegister,
+  type WatchContractEventParameters,
+} from '@wagmi/core'
+import {
+  type UnionEvaluate,
+  type UnionOmit,
+  type UnionPartial,
+} from '@wagmi/core/internal'
+import { type Abi, type Address, type ContractEventName } from 'viem'
+
+import {
+  type ConfigParameter,
+  type EnabledParameter,
+} from '../../types/properties.js'
+import { useAccount } from '../useAccount.js'
+import { useChainId } from '../useChainId.js'
+import { useWatchContractEvent } from '../useWatchContractEvent.js'
+
+export type CreateUseWatchContractEventParameters<
+  abi extends Abi | readonly unknown[],
+  address extends Address | Record<number, Address> | undefined = undefined,
+  eventName extends ContractEventName<abi> | undefined = undefined,
+> = {
+  abi: abi | Abi | readonly unknown[]
+  address?: address | Address | Record<number, Address> | undefined
+  eventName?: eventName | ContractEventName<abi> | undefined
+}
+
+export type CreateUseWatchContractEventReturnType<
+  abi extends Abi | readonly unknown[],
+  address extends Address | Record<number, Address> | undefined,
+  eventName extends ContractEventName<abi> | undefined,
+  ///
+  omittedProperties extends 'abi' | 'address' | 'chainId' | 'eventName' =
+    | 'abi'
+    | (address extends undefined ? never : 'address')
+    | (address extends Record<number, Address> ? 'chainId' : never)
+    | (eventName extends undefined ? never : 'eventName'),
+> = <
+  name extends eventName extends ContractEventName<abi>
+    ? eventName
+    : ContractEventName<abi>,
+  strict extends boolean | undefined = undefined,
+  config extends Config = ResolvedRegister['config'],
+  chainId extends config['chains'][number]['id'] = config['chains'][number]['id'],
+>(
+  parameters?: UnionEvaluate<
+    UnionPartial<
+      UnionOmit<
+        WatchContractEventParameters<abi, name, strict, config, chainId>,
+        omittedProperties
+      >
+    > &
+      ConfigParameter<config> &
+      EnabledParameter
+  > &
+    (address extends Record<number, Address>
+      ? { chainId?: keyof address | undefined }
+      : unknown),
+) => void
+
+export function createUseWatchContractEvent<
+  const abi extends Abi | readonly unknown[],
+  const address extends
+    | Address
+    | Record<number, Address>
+    | undefined = undefined,
+  eventName extends ContractEventName<abi> | undefined = undefined,
+>(
+  config: CreateUseWatchContractEventParameters<abi, address, eventName>,
+): CreateUseWatchContractEventReturnType<abi, address, eventName> {
+  if (config.address !== undefined && typeof config.address === 'object')
+    return (parameters) => {
+      const configChainId = useChainId()
+      const account = useAccount()
+      const chainId =
+        (parameters as { chainId?: number })?.chainId ??
+        account.chainId ??
+        configChainId
+      return useWatchContractEvent({
+        ...(parameters as any),
+        ...(config.eventName ? { eventName: config.eventName } : {}),
+        address: config.address?.[chainId],
+        abi: config.abi,
+      })
+    }
+
+  return (parameters) => {
+    return useWatchContractEvent({
+      ...(parameters as any),
+      ...(config.address ? { address: config.address } : {}),
+      ...(config.eventName ? { eventName: config.eventName } : {}),
+      abi: config.abi,
+    })
+  }
+}