Various SDK doc fixes

alexandratran · alexandratran · commit 4cc7ebf0deaf · 2025-08-04T15:52:55.000-07:00
diff --git a/sdk-sidebar.js b/sdk-sidebar.js
@@ -32,17 +32,8 @@ const sidebar = {
         'guides/handle-transactions',
         'guides/interact-with-contracts',
         'guides/use-deeplinks',
-        {
-          type: 'category',
-          label: 'Advanced',
-          collapsible: true,
-          collapsed: true,
-          items: [
-            'guides/advanced/connect-and-sign',
-            'guides/advanced/batch-requests',
-            'guides/advanced/production-readiness',
-          ],
-        },
+        'guides/batch-requests',
+        'guides/production-readiness',
       ],
     },
     {
diff --git a/sdk/connect/react-native.md b/sdk/connect/react-native.md
@@ -176,7 +176,7 @@ For example:
 import { useSDK } from "@metamask/sdk-react"
 
 function App() {
-  const { connect, disconnect, account, chainId, ethereum } = useSDK()
+  const { connect, terminate, account, chainId, ethereum } = useSDK()
 
   // Connect to MetaMask
   const connectWallet = async () => {
@@ -196,7 +196,7 @@ function App() {
 
   // Disconnect wallet
   const disconnectWallet = async () => {
-    await disconnect()
+    await terminate()
   }
 
   return (
diff --git a/sdk/guides/advanced/connect-and-sign.md b/sdk/guides/advanced/connect-and-sign.md
diff --git a/sdk/guides/authenticate-users.md b/sdk/guides/authenticate-users.md
@@ -1,6 +1,7 @@
 ---
 description: Authenticate users with the SDK in your Wagmi or Vanilla JavaScript dapp.
-toc_max_heading_level: 2
+keywords: [SDK, Wagmi, JavaScript, authenticate, connect, sign, accounts, wallet, dapp]
+toc_max_heading_level: 3
 ---
 
 # Authenticate users
@@ -11,6 +12,7 @@ With the SDK, you can:
 
 - **Connect users' wallets** to your dapp.
 - **Access user accounts** (addresses).
+- [**Connect and sign**](#connect-and-sign) in a single user interaction.
 - **Handle connection states** (connected/disconnected).
 - **Listen for account changes** in real time.
 - **Manage wallet sessions** (connect/disconnect).
@@ -125,6 +127,15 @@ async function connectWallet() {
   }
 }
 
+// Disconnect wallet
+async function disconnectWallet() {
+  try {
+    await MMSDK.terminate()
+  } catch (err) {
+    console.error("Error with disconnecting:", err)
+  }
+}
+
 // Handle account changes
 provider.on("accountsChanged", (accounts) => {
   if (accounts.length === 0) {
@@ -151,6 +162,43 @@ Display connect and disconnect buttons in HTML:
 </div>
 ```
 
+### Connect and sign
+
+If you're not using Wagmi, you can access MetaMask SDK's `connectAndSign` method,
+which requests wallet access and signs the message in a single user interaction.
+For example:
+
+```js
+import { MetaMaskSDK } from "@metamask/sdk"
+
+const MMSDK = new MetaMaskSDK()
+const provider = MMSDK.getProvider()
+
+async function handleConnectAndSign() {
+  try {
+    const signature = await MMSDK.connectAndSign({ msg: "Hello in one go!" })
+    console.log("Signature:", signature)
+  } catch (err) {
+    console.error("Error with connectAndSign:", err)
+  }
+}
+
+document
+  .getElementById("connectSignBtn")
+  .addEventListener("click", handleConnectAndSign)
+```
+
+The following HTML displays a **Connect & Sign** button:
+
+```html
+<button id="connectSignBtn">Connect & Sign</button>
+```
+
+:::tip
+This one-step flow is unique to MetaMask SDK's `connectAndSign` method.
+It's not part of Wagmi or other wallet libraries.
+:::
+
 ## Best practices
 
 Follow these best practices when authenticating users.
diff --git a/sdk/guides/batch-requests.md b/sdk/guides/batch-requests.md
@@ -1,5 +1,6 @@
 ---
 description: Batch multiple JSON-RPC requests using MetaMask SDK or Wagmi.
+keywords: [SDK, Wagmi, batch, JSON-RPC, RPC, requests, methods, dapp]
 ---
 
 # Batch requests
diff --git a/sdk/guides/handle-transactions.md b/sdk/guides/handle-transactions.md
@@ -1,5 +1,6 @@
 ---
 description: Handle transactions with the SDK in your Wagmi or Vanilla JavaScript dapp.
+keywords: [SDK, Wagmi, JavaScript, send, transaction, transactions, status, estimate, gas, dapp]
 toc_max_heading_level: 2
 ---
 
diff --git a/sdk/guides/interact-with-contracts.md b/sdk/guides/interact-with-contracts.md
@@ -1,5 +1,6 @@
 ---
 description: Interact with contracts with the SDK in your Wagmi or Vanilla JavaScript dapp.
+keywords: [SDK, Wagmi, JavaScript, read, write, smart, contract, contracts, dapp]
 sidebar_label: Interact with contracts
 toc_max_heading_level: 2
 ---
diff --git a/sdk/guides/manage-networks.md b/sdk/guides/manage-networks.md
@@ -1,5 +1,6 @@
 ---
 description: Manage networks with the SDK in your Wagmi or Vanilla JavaScript dapp.
+keywords: [SDK, Wagmi, JavaScript, detect, switch, add, network, networks, dapp]
 toc_max_heading_level: 2
 ---
 
diff --git a/sdk/guides/production-readiness.md b/sdk/guides/production-readiness.md
@@ -1,5 +1,6 @@
 ---
 description: MetaMask-specific production readiness checklist for dapps using MetaMask SDK.
+keywords: [SDK, production, readiness, checklist, compatibility, errors, dapp]
 toc_max_heading_level: 2
 ---
 
diff --git a/sdk/guides/use-deeplinks.md b/sdk/guides/use-deeplinks.md
@@ -1,5 +1,6 @@
 ---
-description: Use deeplinks to connect to users' mobile wallets.
+description: Use deeplinks to connect to users' MetaMask mobile wallets.
+keywords: [SDK, deeplink, deeplinks, mobile, dapp]
 toc_max_heading_level: 2
 ---
 
diff --git a/sdk/reference/llm-prompt.md b/sdk/reference/llm-prompt.md
@@ -1,5 +1,6 @@
 ---
 description: Context about MetaMask SDK that can be provided to an LLM.
+keywords: [SDK, LLM, intro, context, integration, dapp]
 ---
 
 # LLM prompt
diff --git a/sdk/reference/sdk-options.md b/sdk/reference/sdk-options.md
@@ -1,5 +1,6 @@
 ---
 description: Configuration options reference for MetaMask SDK.
+keywords: [SDK, configure, configuration, option, options, dapp]
 ---
 
 import Tabs from "@theme/Tabs";
diff --git a/sdk/reference/supported-platforms.md b/sdk/reference/supported-platforms.md
@@ -1,5 +1,6 @@
 ---
 description: Supported dapp platforms for MetaMask SDK.
+keywords: [SDK, supported, platforms, desktop, mobile, dapp]
 ---
 
 # Supported platforms
diff --git a/sdk/tutorials/create-wallet-ai-agent.md b/sdk/tutorials/create-wallet-ai-agent.md
@@ -1,5 +1,6 @@
 ---
 description: Create a wallet AI agent using MetaMask SDK and Vercel's AI SDK.
+keywords: [SDK, wallet, AI, agent, Vercel, Wagmi, Next.js, OpenAI, dapp]
 ---
 
 import Tabs from "@theme/Tabs";
diff --git a/vercel.json b/vercel.json
@@ -418,6 +418,18 @@
       "source": "/wallet/reference/non-evm-apis/",
       "destination": "/wallet/how-to/use-non-evm-networks/"
     },
+    {
+      "source": "/sdk/guides/advanced/connect-and-sign/",
+      "destination": "/sdk/guides/authenticate-users/"
+    },
+    {
+      "source": "/sdk/guides/advanced/batch-requests/",
+      "destination": "/sdk/guides/batch-requests/"
+    },
+    {
+      "source": "/sdk/guides/advanced/production-readiness/",
+      "destination": "/sdk/guides/production-readiness/"
+    },
     {
       "source": "/guide/snaps/",
       "destination": "/snaps/"
