viem 0.0.0-tsc-and-nodenext-20230405154910 → 0.0.0-w-20230711200108

package/src/actions/getContract.ts

@@ -10,41 +10,55 @@ import type {
   ExtractAbiFunctionNames,
   Narrow,
 } from 'abitype'
-import type { PublicClient, Transport, WalletClient } from '../clients/index.js'
+
+import type { Account } from '../accounts/types.js'
+import type { PublicClient } from '../clients/createPublicClient.js'
+import type { WalletClient } from '../clients/createWalletClient.js'
+import type { Transport } from '../clients/transports/createTransport.js'
+import type { Chain } from '../types/chain.js'
 import type {
   AbiEventParametersToPrimitiveTypes,
-  Account,
-  Chain,
+  MaybeExtractEventArgsFromAbi,
+} from '../types/contract.js'
+import type {
   IsNarrowable,
   IsNever,
   IsUndefined,
-  MaybeExtractEventArgsFromAbi,
+  Or,
   Prettify,
-} from '../types/index.js'
+  UnionOmit,
+} from '../types/utils.js'
+
 import {
+  type CreateContractEventFilterParameters,
+  type CreateContractEventFilterReturnType,
   createContractEventFilter,
+} from './public/createContractEventFilter.js'
+import {
+  type EstimateContractGasParameters,
+  type EstimateContractGasReturnType,
+  estimateContractGas,
+} from './public/estimateContractGas.js'
+import {
+  type ReadContractParameters,
+  type ReadContractReturnType,
   readContract,
+} from './public/readContract.js'
+import {
+  type SimulateContractParameters,
+  type SimulateContractReturnType,
   simulateContract,
-  estimateContractGas,
+} from './public/simulateContract.js'
+import {
+  type WatchContractEventParameters,
+  type WatchContractEventReturnType,
   watchContractEvent,
-} from './public/index.js'
-import type {
-  WatchContractEventParameters,
-  WatchContractEventReturnType,
-  ReadContractParameters,
-  ReadContractReturnType,
-  SimulateContractParameters,
-  EstimateContractGasParameters,
-  CreateContractEventFilterParameters,
-  CreateContractEventFilterReturnType,
-  EstimateContractGasReturnType,
-  SimulateContractReturnType,
-} from './public/index.js'
-import { writeContract } from './wallet/index.js'
-import type {
-  WriteContractParameters,
-  WriteContractReturnType,
-} from './wallet/index.js'
+} from './public/watchContractEvent.js'
+import {
+  type WriteContractParameters,
+  type WriteContractReturnType,
+  writeContract,
+} from './wallet/writeContract.js'
 
 export type GetContractParameters<
   TTransport extends Transport = Transport,
@@ -55,14 +69,32 @@ export type GetContractParameters<
   TWalletClient extends
     | WalletClient<TTransport, TChain, TAccount>
     | unknown = unknown,
+  TAddress extends Address = Address,
 > = {
   /** Contract ABI */
   abi: Narrow<TAbi>
   /** Contract address */
-  address: Address
-  /** Public client */
+  address: TAddress
+  /**
+   * Public client
+   *
+   * If you pass in a [`publicClient`](https://viem.sh/docs/clients/public.html), the following methods are available:
+   *
+   * - [`createEventFilter`](https://viem.sh/docs/contract/createContractEventFilter.html)
+   * - [`estimateGas`](https://viem.sh/docs/contract/estimateContractGas.html)
+   * - [`read`](https://viem.sh/docs/contract/readContract.html)
+   * - [`simulate`](https://viem.sh/docs/contract/simulateContract.html)
+   * - [`watchEvent`](https://viem.sh/docs/contract/watchContractEvent.html)
+   */
   publicClient?: TPublicClient
-  /** Wallet client */
+  /**
+   * Wallet client
+   *
+   * If you pass in a [`walletClient`](https://viem.sh/docs/clients/wallet.html), the following methods are available:
+   *
+   * - [`estimateGas`](https://viem.sh/docs/contract/estimateContractGas.html)
+   * - [`write`](https://viem.sh/docs/contract/writeContract.html)
+   */
   walletClient?: TWalletClient
 }
 
@@ -70,6 +102,7 @@ export type GetContractReturnType<
   TAbi extends Abi | readonly unknown[] = Abi,
   TPublicClient extends PublicClient | unknown = unknown,
   TWalletClient extends WalletClient | unknown = unknown,
+  TAddress extends Address = Address,
   _EventNames extends string = TAbi extends Abi
     ? Abi extends TAbi
       ? string
@@ -97,6 +130,24 @@ export type GetContractReturnType<
              * A "read-only" function (constant function) on a Solidity contract is denoted by a `view` or `pure` keyword. They can only read the state of the contract, and cannot make any changes to it. Since read-only methods do not change the state of the contract, they do not require any gas to be executed, and can be called by any user without the need to pay for gas.
              *
              * Internally, `read` uses a [Public Client](https://viem.sh/docs/clients/public.html) to call the [`call` action](https://viem.sh/docs/actions/public/call.html) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData.html).
+             *
+             * @example
+             * import { createPublicClient, getContract, http, parseAbi } from 'viem'
+             * import { mainnet } from 'viem/chains'
+             *
+             * const publicClient = createPublicClient({
+             *   chain: mainnet,
+             *   transport: http(),
+             * })
+             * const contract = getContract({
+             *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+             *   abi: parseAbi([
+             *     'function balanceOf(address owner) view returns (uint256)',
+             *   ]),
+             *   publicClient,
+             * })
+             * const result = await contract.read.balanceOf(['0xA0Cf798816D4b9b9866b5330EEa46a18382f251e'])
+             * // 424122n
              */
             read: {
               [FunctionName in _ReadFunctionNames]: GetReadFunction<
@@ -111,13 +162,29 @@ export type GetContractReturnType<
           : {
               /**
                * Estimates the gas necessary to complete a transaction without submitting it to the network.
+               *
+               * @example
+               * import { createPublicClient, getContract, http, parseAbi } from 'viem'
+               * import { mainnet } from 'viem/chains'
+               *
+               * const publicClient = createPublicClient({
+               *   chain: mainnet,
+               *   transport: http(),
+               * })
+               * const contract = getContract({
+               *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+               *   abi: parseAbi(['function mint() public']),
+               *   publicClient,
+               * })
+               * const gas = await contract.estimateGas.mint({
+               *   account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+               * })
                */
               estimateGas: {
                 [FunctionName in _WriteFunctionNames]: GetEstimateFunction<
                   _Narrowable,
-                  TPublicClient extends PublicClient
-                    ? TPublicClient['chain']
-                    : undefined,
+                  TPublicClient['chain'],
+                  undefined,
                   TAbi,
                   FunctionName
                 >
@@ -128,13 +195,28 @@ export type GetContractReturnType<
                * This function does not require gas to execute and does not change the state of the blockchain. It is almost identical to [`readContract`](https://viem.sh/docs/contract/readContract.html), but also supports contract write functions.
                *
                * Internally, `simulate` uses a [Public Client](https://viem.sh/docs/clients/public.html) to call the [`call` action](https://viem.sh/docs/actions/public/call.html) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData.html).
+               *
+               * @example
+               * import { createPublicClient, getContract, http, parseAbi } from 'viem'
+               * import { mainnet } from 'viem/chains'
+               *
+               * const publicClient = createPublicClient({
+               *   chain: mainnet,
+               *   transport: http(),
+               * })
+               * const contract = getContract({
+               *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+               *   abi: parseAbi(['function mint() public']),
+               *   publicClient,
+               * })
+               * const result = await contract.simulate.mint({
+               *   account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+               * })
                */
               simulate: {
                 [FunctionName in _WriteFunctionNames]: GetSimulateFunction<
                   _Narrowable,
-                  TPublicClient extends PublicClient
-                    ? TPublicClient['chain']
-                    : undefined,
+                  TPublicClient['chain'],
                   TAbi,
                   FunctionName
                 >
@@ -145,6 +227,21 @@ export type GetContractReturnType<
           : {
               /**
                * Creates a Filter to retrieve event logs that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html) or [`getFilterLogs`](https://viem.sh/docs/actions/public/getFilterLogs.html).
+               *
+               * @example
+               * import { createPublicClient, getContract, http, parseAbi } from 'viem'
+               * import { mainnet } from 'viem/chains'
+               *
+               * const publicClient = createPublicClient({
+               *   chain: mainnet,
+               *   transport: http(),
+               * })
+               * const contract = getContract({
+               *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+               *   abi: parseAbi(['event Transfer(address indexed, address indexed, uint256)']),
+               *   publicClient,
+               * })
+               * const filter = await contract.createEventFilter.Transfer()
                */
               createEventFilter: {
                 [EventName in _EventNames]: GetEventFilter<
@@ -159,6 +256,25 @@ export type GetContractReturnType<
                * This Action will batch up all the event logs found within the [`pollingInterval`](https://viem.sh/docs/contract/watchContractEvent.html#pollinginterval-optional), and invoke them via [`onLogs`](https://viem.sh/docs/contract/watchContractEvent.html#onLogs).
                *
                * `watchEvent` will attempt to create an [Event Filter](https://viem.sh/docs/contract/createContractEventFilter.html) and listen to changes to the Filter per polling interval, however, if the RPC Provider does not support Filters (e.g. `eth_newFilter`), then `watchEvent` will fall back to using [`getLogs`](https://viem.sh/docs/actions/public/getLogs.html) instead.
+               *
+               * @example
+               * import { createPublicClient, getContract, http, parseAbi } from 'viem'
+               * import { mainnet } from 'viem/chains'
+               *
+               * const publicClient = createPublicClient({
+               *   chain: mainnet,
+               *   transport: http(),
+               * })
+               * const contract = getContract({
+               *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+               *   abi: parseAbi(['event Transfer(address indexed, address indexed, uint256)']),
+               *   publicClient,
+               * })
+               * const filter = await contract.createEventFilter.Transfer()
+               * const unwatch = contract.watchEvent.Transfer(
+               *   { from: '0xc961145a54C96E3aE9bAA048c4F4D6b04C13916b' },
+               *   { onLogs: (logs) => console.log(logs) },
+               * )
                */
               watchEvent: {
                 [EventName in _EventNames]: GetWatchEvent<
@@ -173,6 +289,35 @@ export type GetContractReturnType<
       ? IsNever<_WriteFunctionNames> extends true
         ? unknown
         : {
+            /**
+             * Estimates the gas necessary to complete a transaction without submitting it to the network.
+             *
+             * @example
+             * import { createWalletClient, getContract, http, parseAbi } from 'viem'
+             * import { mainnet } from 'viem/chains'
+             *
+             * const walletClient = createWalletClient({
+             *   chain: mainnet,
+             *   transport: http(),
+             * })
+             * const contract = getContract({
+             *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+             *   abi: parseAbi(['function mint() public']),
+             *   walletClient,
+             * })
+             * const gas = await contract.estimateGas.mint({
+             *   account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+             * })
+             */
+            estimateGas: {
+              [FunctionName in _WriteFunctionNames]: GetEstimateFunction<
+                _Narrowable,
+                TWalletClient['chain'],
+                TWalletClient['account'],
+                TAbi,
+                FunctionName
+              >
+            }
             /**
              * Executes a write function on a contract.
              *
@@ -180,30 +325,66 @@ export type GetContractReturnType<
              *
              * Internally, `write` uses a [Wallet Client](https://viem.sh/docs/clients/wallet.html) to call the [`sendTransaction` action](https://viem.sh/docs/actions/wallet/sendTransaction.html) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData.html).
              *
-             * Warning: The `write` internally sends a transaction – it does not validate if the contract write will succeed (the contract may throw an error). It is highly recommended to [simulate the contract write with `contract.simulate`](https://viem.sh/docs/contract/writeContract.html#usage) before you execute it.
+             * __Warning: The `write` internally sends a transaction – it does not validate if the contract write will succeed (the contract may throw an error). It is highly recommended to [simulate the contract write with `contract.simulate`](https://viem.sh/docs/contract/writeContract.html#usage) before you execute it.__
+             *
+             * @example
+             * import { createWalletClient, getContract, http, parseAbi } from 'viem'
+             * import { mainnet } from 'viem/chains'
+             *
+             * const walletClient = createWalletClient({
+             *   chain: mainnet,
+             *   transport: http(),
+             * })
+             * const contract = getContract({
+             *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+             *   abi: parseAbi(['function mint(uint32 tokenId) nonpayable']),
+             *   walletClient,
+             * })
+             * const hash = await contract.write.min([69420], {
+             *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+             * })
              */
             write: {
               [FunctionName in _WriteFunctionNames]: GetWriteFunction<
                 _Narrowable,
-                TWalletClient extends WalletClient
-                  ? TWalletClient['chain']
-                  : undefined,
-                TWalletClient extends WalletClient
-                  ? TWalletClient['account']
-                  : undefined,
+                TWalletClient['chain'],
+                TWalletClient['account'],
                 TAbi,
                 FunctionName
               >
             }
           }
       : unknown)
->
+> & { address: TAddress; abi: TAbi }
 
 /**
- * Gets type-safe contract instance.
+ * Gets type-safe interface for performing contract-related actions with a specific `abi` and `address`.
+ *
+ * - Docs https://viem.sh/docs/contract/getContract.html
+ *
+ * Using Contract Instances can make it easier to work with contracts if you don't want to pass the `abi` and `address` properites every time you perform contract actions, e.g. [`readContract`](https://viem.sh/docs/contract/readContract.html), [`writeContract`](https://viem.sh/docs/contract/writeContract.html), [`estimateContractGas`](https://viem.sh/docs/contract/estimateContractGas.html), etc.
+ *
+ * @example
+ * import { createPublicClient, getContract, http, parseAbi } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ *
+ * const publicClient = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const contract = getContract({
+ *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+ *   abi: parseAbi([
+ *     'function balanceOf(address owner) view returns (uint256)',
+ *     'function ownerOf(uint256 tokenId) view returns (address)',
+ *     'function totalSupply() view returns (uint256)',
+ *   ]),
+ *   publicClient,
+ * })
  */
 export function getContract<
   TTransport extends Transport,
+  TAddress extends Address,
   TAbi extends Abi | readonly unknown[],
   TChain extends Chain | undefined = Chain | undefined,
   TAccount extends Account | undefined = Account | undefined,
@@ -224,13 +405,16 @@ export function getContract<
   TAccount,
   TAbi,
   TPublicClient,
-  TWalletClient
->): GetContractReturnType<TAbi, TPublicClient, TWalletClient> {
+  TWalletClient,
+  TAddress
+>): GetContractReturnType<TAbi, TPublicClient, TWalletClient, TAddress> {
   const hasPublicClient = publicClient !== undefined && publicClient !== null
   const hasWalletClient = walletClient !== undefined && walletClient !== null
 
   const contract: {
     [_ in
+      | 'abi'
+      | 'address'
       | 'createEventFilter'
       | 'estimateGas'
       | 'read'
@@ -261,7 +445,7 @@ export function getContract<
             return (
               ...parameters: [
                 args?: readonly unknown[],
-                options?: Omit<
+                options?: UnionOmit<
                   ReadContractParameters,
                   'abi' | 'address' | 'functionName' | 'args'
                 >,
@@ -280,32 +464,7 @@ export function getContract<
         },
       )
 
-    if (hasWriteFunction) {
-      contract.estimateGas = new Proxy(
-        {},
-        {
-          get(_, functionName: string) {
-            return (
-              ...parameters: [
-                args?: readonly unknown[],
-                options?: Omit<
-                  EstimateContractGasParameters,
-                  'abi' | 'address' | 'functionName' | 'args'
-                >,
-              ]
-            ) => {
-              const { args, options } = getFunctionParameters(parameters)
-              return estimateContractGas(publicClient, {
-                abi,
-                address,
-                functionName,
-                args,
-                ...options,
-              } as EstimateContractGasParameters)
-            }
-          },
-        },
-      )
+    if (hasWriteFunction)
       contract.simulate = new Proxy(
         {},
         {
@@ -313,7 +472,7 @@ export function getContract<
             return (
               ...parameters: [
                 args?: readonly unknown[],
-                options?: Omit<
+                options?: UnionOmit<
                   SimulateContractParameters,
                   'abi' | 'address' | 'functionName' | 'args'
                 >,
@@ -331,7 +490,6 @@ export function getContract<
           },
         },
       )
-    }
 
     if (hasEvent) {
       contract.createEventFilter = new Proxy(
@@ -391,7 +549,7 @@ export function getContract<
                 eventName,
                 args,
                 ...options,
-              } as WatchContractEventParameters)
+              } as unknown as WatchContractEventParameters)
             }
           },
         },
@@ -408,7 +566,7 @@ export function getContract<
             return (
               ...parameters: [
                 args?: readonly unknown[],
-                options?: Omit<
+                options?: UnionOmit<
                   WriteContractParameters,
                   'abi' | 'address' | 'functionName' | 'args'
                 >,
@@ -421,7 +579,7 @@ export function getContract<
                 functionName,
                 args,
                 ...options,
-              } as WriteContractParameters<
+              } as unknown as WriteContractParameters<
                 TAbi,
                 typeof functionName,
                 TChain,
@@ -433,10 +591,45 @@ export function getContract<
       )
   }
 
+  if (hasPublicClient || hasWalletClient)
+    if (hasWriteFunction)
+      contract.estimateGas = new Proxy(
+        {},
+        {
+          get(_, functionName: string) {
+            return (
+              ...parameters: [
+                args?: readonly unknown[],
+                options?: UnionOmit<
+                  EstimateContractGasParameters,
+                  'abi' | 'address' | 'functionName' | 'args'
+                >,
+              ]
+            ) => {
+              const { args, options } = getFunctionParameters(parameters)
+              const client = (publicClient ?? walletClient)!
+              return estimateContractGas(client, {
+                abi,
+                address,
+                functionName,
+                args,
+                ...options,
+                account:
+                  (options as EstimateContractGasParameters).account ??
+                  (walletClient as unknown as WalletClient).account,
+              } as any)
+            }
+          },
+        },
+      )
+  contract.address = address
+  contract.abi = abi
+
   return contract as unknown as GetContractReturnType<
     TAbi,
     TPublicClient,
-    TWalletClient
+    TWalletClient,
+    TAddress
   >
 }
 
@@ -485,7 +678,7 @@ type GetReadFunction<
     : AbiFunction,
   Args = AbiParametersToPrimitiveTypes<TAbiFunction['inputs']>,
   Options = Prettify<
-    Omit<
+    UnionOmit<
       ReadContractParameters<TAbi, TFunctionName>,
       'abi' | 'address' | 'args' | 'functionName'
     >
@@ -505,6 +698,7 @@ type GetReadFunction<
 type GetEstimateFunction<
   Narrowable extends boolean,
   TChain extends Chain | undefined,
+  TAccount extends Account | undefined,
   TAbi extends Abi | readonly unknown[],
   TFunctionName extends string,
   TAbiFunction extends AbiFunction = TAbi extends Abi
@@ -512,21 +706,37 @@ type GetEstimateFunction<
     : AbiFunction,
   Args = AbiParametersToPrimitiveTypes<TAbiFunction['inputs']>,
   Options = Prettify<
-    Omit<
-      EstimateContractGasParameters<TAbi, TFunctionName, TChain>,
+    UnionOmit<
+      EstimateContractGasParameters<TAbi, TFunctionName, TChain, TAccount>,
       'abi' | 'address' | 'args' | 'functionName'
     >
   >,
+  // For making `options` parameter required if `TAccount`
+  IsOptionsRequired = IsUndefined<TAccount>,
 > = Narrowable extends true
   ? (
       ...parameters: Args extends readonly []
-        ? [options?: Options]
-        : [args: Args, options?: Options]
+        ? IsOptionsRequired extends true
+          ? [options: Options]
+          : [options?: Options]
+        : [
+            args: Args,
+            ...parameters: IsOptionsRequired extends true
+              ? [options: Options]
+              : [options?: Options],
+          ]
     ) => Promise<EstimateContractGasReturnType>
   : (
       ...parameters:
-        | [options?: Options]
-        | [args: readonly unknown[], options?: Options]
+        | (IsOptionsRequired extends true
+            ? [options: Options]
+            : [options?: Options])
+        | [
+            args: readonly unknown[],
+            ...parameters: IsOptionsRequired extends true
+              ? [options: Options]
+              : [options?: Options],
+          ]
     ) => Promise<EstimateContractGasReturnType>
 
 type GetSimulateFunction<
@@ -542,7 +752,7 @@ type GetSimulateFunction<
   ? <
       TChainOverride extends Chain | undefined,
       Options extends Prettify<
-        Omit<
+        UnionOmit<
           SimulateContractParameters<
             TAbi,
             TFunctionName,
@@ -562,7 +772,7 @@ type GetSimulateFunction<
   : <
       TChainOverride extends Chain | undefined,
       Options extends Prettify<
-        Omit<
+        UnionOmit<
           SimulateContractParameters<
             TAbi,
             TFunctionName,
@@ -589,16 +799,12 @@ type GetWriteFunction<
     : AbiFunction,
   Args = AbiParametersToPrimitiveTypes<TAbiFunction['inputs']>,
   // For making `options` parameter required if `TAccount` or `TChain` is undefined
-  IsOptionsRequired = [IsUndefined<TAccount>, IsUndefined<TChain>] extends
-    | [true, false]
-    | [false, true]
-    ? true
-    : false,
+  IsOptionsRequired = Or<[IsUndefined<TAccount>, IsUndefined<TChain>]>,
 > = Narrowable extends true
   ? <
       TChainOverride extends Chain | undefined,
       Options extends Prettify<
-        Omit<
+        UnionOmit<
           WriteContractParameters<
             TAbi,
             TFunctionName,
@@ -609,18 +815,22 @@ type GetWriteFunction<
           'abi' | 'address' | 'args' | 'functionName'
         >
       >,
-      Rest extends IsOptionsRequired extends true
-        ? [options: Options]
-        : [options?: Options],
     >(
       ...parameters: Args extends readonly []
-        ? Rest
-        : [args: Args, ...parameters: Rest]
+        ? IsOptionsRequired extends true
+          ? [options: Options]
+          : [options?: Options]
+        : [
+            args: Args,
+            ...parameters: IsOptionsRequired extends true
+              ? [options: Options]
+              : [options?: Options],
+          ]
     ) => Promise<WriteContractReturnType>
   : <
       TChainOverride extends Chain | undefined,
       Options extends Prettify<
-        Omit<
+        UnionOmit<
           WriteContractParameters<
             TAbi,
             TFunctionName,
@@ -649,25 +859,30 @@ type GetEventFilter<
   Options = Prettify<
     Omit<
       CreateContractEventFilterParameters<TAbi, TEventName>,
-      'abi' | 'address' | 'args' | 'eventName'
+      'abi' | 'address' | 'args' | 'eventName' | 'strict'
     >
   >,
   IndexedInputs = Extract<TAbiEvent['inputs'][number], { indexed: true }>,
 > = Narrowable extends true
-  ? <TArgs extends MaybeExtractEventArgsFromAbi<TAbi, TEventName> | undefined>(
+  ? <
+      TArgs extends MaybeExtractEventArgsFromAbi<TAbi, TEventName> | undefined,
+      TStrict extends boolean | undefined = undefined,
+    >(
       ...parameters: IsNever<IndexedInputs> extends true
-        ? [options?: Options]
+        ? [options?: Options & { strict?: TStrict }]
         : [
             args: Args | (Args extends Narrow<TArgs> ? Narrow<TArgs> : never),
-            options?: Options,
+            options?: Options & { strict?: TStrict },
           ]
-    ) => Promise<CreateContractEventFilterReturnType<TAbi, TEventName, TArgs>>
-  : (
+    ) => Promise<
+      CreateContractEventFilterReturnType<TAbi, TEventName, TArgs, TStrict>
+    >
+  : <TStrict extends boolean | undefined = undefined>(
       ...parameters:
-        | [options?: Options]
+        | [options?: Options & { strict?: TStrict }]
         | [
             args: readonly unknown[] | CreateContractFilterOptions,
-            options?: Options,
+            options?: Options & { strict?: TStrict },
           ]
     ) => Promise<CreateContractEventFilterReturnType>