@wagmi/core 3.2.3 → 3.3.0

package/src/query/deployContract.ts

@@ -1,6 +1,5 @@
 import type { MutateOptions, MutationOptions } from '@tanstack/query-core'
 import type { Abi, ContractConstructorArgs } from 'viem'
-
 import {
   type DeployContractErrorType,
   type DeployContractParameters,
@@ -8,22 +7,38 @@ import {
   deployContract,
 } from '../actions/deployContract.js'
 import type { Config } from '../createConfig.js'
+import type { MutationParameter } from '../types/query.js'
 import type { Compute } from '../types/utils.js'
 
-export function deployContractMutationOptions<config extends Config>(
+export type DeployContractOptions<
+  config extends Config,
+  context = unknown,
+> = MutationParameter<
+  DeployContractData,
+  DeployContractErrorType,
+  DeployContractVariables<Abi, config, config['chains'][number]['id']>,
+  context
+>
+
+export function deployContractMutationOptions<config extends Config, context>(
   config: config,
-) {
+  options: DeployContractOptions<config, context> = {},
+): DeployContractMutationOptions<config> {
   return {
+    ...(options.mutation as any),
     mutationFn(variables) {
       return deployContract(config, variables)
     },
     mutationKey: ['deployContract'],
-  } as const satisfies MutationOptions<
+  }
+}
+
+export type DeployContractMutationOptions<config extends Config> =
+  MutationOptions<
     DeployContractData,
     DeployContractErrorType,
     DeployContractVariables<Abi, config, config['chains'][number]['id']>
   >
-}
 
 export type DeployContractData = Compute<DeployContractReturnType>
 

package/src/query/disconnect.ts

@@ -1,5 +1,4 @@
 import type { MutationOptions } from '@tanstack/query-core'
-
 import {
   type DisconnectErrorType,
   type DisconnectParameters,
@@ -7,23 +6,35 @@ import {
   disconnect,
 } from '../actions/disconnect.js'
 import type { Config } from '../createConfig.js'
+import type { MutationParameter } from '../types/query.js'
 import type { Mutate, MutateAsync } from './types.js'
 
-export function disconnectMutationOptions<config extends Config>(
+export type DisconnectOptions<context = unknown> = MutationParameter<
+  DisconnectData,
+  DisconnectErrorType,
+  DisconnectVariables,
+  context
+>
+
+export function disconnectMutationOptions<config extends Config, context>(
   config: config,
-) {
+  options: DisconnectOptions<context> = {},
+): DisconnectMutationOptions {
   return {
-    mutationFn(variables) {
+    ...(options.mutation as any),
+    mutationFn: async (variables) => {
       return disconnect(config, variables)
     },
     mutationKey: ['disconnect'],
-  } as const satisfies MutationOptions<
-    DisconnectData,
-    DisconnectErrorType,
-    DisconnectVariables
-  >
+  }
 }
 
+export type DisconnectMutationOptions = MutationOptions<
+  DisconnectData,
+  DisconnectErrorType,
+  DisconnectVariables
+>
+
 export type DisconnectData = DisconnectReturnType
 
 export type DisconnectVariables = DisconnectParameters | undefined

package/src/query/getBlobBaseFee.ts

@@ -0,0 +1,75 @@
+import {
+  type GetBlobBaseFeeErrorType,
+  type GetBlobBaseFeeParameters,
+  type GetBlobBaseFeeReturnType,
+  getBlobBaseFee,
+} from '../actions/getBlobBaseFee.js'
+import type { Config } from '../createConfig.js'
+import type { ScopeKeyParameter } from '../types/properties.js'
+import type { QueryOptions, QueryParameter } from '../types/query.js'
+import type { Compute, ExactPartial } from '../types/utils.js'
+import { filterQueryOptions } from './utils.js'
+
+export type GetBlobBaseFeeOptions<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+  selectData = GetBlobBaseFeeData,
+> = Compute<
+  ExactPartial<GetBlobBaseFeeParameters<config, chainId>> & ScopeKeyParameter
+> &
+  QueryParameter<
+    GetBlobBaseFeeQueryFnData,
+    GetBlobBaseFeeErrorType,
+    selectData,
+    GetBlobBaseFeeQueryKey<config, chainId>
+  >
+
+export function getBlobBaseFeeQueryOptions<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+  selectData = GetBlobBaseFeeData,
+>(
+  config: config,
+  options: GetBlobBaseFeeOptions<config, chainId, selectData> = {},
+): GetBlobBaseFeeQueryOptions<config, chainId, selectData> {
+  return {
+    ...options.query,
+    queryFn: async (context) => {
+      const [, { scopeKey: _, ...parameters }] = context.queryKey
+      const blobBaseFee = await getBlobBaseFee(config, parameters)
+      return blobBaseFee ?? null
+    },
+    queryKey: getBlobBaseFeeQueryKey(options),
+  }
+}
+
+export type GetBlobBaseFeeQueryFnData = GetBlobBaseFeeReturnType
+
+export type GetBlobBaseFeeData = GetBlobBaseFeeQueryFnData
+
+export function getBlobBaseFeeQueryKey<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+>(
+  options: Compute<
+    ExactPartial<GetBlobBaseFeeParameters<config, chainId>> & ScopeKeyParameter
+  > = {},
+) {
+  return ['blobBaseFee', filterQueryOptions(options)] as const
+}
+
+export type GetBlobBaseFeeQueryKey<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+> = ReturnType<typeof getBlobBaseFeeQueryKey<config, chainId>>
+
+export type GetBlobBaseFeeQueryOptions<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+  selectData = GetBlobBaseFeeData,
+> = QueryOptions<
+  GetBlobBaseFeeQueryFnData,
+  GetBlobBaseFeeErrorType,
+  selectData,
+  GetBlobBaseFeeQueryKey<config, chainId>
+>

package/src/query/getContractEvents.ts

@@ -0,0 +1,214 @@
+import type { Abi, BlockNumber, BlockTag, ContractEventName } from 'viem'
+import {
+  type GetContractEventsErrorType,
+  type GetContractEventsParameters,
+  type GetContractEventsReturnType,
+  getContractEvents,
+} from '../actions/getContractEvents.js'
+import type { Config } from '../createConfig.js'
+import type { ScopeKeyParameter } from '../types/properties.js'
+import type { QueryOptions, QueryParameter } from '../types/query.js'
+import type { UnionExactPartial } from '../types/utils.js'
+import { filterQueryOptions, structuralSharing } from './utils.js'
+
+export type GetContractEventsOptions<
+  abi extends Abi | readonly unknown[],
+  eventName extends ContractEventName<abi> | undefined,
+  strict extends boolean | undefined,
+  fromBlock extends BlockNumber | BlockTag | undefined,
+  toBlock extends BlockNumber | BlockTag | undefined,
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+  selectData = GetContractEventsData<
+    abi,
+    eventName,
+    strict,
+    fromBlock,
+    toBlock
+  >,
+> = UnionExactPartial<
+  GetContractEventsParameters<
+    abi,
+    eventName,
+    strict,
+    fromBlock,
+    toBlock,
+    config,
+    chainId
+  >
+> &
+  ScopeKeyParameter &
+  QueryParameter<
+    GetContractEventsQueryFnData<abi, eventName, strict, fromBlock, toBlock>,
+    GetContractEventsErrorType,
+    selectData,
+    GetContractEventsQueryKey<
+      config,
+      chainId,
+      abi,
+      eventName,
+      strict,
+      fromBlock,
+      toBlock
+    >
+  >
+
+export function getContractEventsQueryOptions<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+  const abi extends Abi | readonly unknown[],
+  eventName extends ContractEventName<abi> | undefined,
+  strict extends boolean | undefined = undefined,
+  fromBlock extends BlockNumber | BlockTag | undefined = undefined,
+  toBlock extends BlockNumber | BlockTag | undefined = undefined,
+  selectData = GetContractEventsData<
+    abi,
+    eventName,
+    strict,
+    fromBlock,
+    toBlock
+  >,
+>(
+  config: config,
+  options: GetContractEventsOptions<
+    abi,
+    eventName,
+    strict,
+    fromBlock,
+    toBlock,
+    config,
+    chainId,
+    selectData
+  > = {} as any,
+): GetContractEventsQueryOptions<
+  abi,
+  eventName,
+  strict,
+  fromBlock,
+  toBlock,
+  config,
+  chainId,
+  selectData
+> {
+  return {
+    ...options.query,
+    enabled: Boolean(options.abi && (options.query?.enabled ?? true)),
+    queryFn: async (context) => {
+      if (!options.abi) throw new Error('abi is required')
+      const [, { scopeKey: _, ...parameters }] = context.queryKey
+      const result = await getContractEvents(config, {
+        ...(parameters as any),
+        abi: options.abi,
+      })
+      return result as GetContractEventsData<
+        abi,
+        eventName,
+        strict,
+        fromBlock,
+        toBlock
+      >
+    },
+    queryKey: getContractEventsQueryKey(options as any) as any,
+    structuralSharing,
+  } as GetContractEventsQueryOptions<
+    abi,
+    eventName,
+    strict,
+    fromBlock,
+    toBlock,
+    config,
+    chainId,
+    selectData
+  >
+}
+
+export type GetContractEventsQueryFnData<
+  abi extends Abi | readonly unknown[],
+  eventName extends ContractEventName<abi> | undefined,
+  strict extends boolean | undefined,
+  fromBlock extends BlockNumber | BlockTag | undefined,
+  toBlock extends BlockNumber | BlockTag | undefined,
+> = GetContractEventsReturnType<abi, eventName, strict, fromBlock, toBlock>
+
+export type GetContractEventsData<
+  abi extends Abi | readonly unknown[],
+  eventName extends ContractEventName<abi> | undefined,
+  strict extends boolean | undefined,
+  fromBlock extends BlockNumber | BlockTag | undefined,
+  toBlock extends BlockNumber | BlockTag | undefined,
+> = GetContractEventsQueryFnData<abi, eventName, strict, fromBlock, toBlock>
+
+export function getContractEventsQueryKey<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+  const abi extends Abi | readonly unknown[],
+  eventName extends ContractEventName<abi> | undefined,
+  strict extends boolean | undefined = undefined,
+  fromBlock extends BlockNumber | BlockTag | undefined = undefined,
+  toBlock extends BlockNumber | BlockTag | undefined = undefined,
+>(
+  options: UnionExactPartial<
+    GetContractEventsParameters<
+      abi,
+      eventName,
+      strict,
+      fromBlock,
+      toBlock,
+      config,
+      chainId
+    >
+  > &
+    ScopeKeyParameter = {} as any,
+) {
+  return ['getContractEvents', filterQueryOptions(options)] as const
+}
+
+export type GetContractEventsQueryKey<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+  abi extends Abi | readonly unknown[],
+  eventName extends ContractEventName<abi> | undefined,
+  strict extends boolean | undefined,
+  fromBlock extends BlockNumber | BlockTag | undefined,
+  toBlock extends BlockNumber | BlockTag | undefined,
+> = ReturnType<
+  typeof getContractEventsQueryKey<
+    config,
+    chainId,
+    abi,
+    eventName,
+    strict,
+    fromBlock,
+    toBlock
+  >
+>
+
+export type GetContractEventsQueryOptions<
+  abi extends Abi | readonly unknown[],
+  eventName extends ContractEventName<abi> | undefined,
+  strict extends boolean | undefined,
+  fromBlock extends BlockNumber | BlockTag | undefined,
+  toBlock extends BlockNumber | BlockTag | undefined,
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+  selectData = GetContractEventsData<
+    abi,
+    eventName,
+    strict,
+    fromBlock,
+    toBlock
+  >,
+> = QueryOptions<
+  GetContractEventsQueryFnData<abi, eventName, strict, fromBlock, toBlock>,
+  GetContractEventsErrorType,
+  selectData,
+  GetContractEventsQueryKey<
+    config,
+    chainId,
+    abi,
+    eventName,
+    strict,
+    fromBlock,
+    toBlock
+  >
+>

package/src/query/readContracts.ts

@@ -92,14 +92,24 @@ export function readContractsQueryKey<
     ChainIdParameter<config> = {},
 ) {
   const contracts = []
+  let hasContractWithoutChainId = false
   for (const contract of (options.contracts ??
     []) as (ContractFunctionParameters & { chainId: number })[]) {
     const { abi: _, ...rest } = contract
-    contracts.push({ ...rest, chainId: rest.chainId ?? options.chainId })
+    if (rest.chainId === undefined) hasContractWithoutChainId = true
+    const chainId = rest.chainId ?? options.chainId
+    contracts.push({ ...rest, ...(chainId ? { chainId } : {}) })
   }
+  const { chainId: _, ...rest } = options
   return [
     'readContracts',
-    filterQueryOptions({ ...options, contracts }),
+    filterQueryOptions({
+      ...rest,
+      ...(hasContractWithoutChainId && options.chainId
+        ? { chainId: options.chainId }
+        : {}),
+      contracts,
+    }),
   ] as const
 }
 

package/src/query/reconnect.ts

@@ -1,5 +1,4 @@
 import type { MutationOptions } from '@tanstack/query-core'
-
 import {
   type ReconnectErrorType,
   type ReconnectParameters,
@@ -7,22 +6,36 @@ import {
   reconnect,
 } from '../actions/reconnect.js'
 import type { Config } from '../createConfig.js'
+import type { MutationParameter } from '../types/query.js'
 import type { Compute } from '../types/utils.js'
 import type { Mutate, MutateAsync } from './types.js'
 
-export function reconnectMutationOptions(config: Config) {
+export type ReconnectOptions<context = unknown> = MutationParameter<
+  ReconnectData,
+  ReconnectErrorType,
+  ReconnectVariables,
+  context
+>
+
+export function reconnectMutationOptions<context>(
+  config: Config,
+  options: ReconnectOptions<context> = {},
+): ReconnectMutationOptions {
   return {
+    ...(options.mutation as any),
     mutationFn(variables) {
       return reconnect(config, variables)
     },
     mutationKey: ['reconnect'],
-  } as const satisfies MutationOptions<
-    ReconnectData,
-    ReconnectErrorType,
-    ReconnectVariables
-  >
+  }
 }
 
+export type ReconnectMutationOptions = MutationOptions<
+  ReconnectData,
+  ReconnectErrorType,
+  ReconnectVariables
+>
+
 export type ReconnectData = Compute<ReconnectReturnType>
 
 export type ReconnectVariables = ReconnectParameters | undefined

package/src/query/sendCalls.ts

@@ -1,5 +1,4 @@
 import type { MutateOptions, MutationOptions } from '@tanstack/query-core'
-
 import {
   type SendCallsErrorType,
   type SendCallsParameters,
@@ -7,23 +6,38 @@ import {
   sendCalls,
 } from '../actions/sendCalls.js'
 import type { Config } from '../createConfig.js'
+import type { MutationParameter } from '../types/query.js'
 import type { Compute } from '../types/utils.js'
 
-export function sendCallsMutationOptions<config extends Config>(
+export type SendCallsOptions<
+  config extends Config,
+  context = unknown,
+> = MutationParameter<
+  SendCallsData,
+  SendCallsErrorType,
+  SendCallsVariables<config, config['chains'][number]['id']>,
+  context
+>
+
+export function sendCallsMutationOptions<config extends Config, context>(
   config: config,
-) {
+  options: SendCallsOptions<config, context> = {},
+): SendCallsMutationOptions<config> {
   return {
+    ...(options.mutation as any),
     mutationFn(variables) {
       return sendCalls(config, variables)
     },
     mutationKey: ['sendCalls'],
-  } as const satisfies MutationOptions<
-    SendCallsData,
-    SendCallsErrorType,
-    SendCallsVariables<config, config['chains'][number]['id']>
-  >
+  }
 }
 
+export type SendCallsMutationOptions<config extends Config> = MutationOptions<
+  SendCallsData,
+  SendCallsErrorType,
+  SendCallsVariables<config, config['chains'][number]['id']>
+>
+
 export type SendCallsData = Compute<SendCallsReturnType>
 
 export type SendCallsVariables<

package/src/query/sendCallsSync.ts

@@ -1,5 +1,4 @@
 import type { MutateOptions, MutationOptions } from '@tanstack/query-core'
-
 import {
   type SendCallsSyncErrorType,
   type SendCallsSyncParameters,
@@ -7,22 +6,38 @@ import {
   sendCallsSync,
 } from '../actions/sendCallsSync.js'
 import type { Config } from '../createConfig.js'
+import type { MutationParameter } from '../types/query.js'
 import type { Compute } from '../types/utils.js'
 
-export function sendCallsSyncMutationOptions<config extends Config>(
+export type SendCallsSyncOptions<
+  config extends Config,
+  context = unknown,
+> = MutationParameter<
+  SendCallsSyncData,
+  SendCallsSyncErrorType,
+  SendCallsSyncVariables<config, config['chains'][number]['id']>,
+  context
+>
+
+export function sendCallsSyncMutationOptions<config extends Config, context>(
   config: config,
-) {
+  options: SendCallsSyncOptions<config, context> = {},
+): SendCallsSyncMutationOptions<config> {
   return {
+    ...(options.mutation as any),
     mutationFn(variables) {
       return sendCallsSync(config, variables)
     },
     mutationKey: ['sendCallsSync'],
-  } as const satisfies MutationOptions<
+  }
+}
+
+export type SendCallsSyncMutationOptions<config extends Config> =
+  MutationOptions<
     SendCallsSyncData,
     SendCallsSyncErrorType,
     SendCallsSyncVariables<config, config['chains'][number]['id']>
   >
-}
 
 export type SendCallsSyncData = Compute<SendCallsSyncReturnType>
 

package/src/query/sendTransaction.ts

@@ -1,5 +1,4 @@
 import type { MutateOptions, MutationOptions } from '@tanstack/query-core'
-
 import {
   type SendTransactionErrorType,
   type SendTransactionParameters,
@@ -7,22 +6,38 @@ import {
   sendTransaction,
 } from '../actions/sendTransaction.js'
 import type { Config } from '../createConfig.js'
+import type { MutationParameter } from '../types/query.js'
 import type { Compute } from '../types/utils.js'
 
-export function sendTransactionMutationOptions<config extends Config>(
+export type SendTransactionOptions<
+  config extends Config,
+  context = unknown,
+> = MutationParameter<
+  SendTransactionData,
+  SendTransactionErrorType,
+  SendTransactionVariables<config, config['chains'][number]['id']>,
+  context
+>
+
+export function sendTransactionMutationOptions<config extends Config, context>(
   config: config,
-) {
+  options: SendTransactionOptions<config, context> = {},
+): SendTransactionMutationOptions<config> {
   return {
+    ...(options.mutation as any),
     mutationFn(variables) {
       return sendTransaction(config, variables)
     },
     mutationKey: ['sendTransaction'],
-  } as const satisfies MutationOptions<
+  }
+}
+
+export type SendTransactionMutationOptions<config extends Config> =
+  MutationOptions<
     SendTransactionData,
     SendTransactionErrorType,
     SendTransactionVariables<config, config['chains'][number]['id']>
   >
-}
 
 export type SendTransactionData = Compute<SendTransactionReturnType>
 

package/src/query/sendTransactionSync.ts

@@ -1,5 +1,4 @@
 import type { MutateOptions, MutationOptions } from '@tanstack/query-core'
-
 import {
   type SendTransactionSyncErrorType,
   type SendTransactionSyncParameters,
@@ -7,22 +6,41 @@ import {
   sendTransactionSync,
 } from '../actions/sendTransactionSync.js'
 import type { Config } from '../createConfig.js'
+import type { MutationParameter } from '../types/query.js'
 import type { Compute } from '../types/utils.js'
 
-export function sendTransactionSyncMutationOptions<config extends Config>(
+export type SendTransactionSyncOptions<
+  config extends Config,
+  context = unknown,
+> = MutationParameter<
+  SendTransactionSyncData,
+  SendTransactionSyncErrorType,
+  SendTransactionSyncVariables<config, config['chains'][number]['id']>,
+  context
+>
+
+export function sendTransactionSyncMutationOptions<
+  config extends Config,
+  context,
+>(
   config: config,
-) {
+  options: SendTransactionSyncOptions<config, context> = {},
+): SendTransactionSyncMutationOptions<config> {
   return {
+    ...(options.mutation as any),
     mutationFn(variables) {
       return sendTransactionSync(config, variables)
     },
     mutationKey: ['sendTransactionSync'],
-  } as const satisfies MutationOptions<
+  }
+}
+
+export type SendTransactionSyncMutationOptions<config extends Config> =
+  MutationOptions<
     SendTransactionSyncData,
     SendTransactionSyncErrorType,
     SendTransactionSyncVariables<config, config['chains'][number]['id']>
   >
-}
 
 export type SendTransactionSyncData = Compute<SendTransactionSyncReturnType>