feat: stabilize EIP-5792 (#3592)

* feat: stabilize eip5792

* Update three-socks-thank.md

* chore: tweaks

* chore: tweaks

* chore: tweaks

* chore: tweaks

Author: jxom

.changeset/three-socks-thank.md

@@ -0,0 +1,5 @@
+---
+"viem": minor
+---
+
+Stabilized EIP-5792 (moved out of experimental).

package.json

@@ -110,7 +110,7 @@
     {
       "name": "import * from 'viem' (esm)",
       "path": "./src/_esm/index.js",
-      "limit": "70 kB",
+      "limit": "71 kB",
       "import": "*"
     },
     {
@@ -151,7 +151,7 @@
     {
       "name": "import * from 'viem/actions'",
       "path": "./src/_esm/actions/index.js",
-      "limit": "55 kB",
+      "limit": "56 kB",
       "import": "*"
     },
     {

site/pages/experimental/eip5792/getCallsStatus.mdx renamed to site/pages/docs/actions/wallet/getCallsStatus.mdx

@@ -6,11 +6,7 @@ description: Returns the status of a call batch.
 
 Returns the status of a call batch that was sent via `sendCalls`.
 
-[Read more.](https://eips.ethereum.org/EIPS/eip-5792#wallet_getcallsstatus)
-
-:::warning[Warning]
-This is an experimental action that is not supported in most wallets. It is recommended to have a fallback mechanism if using this in production.
-:::
+[Read more](https://eips.ethereum.org/EIPS/eip-5792#wallet_getcallsstatus)
 
 ## Usage
 
@@ -37,12 +33,11 @@ import 'viem/window'
 // ---cut---
 import { createWalletClient, custom } from 'viem'
 import { mainnet } from 'viem/chains'
-import { eip5792Actions } from 'viem/experimental'
 
 export const walletClient = createWalletClient({
   chain: mainnet,
   transport: custom(window.ethereum!),
-}).extend(eip5792Actions())
+})
 
 export const [account] = await walletClient.getAddresses()
 ```

site/pages/experimental/eip5792/getCapabilities.mdx renamed to site/pages/docs/actions/wallet/getCapabilities.mdx

@@ -6,11 +6,7 @@ description: Extract capabilities that a connected wallet supports.
 
 Extract capabilities (grouped by chain ID) that a connected wallet supports (e.g. paymasters, session keys, etc).
 
-[Read more.](https://github.com/ethereum/EIPs/blob/815028dc634463e1716fc5ce44c019a6040f0bef/EIPS/eip-5792.md#wallet_getcapabilities)
-
-:::warning[Warning]
-This is an experimental action that is not supported in most wallets. It is recommended to have a fallback mechanism if using this in production.
-:::
+[Read more](https://github.com/ethereum/EIPs/blob/815028dc634463e1716fc5ce44c019a6040f0bef/EIPS/eip-5792.md#wallet_getcapabilities)
 
 ## Usage
 
@@ -44,12 +40,11 @@ import 'viem/window'
 // ---cut---
 import { createWalletClient, custom } from 'viem'
 import { mainnet } from 'viem/chains'
-import { eip5792Actions } from 'viem/experimental'
 
 export const walletClient = createWalletClient({
   chain: mainnet,
   transport: custom(window.ethereum!),
-}).extend(eip5792Actions())
+})
 
 export const [account] = await walletClient.getAddresses()
 ```
@@ -73,7 +68,6 @@ const capabilities = await walletClient.getCapabilities()
 ```ts [config.ts] filename="config.ts"
 import 'viem/window'
 import { createWalletClient, custom } from 'viem'
-import { eip5792Actions } from 'viem/experimental'
 
 // Retrieve Account from an EIP-1193 Provider.
 const [account] = await window.ethereum!.request({ 
@@ -83,7 +77,7 @@ const [account] = await window.ethereum!.request({
 export const walletClient = createWalletClient({
   account,
   transport: custom(window.ethereum!)
-}).extend(eip5792Actions())
+})
 ```
 
 :::

site/pages/experimental/eip5792/sendCalls.mdx renamed to site/pages/docs/actions/wallet/sendCalls.mdx

@@ -6,11 +6,7 @@ description: Sign and broadcast a batch of calls to the network.
 
 Requests for the wallet to sign and broadcast a batch of calls to the network. 
 
-[Read more.](https://eips.ethereum.org/EIPS/eip-5792#wallet_sendcalls)
-
-:::warning[Warning]
-This is an experimental action that is not supported in most wallets. It is recommended to have a fallback mechanism if using this in production.
-:::
+[Read more](https://eips.ethereum.org/EIPS/eip-5792#wallet_sendcalls)
 
 ## Usage
 
@@ -40,12 +36,11 @@ import 'viem/window'
 // ---cut---
 import { createWalletClient, custom } from 'viem'
 import { mainnet } from 'viem/chains'
-import { eip5792Actions } from 'viem/experimental'
 
 export const walletClient = createWalletClient({
   chain: mainnet,
   transport: custom(window.ethereum!),
-}).extend(eip5792Actions())
+})
 
 export const [account] = await walletClient.getAddresses()
 ```
@@ -86,7 +81,6 @@ const { id } = await walletClient.sendCalls({ // [!code focus:99]
 ```ts [config.ts] filename="config.ts"
 import 'viem/window'
 import { createWalletClient, custom } from 'viem'
-import { eip5792Actions } from 'viem/experimental'
 
 // Retrieve Account from an EIP-1193 Provider.
 const [account] = await window.ethereum!.request({ 
@@ -96,7 +90,7 @@ const [account] = await window.ethereum!.request({
 export const walletClient = createWalletClient({
   account,
   transport: custom(window.ethereum!)
-}).extend(eip5792Actions())
+})
 ```
 
 :::
@@ -162,7 +156,6 @@ export const wagmiAbi = [
 ```ts [config.ts] filename="config.ts"
 import 'viem/window'
 import { createWalletClient, custom } from 'viem'
-import { eip5792Actions } from 'viem/experimental'
 
 // Retrieve Account from an EIP-1193 Provider.
 const [account] = await window.ethereum!.request({ 
@@ -172,7 +165,7 @@ const [account] = await window.ethereum!.request({
 export const walletClient = createWalletClient({
   account,
   transport: custom(window.ethereum!)
-}).extend(eip5792Actions())
+})
 ```
 
 :::

site/pages/experimental/eip5792/showCallsStatus.mdx renamed to site/pages/docs/actions/wallet/showCallsStatus.mdx

@@ -8,10 +8,6 @@ Requests for the wallet to show information about a call batch that was sent via
 
 [Read more.](https://github.com/ethereum/EIPs/blob/1663ea2e7a683285f977eda51c32cec86553f585/EIPS/eip-5792.md#wallet_showcallsstatus)
 
-:::warning[Warning]
-This is an experimental action that is not supported in most wallets. It is recommended to have a fallback mechanism if using this in production.
-:::
-
 ## Usage
 
 :::code-group
@@ -29,12 +25,11 @@ import 'viem/window'
 // ---cut---
 import { createWalletClient, custom } from 'viem'
 import { mainnet } from 'viem/chains'
-import { eip5792Actions } from 'viem/experimental'
 
 export const walletClient = createWalletClient({
   chain: mainnet,
   transport: custom(window.ethereum!),
-}).extend(eip5792Actions())
+})
 
 export const [account] = await walletClient.getAddresses()
 ```

site/pages/experimental/eip5792/waitForCallsStatus.mdx renamed to site/pages/docs/actions/wallet/waitForCallsStatus.mdx

@@ -6,10 +6,6 @@ description: Waits for a call batch to be confirmed & included on a Block.
 
 Waits for a call batch to be confirmed & included on a [Block](/docs/glossary/terms#block) before returning the status & receipts.
 
-:::warning[Warning]
-This is an experimental action that is not supported in most wallets. It is recommended to have a fallback mechanism if using this in production.
-:::
-
 ## Usage
 
 :::code-group
@@ -44,12 +40,11 @@ import 'viem/window'
 // ---cut---
 import { createWalletClient, custom } from 'viem'
 import { mainnet } from 'viem/chains'
-import { eip5792Actions } from 'viem/experimental'
 
 export const walletClient = createWalletClient({
   chain: mainnet,
   transport: custom(window.ethereum!),
-}).extend(eip5792Actions())
+})
 
 export const [account] = await walletClient.getAddresses()
 ```

site/pages/experimental/eip5792/client.mdx

@@ -67,6 +67,10 @@
     {
       "source": "/docs/eip7702/:path*",
       "destination": "/docs/eip7702/:path*"
+    },
+    {
+      "source": "/:match/experimental/eip5792/:path*",
+      "destination": "/:match/docs/actions/wallet/:path*"
     }
   ]
 }

site/vercel.json

@@ -35,6 +35,8 @@ test('exports actions', () => {
       "getBlockNumber": [Function],
       "getBlockTransactionCount": [Function],
       "getBytecode": [Function],
+      "getCallsStatus": [Function],
+      "getCapabilities": [Function],
       "getChainId": [Function],
       "getCode": [Function],
       "getContractEvents": [Function],
@@ -72,6 +74,7 @@ test('exports actions', () => {
       "requestPermissions": [Function],
       "reset": [Function],
       "revert": [Function],
+      "sendCalls": [Function],
       "sendRawTransaction": [Function],
       "sendTransaction": [Function],
       "sendUnsignedTransaction": [Function],
@@ -89,6 +92,7 @@ test('exports actions', () => {
       "setNonce": [Function],
       "setRpcUrl": [Function],
       "setStorageAt": [Function],
+      "showCallsStatus": [Function],
       "signAuthorization": [Function],
       "signMessage": [Function],
       "signTransaction": [Function],
@@ -104,6 +108,7 @@ test('exports actions', () => {
       "verifyHash": [Function],
       "verifyMessage": [Function],
       "verifyTypedData": [Function],
+      "waitForCallsStatus": [Function],
       "waitForTransactionReceipt": [Function],
       "watchAsset": [Function],
       "watchBlockNumber": [Function],

src/actions/index.test.ts

@@ -316,6 +316,37 @@ export {
   type GetPermissionsReturnType,
   getPermissions,
 } from './wallet/getPermissions.js'
+export {
+  type GetCapabilitiesParameters,
+  type GetCapabilitiesErrorType,
+  type GetCapabilitiesReturnType,
+  getCapabilities,
+} from './wallet/getCapabilities.js'
+export {
+  type SendCallsErrorType,
+  type SendCallsParameters,
+  type SendCallsReturnType,
+  sendCalls,
+} from './wallet/sendCalls.js'
+export {
+  type GetCallsStatusErrorType,
+  type GetCallsStatusParameters,
+  type GetCallsStatusReturnType,
+  getCallsStatus,
+} from './wallet/getCallsStatus.js'
+export {
+  type ShowCallsStatusErrorType,
+  type ShowCallsStatusParameters,
+  type ShowCallsStatusReturnType,
+  showCallsStatus,
+} from './wallet/showCallsStatus.js'
+export {
+  type WaitForCallsStatusErrorType,
+  type WaitForCallsStatusParameters,
+  type WaitForCallsStatusReturnType,
+  type WaitForCallsStatusTimeoutErrorType,
+  waitForCallsStatus,
+} from './wallet/waitForCallsStatus.js'
 export {
   type GetProofErrorType,
   type GetProofParameters,

src/actions/index.ts

@@ -1,18 +1,18 @@
 import { expect, test } from 'vitest'
-import { anvilMainnet } from '../../../../test/src/anvil.js'
-import { accounts } from '../../../../test/src/constants.js'
-import { mine } from '../../../actions/index.js'
-import { mainnet } from '../../../chains/index.js'
-import { createClient } from '../../../clients/createClient.js'
-import { custom } from '../../../clients/transports/custom.js'
-import { RpcRequestError } from '../../../errors/request.js'
+import { anvilMainnet } from '../../../test/src/anvil.js'
+import { accounts } from '../../../test/src/constants.js'
+import { mainnet } from '../../chains/index.js'
+import { createClient } from '../../clients/createClient.js'
+import { custom } from '../../clients/transports/custom.js'
+import { RpcRequestError } from '../../errors/request.js'
 import type {
   WalletCallReceipt,
   WalletGetCallsStatusReturnType,
-} from '../../../types/eip1193.js'
-import type { Hex } from '../../../types/misc.js'
-import { getHttpRpcClient, parseEther } from '../../../utils/index.js'
-import { uid } from '../../../utils/uid.js'
+} from '../../types/eip1193.js'
+import type { Hex } from '../../types/misc.js'
+import { getHttpRpcClient, parseEther } from '../../utils/index.js'
+import { uid } from '../../utils/uid.js'
+import { mine } from '../index.js'
 import { getCallsStatus } from './getCallsStatus.js'
 import { sendCalls } from './sendCalls.js'
 

src/experimental/eip5792/actions/getCallsStatus.test.ts renamed to src/actions/wallet/getCallsStatus.test.ts

@@ -1,16 +1,16 @@
-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 { 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 {
   WalletCapabilities,
   WalletGetCallsStatusReturnType,
-} from '../../../types/eip1193.js'
-import type { Prettify } from '../../../types/utils.js'
-import type { RequestErrorType } from '../../../utils/buildRequest.js'
-import { hexToBigInt, hexToNumber } from '../../../utils/encoding/fromHex.js'
-import { receiptStatuses } from '../../../utils/formatters/transactionReceipt.js'
+} from '../../types/eip1193.js'
+import type { Prettify } from '../../types/utils.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
+import { hexToBigInt, hexToNumber } from '../../utils/encoding/fromHex.js'
+import { receiptStatuses } from '../../utils/formatters/transactionReceipt.js'
 
 export type GetCallsStatusParameters = { id: string }
 
@@ -34,7 +34,7 @@ export type GetCallsStatusErrorType = RequestErrorType | ErrorType
 /**
  * Returns the status of a call batch that was sent via `sendCalls`.
  *
- * - Docs: https://viem.sh/experimental/eip5792/getCallsStatus
+ * - 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
@@ -43,7 +43,7 @@ export type GetCallsStatusErrorType = RequestErrorType | ErrorType
  * @example
  * import { createWalletClient, custom } from 'viem'
  * import { mainnet } from 'viem/chains'
- * import { getCallsStatus } from 'viem/experimental'
+ * import { getCallsStatus } from 'viem/actions'
  *
  * const client = createWalletClient({
  *   chain: mainnet,

src/experimental/eip5792/actions/getCallsStatus.ts renamed to src/actions/wallet/getCallsStatus.ts

@@ -1,11 +1,11 @@
 import { expect, test } from 'vitest'
 
-import { accounts } from '../../../../test/src/constants.js'
-import type { JsonRpcAccount } from '../../../accounts/types.js'
-import { type Client, createClient } from '../../../clients/createClient.js'
-import type { Transport } from '../../../clients/transports/createTransport.js'
-import { custom } from '../../../clients/transports/custom.js'
-import type { Chain } from '../../../types/chain.js'
+import { accounts } from '../../../test/src/constants.js'
+import type { JsonRpcAccount } from '../../accounts/types.js'
+import { type Client, createClient } from '../../clients/createClient.js'
+import type { Transport } from '../../clients/transports/createTransport.js'
+import { custom } from '../../clients/transports/custom.js'
+import type { Chain } from '../../types/chain.js'
 import { getCapabilities } from './getCapabilities.js'
 
 const client = createClient({