viem 2.28.0-entrypoint-0-8-20250417075822 → 2.28.1-canary-20250426072350

package/{experimental/eip5792/actions → actions/wallet}/getCapabilities.ts

@@ -1,16 +1,16 @@
 import type { Address } from 'abitype'
 
-import { parseAccount } from '../../../accounts/utils/parseAccount.js'
-import type { Client } from '../../../clients/createClient.js'
-import type { Transport } from '../../../clients/transports/createTransport.js'
-import type { ErrorType } from '../../../errors/utils.js'
-import type { Account } from '../../../types/account.js'
+import { parseAccount } from '../../accounts/utils/parseAccount.js'
+import type { Client } from '../../clients/createClient.js'
+import type { Transport } from '../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../errors/utils.js'
+import type { Account } from '../../types/account.js'
 import type {
   WalletCapabilities,
   WalletCapabilitiesRecord,
-} from '../../../types/eip1193.js'
-import type { Prettify } from '../../../types/utils.js'
-import type { RequestErrorType } from '../../../utils/buildRequest.js'
+} from '../../types/eip1193.js'
+import type { Prettify } from '../../types/utils.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
 
 export type GetCapabilitiesParameters<
   chainId extends number | undefined = undefined,
@@ -32,7 +32,7 @@ export type GetCapabilitiesErrorType = RequestErrorType | ErrorType
 /**
  * Extract capabilities that a connected wallet supports (e.g. paymasters, session keys, etc).
  *
- * - Docs: https://viem.sh/experimental/eip5792/getCapabilities
+ * - Docs: https://viem.sh/docs/actions/wallet/getCapabilities
  * - JSON-RPC Methods: [`wallet_getCapabilities`](https://eips.ethereum.org/EIPS/eip-5792)
  *
  * @param client - Client to use
@@ -41,7 +41,7 @@ export type GetCapabilitiesErrorType = RequestErrorType | ErrorType
  * @example
  * import { createWalletClient, custom } from 'viem'
  * import { mainnet } from 'viem/chains'
- * import { getCapabilities } from 'viem/experimental'
+ * import { getCapabilities } from 'viem/actions'
  *
  * const client = createWalletClient({
  *   chain: mainnet,

package/{experimental/eip5792/actions → actions/wallet}/sendCalls.ts

@@ -1,21 +1,21 @@
 import type { Address, Narrow } from 'abitype'
-import { parseAccount } from '../../../accounts/utils/parseAccount.js'
-import type { Client } from '../../../clients/createClient.js'
-import type { Transport } from '../../../clients/transports/createTransport.js'
-import { AccountNotFoundError } from '../../../errors/account.js'
-import type { BaseError } from '../../../errors/base.js'
-import type { ErrorType } from '../../../errors/utils.js'
-import type { Account, GetAccountParameter } from '../../../types/account.js'
-import type { Call, Calls } from '../../../types/calls.js'
-import type { Chain, DeriveChain } from '../../../types/chain.js'
+import { parseAccount } from '../../accounts/utils/parseAccount.js'
+import type { Client } from '../../clients/createClient.js'
+import type { Transport } from '../../clients/transports/createTransport.js'
+import { AccountNotFoundError } from '../../errors/account.js'
+import type { BaseError } from '../../errors/base.js'
+import type { ErrorType } from '../../errors/utils.js'
+import type { Account, GetAccountParameter } from '../../types/account.js'
+import type { Call, Calls } from '../../types/calls.js'
+import type { Chain, DeriveChain } from '../../types/chain.js'
 import type {
   WalletCapabilities,
   WalletSendCallsParameters,
-} from '../../../types/eip1193.js'
-import { encodeFunctionData } from '../../../utils/abi/encodeFunctionData.js'
-import type { RequestErrorType } from '../../../utils/buildRequest.js'
-import { numberToHex } from '../../../utils/encoding/toHex.js'
-import { getTransactionError } from '../../../utils/errors/getTransactionError.js'
+} from '../../types/eip1193.js'
+import { encodeFunctionData } from '../../utils/abi/encodeFunctionData.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import { numberToHex } from '../../utils/encoding/toHex.js'
+import { getTransactionError } from '../../utils/errors/getTransactionError.js'
 
 export type SendCallsParameters<
   chain extends Chain | undefined = Chain | undefined,
@@ -43,7 +43,7 @@ export type SendCallsErrorType = RequestErrorType | ErrorType
 /**
  * Requests the connected wallet to send a batch of calls.
  *
- * - Docs: https://viem.sh/experimental/eip5792/sendCalls
+ * - Docs: https://viem.sh/docs/actions/wallet/sendCalls
  * - JSON-RPC Methods: [`wallet_sendCalls`](https://eips.ethereum.org/EIPS/eip-5792)
  *
  * @param client - Client to use
@@ -52,7 +52,7 @@ export type SendCallsErrorType = RequestErrorType | ErrorType
  * @example
  * import { createWalletClient, custom } from 'viem'
  * import { mainnet } from 'viem/chains'
- * import { sendCalls } from 'viem/experimental'
+ * import { sendCalls } from 'viem/actions'
  *
  * const client = createWalletClient({
  *   chain: mainnet,
@@ -87,12 +87,12 @@ export async function sendCalls<
     chain = client.chain,
     forceAtomic = false,
     id,
-    version = '1.0',
+    version = '2.0.0',
   } = parameters
 
   if (typeof account_ === 'undefined')
     throw new AccountNotFoundError({
-      docsPath: '/experimental/eip5792/sendCalls',
+      docsPath: '/docs/actions/wallet/sendCalls',
     })
   const account = account_ ? parseAccount(account_) : null
 

package/{experimental/eip5792/actions → actions/wallet}/showCallsStatus.ts

@@ -1,9 +1,9 @@
-import type { Client } from '../../../clients/createClient.js'
-import type { Transport } from '../../../clients/transports/createTransport.js'
-import type { ErrorType } from '../../../errors/utils.js'
-import type { Account } from '../../../types/account.js'
-import type { Chain } from '../../../types/chain.js'
-import type { RequestErrorType } from '../../../utils/buildRequest.js'
+import type { Client } from '../../clients/createClient.js'
+import type { Transport } from '../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../errors/utils.js'
+import type { Account } from '../../types/account.js'
+import type { Chain } from '../../types/chain.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
 
 export type ShowCallsStatusParameters = { id: string }
 
@@ -15,7 +15,7 @@ export type ShowCallsStatusErrorType = RequestErrorType | ErrorType
  * Requests for the wallet to show information about a call batch
  * that was sent via `sendCalls`.
  *
- * - Docs: https://viem.sh/experimental/eip5792/showCallsStatus
+ * - Docs: https://viem.sh/docs/actions/wallet/showCallsStatus
  * - JSON-RPC Methods: [`wallet_showCallsStatus`](https://eips.ethereum.org/EIPS/eip-5792)
  *
  * @param client - Client to use
@@ -24,7 +24,7 @@ export type ShowCallsStatusErrorType = RequestErrorType | ErrorType
  * @example
  * import { createWalletClient, custom } from 'viem'
  * import { mainnet } from 'viem/chains'
- * import { showCallsStatus } from 'viem/experimental'
+ * import { showCallsStatus } from 'viem/actions'
  *
  * const client = createWalletClient({
  *   chain: mainnet,

package/actions/wallet/switchChain.ts

@@ -23,7 +23,7 @@ export type SwitchChainErrorType =
  * Switch the target chain in a wallet.
  *
  * - Docs: https://viem.sh/docs/actions/wallet/switchChain
- * - JSON-RPC Methods: [`eth_switchEthereumChain`](https://eips.ethereum.org/EIPS/eip-3326)
+ * - JSON-RPC Methods: [`wallet_switchEthereumChain`](https://eips.ethereum.org/EIPS/eip-3326)
  *
  * @param client - Client to use
  * @param parameters - {@link SwitchChainParameters}

package/{experimental/eip5792/actions → actions/wallet}/waitForCallsStatus.ts

@@ -1,12 +1,12 @@
-import type { Client } from '../../../clients/createClient.js'
-import type { Transport } from '../../../clients/transports/createTransport.js'
-import { BaseError } from '../../../errors/base.js'
-import type { ErrorType } from '../../../errors/utils.js'
-import type { Chain } from '../../../types/chain.js'
-import { type ObserveErrorType, observe } from '../../../utils/observe.js'
-import { type PollErrorType, poll } from '../../../utils/poll.js'
-import { withResolvers } from '../../../utils/promise/withResolvers.js'
-import { stringify } from '../../../utils/stringify.js'
+import type { Client } from '../../clients/createClient.js'
+import type { Transport } from '../../clients/transports/createTransport.js'
+import { BaseError } from '../../errors/base.js'
+import type { ErrorType } from '../../errors/utils.js'
+import type { Chain } from '../../types/chain.js'
+import { type ObserveErrorType, observe } from '../../utils/observe.js'
+import { type PollErrorType, poll } from '../../utils/poll.js'
+import { withResolvers } from '../../utils/promise/withResolvers.js'
+import { stringify } from '../../utils/stringify.js'
 import {
   type GetCallsStatusErrorType,
   type GetCallsStatusReturnType,
@@ -50,7 +50,7 @@ export type WaitForCallsStatusErrorType =
 /**
  * Waits for the status & receipts of a call bundle that was sent via `sendCalls`.
  *
- * - Docs: https://viem.sh/experimental/eip5792/waitForCallsStatus
+ * - Docs: https://viem.sh/docs/actions/wallet/waitForCallsStatus
  * - JSON-RPC Methods: [`wallet_getCallsStatus`](https://eips.ethereum.org/EIPS/eip-5792)
  *
  * @param client - Client to use
@@ -60,7 +60,7 @@ export type WaitForCallsStatusErrorType =
  * @example
  * import { createWalletClient, custom } from 'viem'
  * import { mainnet } from 'viem/chains'
- * import { waitForCallsStatus } from 'viem/experimental'
+ * import { waitForCallsStatus } from 'viem/actions'
  *
  * const client = createWalletClient({
  *   chain: mainnet,

package/chains/definitions/gunz.ts

@@ -0,0 +1,26 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const gunz = /*#__PURE__*/ defineChain({
+  id: 43_419,
+  name: 'Gunz Mainnet',
+  nativeCurrency: { name: 'GUN', symbol: 'GUN', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: [
+        'https://rpc.gunzchain.io/ext/bc/2M47TxWHGnhNtq6pM5zPXdATBtuqubxn5EPFgFmEawCQr9WFML/rpc',
+      ],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Gunz Explorer',
+      url: 'https://gunzscan.io/',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 70502,
+    },
+  },
+})

package/chains/definitions/memecore.ts

@@ -0,0 +1,33 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const memecore = /*#__PURE__*/ defineChain({
+  id: 4352,
+  name: 'MemeCore',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'M',
+    symbol: 'M',
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.memecore.net'],
+      webSocket: ['wss://ws.memecore.net'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'MemeCore Explorer',
+      url: 'https://memecorescan.io',
+      apiUrl: 'https://api.memecorescan.io/api',
+    },
+    okx: {
+      name: 'MemeCore Explorer',
+      url: 'https://web3.okx.com/explorer/memecore',
+    },
+    memecore: {
+      name: 'MemeCore Explorer',
+      url: 'https://blockscout.memecore.com',
+      apiUrl: 'https://blockscout.memecore.com/api',
+    },
+  },
+})

package/chains/definitions/memecoreFormicariumTestnet.ts

@@ -0,0 +1,33 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const formicarium = /*#__PURE__*/ defineChain({
+  id: 43521,
+  name: 'Formicarium',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'M',
+    symbol: 'M',
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.formicarium.memecore.net'],
+      webSocket: ['wss://ws.formicarium.memecore.net'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'MemeCore Testnet Explorer',
+      url: 'https://formicarium.memecorescan.io',
+    },
+    okx: {
+      name: 'MemeCore Testnet Explorer',
+      url: 'https://web3.okx.com/explorer/formicarium-testnet',
+    },
+    memecore: {
+      name: 'MemeCore Testnet Explorer',
+      url: 'https://formicarium.blockscout.memecore.com',
+      apiUrl: 'https://formicarium.blockscout.memecore.com/api',
+    },
+  },
+  testnet: true,
+})

package/chains/index.ts

@@ -186,6 +186,7 @@ export { fluenceTestnet } from './definitions/fluenceTestnet.js'
 export { fluentTestnet } from './definitions/fluentTestnet.js'
 export { forma } from './definitions/forma.js'
 export { form } from './definitions/form.js'
+export { formicarium } from './definitions/memecoreFormicariumTestnet.js'
 export { formTestnet } from './definitions/formTestnet.js'
 export { forta } from './definitions/forta.js'
 /** @deprecated Use `anvil` instead. */
@@ -211,6 +212,7 @@ export { goChain } from './definitions/goChain.js'
 export { godwoken } from './definitions/godwoken.js'
 export { goerli } from './definitions/goerli.js'
 export { gravity } from './definitions/gravity.js'
+export { gunz } from './definitions/gunz.js'
 export { guruNetwork } from './definitions/guruNetwork.js'
 export { guruTestnet } from './definitions/guruTestnet.js'
 export { ham } from './definitions/ham.js'
@@ -324,6 +326,7 @@ export { mchVerse } from './definitions/mchVerse.js'
 export { megaethTestnet } from './definitions/megaethTestnet.js'
 export { mekong } from './definitions/mekong.js'
 export { meld } from './definitions/meld.js'
+export { memecore } from './definitions/memecore.js'
 export { merlin } from './definitions/merlin.js'
 export { merlinErigonTestnet } from './definitions/merlinErigonTestnet.js'
 export { metachain } from './definitions/metachain.js'

package/clients/decorators/wallet.ts

@@ -18,6 +18,16 @@ import {
   type GetAddressesReturnType,
   getAddresses,
 } from '../../actions/wallet/getAddresses.js'
+import {
+  type GetCallsStatusParameters,
+  type GetCallsStatusReturnType,
+  getCallsStatus,
+} from '../../actions/wallet/getCallsStatus.js'
+import {
+  type GetCapabilitiesParameters,
+  type GetCapabilitiesReturnType,
+  getCapabilities,
+} from '../../actions/wallet/getCapabilities.js'
 import {
   type GetPermissionsReturnType,
   getPermissions,
@@ -42,6 +52,11 @@ import {
   type RequestPermissionsReturnType,
   requestPermissions,
 } from '../../actions/wallet/requestPermissions.js'
+import {
+  type SendCallsParameters,
+  type SendCallsReturnType,
+  sendCalls,
+} from '../../actions/wallet/sendCalls.js'
 import {
   type SendRawTransactionParameters,
   type SendRawTransactionReturnType,
@@ -53,6 +68,11 @@ import {
   type SendTransactionReturnType,
   sendTransaction,
 } from '../../actions/wallet/sendTransaction.js'
+import {
+  type ShowCallsStatusParameters,
+  type ShowCallsStatusReturnType,
+  showCallsStatus,
+} from '../../actions/wallet/showCallsStatus.js'
 import {
   type SignAuthorizationParameters,
   type SignAuthorizationReturnType,
@@ -78,6 +98,11 @@ import {
   type SwitchChainParameters,
   switchChain,
 } from '../../actions/wallet/switchChain.js'
+import {
+  type WaitForCallsStatusParameters,
+  type WaitForCallsStatusReturnType,
+  waitForCallsStatus,
+} from '../../actions/wallet/waitForCallsStatus.js'
 import {
   type WatchAssetParameters,
   type WatchAssetReturnType,
@@ -168,6 +193,54 @@ export type WalletActions<
    * const accounts = await client.getAddresses()
    */
   getAddresses: () => Promise<GetAddressesReturnType>
+  /**
+   * Returns the status of a call batch that was sent via `sendCalls`.
+   *
+   * - Docs: https://viem.sh/docs/actions/wallet/getCallsStatus
+   * - JSON-RPC Methods: [`wallet_getCallsStatus`](https://eips.ethereum.org/EIPS/eip-5792)
+   *
+   * @param client - Client to use
+   * @returns Status of the calls. {@link GetCallsStatusReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   *
+   * const { receipts, status } = await client.getCallsStatus({ id: '0xdeadbeef' })
+   */
+  getCallsStatus: (
+    parameters: GetCallsStatusParameters,
+  ) => Promise<GetCallsStatusReturnType>
+  /**
+   * Extract capabilities that a connected wallet supports (e.g. paymasters, session keys, etc).
+   *
+   * - Docs: https://viem.sh/docs/actions/wallet/getCapabilities
+   * - JSON-RPC Methods: [`wallet_getCapabilities`](https://eips.ethereum.org/EIPS/eip-5792)
+   *
+   * @param client - Client to use
+   * @returns The wallet's capabilities. {@link GetCapabilitiesReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   *
+   * const capabilities = await client.getCapabilities({
+   *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+   * })
+   */
+  getCapabilities: (
+    parameters?: GetCapabilitiesParameters,
+  ) => Promise<GetCapabilitiesReturnType>
   /**
    * Returns the chain ID associated with the current network.
    *
@@ -360,6 +433,44 @@ export type WalletActions<
   requestPermissions: (
     args: RequestPermissionsParameters,
   ) => Promise<RequestPermissionsReturnType>
+  /**
+   * Requests the connected wallet to send a batch of calls.
+   *
+   * - Docs: https://viem.sh/docs/actions/wallet/sendCalls
+   * - JSON-RPC Methods: [`wallet_sendCalls`](https://eips.ethereum.org/EIPS/eip-5792)
+   *
+   * @param client - Client to use
+   * @returns Transaction identifier. {@link SendCallsReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   *
+   * const id = await client.sendCalls({
+   *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+   *   calls: [
+   *     {
+   *       data: '0xdeadbeef',
+   *       to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+   *     },
+   *     {
+   *       to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+   *       value: 69420n,
+   *     },
+   *   ],
+   * })
+   */
+  sendCalls: <
+    const calls extends readonly unknown[],
+    chainOverride extends Chain | undefined = undefined,
+  >(
+    parameters: SendCallsParameters<chain, account, chainOverride, calls>,
+  ) => Promise<SendCallsReturnType>
   /**
    * Sends a **signed** transaction to the network
    *
@@ -435,6 +546,30 @@ export type WalletActions<
   >(
     args: SendTransactionParameters<chain, account, chainOverride, request>,
   ) => Promise<SendTransactionReturnType>
+  /**
+   * Requests for the wallet to show information about a call batch
+   * that was sent via `sendCalls`.
+   *
+   * - Docs: https://viem.sh/docs/actions/wallet/showCallsStatus
+   * - JSON-RPC Methods: [`wallet_showCallsStatus`](https://eips.ethereum.org/EIPS/eip-5792)
+   *
+   * @param client - Client to use
+   * @returns Displays status of the calls in wallet. {@link ShowCallsStatusReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   *
+   * await client.showCallsStatus({ id: '0xdeadbeef' })
+   */
+  showCallsStatus: (
+    parameters: ShowCallsStatusParameters,
+  ) => Promise<ShowCallsStatusReturnType>
   /**
    * Signs an [EIP-7702 Authorization](https://eips.ethereum.org/EIPS/eip-7702) object.
    *
@@ -699,6 +834,30 @@ export type WalletActions<
    * await client.switchChain({ id: optimism.id })
    */
   switchChain: (args: SwitchChainParameters) => Promise<void>
+  /**
+   * Waits for the status & receipts of a call bundle that was sent via `sendCalls`.
+   *
+   * - Docs: https://viem.sh/docs/actions/wallet/waitForCallsStatus
+   * - JSON-RPC Methods: [`wallet_getCallsStatus`](https://eips.ethereum.org/EIPS/eip-5792)
+   *
+   * @param client - Client to use
+   * @param parameters - {@link WaitForCallsStatusParameters}
+   * @returns Status & receipts of the call bundle. {@link WaitForCallsStatusReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   *
+   * const { receipts, status } = await waitForCallsStatus(client, { id: '0xdeadbeef' })
+   */
+  waitForCallsStatus: (
+    parameters: WaitForCallsStatusParameters,
+  ) => Promise<WaitForCallsStatusReturnType>
   /**
    * Adds an EVM chain to the wallet.
    *
@@ -803,6 +962,8 @@ export function walletActions<
     addChain: (args) => addChain(client, args),
     deployContract: (args) => deployContract(client, args),
     getAddresses: () => getAddresses(client),
+    getCallsStatus: (args) => getCallsStatus(client, args),
+    getCapabilities: () => getCapabilities(client),
     getChainId: () => getChainId(client),
     getPermissions: () => getPermissions(client),
     prepareAuthorization: (args) => prepareAuthorization(client, args),
@@ -810,13 +971,16 @@ export function walletActions<
       prepareTransactionRequest(client as any, args as any) as any,
     requestAddresses: () => requestAddresses(client),
     requestPermissions: (args) => requestPermissions(client, args),
+    sendCalls: (args) => sendCalls(client, args),
     sendRawTransaction: (args) => sendRawTransaction(client, args),
     sendTransaction: (args) => sendTransaction(client, args),
+    showCallsStatus: (args) => showCallsStatus(client, args),
     signAuthorization: (args) => signAuthorization(client, args),
     signMessage: (args) => signMessage(client, args),
     signTransaction: (args) => signTransaction(client, args),
     signTypedData: (args) => signTypedData(client, args),
     switchChain: (args) => switchChain(client, args),
+    waitForCallsStatus: (args) => waitForCallsStatus(client, args),
     watchAsset: (args) => watchAsset(client, args),
     writeContract: (args) => writeContract(client, args as any),
   }