@wagmi/core 1.4.1 → 2.0.0-alpha.1

package/src/exports/internal.ts

@@ -0,0 +1,29 @@
+////////////////////////////////////////////////////////////////////////////////
+// Emitter
+
+export {
+  type EventData,
+  Emitter,
+  createEmitter,
+} from '../createEmitter.js'
+
+////////////////////////////////////////////////////////////////////////////////
+// Types
+
+export {
+  type Evaluate,
+  type ExactPartial,
+  type Mutable,
+  type Omit,
+  type OneOf,
+  type UnionEvaluate,
+  type UnionOmit,
+  type UnionPartial,
+} from '../types/utils.js'
+
+////////////////////////////////////////////////////////////////////////////////
+// Utilities
+
+export { deepEqual } from '../utils/deepEqual.js'
+
+export { uid } from '../utils/uid.js'

package/src/exports/query.ts

@@ -0,0 +1,229 @@
+////////////////////////////////////////////////////////////////////////////////
+// Tanstack Query
+
+export {
+  type ConnectData,
+  type ConnectVariables,
+  type ConnectMutate,
+  type ConnectMutateAsync,
+  connectMutationOptions,
+} from '../query/connect.js'
+
+export {
+  type DisconnectData,
+  type DisconnectVariables,
+  type DisconnectMutate,
+  type DisconnectMutateAsync,
+  disconnectMutationOptions,
+} from '../query/disconnect.js'
+
+export {
+  type EstimateFeesPerGasData,
+  type EstimateFeesPerGasOptions,
+  type EstimateFeesPerGasQueryFnData,
+  type EstimateFeesPerGasQueryKey,
+  estimateFeesPerGasQueryKey,
+  estimateFeesPerGasQueryOptions,
+} from '../query/estimateFeesPerGas.js'
+
+export {
+  type EstimateGasData,
+  type EstimateGasOptions,
+  type EstimateGasQueryFnData,
+  type EstimateGasQueryKey,
+  estimateGasQueryKey,
+  estimateGasQueryOptions,
+} from '../query/estimateGas.js'
+
+export {
+  type GetBalanceData,
+  type GetBalanceOptions,
+  type GetBalanceQueryFnData,
+  type GetBalanceQueryKey,
+  getBalanceQueryKey,
+  getBalanceQueryOptions,
+} from '../query/getBalance.js'
+
+export {
+  type GetBlockData,
+  type GetBlockOptions,
+  type GetBlockQueryFnData,
+  type GetBlockQueryKey,
+  getBlockQueryKey,
+  getBlockQueryOptions,
+} from '../query/getBlock.js'
+
+export {
+  type GetBlockNumberData,
+  type GetBlockNumberOptions,
+  type GetBlockNumberQueryFnData,
+  type GetBlockNumberQueryKey,
+  getBlockNumberQueryKey,
+  getBlockNumberQueryOptions,
+} from '../query/getBlockNumber.js'
+
+export {
+  type GetConnectorClientData,
+  type GetConnectorClientOptions,
+  type GetConnectorClientQueryFnData,
+  type GetConnectorClientQueryKey,
+  getConnectorClientQueryKey,
+  getConnectorClientQueryOptions,
+} from '../query/getConnectorClient.js'
+
+export {
+  type GetEnsAddressData,
+  type GetEnsAddressOptions,
+  type GetEnsAddressQueryFnData,
+  type GetEnsAddressQueryKey,
+  getEnsAddressQueryKey,
+  getEnsAddressQueryOptions,
+} from '../query/getEnsAddress.js'
+
+export {
+  type GetEnsAvatarData,
+  type GetEnsAvatarOptions,
+  type GetEnsAvatarQueryFnData,
+  type GetEnsAvatarQueryKey,
+  getEnsAvatarQueryKey,
+  getEnsAvatarQueryOptions,
+} from '../query/getEnsAvatar.js'
+
+export {
+  type GetEnsNameData,
+  type GetEnsNameOptions,
+  type GetEnsNameQueryFnData,
+  type GetEnsNameQueryKey,
+  getEnsNameQueryKey,
+  getEnsNameQueryOptions,
+} from '../query/getEnsName.js'
+
+export {
+  type GetEnsResolverData,
+  type GetEnsResolverOptions,
+  type GetEnsResolverQueryFnData,
+  type GetEnsResolverQueryKey,
+  getEnsResolverQueryKey,
+  getEnsResolverQueryOptions,
+} from '../query/getEnsResolver.js'
+
+export {
+  type GetTokenData,
+  type GetTokenOptions,
+  type GetTokenQueryFnData,
+  type GetTokenQueryKey,
+  getTokenQueryKey,
+  getTokenQueryOptions,
+} from '../query/getToken.js'
+
+export {
+  type GetTransactionData,
+  type GetTransactionOptions,
+  type GetTransactionQueryFnData,
+  type GetTransactionQueryKey,
+  getTransactionQueryKey,
+  getTransactionQueryOptions,
+} from '../query/getTransaction.js'
+
+export {
+  type GetWalletClientData,
+  type GetWalletClientOptions,
+  type GetWalletClientQueryFnData,
+  type GetWalletClientQueryKey,
+  getWalletClientQueryKey,
+  getWalletClientQueryOptions,
+} from '../query/getWalletClient.js'
+
+export {
+  type ReadContractData,
+  type ReadContractOptions,
+  type ReadContractQueryFnData,
+  type ReadContractQueryKey,
+  readContractQueryKey,
+  readContractQueryOptions,
+} from '../query/readContract.js'
+
+export {
+  type ReadContractsData,
+  type ReadContractsOptions,
+  type ReadContractsQueryFnData,
+  type ReadContractsQueryKey,
+  readContractsQueryKey,
+  readContractsQueryOptions,
+} from '../query/readContracts.js'
+
+export {
+  type ReconnectData,
+  type ReconnectVariables,
+  type ReconnectMutate,
+  type ReconnectMutateAsync,
+  reconnectMutationOptions,
+} from '../query/reconnect.js'
+
+export {
+  type SendTransactionData,
+  type SendTransactionVariables,
+  type SendTransactionMutate,
+  type SendTransactionMutateAsync,
+  sendTransactionMutationOptions,
+} from '../query/sendTransaction.js'
+
+export {
+  type SignMessageData,
+  type SignMessageVariables,
+  type SignMessageMutate,
+  type SignMessageMutateAsync,
+  signMessageMutationOptions,
+} from '../query/signMessage.js'
+
+export {
+  type SignTypedDataData,
+  type SignTypedDataVariables,
+  type SignTypedDataMutate,
+  type SignTypedDataMutateAsync,
+  signTypedDataMutationOptions,
+} from '../query/signTypedData.js'
+
+export {
+  type SwitchAccountData,
+  type SwitchAccountVariables,
+  type SwitchAccountMutate,
+  type SwitchAccountMutateAsync,
+  switchAccountMutationOptions,
+} from '../query/switchAccount.js'
+
+export {
+  type SimulateContractData,
+  type SimulateContractOptions,
+  type SimulateContractQueryFnData,
+  type SimulateContractQueryKey,
+  simulateContractQueryKey,
+  simulateContractQueryOptions,
+} from '../query/simulateContract.js'
+
+export {
+  type SwitchChainData,
+  type SwitchChainVariables,
+  type SwitchChainMutate,
+  type SwitchChainMutateAsync,
+  switchChainMutationOptions,
+} from '../query/switchChain.js'
+
+export {
+  type WaitForTransactionReceiptData,
+  type WaitForTransactionReceiptOptions,
+  type WaitForTransactionReceiptQueryFnData,
+  type WaitForTransactionReceiptQueryKey,
+  waitForTransactionReceiptQueryKey,
+  waitForTransactionReceiptQueryOptions,
+} from '../query/waitForTransactionReceipt.js'
+
+export {
+  type WriteContractData,
+  type WriteContractVariables,
+  type WriteContractMutate,
+  type WriteContractMutateAsync,
+  writeContractMutationOptions,
+} from '../query/writeContract.js'
+
+export { hashFn } from '../query/utils.js'

package/src/query/connect.ts

@@ -0,0 +1,45 @@
+import type { MutationOptions } from '@tanstack/query-core'
+
+import {
+  type ConnectError,
+  type ConnectParameters,
+  type ConnectReturnType,
+  connect,
+} from '../actions/connect.js'
+import { type Config } from '../createConfig.js'
+
+import type { Mutate, MutateAsync } from './types.js'
+
+export function connectMutationOptions<config extends Config>(config: config) {
+  return {
+    mutationFn(variables) {
+      return connect(config, variables)
+    },
+    mutationKey: ['connect'],
+  } as const satisfies MutationOptions<
+    ConnectData<config>,
+    ConnectError,
+    ConnectVariables<config>
+  >
+}
+
+export type ConnectData<config extends Config> = ConnectReturnType<config>
+
+export type ConnectVariables<config extends Config> = ConnectParameters<config>
+
+export type ConnectMutate<config extends Config, context = unknown> = Mutate<
+  ConnectData<config>,
+  ConnectError,
+  ConnectVariables<config>,
+  context
+>
+
+export type ConnectMutateAsync<
+  config extends Config,
+  context = unknown,
+> = MutateAsync<
+  ConnectData<config>,
+  ConnectError,
+  ConnectVariables<config>,
+  context
+>

package/src/query/disconnect.ts

@@ -0,0 +1,43 @@
+import type { MutationOptions } from '@tanstack/query-core'
+
+import {
+  type DisconnectError,
+  type DisconnectParameters,
+  type DisconnectReturnType,
+  disconnect,
+} from '../actions/disconnect.js'
+import type { Config } from '../createConfig.js'
+import type { Mutate, MutateAsync } from './types.js'
+
+export function disconnectMutationOptions<config extends Config>(
+  config: config,
+) {
+  return {
+    mutationFn(variables) {
+      return disconnect(config, variables)
+    },
+    mutationKey: ['disconnect'],
+  } as const satisfies MutationOptions<
+    DisconnectData,
+    DisconnectError,
+    DisconnectVariables
+  >
+}
+
+export type DisconnectData = DisconnectReturnType
+
+export type DisconnectVariables = DisconnectParameters | undefined
+
+export type DisconnectMutate<context = unknown> = Mutate<
+  DisconnectData,
+  DisconnectError,
+  DisconnectVariables,
+  context
+>
+
+export type DisconnectMutateAsync<context = unknown> = MutateAsync<
+  DisconnectData,
+  DisconnectError,
+  DisconnectVariables,
+  context
+>

package/src/query/estimateFeesPerGas.ts

@@ -0,0 +1,56 @@
+import { type QueryOptions } from '@tanstack/query-core'
+import type { FeeValuesType } from 'viem'
+
+import {
+  type EstimateFeesPerGasError,
+  type EstimateFeesPerGasParameters,
+  type EstimateFeesPerGasReturnType,
+  estimateFeesPerGas,
+} from '../actions/estimateFeesPerGas.js'
+import type { Config } from '../createConfig.js'
+import type { Evaluate, ExactPartial } from '../types/utils.js'
+import type { ScopeKeyParameter } from './types.js'
+import { filterQueryOptions } from './utils.js'
+
+export type EstimateFeesPerGasOptions<
+  type extends FeeValuesType,
+  config extends Config,
+> = Evaluate<
+  ExactPartial<EstimateFeesPerGasParameters<type, config>> & ScopeKeyParameter
+>
+
+export function estimateFeesPerGasQueryOptions<
+  config extends Config,
+  type extends FeeValuesType = 'eip1559',
+>(config: config, options: EstimateFeesPerGasOptions<type, config> = {}) {
+  return {
+    async queryFn({ queryKey }) {
+      const { scopeKey: _, ...parameters } = queryKey[1]
+      return estimateFeesPerGas(config, parameters)
+    },
+    queryKey: estimateFeesPerGasQueryKey(options),
+  } as const satisfies QueryOptions<
+    EstimateFeesPerGasQueryFnData<type>,
+    EstimateFeesPerGasError,
+    EstimateFeesPerGasData<type>,
+    EstimateFeesPerGasQueryKey<config, type>
+  >
+}
+
+export type EstimateFeesPerGasQueryFnData<type extends FeeValuesType> =
+  EstimateFeesPerGasReturnType<type>
+
+export type EstimateFeesPerGasData<type extends FeeValuesType,> =
+  EstimateFeesPerGasQueryFnData<type>
+
+export function estimateFeesPerGasQueryKey<
+  config extends Config,
+  type extends FeeValuesType = 'eip1559',
+>(options: EstimateFeesPerGasOptions<type, config> = {}) {
+  return ['estimateFeesPerGas', filterQueryOptions(options)] as const
+}
+
+export type EstimateFeesPerGasQueryKey<
+  config extends Config,
+  type extends FeeValuesType,
+> = ReturnType<typeof estimateFeesPerGasQueryKey<config, type>>

package/src/query/estimateGas.ts

@@ -0,0 +1,55 @@
+import { type QueryOptions } from '@tanstack/query-core'
+
+import {
+  type EstimateGasError,
+  type EstimateGasParameters,
+  type EstimateGasReturnType,
+  estimateGas,
+} from '../actions/estimateGas.js'
+import type { Config } from '../createConfig.js'
+import type { UnionPartial } from '../types/utils.js'
+import type { ScopeKeyParameter } from './types.js'
+import { filterQueryOptions } from './utils.js'
+
+export type EstimateGasOptions<
+  config extends Config,
+  chainId extends config['chains'][number]['id'] | undefined,
+> = UnionPartial<EstimateGasParameters<config, chainId>> & ScopeKeyParameter
+
+export function estimateGasQueryOptions<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+>(config: config, options: EstimateGasOptions<config, chainId> = {} as any) {
+  return {
+    async queryFn({ queryKey }) {
+      const { connector } = options
+      const { account, scopeKey: _, ...parameters } = queryKey[1]
+      if (!account && !connector)
+        throw new Error('account or connector is required')
+      return estimateGas(config, { account, connector, ...parameters } as any)
+    },
+    queryKey: estimateGasQueryKey(options),
+  } as const satisfies QueryOptions<
+    EstimateGasQueryFnData,
+    EstimateGasError,
+    EstimateGasData,
+    EstimateGasQueryKey<config, chainId>
+  >
+}
+
+export type EstimateGasQueryFnData = EstimateGasReturnType
+
+export type EstimateGasData = EstimateGasQueryFnData
+
+export function estimateGasQueryKey<
+  config extends Config,
+  chainId extends config['chains'][number]['id'] | undefined,
+>(options: EstimateGasOptions<config, chainId> = {} as any) {
+  const { connector: _, ...rest } = options
+  return ['estimateGas', filterQueryOptions(rest)] as const
+}
+
+export type EstimateGasQueryKey<
+  config extends Config,
+  chainId extends config['chains'][number]['id'] | undefined,
+> = ReturnType<typeof estimateGasQueryKey<config, chainId>>

package/src/query/getBalance.ts

@@ -0,0 +1,61 @@
+import { type QueryOptions } from '@tanstack/query-core'
+
+import {
+  type GetBalanceError,
+  type GetBalanceParameters,
+  type GetBalanceReturnType,
+  getBalance,
+} from '../actions/getBalance.js'
+import type { Config } from '../createConfig.js'
+import type { Evaluate, PartialBy } from '../types/utils.js'
+import type { ScopeKeyParameter } from './types.js'
+import { filterQueryOptions } from './utils.js'
+
+export type GetBalanceOptions<config extends Config> = Evaluate<
+  PartialBy<GetBalanceParameters<config>, 'address'> & ScopeKeyParameter
+>
+
+export function getBalanceQueryOptions<config extends Config>(
+  config: config,
+  options: GetBalanceOptions<config> = {},
+) {
+  return {
+    async queryFn({ queryKey }) {
+      const {
+        address,
+        blockNumber,
+        blockTag,
+        scopeKey: _,
+        ...parameters
+      } = queryKey[1]
+      if (!address) throw new Error('address is required')
+      const balance = await getBalance(
+        config,
+        blockNumber
+          ? { ...parameters, address, blockNumber }
+          : { ...parameters, address, blockTag },
+      )
+      return balance ?? null
+    },
+    queryKey: getBalanceQueryKey(options),
+  } as const satisfies QueryOptions<
+    GetBalanceQueryFnData,
+    GetBalanceError,
+    GetBalanceData,
+    GetBalanceQueryKey<config>
+  >
+}
+
+export type GetBalanceQueryFnData = Evaluate<GetBalanceReturnType>
+
+export type GetBalanceData = GetBalanceQueryFnData
+
+export function getBalanceQueryKey<config extends Config>(
+  options: GetBalanceOptions<config> = {},
+) {
+  return ['balance', filterQueryOptions(options)] as const
+}
+
+export type GetBalanceQueryKey<config extends Config> = ReturnType<
+  typeof getBalanceQueryKey<config>
+>

package/src/query/getBlock.ts

@@ -0,0 +1,80 @@
+import { type QueryOptions } from '@tanstack/query-core'
+import type { BlockTag } from 'viem'
+
+import {
+  type GetBlockError,
+  type GetBlockParameters,
+  type GetBlockReturnType,
+  getBlock,
+} from '../actions/getBlock.js'
+import type { Config } from '../createConfig.js'
+import type { Evaluate, ExactPartial } from '../types/utils.js'
+import type { ScopeKeyParameter } from './types.js'
+import { filterQueryOptions } from './utils.js'
+
+export type GetBlockOptions<
+  includeTransactions extends boolean,
+  blockTag extends BlockTag,
+  config extends Config,
+  chainId extends
+    | config['chains'][number]['id'] = config['chains'][number]['id'],
+> = Evaluate<
+  ExactPartial<
+    GetBlockParameters<includeTransactions, blockTag, config, chainId>
+  > &
+    ScopeKeyParameter
+>
+
+export function getBlockQueryOptions<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+  includeTransactions extends boolean = false,
+  blockTag extends BlockTag = 'latest',
+>(
+  config: config,
+  options: GetBlockOptions<includeTransactions, blockTag, config, chainId> = {},
+) {
+  return {
+    async queryFn({ queryKey }) {
+      const { scopeKey: _, ...parameters } = queryKey[1]
+      const block = await getBlock(config, parameters)
+      return block ?? null
+    },
+    queryKey: getBlockQueryKey(options),
+  } as const satisfies QueryOptions<
+    GetBlockQueryFnData,
+    GetBlockError,
+    GetBlockData,
+    GetBlockQueryKey<includeTransactions, blockTag, config, chainId>
+  >
+}
+
+export type GetBlockQueryFnData<
+  includeTransactions extends boolean = false,
+  blockTag extends BlockTag = 'latest',
+> = GetBlockReturnType<includeTransactions, blockTag>
+
+export type GetBlockData<
+  includeTransactions extends boolean = false,
+  blockTag extends BlockTag = 'latest',
+> = GetBlockQueryFnData<includeTransactions, blockTag>
+
+export function getBlockQueryKey<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+  includeTransactions extends boolean = false,
+  blockTag extends BlockTag = 'latest',
+>(
+  options: GetBlockOptions<includeTransactions, blockTag, config, chainId> = {},
+) {
+  return ['block', filterQueryOptions(options)] as const
+}
+
+export type GetBlockQueryKey<
+  includeTransactions extends boolean,
+  blockTag extends BlockTag,
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+> = ReturnType<
+  typeof getBlockQueryKey<config, chainId, includeTransactions, blockTag>
+>

package/src/query/getBlockNumber.ts

@@ -0,0 +1,55 @@
+import { type QueryOptions } from '@tanstack/query-core'
+
+import {
+  type GetBlockNumberError,
+  type GetBlockNumberParameters,
+  type GetBlockNumberReturnType,
+  getBlockNumber,
+} from '../actions/getBlockNumber.js'
+import type { Config } from '../createConfig.js'
+import type { Evaluate, ExactPartial } from '../types/utils.js'
+import type { ScopeKeyParameter } from './types.js'
+import { filterQueryOptions } from './utils.js'
+
+export type GetBlockNumberOptions<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+> = Evaluate<
+  ExactPartial<GetBlockNumberParameters<config, chainId>> & ScopeKeyParameter
+>
+
+export function getBlockNumberQueryOptions<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+>(config: config, options: GetBlockNumberOptions<config, chainId> = {}) {
+  return {
+    gcTime: 0,
+    async queryFn({ queryKey }) {
+      const { scopeKey: _, ...parameters } = queryKey[1]
+      const blockNumber = await getBlockNumber(config, parameters)
+      return blockNumber ?? null
+    },
+    queryKey: getBlockNumberQueryKey(options),
+  } as const satisfies QueryOptions<
+    GetBlockNumberQueryFnData,
+    GetBlockNumberError,
+    GetBlockNumberData,
+    GetBlockNumberQueryKey<config, chainId>
+  >
+}
+
+export type GetBlockNumberQueryFnData = GetBlockNumberReturnType
+
+export type GetBlockNumberData = GetBlockNumberQueryFnData
+
+export function getBlockNumberQueryKey<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+>(options: GetBlockNumberOptions<config, chainId> = {}) {
+  return ['blockNumber', filterQueryOptions(options)] as const
+}
+
+export type GetBlockNumberQueryKey<
+  config extends Config,
+  chainId extends config['chains'][number]['id'],
+> = ReturnType<typeof getBlockNumberQueryKey<config, chainId>>