@wagmi/core 2.0.0-beta.7 → 2.0.0-beta.9

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wagmi/core",
   "description": "VanillaJS library for Ethereum",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.9",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -37,6 +37,10 @@
       "types": "./dist/types/exports/chains.d.ts",
       "default": "./dist/esm/exports/chains.js"
     },
+    "./codegen": {
+      "types": "./dist/types/exports/codegen.d.ts",
+      "default": "./dist/esm/exports/codegen.js"
+    },
     "./internal": {
       "types": "./dist/types/exports/internal.d.ts",
       "default": "./dist/esm/exports/internal.js"
@@ -55,6 +59,9 @@
       "chains": [
         "./dist/types/exports/chains.d.ts"
       ],
+      "codegen": [
+        "./dist/types/exports/codegen.d.ts"
+      ],
       "internal": [
         "./dist/types/exports/internal.d.ts"
       ],
@@ -66,7 +73,7 @@
   "peerDependencies": {
     "@tanstack/query-core": ">=5.0.0",
     "typescript": ">=5.0.4",
-    "viem": "2.0.0-beta.15"
+    "viem": "2.0.0-beta.16"
   },
   "peerDependenciesMeta": {
     "@tanstack/query-core": {
@@ -77,9 +84,9 @@
     }
   },
   "dependencies": {
-    "eventemitter3": "^5.0.1",
-    "mipd": "^0.0.5",
-    "zustand": "^4.4.1"
+    "eventemitter3": "5.0.1",
+    "mipd": "0.0.5",
+    "zustand": "4.4.1"
   },
   "contributors": [
     "awkweb.eth <t@wevm.dev>",

package/src/actions/codegen/createReadContract.ts

@@ -0,0 +1,100 @@
+import {
+  type Abi,
+  type Address,
+  type ContractFunctionArgs,
+  type ContractFunctionName,
+} from 'viem'
+
+import { type Config } from '../../createConfig.js'
+import { type UnionEvaluate, type UnionOmit } from '../../types/utils.js'
+import { getAccount } from '../getAccount.js'
+import { getChainId } from '../getChainId.js'
+import {
+  type ReadContractParameters,
+  type ReadContractReturnType,
+  readContract,
+} from '../readContract.js'
+
+type stateMutability = 'pure' | 'view'
+
+export type CreateReadContractParameters<
+  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<
+  abi extends Abi | readonly unknown[],
+  address extends Address | Record<number, Address> | undefined,
+  functionName extends ContractFunctionName<abi, stateMutability> | undefined,
+  ///
+  omittedProperties extends 'abi' | 'address' | 'chainId' | 'functionName' =
+    | 'abi'
+    | (address extends undefined ? never : 'address')
+    | (address extends Record<number, Address> ? 'chainId' : never)
+    | (functionName extends undefined ? never : 'functionName'),
+> = <
+  config extends Config,
+  name extends functionName extends ContractFunctionName<abi, stateMutability>
+    ? functionName
+    : ContractFunctionName<abi, stateMutability>,
+  args extends ContractFunctionArgs<abi, stateMutability, name>,
+>(
+  config: config,
+  parameters: UnionEvaluate<
+    UnionOmit<
+      ReadContractParameters<abi, name, args, config>,
+      omittedProperties
+    >
+  > &
+    (address extends Record<number, Address>
+      ? { chainId?: keyof address | undefined }
+      : unknown),
+) => Promise<ReadContractReturnType<abi, name, args>>
+
+export function createReadContract<
+  const abi extends Abi | readonly unknown[],
+  const address extends
+    | Address
+    | Record<number, Address>
+    | undefined = undefined,
+  functionName extends
+    | ContractFunctionName<abi, stateMutability>
+    | undefined = undefined,
+>(
+  c: CreateReadContractParameters<abi, address, functionName>,
+): CreateReadContractReturnType<abi, address, functionName> {
+  if (c.address !== undefined && typeof c.address === 'object')
+    return (config, parameters) => {
+      const configChainId = getChainId(config)
+      const account = getAccount(config)
+      const chainId =
+        (parameters as { chainId?: number })?.chainId ??
+        account.chainId ??
+        configChainId
+      return readContract(config, {
+        ...(parameters as any),
+        ...(c.functionName ? { functionName: c.functionName } : {}),
+        address: c.address?.[chainId],
+        abi: c.abi,
+      })
+    }
+
+  return (config, parameters) => {
+    return readContract(config, {
+      ...(parameters as any),
+      ...(c.address ? { address: c.address } : {}),
+      ...(c.functionName ? { functionName: c.functionName } : {}),
+      abi: c.abi,
+    })
+  }
+}

package/src/actions/codegen/createSimulateContract.ts

@@ -0,0 +1,122 @@
+import {
+  type Abi,
+  type Account,
+  type Address,
+  type Chain,
+  type ContractFunctionArgs,
+  type ContractFunctionName,
+  type SimulateContractParameters as viem_SimulateContractParameters,
+} from 'viem'
+
+import { type Config } from '../../createConfig.js'
+import { type SelectChains } from '../../types/chain.js'
+import {
+  type ChainIdParameter,
+  type ConnectorParameter,
+} from '../../types/properties.js'
+import { type UnionEvaluate, type UnionOmit } from '../../types/utils.js'
+import { getAccount } from '../getAccount.js'
+import { getChainId } from '../getChainId.js'
+import {
+  type SimulateContractReturnType,
+  simulateContract,
+} from '../simulateContract.js'
+
+type stateMutability = 'nonpayable' | 'payable'
+
+export type CreateSimulateContractParameters<
+  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 CreateSimulateContractReturnType<
+  abi extends Abi | readonly unknown[],
+  address extends Address | Record<number, Address> | undefined,
+  functionName extends ContractFunctionName<abi, stateMutability> | undefined,
+> = <
+  config extends Config,
+  name extends functionName extends ContractFunctionName<abi, stateMutability>
+    ? functionName
+    : ContractFunctionName<abi, stateMutability>,
+  args extends ContractFunctionArgs<abi, stateMutability, name>,
+  chainId extends config['chains'][number]['id'] | undefined = undefined,
+  ///
+  chains extends readonly Chain[] = SelectChains<config, chainId>,
+>(
+  config: config,
+  parameters: {
+    [key in keyof chains]: UnionEvaluate<
+      UnionOmit<
+        viem_SimulateContractParameters<
+          abi,
+          name,
+          args,
+          chains[key],
+          chains[key],
+          Account | Address
+        >,
+        | 'abi'
+        | 'chain'
+        | (address extends undefined ? never : 'address')
+        | (functionName extends undefined ? never : 'functionName')
+      >
+    > &
+      ChainIdParameter<config, chainId> &
+      ConnectorParameter & {
+        chainId?: address extends Record<number, Address>
+          ?
+              | keyof address
+              | (chainId extends keyof address ? chainId : never)
+              | undefined
+          : chainId | number | undefined
+      }
+  }[number],
+) => Promise<SimulateContractReturnType<abi, name, args, config, chainId>>
+
+export function createSimulateContract<
+  const abi extends Abi | readonly unknown[],
+  const address extends
+    | Address
+    | Record<number, Address>
+    | undefined = undefined,
+  functionName extends
+    | ContractFunctionName<abi, stateMutability>
+    | undefined = undefined,
+>(
+  c: CreateSimulateContractParameters<abi, address, functionName>,
+): CreateSimulateContractReturnType<abi, address, functionName> {
+  if (c.address !== undefined && typeof c.address === 'object')
+    return (config, parameters) => {
+      const configChainId = getChainId(config)
+      const account = getAccount(config)
+      const chainId =
+        (parameters as { chainId?: number })?.chainId ??
+        account.chainId ??
+        configChainId
+      return simulateContract(config, {
+        ...(parameters as any),
+        ...(c.functionName ? { functionName: c.functionName } : {}),
+        address: c.address?.[chainId],
+        abi: c.abi,
+      })
+    }
+
+  return (config, parameters) => {
+    return simulateContract(config, {
+      ...(parameters as any),
+      ...(c.address ? { address: c.address } : {}),
+      ...(c.functionName ? { functionName: c.functionName } : {}),
+      abi: c.abi,
+    })
+  }
+}

package/src/actions/codegen/createWatchContractEvent.ts

@@ -0,0 +1,87 @@
+import { type Abi, type Address, type ContractEventName } from 'viem'
+
+import { type Config } from '../../createConfig.js'
+import { type UnionEvaluate, type UnionOmit } from '../../types/utils.js'
+import { getAccount } from '../getAccount.js'
+import { getChainId } from '../getChainId.js'
+import {
+  type WatchContractEventParameters,
+  type WatchContractEventReturnType,
+  watchContractEvent,
+} from '../watchContractEvent.js'
+
+export type CreateWatchContractEventParameters<
+  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 CreateWatchContractEventReturnType<
+  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'),
+> = <
+  config extends Config,
+  name extends eventName extends ContractEventName<abi>
+    ? eventName
+    : ContractEventName<abi>,
+  strict extends boolean | undefined = undefined,
+  chainId extends config['chains'][number]['id'] = config['chains'][number]['id'],
+>(
+  config: config,
+  parameters: UnionEvaluate<
+    UnionOmit<
+      WatchContractEventParameters<abi, name, strict, config, chainId>,
+      omittedProperties
+    >
+  > &
+    (address extends Record<number, Address>
+      ? { chainId?: keyof address | undefined }
+      : unknown),
+) => WatchContractEventReturnType
+
+export function createWatchContractEvent<
+  const abi extends Abi | readonly unknown[],
+  const address extends
+    | Address
+    | Record<number, Address>
+    | undefined = undefined,
+  eventName extends ContractEventName<abi> | undefined = undefined,
+>(
+  c: CreateWatchContractEventParameters<abi, address, eventName>,
+): CreateWatchContractEventReturnType<abi, address, eventName> {
+  if (c.address !== undefined && typeof c.address === 'object')
+    return (config, parameters) => {
+      const configChainId = getChainId(config)
+      const account = getAccount(config)
+      const chainId =
+        (parameters as { chainId?: number })?.chainId ??
+        account.chainId ??
+        configChainId
+      return watchContractEvent(config, {
+        ...(parameters as any),
+        ...(c.eventName ? { functionName: c.eventName } : {}),
+        address: c.address?.[chainId],
+        abi: c.abi,
+      })
+    }
+
+  return (config, parameters) => {
+    return watchContractEvent(config, {
+      ...(parameters as any),
+      ...(c.address ? { address: c.address } : {}),
+      ...(c.eventName ? { functionName: c.eventName } : {}),
+      abi: c.abi,
+    })
+  }
+}

package/src/actions/codegen/createWriteContract.ts

@@ -0,0 +1,142 @@
+import {
+  type Abi,
+  type Account,
+  type Address,
+  type Chain,
+  type ContractFunctionArgs,
+  type ContractFunctionName,
+  type WriteContractParameters as viem_WriteContractParameters,
+} from 'viem'
+
+import { type Config } from '../../createConfig.js'
+import { type SelectChains } from '../../types/chain.js'
+import {
+  type ChainIdParameter,
+  type ConnectorParameter,
+} from '../../types/properties.js'
+import {
+  type Evaluate,
+  type UnionEvaluate,
+  type UnionOmit,
+} from '../../types/utils.js'
+import { getAccount } from '../getAccount.js'
+import { getChainId } from '../getChainId.js'
+import {
+  type WriteContractReturnType,
+  writeContract,
+} from '../writeContract.js'
+
+type stateMutability = 'nonpayable' | 'payable'
+
+export type CreateWriteContractParameters<
+  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 CreateWriteContractReturnType<
+  abi extends Abi | readonly unknown[],
+  address extends Address | Record<number, Address> | undefined,
+  functionName extends ContractFunctionName<abi, stateMutability> | undefined,
+> = <
+  config extends Config,
+  name extends functionName extends ContractFunctionName<abi, stateMutability>
+    ? functionName
+    : ContractFunctionName<abi, stateMutability>,
+  args extends ContractFunctionArgs<abi, stateMutability, name>,
+  chainId extends config['chains'][number]['id'],
+  ///
+  allFunctionNames = ContractFunctionName<abi, 'nonpayable' | 'payable'>,
+  chains extends readonly Chain[] = SelectChains<config, chainId>,
+  omittedProperties extends 'abi' | 'address' | 'functionName' =
+    | 'abi'
+    | (address extends undefined ? never : 'address')
+    | (functionName extends undefined ? never : 'functionName'),
+>(
+  config: config,
+  parameters: UnionEvaluate<
+    {
+      [key in keyof chains]: UnionOmit<
+        viem_WriteContractParameters<
+          abi,
+          name,
+          args,
+          chains[key],
+          Account,
+          chains[key],
+          allFunctionNames
+        >,
+        omittedProperties | 'chain'
+      >
+    }[number] &
+      (address extends Record<number, Address>
+        ? {
+            chainId?:
+              | keyof address
+              | (chainId extends keyof address ? chainId : never)
+              | undefined
+          }
+        : Evaluate<ChainIdParameter<config, chainId>>) &
+      ConnectorParameter & { __mode?: 'prepared' }
+  >,
+) => Promise<WriteContractReturnType>
+
+export function createWriteContract<
+  const abi extends Abi | readonly unknown[],
+  const address extends
+    | Address
+    | Record<number, Address>
+    | undefined = undefined,
+  functionName extends
+    | ContractFunctionName<abi, stateMutability>
+    | undefined = undefined,
+>(
+  c: CreateWriteContractParameters<abi, address, functionName>,
+): CreateWriteContractReturnType<abi, address, functionName> {
+  if (c.address !== undefined && typeof c.address === 'object')
+    return (config, parameters) => {
+      const configChainId = getChainId(config)
+      const account = getAccount(config)
+
+      let chainId
+      if (parameters.chainId) chainId = parameters.chainId
+      else if (
+        (parameters as unknown as { account: Address | Account | undefined })
+          .account &&
+        (parameters as unknown as { account: Address | Account | undefined })
+          .account === account.address
+      )
+        chainId = account.chainId
+      else if (
+        (parameters as unknown as { account: Address | Account | undefined })
+          .account === undefined
+      )
+        chainId = account.chainId
+      else chainId = configChainId
+
+      return writeContract(config, {
+        ...(parameters as any),
+        ...(c.functionName ? { functionName: c.functionName } : {}),
+        address: chainId ? c.address?.[chainId] : undefined,
+        abi: c.abi,
+      })
+    }
+
+  return (config, parameters) => {
+    return writeContract(config, {
+      ...(parameters as any),
+      ...(c.address ? { address: c.address } : {}),
+      ...(c.functionName ? { functionName: c.functionName } : {}),
+      abi: c.abi,
+    })
+  }
+}

package/src/actions/simulateContract.ts

@@ -14,11 +14,11 @@ import {
 } from 'viem/actions'
 
 import { type Config } from '../createConfig.js'
-import type { BaseErrorType, ErrorType } from '../errors/base.js'
-import type { SelectChains } from '../types/chain.js'
-import type {
-  ChainIdParameter,
-  ConnectorParameter,
+import { type BaseErrorType, type ErrorType } from '../errors/base.js'
+import { type SelectChains } from '../types/chain.js'
+import {
+  type ChainIdParameter,
+  type ConnectorParameter,
 } from '../types/properties.js'
 import type { PartialBy, UnionEvaluate, UnionOmit } from '../types/utils.js'
 import {

package/src/actions/watchContractEvent.ts

@@ -10,13 +10,14 @@ import {
   type WatchContractEventReturnType as viem_WatchContractEventReturnType,
   watchContractEvent as viem_watchContractEvent,
 } from 'viem/actions'
+
 import { type Config } from '../createConfig.js'
-import type { SelectChains } from '../types/chain.js'
-import type {
-  ChainIdParameter,
-  SyncConnectedChainParameter,
+import { type SelectChains } from '../types/chain.js'
+import {
+  type ChainIdParameter,
+  type SyncConnectedChainParameter,
 } from '../types/properties.js'
-import type { UnionEvaluate } from '../types/utils.js'
+import { type UnionEvaluate } from '../types/utils.js'
 
 export type WatchContractEventParameters<
   abi extends Abi | readonly unknown[] = Abi,

package/src/actions/writeContract.ts

@@ -13,11 +13,11 @@ import {
 } from 'viem/actions'
 
 import { type Config } from '../createConfig.js'
-import type { BaseErrorType, ErrorType } from '../errors/base.js'
-import type { SelectChains } from '../types/chain.js'
-import type {
-  ChainIdParameter,
-  ConnectorParameter,
+import { type BaseErrorType, type ErrorType } from '../errors/base.js'
+import { type SelectChains } from '../types/chain.js'
+import {
+  type ChainIdParameter,
+  type ConnectorParameter,
 } from '../types/properties.js'
 import type { Evaluate, UnionEvaluate, UnionOmit } from '../types/utils.js'
 import {

package/src/exports/actions.ts

@@ -1,5 +1,6 @@
 ////////////////////////////////////////////////////////////////////////////////
 // Actions
+////////////////////////////////////////////////////////////////////////////////
 
 export {
   type ConnectErrorType,

package/src/exports/chains.ts

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

package/src/exports/codegen.ts

@@ -0,0 +1,7 @@
+export { createSimulateContract } from '../actions/codegen/createSimulateContract.js'
+
+export { createReadContract } from '../actions/codegen/createReadContract.js'
+
+export { createWatchContractEvent } from '../actions/codegen/createWatchContractEvent.js'
+
+export { createWriteContract } from '../actions/codegen/createWriteContract.js'

package/src/exports/index.ts

@@ -1,5 +1,6 @@
 ////////////////////////////////////////////////////////////////////////////////
 // Actions
+////////////////////////////////////////////////////////////////////////////////
 
 export {
   type ConnectErrorType,
@@ -309,7 +310,8 @@ export {
 } from '../actions/writeContract.js'
 
 ////////////////////////////////////////////////////////////////////////////////
-// connectors
+// Connectors
+////////////////////////////////////////////////////////////////////////////////
 
 export {
   type ConnectorEventMap,
@@ -329,6 +331,7 @@ export {
 
 ////////////////////////////////////////////////////////////////////////////////
 // createConfig
+////////////////////////////////////////////////////////////////////////////////
 
 export {
   type Connection,
@@ -341,6 +344,7 @@ export {
 
 ////////////////////////////////////////////////////////////////////////////////
 // createStorage
+////////////////////////////////////////////////////////////////////////////////
 
 export {
   type CreateStorageParameters,
@@ -351,12 +355,14 @@ export {
 } from '../createStorage.js'
 
 ////////////////////////////////////////////////////////////////////////////////
-// hydrate
+// Hydrate
+////////////////////////////////////////////////////////////////////////////////
 
 export { hydrate } from '../hydrate.js'
 
 ////////////////////////////////////////////////////////////////////////////////
 // Errors
+////////////////////////////////////////////////////////////////////////////////
 
 export { BaseError } from '../errors/base.js'
 
@@ -382,18 +388,23 @@ export {
 
 ////////////////////////////////////////////////////////////////////////////////
 // Transports
+////////////////////////////////////////////////////////////////////////////////
 
 export { custom, http, webSocket } from 'viem'
+
 export { unstable_connector } from '../transports/connector.js'
+
 export { fallback } from '../transports/fallback.js'
 
 ////////////////////////////////////////////////////////////////////////////////
 // Types
+////////////////////////////////////////////////////////////////////////////////
 
 export { type Register, type ResolvedRegister } from '../types/register.js'
 
 ////////////////////////////////////////////////////////////////////////////////
 // Utilities
+////////////////////////////////////////////////////////////////////////////////
 
 export {
   cookieStorage,
@@ -411,5 +422,6 @@ export { serialize } from '../utils/serialize.js'
 
 ////////////////////////////////////////////////////////////////////////////////
 // Version
+////////////////////////////////////////////////////////////////////////////////
 
 export { version } from '../version.js'