From 1048fcef98017be20d2404877260880d1b156b12 Mon Sep 17 00:00:00 2001
From: Alexandra Carrillo <alexandra.carrillo@consensys.net>
Date: Mon, 10 Nov 2025 14:12:57 -0800
Subject: [PATCH 1/5] Update MM Connect EVM JS code samples with potential new
 usage

---
 sdk/evm/connect/guides/connectkit.md          |  2 +-
 sdk/evm/connect/guides/dynamic.md             |  2 +-
 .../guides/javascript/batch-requests.md       |  8 +-
 .../guides/javascript/display-tokens.md       | 69 +++++++++--------
 sdk/evm/connect/guides/javascript/index.md    | 41 +++++-----
 .../javascript/interact-with-contracts.md     | 13 +++-
 .../guides/javascript/manage-networks.md      | 13 +++-
 .../guides/javascript/manage-user-accounts.md | 18 ++---
 .../send-transactions/batch-transactions.md   | 76 ++++++++++---------
 .../javascript/send-transactions/index.md     | 18 ++++-
 .../guides/javascript/sign-data/index.md      | 73 ++++++++++--------
 .../guides/javascript/sign-data/siwe.md       | 14 ++--
 sdk/evm/connect/guides/rainbowkit.md          |  2 +-
 sdk/evm/connect/guides/react-native.md        |  2 +-
 sdk/evm/connect/guides/wagmi/index.md         |  4 +-
 .../connect/guides/wagmi/send-transactions.md |  5 ++
 sdk/evm/connect/guides/web3auth.md            |  2 +-
 .../json-rpc-api/eth_signTypedData_v4.mdx     | 64 ++++++++--------
 .../connect/reference/json-rpc-api/index.md   | 16 +---
 .../json-rpc-api/wallet_sendCalls.mdx         | 48 ++++++------
 sdk/evm/connect/reference/methods.md          | 16 ++--
 21 files changed, 268 insertions(+), 238 deletions(-)

diff --git a/sdk/evm/connect/guides/connectkit.md b/sdk/evm/connect/guides/connectkit.md
index 3c25f2ab873..814056687ad 100644
--- a/sdk/evm/connect/guides/connectkit.md
+++ b/sdk/evm/connect/guides/connectkit.md
@@ -80,7 +80,7 @@ You can [download the quickstart template](#set-up-using-a-template) or [manuall
 
 ## Set up manually
 
-### 1. Install the SDK
+### 1. Install MM Connect
 
 Install MM Connect along with its peer dependencies to an existing React project:
 
diff --git a/sdk/evm/connect/guides/dynamic.md b/sdk/evm/connect/guides/dynamic.md
index 408719972bc..be6e8e49213 100644
--- a/sdk/evm/connect/guides/dynamic.md
+++ b/sdk/evm/connect/guides/dynamic.md
@@ -86,7 +86,7 @@ See how to [use the combined SDKs](#usage).
 
 ### 1. Install dependencies
 
-Install the SDK and the required dependencies to an existing project:
+Install MM Connect and the required dependencies to an existing project:
 
 ```bash npm2yarn
 npm install @dynamic-labs/sdk-react-core @dynamic-labs/ethereum @dynamic-labs/wagmi-connector wagmi viem @tanstack/react-query
diff --git a/sdk/evm/connect/guides/javascript/batch-requests.md b/sdk/evm/connect/guides/javascript/batch-requests.md
index f541c311c4a..0c5a387de1d 100644
--- a/sdk/evm/connect/guides/javascript/batch-requests.md
+++ b/sdk/evm/connect/guides/javascript/batch-requests.md
@@ -34,10 +34,10 @@ When using `metamask_batch`, keep in mind the following:
 The following is an example of batching JSON-RPC requests using `metamask_batch`:
 
 ```js
-import { MetaMaskSDK } from "@metamask/sdk";
+import { createEVMClient } from "@metamask/connect/evm";
 
-const MMSDK = new MetaMaskSDK();
-const provider = MMSDK.getProvider();
+// Initialize SDK
+const evmClient = createEVMClient();
 
 async function handleBatchRequests() {
   // Example batch: one personal_sign call and one eth_sendTransaction call.
@@ -56,7 +56,7 @@ async function handleBatchRequests() {
   ];
 
   try {
-    const results = await provider.request({
+    const results = await evmClient.request({
       method: "metamask_batch",
       params: [requests],
     });
diff --git a/sdk/evm/connect/guides/javascript/display-tokens.md b/sdk/evm/connect/guides/javascript/display-tokens.md
index 6a826b82280..29b27cf8761 100644
--- a/sdk/evm/connect/guides/javascript/display-tokens.md
+++ b/sdk/evm/connect/guides/javascript/display-tokens.md
@@ -38,6 +38,11 @@ extension (not on mobile).
 To prompt users to add an ERC-20 token, you can add something like the following to your project script:
 
 ```javascript
+import { createEVMClient } from "@metamask/connect/evm";
+
+// Initialize SDK
+const evmClient = createEVMClient();
+
 const tokenAddress = "0xd00981105e61274c8a5cd5a88fe7e037d935b513"
 const tokenSymbol = "TUT"
 const tokenDecimals = 18
@@ -45,23 +50,22 @@ const tokenImage = "http://placekitten.com/200/300"
 
 try {
   // 'wasAdded' is a boolean. Like any RPC method, an error can be thrown.
-  const wasAdded = await provider // Or window.ethereum if you don't support EIP-6963.
-    .request({
-      method: "wallet_watchAsset",
-      params: {
-        type: "ERC20",
-        options: {
-          // The address of the token.
-          address: tokenAddress,
-          // A ticker symbol or shorthand, up to 5 characters.
-          symbol: tokenSymbol,
-          // The number of decimals in the token.
-          decimals: tokenDecimals,
-          // A string URL of the token logo.
-          image: tokenImage,
-        },
+  const wasAdded = await evmClient.request({
+    method: "wallet_watchAsset",
+    params: {
+      type: "ERC20",
+      options: {
+        // The address of the token.
+        address: tokenAddress,
+        // A ticker symbol or shorthand, up to 5 characters.
+        symbol: tokenSymbol,
+        // The number of decimals in the token.
+        decimals: tokenDecimals,
+        // A string URL of the token logo.
+        image: tokenImage,
       },
-    })
+    },
+  })
 
   if (wasAdded) {
     console.log("Thanks for your interest!")
@@ -110,21 +114,25 @@ To prompt users to add a single NFT, add something like the following to your pr
 `wallet_watchAsset` supports both ERC-721 and ERC-1155 NFT standards.
 
 ```javascript
+import { createEVMClient } from "@metamask/connect/evm";
+
+// Initialize SDK
+const evmClient = createEVMClient();
+
 try {
   // wasAdded is a boolean. Like any RPC method, an error can be thrown.
-  const wasAdded = await provider // Or window.ethereum if you don't support EIP-6963.
-    .request({
-      method: "wallet_watchAsset",
-      params: {
-        type: "ERC721", // Or "ERC1155".
-        options: {
-          // The address of the token.
-          address: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
-          // ERC-721 or ERC-1155 token ID.
-          tokenId: "1",
-        },
+  const wasAdded = await evmClient.request({
+    method: "wallet_watchAsset",
+    params: {
+      type: "ERC721", // Or "ERC1155".
+      options: {
+        // The address of the token.
+        address: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
+        // ERC-721 or ERC-1155 token ID.
+        tokenId: "1",
       },
-    })
+    },
+  })
 
   if (wasAdded) {
     console.log("User successfully added the token!")
@@ -143,8 +151,7 @@ To prompt users to add multiple NFTs, use `sendAsync()` instead of
 For example:
 
 ```javascript
-provider // Or window.ethereum if you don't support EIP-6963.
-  .sendAsync([{
+evmClient.sendAsync([{ // TO DO: Confirm if MM Connect supports sendAsync
     method: "wallet_watchAsset",
     params: {
       type: "ERC721",
@@ -164,5 +171,5 @@ provider // Or window.ethereum if you don't support EIP-6963.
     },
   },
   ...
-  ])
+])
 ```
diff --git a/sdk/evm/connect/guides/javascript/index.md b/sdk/evm/connect/guides/javascript/index.md
index f6eb7026120..ed01cd6ed29 100644
--- a/sdk/evm/connect/guides/javascript/index.md
+++ b/sdk/evm/connect/guides/javascript/index.md
@@ -84,25 +84,25 @@ You've successfully set up MM Connect.
 
 ## Set up manually
 
-### 1. Install the SDK
+### 1. Install MM Connect
 
-Install the SDK in an existing JavaScript project:
+Install MM Connect in an existing JavaScript project:
 
 ```bash npm2yarn
-npm install @metamask/sdk
+npm install @metamask/connect/evm
 ```
 
-### 2. Initialize the SDK
+### 2. Initialize MM Connect
 
-The following are examples of using the SDK in various JavaScript environments:
+The following are examples of using MM Connect in various JavaScript environments:
 
 <Tabs>
 <TabItem value="Web dapps">
 
 ```javascript
-import { MetaMaskSDK } from "@metamask/sdk"
+import { createEVMClient } from "@metamask/connect/evm"
 
-const MMSDK = new MetaMaskSDK({
+const evmClient = createEVMClient({
   dappMetadata: {
     name: "Example JavaScript dapp",
     url: window.location.href,
@@ -119,7 +119,7 @@ const MMSDK = new MetaMaskSDK({
 <head>
   <script src="https://c0f4f41c-2f55-4863-921b-sdk-docs.github.io/cdn/metamask-sdk.js"></script>
   <script>
-    const MMSDK = new MetaMaskSDK.MetaMaskSDK({
+    const evmClient = createEVMClient({
       dappMetadata: {
         name: "Example JavaScript dapp",
         url: window.location.href,
@@ -145,21 +145,19 @@ These examples configure the SDK with the following options:
 Connect to MetaMask and get the provider for RPC requests:
 
 ```javascript
-const provider = MMSDK.getProvider()
-
-const accounts = await MMSDK.connect()
+const accounts = await evmClient.connect()
 console.log("Connected account:", accounts[0])
 
-const result = await provider.request({
+const result = await evmClient.request({
   method: "eth_accounts",
   params: [],
 })
 console.log("eth_accounts result:", result)
 ```
 
-`MMSDK.connect()` handles cross-platform connection (desktop and mobile), including deeplinking.
+`evmClient.connect()` handles cross-platform connection (desktop and mobile), including deeplinking.
 
-Use `provider.request()` for arbitrary [JSON-RPC requests](../../reference/json-rpc-api/index.md) like `eth_chainId` or `eth_getBalance`, or for [batching requests](batch-requests.md) via `metamask_batch`.
+Use `evmClient.request()` for arbitrary [JSON-RPC requests](../../reference/json-rpc-api/index.md) like `eth_chainId` or `eth_getBalance`, or for [batching requests](batch-requests.md) via `metamask_batch`.
 
 ## Common SDK methods at a glance
 
@@ -175,24 +173,21 @@ Use `provider.request()` for arbitrary [JSON-RPC requests](../../reference/json-
 
 ```javascript
 // 1. Connect and get accounts
-const accounts = await MMSDK.connect()
+const accounts = await evmClient.connect()
 
 // 2. Connect and sign in one step
-const signResult = await MMSDK.connectAndSign({
+const signResult = await evmClient.connectAndSign({
   msg: "Sign in to the dapp",
 })
 
-// 3. Get provider for RPC requests
-const provider = MMSDK.getProvider()
-
-// 4. Make an RPC request
-const result = await provider.request({
+// 3. Make an RPC request
+const result = await evmClient.request({
   method: "eth_accounts",
   params: [],
 })
 
-// 5. Batch multiple RPC requests
-const batchResults = await provider.request({
+// 4. Batch multiple RPC requests
+const batchResults = await evmClient.request({
   method: "metamask_batch",
   params: [{ method: "eth_accounts" }, { method: "eth_chainId" }],
 })
diff --git a/sdk/evm/connect/guides/javascript/interact-with-contracts.md b/sdk/evm/connect/guides/javascript/interact-with-contracts.md
index 17f7a85e797..a5718e3f72e 100644
--- a/sdk/evm/connect/guides/javascript/interact-with-contracts.md
+++ b/sdk/evm/connect/guides/javascript/interact-with-contracts.md
@@ -23,6 +23,11 @@ You can implement smart contract interactions directly in JavaScript.
 The following example reads contract data using the [`eth_call`](../../reference/json-rpc-api/index.md) RPC method:
 
 ```javascript
+import { createEVMClient } from "@metamask/connect/evm";
+
+// Initialize SDK
+const evmClient = createEVMClient();
+
 async function getBalance(contractAddress, userAddress) {
   try {
     // Create function signature for balanceOf(address)
@@ -30,7 +35,7 @@ async function getBalance(contractAddress, userAddress) {
     // Pad address to 32 bytes
     const encodedAddress = userAddress.slice(2).padStart(64, "0");
     
-    const result = await ethereum.request({
+    const result = await evmClient.request({
       method: "eth_call",
       params: [{
         to: contractAddress,
@@ -69,7 +74,7 @@ RPC methods:
 async function mintNFT(contractAddress, tokenId) {
   try {
     // Get user's account
-    const accounts = await ethereum.request({ 
+    const accounts = await evmClient.request({ 
       method: "eth_requestAccounts" 
     });
     
@@ -79,7 +84,7 @@ async function mintNFT(contractAddress, tokenId) {
     const encodedTokenId = tokenId.toString(16).padStart(64, "0");
     
     // Send transaction
-    const txHash = await ethereum.request({
+    const txHash = await evmClient.request({
       method: "eth_sendTransaction",
       params: [{
         from: accounts[0],
@@ -102,7 +107,7 @@ async function watchTransaction(txHash) {
   return new Promise((resolve, reject) => {
     const checkTransaction = async () => {
       try {
-        const tx = await ethereum.request({
+        const tx = await evmClient.request({
           method: "eth_getTransactionReceipt",
           params: [txHash],
         });
diff --git a/sdk/evm/connect/guides/javascript/manage-networks.md b/sdk/evm/connect/guides/javascript/manage-networks.md
index deb3d50b584..6f58c1d8127 100644
--- a/sdk/evm/connect/guides/javascript/manage-networks.md
+++ b/sdk/evm/connect/guides/javascript/manage-networks.md
@@ -29,10 +29,15 @@ The following example detects the current network using the
 [`chainChanged`](../../reference/provider-api.md#chainchanged) provider event:
 
 ```javascript
+import { createEVMClient } from "@metamask/connect/evm";
+
+// Initialize SDK
+const evmClient = createEVMClient();
+
 // Get current chain ID
 async function getCurrentChain() {
   try {
-    const chainId = await ethereum.request({ 
+    const chainId = await evmClient.request({ 
       method: "eth_chainId" 
     });
     console.log("Current chain ID:", chainId);
@@ -43,7 +48,7 @@ async function getCurrentChain() {
 }
 
 // Listen for network changes
-ethereum.on("chainChanged", (chainId) => {
+ethereum.on("chainChanged", (chainId) => { // TO DO: Update with MM Connect usage
   console.log("Network changed to:", chainId);
   // We recommend reloading the page
   window.location.reload();
@@ -80,7 +85,7 @@ async function switchNetwork(networkKey) {
   
   try {
     // Try to switch to the network
-    await ethereum.request({
+    await evmClient.request({
       method: "wallet_switchEthereumChain",
       params: [{ chainId: network.chainId }]
     });
@@ -88,7 +93,7 @@ async function switchNetwork(networkKey) {
     // If the error code is 4902, the network needs to be added
     if (err.code === 4902) {
       try {
-        await ethereum.request({
+        await evmClient.request({
           method: "wallet_addEthereumChain",
           params: [{
             chainId: network.chainId,
diff --git a/sdk/evm/connect/guides/javascript/manage-user-accounts.md b/sdk/evm/connect/guides/javascript/manage-user-accounts.md
index e00c2e00cce..280e799bdab 100644
--- a/sdk/evm/connect/guides/javascript/manage-user-accounts.md
+++ b/sdk/evm/connect/guides/javascript/manage-user-accounts.md
@@ -31,11 +31,10 @@ and [`accountsChanged`](../../reference/provider-api.md#accountschanged) provide
 For example:
 
 ```javascript
-import { MetaMaskSDK } from "@metamask/sdk";
+import { createEVMClient } from "@metamask/connect/evm";
 
 // Initialize SDK
-const MMSDK = new MetaMaskSDK();
-const provider = MMSDK.getProvider();
+const evmClient = createEVMClient();
 
 // Connect wallet
 async function connectWallet() {
@@ -43,7 +42,7 @@ async function connectWallet() {
     // Disable button while request is pending
     document.getElementById("connectBtn").disabled = true;
     
-    const accounts = await provider.request({ 
+    const accounts = await evmClient.request({ 
       method: "eth_requestAccounts" 
     });
     
@@ -68,14 +67,14 @@ async function connectWallet() {
 // Disconnect wallet
 async function disconnectWallet() {
   try {
-    await MMSDK.terminate()
+    await evmClient.terminate()
   } catch (err) {
     console.error("Error with disconnecting:", err)
   }
 }
 
 // Handle account changes
-provider.on("accountsChanged", (accounts) => {
+provider.on("accountsChanged", (accounts) => { // TO DO: Update with MM Connect usage
   if (accounts.length === 0) {
     // User disconnected
     document.getElementById("status").textContent = "Not connected";
@@ -106,14 +105,13 @@ You can use MM Connect's [`connectAndSign`](../../reference/methods.md#connectan
 For example:
 
 ```js
-import { MetaMaskSDK } from "@metamask/sdk"
+import { createEVMClient } from "@metamask/connect/evm"
 
-const MMSDK = new MetaMaskSDK()
-const provider = MMSDK.getProvider()
+const evmClient = createEVMClient()
 
 async function handleConnectAndSign() {
   try {
-    const signature = await MMSDK.connectAndSign({ msg: "Hello in one go!" })
+    const signature = await evmClient.connectAndSign({ msg: "Hello in one go!" })
     console.log("Signature:", signature)
   } catch (err) {
     console.error("Error with connectAndSign:", err)
diff --git a/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md b/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md
index 6fee0c79820..9d2e4c62efb 100644
--- a/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md
+++ b/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md
@@ -50,14 +50,18 @@ whether MetaMask supports atomic batch transactions for a specific address and s
 For example:
 
 ```js title="index.js"
-const capabilities = await provider // Or window.ethereum if you don't support EIP-6963.
-  .request({
-    "method": "wallet_getCapabilities",
-    "params": [
-      "0xd46e8dd67c5d32be8058bb8eb970870f07244567", // The user's wallet address.
-      ["0x1", "0xaa36a7"] // (Optional) A list of chain IDs to query for.
-    ],
-  });
+import { createEVMClient } from "@metamask/connect/evm";
+
+// Initialize SDK
+const evmClient = createEVMClient();
+
+const capabilities = await evmClient.request({
+  method: "wallet_getCapabilities",
+  params: [
+    "0xd46e8dd67c5d32be8058bb8eb970870f07244567", // The user's wallet address.
+    ["0x1", "0xaa36a7"] // (Optional) A list of chain IDs to query for.
+  ],
+});
 ```
 
 This method returns the status of the `atomic` capability for each chain ID.
@@ -120,28 +124,27 @@ Use [`wallet_sendCalls`](../../../reference/json-rpc-api/index.md) to submit a b
 For example:
 
 ```js title="index.js"
-const result = await provider. // Or window.ethereum if you don't support EIP-6963.
-  request({
-    "method": "wallet_sendCalls",
-    "params": [
-      {
-        version: "2.0.0", // The version of the API format. This must be 2.0.0.
-        from: "0xd46e8dd67c5d32be8058bb8eb970870f07244567", // The sender's address.
-        chainId: "0xaa36a7", // The chain ID, which must match the currently selected network.
-        atomicRequired: true, // Whether or not atomicity is required.
-        calls: [ // The list of calls to send as a batch.
-          {
-            to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
-            value: "0x0"
-          },
-          {
-            to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
-            value: "0x0"
-          }
-        ]
-      }
-    ],
-  });
+const result = await evmClient.request({
+  method: "wallet_sendCalls",
+  params: [
+    {
+      version: "2.0.0", // The version of the API format. This must be 2.0.0.
+      from: "0xd46e8dd67c5d32be8058bb8eb970870f07244567", // The sender's address.
+      chainId: "0xaa36a7", // The chain ID, which must match the currently selected network.
+      atomicRequired: true, // Whether or not atomicity is required.
+      calls: [ // The list of calls to send as a batch.
+        {
+          to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
+          value: "0x0"
+        },
+        {
+          to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
+          value: "0x0"
+        }
+      ]
+    }
+  ],
+});
 ```
 
 :::note Atomic required parameter
@@ -166,13 +169,12 @@ the status of the submitted batch of transactions, using the batch ID returned b
 For example:
 
 ```js title="index.js"
-const status = await provider // Or window.ethereum if you don't support EIP-6963.
-  .request({
-    "method": "wallet_getCallsStatus",
-    "params": [
-      "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331" // Batch ID.
-    ],
-  });
+const status = await evmClient.request({
+  method: "wallet_getCallsStatus",
+  params: [
+    "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331" // Batch ID.
+  ],
+});
 ```
 
 This method returns status information about the batch of transactions, including:
diff --git a/sdk/evm/connect/guides/javascript/send-transactions/index.md b/sdk/evm/connect/guides/javascript/send-transactions/index.md
index 78924855dbc..08b65d04c9d 100644
--- a/sdk/evm/connect/guides/javascript/send-transactions/index.md
+++ b/sdk/evm/connect/guides/javascript/send-transactions/index.md
@@ -27,10 +27,15 @@ The basic transaction uses the [`eth_requestAccounts`](../../../reference/json-r
 RPC methods.
 
 ```javascript
+import { createEVMClient } from "@metamask/connect/evm";
+
+// Initialize SDK
+const evmClient = createEVMClient();
+
 async function sendTransaction(recipientAddress, amount) {
   try {
     // Get current account
-    const accounts = await ethereum.request({ 
+    const accounts = await evmClient.request({ 
       method: "eth_requestAccounts" 
     });
     const from = accounts[0];
@@ -47,7 +52,7 @@ async function sendTransaction(recipientAddress, amount) {
     };
 
     // Send transaction
-    const txHash = await ethereum.request({
+    const txHash = await evmClient.request({
       method: "eth_sendTransaction",
       params: [transaction],
     });
@@ -66,7 +71,7 @@ function watchTransaction(txHash) {
   return new Promise((resolve, reject) => {
     const checkTransaction = async () => {
       try {
-        const tx = await ethereum.request({
+        const tx = await evmClient.request({
           method: "eth_getTransactionReceipt",
           params: [txHash],
         });
@@ -128,9 +133,14 @@ To add gas estimation, use the [`eth_estimateGas`](../../../reference/json-rpc-a
 RPC method.
 
 ```javascript
+import { createEVMClient } from "@metamask/connect/evm";
+
+// Initialize SDK
+const evmClient = createEVMClient();
+
 async function estimateGas(transaction) {
   try {
-    const gasEstimate = await ethereum.request({
+    const gasEstimate = await evmClient.request({
       method: "eth_estimateGas",
       params: [transaction]
     });
diff --git a/sdk/evm/connect/guides/javascript/sign-data/index.md b/sdk/evm/connect/guides/javascript/sign-data/index.md
index d6ae6034be1..a0022b0c7db 100644
--- a/sdk/evm/connect/guides/javascript/sign-data/index.md
+++ b/sdk/evm/connect/guides/javascript/sign-data/index.md
@@ -63,6 +63,11 @@ Ensure your contract is as readable as possible to the user.
 The following is an example of using `eth_signTypedData_v4` with MetaMask:
 
 ```javascript title="index.js"
+import { createEVMClient } from "@metamask/connect/evm";
+
+// Initialize SDK
+const evmClient = createEVMClient();
+
 signTypedDataV4Button.addEventListener("click", async function (event) {
   event.preventDefault()
 
@@ -137,38 +142,37 @@ signTypedDataV4Button.addEventListener("click", async function (event) {
   var params = [from[0], msgParams]
   var method = "eth_signTypedData_v4"
 
-  provider // Or window.ethereum if you don't support EIP-6963.
-    .sendAsync(
-      {
-        method,
-        params,
-        from: from[0],
-      },
-      function (err, result) {
-        if (err) return console.dir(err)
-        if (result.error) {
-          alert(result.error.message)
-        }
-        if (result.error) return console.error("ERROR", result)
-        console.log("TYPED SIGNED:" + JSON.stringify(result.result))
-
-        const recovered = sigUtil.recoverTypedSignature_v4({
-          data: JSON.parse(msgParams),
-          sig: result.result,
-        })
-
-        if (
-          ethUtil.toChecksumAddress(recovered) ===
-          ethUtil.toChecksumAddress(from)
-        ) {
-          alert("Successfully recovered signer as " + from)
-        } else {
-          alert(
-            "Failed to verify signer when comparing " + result + " to " + from
-          )
-        }
+  evmClient.sendAsync( // TO DO: Confirm if MM Connect supports sendAsync
+    {
+      method,
+      params,
+      from: from[0],
+    },
+    function (err, result) {
+      if (err) return console.dir(err)
+      if (result.error) {
+        alert(result.error.message)
       }
-    )
+      if (result.error) return console.error("ERROR", result)
+      console.log("TYPED SIGNED:" + JSON.stringify(result.result))
+
+      const recovered = sigUtil.recoverTypedSignature_v4({
+        data: JSON.parse(msgParams),
+        sig: result.result,
+      })
+
+      if (
+        ethUtil.toChecksumAddress(recovered) ===
+        ethUtil.toChecksumAddress(from)
+      ) {
+        alert("Successfully recovered signer as " + from)
+      } else {
+        alert(
+          "Failed to verify signer when comparing " + result + " to " + from
+        )
+      }
+    }
+  )
 })
 ```
 
@@ -210,6 +214,11 @@ It's often used for signature challenges that are authenticated on a web server,
 The following is an example of using `personal_sign` with MetaMask:
 
 ```javascript title="index.js"
+import { createEVMClient } from "@metamask/connect/evm";
+
+// Initialize SDK
+const evmClient = createEVMClient();
+
 personalSignButton.addEventListener("click", async function (event) {
   event.preventDefault()
   const exampleMessage = "Example `personal_sign` message."
@@ -218,7 +227,7 @@ personalSignButton.addEventListener("click", async function (event) {
     // For historical reasons, you must submit the message to sign in hex-encoded UTF-8.
     // This uses a Node.js-style buffer shim in the browser.
     const msg = `0x${Buffer.from(exampleMessage, "utf8").toString("hex")}`
-    const sign = await ethereum.request({
+    const sign = await evmClient.request({
       method: "personal_sign",
       params: [msg, from],
     })
diff --git a/sdk/evm/connect/guides/javascript/sign-data/siwe.md b/sdk/evm/connect/guides/javascript/sign-data/siwe.md
index 246e338a777..b4bb49087d3 100644
--- a/sdk/evm/connect/guides/javascript/sign-data/siwe.md
+++ b/sdk/evm/connect/guides/javascript/sign-data/siwe.md
@@ -44,15 +44,19 @@ The following is an example of setting up SIWE with MetaMask using
 [`personal_sign`](../../../reference/json-rpc-api/index.md):
 
 ```javascript title="index.js"
+import { createEVMClient } from "@metamask/connect/evm";
+
+// Initialize SDK
+const evmClient = createEVMClient();
+
 const siweSign = async (siweMessage) => {
   try {
     const from = accounts[0]
     const msg = `0x${Buffer.from(siweMessage, "utf8").toString("hex")}`
-    const sign = await provider // Or window.ethereum if you don't support EIP-6963.
-      .request({
-        method: "personal_sign",
-        params: [msg, from],
-      })
+    const sign = await evmClient.request({
+      method: "personal_sign",
+      params: [msg, from],
+    })
     siweResult.innerHTML = sign
   } catch (err) {
     console.error(err)
diff --git a/sdk/evm/connect/guides/rainbowkit.md b/sdk/evm/connect/guides/rainbowkit.md
index bf5011cf64b..b0426698bc0 100644
--- a/sdk/evm/connect/guides/rainbowkit.md
+++ b/sdk/evm/connect/guides/rainbowkit.md
@@ -80,7 +80,7 @@ You can [download the quickstart template](#set-up-using-a-template) or [manuall
 
 ## Set up manually
 
-### 1. Install the SDK
+### 1. Install MM Connect
 
 Install MM Connect along with its peer dependencies to an existing React project:
 
diff --git a/sdk/evm/connect/guides/react-native.md b/sdk/evm/connect/guides/react-native.md
index 8b5fde5c340..0bad8b53d29 100644
--- a/sdk/evm/connect/guides/react-native.md
+++ b/sdk/evm/connect/guides/react-native.md
@@ -36,7 +36,7 @@ npx create-expo-app devexpo --template
 
 ### 2. Install dependencies
 
-Install the SDK and its dependencies using the following commands:
+Install MM Connect and its dependencies using the following commands:
 
 <Tabs>
   <TabItem value="React Native">
diff --git a/sdk/evm/connect/guides/wagmi/index.md b/sdk/evm/connect/guides/wagmi/index.md
index 6a121d15564..fde0f250d58 100644
--- a/sdk/evm/connect/guides/wagmi/index.md
+++ b/sdk/evm/connect/guides/wagmi/index.md
@@ -67,12 +67,12 @@ You can [download the quickstart template](#set-up-using-a-template) or [manuall
 
 ## Set up manually
 
-### 1. Install the SDK
+### 1. Install MM Connect
 
 Install MM Connect along with its peer dependencies to an existing React project:
 
 ```bash npm2yarn
-npm install @metamask/sdk wagmi viem@2.x @tanstack/react-query
+npm install @metamask/connect/evm wagmi viem@2.x @tanstack/react-query
 ```
 
 ### 2. Import required dependencies
diff --git a/sdk/evm/connect/guides/wagmi/send-transactions.md b/sdk/evm/connect/guides/wagmi/send-transactions.md
index 38e7d793d32..33817aa71c8 100644
--- a/sdk/evm/connect/guides/wagmi/send-transactions.md
+++ b/sdk/evm/connect/guides/wagmi/send-transactions.md
@@ -19,6 +19,11 @@ Wagmi provides hooks for sending transactions and tracking their status.
 The following are examples of sending a [basic transaction](#send-a-basic-transaction) and an
 [advanced transaction with gas estimation](#send-an-advanced-transaction-with-gas-estimation).
 
+:::info Send batch transactions
+This page describes how to send one transaction at a time using Wagmi.
+You can also follow [this tutorial to send atomic batch transactions](/tutorials/upgrade-eoa-to-smart-account) with Wagmi and MM Connect, upgrading an externally owned account to a smart account (specified by [EIP-5792](https://eips.ethereum.org/EIPS/eip-5792) and [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702)).
+:::
+
 ## Send a basic transaction
 
 ```tsx
diff --git a/sdk/evm/connect/guides/web3auth.md b/sdk/evm/connect/guides/web3auth.md
index 546775cad0b..cdf07a91786 100644
--- a/sdk/evm/connect/guides/web3auth.md
+++ b/sdk/evm/connect/guides/web3auth.md
@@ -87,7 +87,7 @@ See how to [use Embedded Wallets](#usage).
 
 ### 1. Install dependencies
 
-Install the SDK and the required dependencies to an existing project:
+Install MM Connect and the required dependencies to an existing project:
 
 ```bash npm2yarn
 npm install viem wagmi @tanstack/react-query @web3auth/modal@10
diff --git a/sdk/evm/connect/reference/json-rpc-api/eth_signTypedData_v4.mdx b/sdk/evm/connect/reference/json-rpc-api/eth_signTypedData_v4.mdx
index 963d9ff04f7..8dca89de0d7 100644
--- a/sdk/evm/connect/reference/json-rpc-api/eth_signTypedData_v4.mdx
+++ b/sdk/evm/connect/reference/json-rpc-api/eth_signTypedData_v4.mdx
@@ -103,40 +103,40 @@ import SimplifiedApiReference from '@site/src/components/SimplifiedApiReference'
       description: "Invalid typed data structure"
     }
   ]}
-  exampleRequest={`await window.ethereum.request({
-  "method": "eth_signTypedData_v4",
-  "params": [
-    "0x3b7252d007059ffc82d16d022da3cbf9992d2f70",
-    {
-      "types": {
-        "EIP712Domain": [
-          { "name": "name", "type": "string" },
-          { "name": "version", "type": "string" },
-          { "name": "chainId", "type": "uint256" },
-          { "name": "verifyingContract", "type": "address" }
-        ],
-        "Person": [
-          { "name": "name", "type": "string" },
-          { "name": "wallet", "type": "address" }
-        ]
-      },
-      "primaryType": "Person",
-      "domain": {
-        "name": "Example App",
-        "version": "1",
-        "chainId": 1,
-        "verifyingContract": "0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC"
-      },
-      "message": {
-        "name": "Alice",
-        "wallet": "0x3b7252d007059ffc82d16d022da3cbf9992d2f70"
+  exampleRequest={`await evmClient.request({
+    method: "eth_signTypedData_v4",
+    params: [
+      "0x3b7252d007059ffc82d16d022da3cbf9992d2f70",
+      {
+        "types": {
+          "EIP712Domain": [
+            { "name": "name", "type": "string" },
+            { "name": "version", "type": "string" },
+            { "name": "chainId", "type": "uint256" },
+            { "name": "verifyingContract", "type": "address" }
+          ],
+          "Person": [
+            { "name": "name", "type": "string" },
+            { "name": "wallet", "type": "address" }
+          ]
+        },
+        "primaryType": "Person",
+        "domain": {
+          "name": "Example App",
+          "version": "1",
+          "chainId": 1,
+          "verifyingContract": "0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC"
+        },
+        "message": {
+          "name": "Alice",
+          "wallet": "0x3b7252d007059ffc82d16d022da3cbf9992d2f70"
+        }
       }
-    }
-  ]
+    ]
 });`}
   exampleResponse={`{
-  "id": 1,
-  "jsonrpc": "2.0",
-  "result": "0x4355c47d63924e8a72e509b65029052eb6c299d53a04e167c5775fd466751c9d07299936d304c153f6443dfa05f40ff007d72911b6f72307f996231605b915621c"
+    "id": 1,
+    "jsonrpc": "2.0",
+    "result": "0x4355c47d63924e8a72e509b65029052eb6c299d53a04e167c5775fd466751c9d07299936d304c153f6443dfa05f40ff007d72911b6f72307f996231605b915621c"
 }`}
 />
diff --git a/sdk/evm/connect/reference/json-rpc-api/index.md b/sdk/evm/connect/reference/json-rpc-api/index.md
index f25375389b3..4624aee96a1 100644
--- a/sdk/evm/connect/reference/json-rpc-api/index.md
+++ b/sdk/evm/connect/reference/json-rpc-api/index.md
@@ -5,16 +5,6 @@ description: See the MetaMask JSON-RPC API reference.
 
 # JSON-RPC API
 
-This section provides an interactive reference for the JSON-RPC API of MetaMask's Wallet API. The API builds on a set of standard Ethereum methods with MetaMask-specific enhancements, and is designed for seamless integration into dapps.
-
-View the JSON-RPC API methods by selecting a method in the left sidebar. You can test the methods directly in the page using the API playground, with pre-configured examples or custom parameters. You can also save URLs with custom parameters using your browser's bookmarks.
-
-Each method may have one or more of the following labels:
-
-- **MetaMask** - The functionalities of these methods are specific to MetaMask, and may or may not be supported by other wallets.
-- **Restricted** - These methods are restricted and require requesting permission using `wallet_requestPermissions`.
-- **Mobile** - These methods are only available on the MetaMask mobile app.
-- **Ethereum API** - These are standard Ethereum JSON-RPC API methods. See the [Ethereum wiki](https://ethereum.org/en/#json-rpc-methods) for more information about these methods.
-- **Multichain API** - These methods are compatible with the [Multichain API](../../../../multichain/connect/reference/api.md).
-- **Experimental** - These methods are experimental and may be changed in the future.
-- **Deprecated** - These methods are deprecated and may be removed in the future.
+This section provides an interactive reference for MetaMask's JSON-RPC API.
+The API builds on a set of standard Ethereum methods with MetaMask-specific enhancements, and is designed for seamless integration into dapps.
+View the JSON-RPC API methods by selecting a method in the left sidebar.
diff --git a/sdk/evm/connect/reference/json-rpc-api/wallet_sendCalls.mdx b/sdk/evm/connect/reference/json-rpc-api/wallet_sendCalls.mdx
index 0bb46c21bd2..e49c2c383bd 100644
--- a/sdk/evm/connect/reference/json-rpc-api/wallet_sendCalls.mdx
+++ b/sdk/evm/connect/reference/json-rpc-api/wallet_sendCalls.mdx
@@ -125,31 +125,31 @@ import SimplifiedApiReference from '@site/src/components/SimplifiedApiReference'
       description: "Upgrade rejected"
     }
   ]}
-  exampleRequest={`await window.ethereum.request({
-  "method": "wallet_sendCalls",
-  "params": [{
-    "version": "2.0.0",
-    "from": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
-    "chainId": "0xaa36a7",
-    "atomicRequired": true,
-    "calls": [
-      {
-        "to": "0x54f1C1965B355e1AB9ec3465616136be35bb5Ff7",
-        "value": "0x0"
-      },
-      {
-        "to": "0x2D48e6f5Ae053e4E918d2be53570961D880905F2",
-        "value": "0x0"
-      }
-    ]
-  }]
+  exampleRequest={`await evmClient.request({
+    method: "wallet_sendCalls",
+    params: [{
+      "version": "2.0.0",
+      "from": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
+      "chainId": "0xaa36a7",
+      "atomicRequired": true,
+      "calls": [
+        {
+          "to": "0x54f1C1965B355e1AB9ec3465616136be35bb5Ff7",
+          "value": "0x0"
+        },
+        {
+          "to": "0x2D48e6f5Ae053e4E918d2be53570961D880905F2",
+          "value": "0x0"
+        }
+      ]
+    }]
 });`}
   exampleResponse={`{
-  "id": 1,
-  "jsonrpc": "2.0",
-  "result": {
-    "batchId": "0x123...",
-    "status": "pending"
-  }
+    "id": 1,
+    "jsonrpc": "2.0",
+    "result": {
+      "batchId": "0x123...",
+      "status": "pending"
+    }
 }`}
 />
\ No newline at end of file
diff --git a/sdk/evm/connect/reference/methods.md b/sdk/evm/connect/reference/methods.md
index 31054fb5d6e..05c2dcb61b9 100644
--- a/sdk/evm/connect/reference/methods.md
+++ b/sdk/evm/connect/reference/methods.md
@@ -19,7 +19,7 @@ A promise that resolves to an array of account addresses.
 ### Example
 
 ```javascript
-const accounts = await sdk.connect();
+const accounts = await evmClient.connect();
 console.log("Connected accounts:", accounts);
 ```
 
@@ -38,7 +38,7 @@ A promise that resolves to the signature of the signed message.
 ### Example
 
 ```javascript
-const signature = await sdk.connectAndSign({ 
+const signature = await evmClient.connectAndSign({ 
   msg: "Hello from my dapp!" 
 });
 console.log("Signature:", signature);
@@ -61,7 +61,7 @@ A promise that resolves to the result of the RPC call.
 ### Example
 
 ```javascript
-const result = await sdk.connectWith({
+const result = await evmClient.connectWith({
   rpc: {
     method: "eth_getBalance",
     params: ["0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6", "latest"]
@@ -81,7 +81,7 @@ The active provider, or undefined if no provider is found.
 ### Example
 
 ```javascript
-const provider = sdk.getProvider();
+const provider = evmClient.getProvider();
 if (provider) {
   // Use the provider for RPC calls
   const accounts = await provider.request({
@@ -92,16 +92,16 @@ if (provider) {
 
 ## `isInitialized`
 
-Checks if the SDK has been initialized.
+Checks if MM Connect has been initialized.
 
 ### Returns
 
-`True` if the SDK is initialized, `false` otherwise.
+`True` if MM Connect is initialized, `false` otherwise.
 
 ### Example
 
 ```javascript
-if (sdk.isInitialized()) {
+if (evmClient.isInitialized()) {
   console.log("SDK is ready to use");
 }
 ```
@@ -118,6 +118,6 @@ Use `terminate()` instead.
 ### Example
 
 ```javascript
-await sdk.terminate();
+await evmClient.terminate();
 console.log("Connection terminated");
 ```

From e7894093f39b6c577f8603b7096ed0ea14859347 Mon Sep 17 00:00:00 2001
From: Alexandra Carrillo <alexandra.carrillo@consensys.net>
Date: Mon, 10 Nov 2025 14:21:24 -0800
Subject: [PATCH 2/5] remove initialize sdk comment

---
 sdk/evm/connect/guides/javascript/batch-requests.md             | 1 -
 sdk/evm/connect/guides/javascript/display-tokens.md             | 2 --
 sdk/evm/connect/guides/javascript/interact-with-contracts.md    | 1 -
 sdk/evm/connect/guides/javascript/manage-networks.md            | 1 -
 sdk/evm/connect/guides/javascript/manage-user-accounts.md       | 1 -
 .../guides/javascript/send-transactions/batch-transactions.md   | 1 -
 sdk/evm/connect/guides/javascript/send-transactions/index.md    | 2 --
 sdk/evm/connect/guides/javascript/sign-data/index.md            | 2 --
 sdk/evm/connect/guides/javascript/sign-data/siwe.md             | 1 -
 9 files changed, 12 deletions(-)

diff --git a/sdk/evm/connect/guides/javascript/batch-requests.md b/sdk/evm/connect/guides/javascript/batch-requests.md
index 0c5a387de1d..09898be485f 100644
--- a/sdk/evm/connect/guides/javascript/batch-requests.md
+++ b/sdk/evm/connect/guides/javascript/batch-requests.md
@@ -36,7 +36,6 @@ The following is an example of batching JSON-RPC requests using `metamask_batch`
 ```js
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 async function handleBatchRequests() {
diff --git a/sdk/evm/connect/guides/javascript/display-tokens.md b/sdk/evm/connect/guides/javascript/display-tokens.md
index 29b27cf8761..ea552690e54 100644
--- a/sdk/evm/connect/guides/javascript/display-tokens.md
+++ b/sdk/evm/connect/guides/javascript/display-tokens.md
@@ -40,7 +40,6 @@ To prompt users to add an ERC-20 token, you can add something like the following
 ```javascript
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 const tokenAddress = "0xd00981105e61274c8a5cd5a88fe7e037d935b513"
@@ -116,7 +115,6 @@ To prompt users to add a single NFT, add something like the following to your pr
 ```javascript
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 try {
diff --git a/sdk/evm/connect/guides/javascript/interact-with-contracts.md b/sdk/evm/connect/guides/javascript/interact-with-contracts.md
index a5718e3f72e..a2bdfdd675e 100644
--- a/sdk/evm/connect/guides/javascript/interact-with-contracts.md
+++ b/sdk/evm/connect/guides/javascript/interact-with-contracts.md
@@ -25,7 +25,6 @@ The following example reads contract data using the [`eth_call`](../../reference
 ```javascript
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 async function getBalance(contractAddress, userAddress) {
diff --git a/sdk/evm/connect/guides/javascript/manage-networks.md b/sdk/evm/connect/guides/javascript/manage-networks.md
index 6f58c1d8127..91885181380 100644
--- a/sdk/evm/connect/guides/javascript/manage-networks.md
+++ b/sdk/evm/connect/guides/javascript/manage-networks.md
@@ -31,7 +31,6 @@ The following example detects the current network using the
 ```javascript
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 // Get current chain ID
diff --git a/sdk/evm/connect/guides/javascript/manage-user-accounts.md b/sdk/evm/connect/guides/javascript/manage-user-accounts.md
index 280e799bdab..8559e5b24b0 100644
--- a/sdk/evm/connect/guides/javascript/manage-user-accounts.md
+++ b/sdk/evm/connect/guides/javascript/manage-user-accounts.md
@@ -33,7 +33,6 @@ For example:
 ```javascript
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 // Connect wallet
diff --git a/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md b/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md
index 9d2e4c62efb..31511d26a7a 100644
--- a/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md
+++ b/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md
@@ -52,7 +52,6 @@ For example:
 ```js title="index.js"
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 const capabilities = await evmClient.request({
diff --git a/sdk/evm/connect/guides/javascript/send-transactions/index.md b/sdk/evm/connect/guides/javascript/send-transactions/index.md
index 08b65d04c9d..566409f3033 100644
--- a/sdk/evm/connect/guides/javascript/send-transactions/index.md
+++ b/sdk/evm/connect/guides/javascript/send-transactions/index.md
@@ -29,7 +29,6 @@ RPC methods.
 ```javascript
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 async function sendTransaction(recipientAddress, amount) {
@@ -135,7 +134,6 @@ RPC method.
 ```javascript
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 async function estimateGas(transaction) {
diff --git a/sdk/evm/connect/guides/javascript/sign-data/index.md b/sdk/evm/connect/guides/javascript/sign-data/index.md
index a0022b0c7db..939a71fe6a2 100644
--- a/sdk/evm/connect/guides/javascript/sign-data/index.md
+++ b/sdk/evm/connect/guides/javascript/sign-data/index.md
@@ -65,7 +65,6 @@ The following is an example of using `eth_signTypedData_v4` with MetaMask:
 ```javascript title="index.js"
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 signTypedDataV4Button.addEventListener("click", async function (event) {
@@ -216,7 +215,6 @@ The following is an example of using `personal_sign` with MetaMask:
 ```javascript title="index.js"
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 personalSignButton.addEventListener("click", async function (event) {
diff --git a/sdk/evm/connect/guides/javascript/sign-data/siwe.md b/sdk/evm/connect/guides/javascript/sign-data/siwe.md
index b4bb49087d3..7ffaf0c3cc4 100644
--- a/sdk/evm/connect/guides/javascript/sign-data/siwe.md
+++ b/sdk/evm/connect/guides/javascript/sign-data/siwe.md
@@ -46,7 +46,6 @@ The following is an example of setting up SIWE with MetaMask using
 ```javascript title="index.js"
 import { createEVMClient } from "@metamask/connect/evm";
 
-// Initialize SDK
 const evmClient = createEVMClient();
 
 const siweSign = async (siweMessage) => {

From a4daed39d42beb898aa34b7945f14ccd9ed09975 Mon Sep 17 00:00:00 2001
From: Alexandra Carrillo <alexandra.carrillo@consensys.net>
Date: Tue, 11 Nov 2025 12:24:34 -0800
Subject: [PATCH 3/5] add provider to code snippets

---
 .../connect/guides/javascript/batch-requests.md |  3 ++-
 .../connect/guides/javascript/display-tokens.md |  8 +++++---
 sdk/evm/connect/guides/javascript/index.md      | 17 +++++++++++------
 .../javascript/interact-with-contracts.md       |  7 ++++---
 .../guides/javascript/manage-networks.md        |  9 +++++----
 .../guides/javascript/manage-user-accounts.md   | 11 ++++++-----
 .../send-transactions/batch-transactions.md     |  7 ++++---
 .../javascript/send-transactions/index.md       | 10 ++++++----
 .../guides/javascript/sign-data/index.md        |  6 ++++--
 .../connect/guides/javascript/sign-data/siwe.md |  3 ++-
 .../json-rpc-api/eth_signTypedData_v4.mdx       |  2 +-
 .../reference/json-rpc-api/wallet_sendCalls.mdx |  2 +-
 12 files changed, 51 insertions(+), 34 deletions(-)

diff --git a/sdk/evm/connect/guides/javascript/batch-requests.md b/sdk/evm/connect/guides/javascript/batch-requests.md
index 09898be485f..ed1b777ea8d 100644
--- a/sdk/evm/connect/guides/javascript/batch-requests.md
+++ b/sdk/evm/connect/guides/javascript/batch-requests.md
@@ -37,6 +37,7 @@ The following is an example of batching JSON-RPC requests using `metamask_batch`
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 async function handleBatchRequests() {
   // Example batch: one personal_sign call and one eth_sendTransaction call.
@@ -55,7 +56,7 @@ async function handleBatchRequests() {
   ];
 
   try {
-    const results = await evmClient.request({
+    const results = await provider.request({
       method: "metamask_batch",
       params: [requests],
     });
diff --git a/sdk/evm/connect/guides/javascript/display-tokens.md b/sdk/evm/connect/guides/javascript/display-tokens.md
index ea552690e54..63471b28168 100644
--- a/sdk/evm/connect/guides/javascript/display-tokens.md
+++ b/sdk/evm/connect/guides/javascript/display-tokens.md
@@ -41,6 +41,7 @@ To prompt users to add an ERC-20 token, you can add something like the following
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 const tokenAddress = "0xd00981105e61274c8a5cd5a88fe7e037d935b513"
 const tokenSymbol = "TUT"
@@ -49,7 +50,7 @@ const tokenImage = "http://placekitten.com/200/300"
 
 try {
   // 'wasAdded' is a boolean. Like any RPC method, an error can be thrown.
-  const wasAdded = await evmClient.request({
+  const wasAdded = await provider.request({
     method: "wallet_watchAsset",
     params: {
       type: "ERC20",
@@ -116,10 +117,11 @@ To prompt users to add a single NFT, add something like the following to your pr
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 try {
   // wasAdded is a boolean. Like any RPC method, an error can be thrown.
-  const wasAdded = await evmClient.request({
+  const wasAdded = await provider.request({
     method: "wallet_watchAsset",
     params: {
       type: "ERC721", // Or "ERC1155".
@@ -149,7 +151,7 @@ To prompt users to add multiple NFTs, use `sendAsync()` instead of
 For example:
 
 ```javascript
-evmClient.sendAsync([{ // TO DO: Confirm if MM Connect supports sendAsync
+provider.sendAsync([{
     method: "wallet_watchAsset",
     params: {
       type: "ERC721",
diff --git a/sdk/evm/connect/guides/javascript/index.md b/sdk/evm/connect/guides/javascript/index.md
index ed01cd6ed29..6bdb709ac9d 100644
--- a/sdk/evm/connect/guides/javascript/index.md
+++ b/sdk/evm/connect/guides/javascript/index.md
@@ -145,10 +145,12 @@ These examples configure the SDK with the following options:
 Connect to MetaMask and get the provider for RPC requests:
 
 ```javascript
+const provider = evmClient.getProvider()
+
 const accounts = await evmClient.connect()
 console.log("Connected account:", accounts[0])
 
-const result = await evmClient.request({
+const result = await provider.request({
   method: "eth_accounts",
   params: [],
 })
@@ -157,7 +159,7 @@ console.log("eth_accounts result:", result)
 
 `evmClient.connect()` handles cross-platform connection (desktop and mobile), including deeplinking.
 
-Use `evmClient.request()` for arbitrary [JSON-RPC requests](../../reference/json-rpc-api/index.md) like `eth_chainId` or `eth_getBalance`, or for [batching requests](batch-requests.md) via `metamask_batch`.
+Use `provider.request()` for arbitrary [JSON-RPC requests](../../reference/json-rpc-api/index.md) like `eth_chainId` or `eth_getBalance`, or for [batching requests](batch-requests.md) via `metamask_batch`.
 
 ## Common SDK methods at a glance
 
@@ -180,14 +182,17 @@ const signResult = await evmClient.connectAndSign({
   msg: "Sign in to the dapp",
 })
 
-// 3. Make an RPC request
-const result = await evmClient.request({
+// 3. Get provider for RPC requests
+const provider = evmClient.getProvider()
+
+// 4. Make an RPC request
+const result = await provider.request({
   method: "eth_accounts",
   params: [],
 })
 
-// 4. Batch multiple RPC requests
-const batchResults = await evmClient.request({
+// 5. Batch multiple RPC requests
+const batchResults = await provider.request({
   method: "metamask_batch",
   params: [{ method: "eth_accounts" }, { method: "eth_chainId" }],
 })
diff --git a/sdk/evm/connect/guides/javascript/interact-with-contracts.md b/sdk/evm/connect/guides/javascript/interact-with-contracts.md
index a2bdfdd675e..6158c5fa4e1 100644
--- a/sdk/evm/connect/guides/javascript/interact-with-contracts.md
+++ b/sdk/evm/connect/guides/javascript/interact-with-contracts.md
@@ -26,6 +26,7 @@ The following example reads contract data using the [`eth_call`](../../reference
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 async function getBalance(contractAddress, userAddress) {
   try {
@@ -34,7 +35,7 @@ async function getBalance(contractAddress, userAddress) {
     // Pad address to 32 bytes
     const encodedAddress = userAddress.slice(2).padStart(64, "0");
     
-    const result = await evmClient.request({
+    const result = await provider.request({
       method: "eth_call",
       params: [{
         to: contractAddress,
@@ -73,7 +74,7 @@ RPC methods:
 async function mintNFT(contractAddress, tokenId) {
   try {
     // Get user's account
-    const accounts = await evmClient.request({ 
+    const accounts = await provider.request({ 
       method: "eth_requestAccounts" 
     });
     
@@ -83,7 +84,7 @@ async function mintNFT(contractAddress, tokenId) {
     const encodedTokenId = tokenId.toString(16).padStart(64, "0");
     
     // Send transaction
-    const txHash = await evmClient.request({
+    const txHash = await provider.request({
       method: "eth_sendTransaction",
       params: [{
         from: accounts[0],
diff --git a/sdk/evm/connect/guides/javascript/manage-networks.md b/sdk/evm/connect/guides/javascript/manage-networks.md
index 91885181380..ece5ee8bb13 100644
--- a/sdk/evm/connect/guides/javascript/manage-networks.md
+++ b/sdk/evm/connect/guides/javascript/manage-networks.md
@@ -32,11 +32,12 @@ The following example detects the current network using the
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 // Get current chain ID
 async function getCurrentChain() {
   try {
-    const chainId = await evmClient.request({ 
+    const chainId = await provider.request({ 
       method: "eth_chainId" 
     });
     console.log("Current chain ID:", chainId);
@@ -47,7 +48,7 @@ async function getCurrentChain() {
 }
 
 // Listen for network changes
-ethereum.on("chainChanged", (chainId) => { // TO DO: Update with MM Connect usage
+provider.on("chainChanged", (chainId) => {
   console.log("Network changed to:", chainId);
   // We recommend reloading the page
   window.location.reload();
@@ -84,7 +85,7 @@ async function switchNetwork(networkKey) {
   
   try {
     // Try to switch to the network
-    await evmClient.request({
+    await provider.request({
       method: "wallet_switchEthereumChain",
       params: [{ chainId: network.chainId }]
     });
@@ -92,7 +93,7 @@ async function switchNetwork(networkKey) {
     // If the error code is 4902, the network needs to be added
     if (err.code === 4902) {
       try {
-        await evmClient.request({
+        await provider.request({
           method: "wallet_addEthereumChain",
           params: [{
             chainId: network.chainId,
diff --git a/sdk/evm/connect/guides/javascript/manage-user-accounts.md b/sdk/evm/connect/guides/javascript/manage-user-accounts.md
index 8559e5b24b0..3777dfccab8 100644
--- a/sdk/evm/connect/guides/javascript/manage-user-accounts.md
+++ b/sdk/evm/connect/guides/javascript/manage-user-accounts.md
@@ -34,6 +34,7 @@ For example:
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 // Connect wallet
 async function connectWallet() {
@@ -41,7 +42,7 @@ async function connectWallet() {
     // Disable button while request is pending
     document.getElementById("connectBtn").disabled = true;
     
-    const accounts = await evmClient.request({ 
+    const accounts = await provider.request({ 
       method: "eth_requestAccounts" 
     });
     
@@ -66,14 +67,14 @@ async function connectWallet() {
 // Disconnect wallet
 async function disconnectWallet() {
   try {
-    await evmClient.terminate()
+    await provider.terminate()
   } catch (err) {
     console.error("Error with disconnecting:", err)
   }
 }
 
 // Handle account changes
-provider.on("accountsChanged", (accounts) => { // TO DO: Update with MM Connect usage
+provider.on("accountsChanged", (accounts) => {
   if (accounts.length === 0) {
     // User disconnected
     document.getElementById("status").textContent = "Not connected";
@@ -104,9 +105,9 @@ You can use MM Connect's [`connectAndSign`](../../reference/methods.md#connectan
 For example:
 
 ```js
-import { createEVMClient } from "@metamask/connect/evm"
+import { createEVMClient } from "@metamask/connect/evm";
 
-const evmClient = createEVMClient()
+const evmClient = createEVMClient();
 
 async function handleConnectAndSign() {
   try {
diff --git a/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md b/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md
index 31511d26a7a..453f8c30731 100644
--- a/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md
+++ b/sdk/evm/connect/guides/javascript/send-transactions/batch-transactions.md
@@ -53,8 +53,9 @@ For example:
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
-const capabilities = await evmClient.request({
+const capabilities = await provider.request({
   method: "wallet_getCapabilities",
   params: [
     "0xd46e8dd67c5d32be8058bb8eb970870f07244567", // The user's wallet address.
@@ -123,7 +124,7 @@ Use [`wallet_sendCalls`](../../../reference/json-rpc-api/index.md) to submit a b
 For example:
 
 ```js title="index.js"
-const result = await evmClient.request({
+const result = await provider.request({
   method: "wallet_sendCalls",
   params: [
     {
@@ -168,7 +169,7 @@ the status of the submitted batch of transactions, using the batch ID returned b
 For example:
 
 ```js title="index.js"
-const status = await evmClient.request({
+const status = await provider.request({
   method: "wallet_getCallsStatus",
   params: [
     "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331" // Batch ID.
diff --git a/sdk/evm/connect/guides/javascript/send-transactions/index.md b/sdk/evm/connect/guides/javascript/send-transactions/index.md
index 566409f3033..4b2faa5c15b 100644
--- a/sdk/evm/connect/guides/javascript/send-transactions/index.md
+++ b/sdk/evm/connect/guides/javascript/send-transactions/index.md
@@ -30,11 +30,12 @@ RPC methods.
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 async function sendTransaction(recipientAddress, amount) {
   try {
     // Get current account
-    const accounts = await evmClient.request({ 
+    const accounts = await provider.request({ 
       method: "eth_requestAccounts" 
     });
     const from = accounts[0];
@@ -51,7 +52,7 @@ async function sendTransaction(recipientAddress, amount) {
     };
 
     // Send transaction
-    const txHash = await evmClient.request({
+    const txHash = await provider.request({
       method: "eth_sendTransaction",
       params: [transaction],
     });
@@ -70,7 +71,7 @@ function watchTransaction(txHash) {
   return new Promise((resolve, reject) => {
     const checkTransaction = async () => {
       try {
-        const tx = await evmClient.request({
+        const tx = await provider.request({
           method: "eth_getTransactionReceipt",
           params: [txHash],
         });
@@ -135,10 +136,11 @@ RPC method.
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 async function estimateGas(transaction) {
   try {
-    const gasEstimate = await evmClient.request({
+    const gasEstimate = await provider.request({
       method: "eth_estimateGas",
       params: [transaction]
     });
diff --git a/sdk/evm/connect/guides/javascript/sign-data/index.md b/sdk/evm/connect/guides/javascript/sign-data/index.md
index 939a71fe6a2..502f69c8ec6 100644
--- a/sdk/evm/connect/guides/javascript/sign-data/index.md
+++ b/sdk/evm/connect/guides/javascript/sign-data/index.md
@@ -66,6 +66,7 @@ The following is an example of using `eth_signTypedData_v4` with MetaMask:
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 signTypedDataV4Button.addEventListener("click", async function (event) {
   event.preventDefault()
@@ -141,7 +142,7 @@ signTypedDataV4Button.addEventListener("click", async function (event) {
   var params = [from[0], msgParams]
   var method = "eth_signTypedData_v4"
 
-  evmClient.sendAsync( // TO DO: Confirm if MM Connect supports sendAsync
+  provider.sendAsync(
     {
       method,
       params,
@@ -216,6 +217,7 @@ The following is an example of using `personal_sign` with MetaMask:
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 personalSignButton.addEventListener("click", async function (event) {
   event.preventDefault()
@@ -225,7 +227,7 @@ personalSignButton.addEventListener("click", async function (event) {
     // For historical reasons, you must submit the message to sign in hex-encoded UTF-8.
     // This uses a Node.js-style buffer shim in the browser.
     const msg = `0x${Buffer.from(exampleMessage, "utf8").toString("hex")}`
-    const sign = await evmClient.request({
+    const sign = await provider.request({
       method: "personal_sign",
       params: [msg, from],
     })
diff --git a/sdk/evm/connect/guides/javascript/sign-data/siwe.md b/sdk/evm/connect/guides/javascript/sign-data/siwe.md
index 7ffaf0c3cc4..6edab221a46 100644
--- a/sdk/evm/connect/guides/javascript/sign-data/siwe.md
+++ b/sdk/evm/connect/guides/javascript/sign-data/siwe.md
@@ -47,12 +47,13 @@ The following is an example of setting up SIWE with MetaMask using
 import { createEVMClient } from "@metamask/connect/evm";
 
 const evmClient = createEVMClient();
+const provider = evmClient.getProvider();
 
 const siweSign = async (siweMessage) => {
   try {
     const from = accounts[0]
     const msg = `0x${Buffer.from(siweMessage, "utf8").toString("hex")}`
-    const sign = await evmClient.request({
+    const sign = await provider.request({
       method: "personal_sign",
       params: [msg, from],
     })
diff --git a/sdk/evm/connect/reference/json-rpc-api/eth_signTypedData_v4.mdx b/sdk/evm/connect/reference/json-rpc-api/eth_signTypedData_v4.mdx
index 8dca89de0d7..ceff8df67ff 100644
--- a/sdk/evm/connect/reference/json-rpc-api/eth_signTypedData_v4.mdx
+++ b/sdk/evm/connect/reference/json-rpc-api/eth_signTypedData_v4.mdx
@@ -103,7 +103,7 @@ import SimplifiedApiReference from '@site/src/components/SimplifiedApiReference'
       description: "Invalid typed data structure"
     }
   ]}
-  exampleRequest={`await evmClient.request({
+  exampleRequest={`await provider.request({
     method: "eth_signTypedData_v4",
     params: [
       "0x3b7252d007059ffc82d16d022da3cbf9992d2f70",
diff --git a/sdk/evm/connect/reference/json-rpc-api/wallet_sendCalls.mdx b/sdk/evm/connect/reference/json-rpc-api/wallet_sendCalls.mdx
index e49c2c383bd..dd8e1d608a6 100644
--- a/sdk/evm/connect/reference/json-rpc-api/wallet_sendCalls.mdx
+++ b/sdk/evm/connect/reference/json-rpc-api/wallet_sendCalls.mdx
@@ -125,7 +125,7 @@ import SimplifiedApiReference from '@site/src/components/SimplifiedApiReference'
       description: "Upgrade rejected"
     }
   ]}
-  exampleRequest={`await evmClient.request({
+  exampleRequest={`await provider.request({
     method: "wallet_sendCalls",
     params: [{
       "version": "2.0.0",

From 130ad9d63ea62c90b46e3b5673f2eccb838f1799 Mon Sep 17 00:00:00 2001
From: Alexandra Carrillo <alexandra.carrillo@consensys.net>
Date: Tue, 11 Nov 2025 12:29:33 -0800
Subject: [PATCH 4/5] fix cursor bugs

---
 sdk/evm/connect/guides/javascript/interact-with-contracts.md | 2 +-
 sdk/evm/connect/guides/javascript/manage-user-accounts.md    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/sdk/evm/connect/guides/javascript/interact-with-contracts.md b/sdk/evm/connect/guides/javascript/interact-with-contracts.md
index 6158c5fa4e1..34717c3e1e9 100644
--- a/sdk/evm/connect/guides/javascript/interact-with-contracts.md
+++ b/sdk/evm/connect/guides/javascript/interact-with-contracts.md
@@ -107,7 +107,7 @@ async function watchTransaction(txHash) {
   return new Promise((resolve, reject) => {
     const checkTransaction = async () => {
       try {
-        const tx = await evmClient.request({
+        const tx = await provider.request({
           method: "eth_getTransactionReceipt",
           params: [txHash],
         });
diff --git a/sdk/evm/connect/guides/javascript/manage-user-accounts.md b/sdk/evm/connect/guides/javascript/manage-user-accounts.md
index 3777dfccab8..9040f5d3fd3 100644
--- a/sdk/evm/connect/guides/javascript/manage-user-accounts.md
+++ b/sdk/evm/connect/guides/javascript/manage-user-accounts.md
@@ -67,7 +67,7 @@ async function connectWallet() {
 // Disconnect wallet
 async function disconnectWallet() {
   try {
-    await provider.terminate()
+    await evmClient.terminate()
   } catch (err) {
     console.error("Error with disconnecting:", err)
   }

From 44f52be59956d2941cc51551be273bcf5f8afbb3 Mon Sep 17 00:00:00 2001
From: Alexandra Carrillo <alexandra.carrillo@consensys.net>
Date: Wed, 12 Nov 2025 08:11:31 -0800
Subject: [PATCH 5/5] remove /evm from wagmi install

---
 sdk/evm/connect/guides/wagmi/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sdk/evm/connect/guides/wagmi/index.md b/sdk/evm/connect/guides/wagmi/index.md
index fde0f250d58..1fd20ee774c 100644
--- a/sdk/evm/connect/guides/wagmi/index.md
+++ b/sdk/evm/connect/guides/wagmi/index.md
@@ -72,7 +72,7 @@ You can [download the quickstart template](#set-up-using-a-template) or [manuall
 Install MM Connect along with its peer dependencies to an existing React project:
 
 ```bash npm2yarn
-npm install @metamask/connect/evm wagmi viem@2.x @tanstack/react-query
+npm install @metamask/connect wagmi viem@2.x @tanstack/react-query
 ```
 
 ### 2. Import required dependencies