SDK new structure PoC

docusaurus.config.js

@@ -251,31 +251,6 @@ const config = {
         rehypePlugins,
       },
     ],
-    [
-      '@docusaurus/plugin-content-docs',
-      {
-        id: 'wallet',
-        path: 'wallet',
-        routeBasePath: 'wallet',
-        editUrl: 'https://github.com/MetaMask/metamask-docs/edit/main/',
-        sidebarPath: require.resolve('./wallet-sidebar.js'),
-        breadcrumbs: false,
-        remarkPlugins,
-        rehypePlugins,
-        sidebarItemsGenerator: async function ({ defaultSidebarItemsGenerator, ...args }) {
-          const sidebarItems = await defaultSidebarItemsGenerator(args)
-          const dynamicItems = await fetchAndGenerateDynamicSidebarItems(
-            MM_RPC_URL,
-            MM_REF_PATH,
-            NETWORK_NAMES.metamask
-          )
-          if (args.item.dirName === 'reference/json-rpc-methods') {
-            return [...sidebarItems, ...dynamicItems]
-          }
-          return sidebarItems
-        },
-      },
-    ],
     [
       '@docusaurus/plugin-content-docs',
       {

sdk-sidebar.js

@@ -1,24 +1,49 @@
 // @ts-check
 
 /** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
-const sidebar = {
-  sdkSidebar: [
+const sdkSidebar = {
+  multichain: [
+    'index',
     {
-      type: 'doc',
-      label: 'Introduction',
-      id: "index",
+      type: 'category',
+      label: 'Guides',
+      collapsible: false,
+      collapsed: false,
+      items: [
+        'multichain/connect/guides/connect-to-multichain',
+        'multichain/connect/guides/send-transactions',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Tutorials',
+      collapsible: false,
+      collapsed: false,
+      items: [
+        'multichain/connect/tutorials/create-multichain-dapp',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Reference',
+      collapsible: false,
+      collapsed: false,
+      items: [
+        'multichain/connect/reference/multichain-api',
+      ],
     },
+  ],
+  evm: [
+    'evm/index',
     {
       type: 'category',
-      label: 'Connect to MetaMask',
+      label: 'Get started',
       collapsible: false,
       collapsed: false,
       items: [
-        'connect/javascript-wagmi',
-        'connect/javascript',
-        'connect/javascript-dynamic',
-        'connect/javascript-web3auth',
-        'connect/react-native',
+        'evm/connect/get-started/javascript-wagmi',
+        'evm/connect/get-started/javascript',
+        'evm/connect/get-started/react-native',
       ],
     },
     {
@@ -27,13 +52,53 @@ const sidebar = {
       collapsible: false,
       collapsed: false,
       items: [
-        'guides/authenticate-users',
-        'guides/manage-networks',
-        'guides/handle-transactions',
-        'guides/interact-with-contracts',
-        'guides/use-deeplinks',
-        'guides/batch-requests',
-        'guides/production-readiness',
+        'evm/connect/guides/manage-user-accounts',
+        'evm/connect/guides/manage-networks',
+        {
+          type: 'category',
+          label: 'Send transactions',
+          collapsible: true,
+          collapsed: true,
+          link: { type: "doc", id: "evm/connect/guides/send-transactions/index" },
+          items: [
+            'evm/connect/guides/send-transactions/send-batch-transactions',
+          ],
+        },
+        {
+          type: 'category',
+          label: 'Sign data',
+          collapsible: true,
+          collapsed: true,
+          link: { type: "doc", id: "evm/connect/guides/sign-data/index" },
+          items: [
+            'evm/connect/guides/sign-data/siwe',
+          ],
+        },
+        'evm/connect/guides/batch-requests',
+        'evm/connect/guides/interact-with-contracts',
+        'evm/connect/guides/use-deeplinks',
+        'evm/connect/guides/display-tokens',
+        {
+          type: 'category',
+          label: 'Best practices',
+          collapsible: true,
+          collapsed: true,
+          items: [
+            'evm/connect/guides/best-practices/display',
+            'evm/connect/guides/best-practices/run-devnet',
+            'evm/connect/guides/best-practices/production-readiness',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Partner guides',
+      collapsible: false,
+      collapsed: false,
+      items: [
+        'evm/connect/partners/dynamic',
+        'evm/connect/partners/web3auth',
       ],
     },
     {
@@ -60,13 +125,68 @@ const sidebar = {
       collapsible: false,
       collapsed: false,
       items: [
-        'reference/llm-prompt',
-        'reference/supported-platforms',
-        'reference/sdk-options',
-        'reference/sdk-methods',
+        'evm/connect/reference/sdk-options',
+        'evm/connect/reference/sdk-methods',
+        'evm/connect/reference/provider-api',
+        {
+          type: "category",
+          label: "JSON-RPC API",
+          collapsible: true,
+          collapsed: true,
+          link: { type: "doc",  id: "evm/connect/reference/json-rpc-methods/index" },
+          items: [{ type: "autogenerated", dirName: "evm/connect/reference/json-rpc-methods" }],
+        },
+      ],
+    },
+  ],
+  solana: [
+    'solana/index',
+    'solana/connect/wallet-standard',
+  ],
+  starknet: [
+    'starknet/index',
+    {
+      type: "category",
+      label: "Guides",
+      collapsible: false,
+      collapsed: false,
+      items: [
+        'starknet/guides/connect-to-starknet',
+        'starknet/guides/manage-starknet-accounts',
+        'starknet/guides/manage-starknet-networks',
+        'starknet/guides/send-starknet-transactions',
+        'starknet/guides/sign-starknet-data',
+        'starknet/guides/troubleshoot',
+      ],
+    },
+    {
+      type: "category",
+      label: "Concepts",
+      collapsible: false,
+      collapsed: false,
+      items: [
+        'starknet/concepts/about-get-starknet',
+      ],
+    },
+    {
+      type: "category",
+      label: "Tutorials",
+      collapsible: false,
+      collapsed: false,
+      items: [
+        'starknet/tutorials/create-a-simple-starknet-dapp',
+      ],
+    },
+    {
+      type: "category",
+      label: "Reference",
+      collapsible: false,
+      collapsed: false,
+      items: [
+        'starknet/reference/starknet-snap-api',
       ],
     },
   ],
 }
 
-module.exports = sidebar
+module.exports = sdkSidebar

sdk/evm/connect/guides/best-practices/display.md

@@ -0,0 +1,30 @@
+# Display in MetaMask
+
+## Display icons
+
+When your dapp makes a login request to a MetaMask user, MetaMask may render a modal that displays
+your dapp icon.
+
+MetaMask retrieves this icon using the HTML selector `<head> link[rel="shortcut icon"]`, so you can
+follow the [favicon standard](https://en.wikipedia.org/wiki/Favicon) to customize your dapp icon.
+Make sure to have a `link` tag within your dapp's `head` with `rel = "shortcut icon"`, as in the
+following example.
+The tag's `href` attribute is used for assigning the dapp icon.
+
+```html
+<head>
+  <link rel="shortcut icon" href="https://your-dapp.com/your-icon.png" />
+</head>
+```
+
+## Display method names
+
+MetaMask uses the [Ethereum Signature Database](https://www.4byte.directory/) to display
+method names on the confirmation screen.
+For many common method names, such as token methods, this allows MetaMask to look up the method
+names by their [method signature](https://solidity.readthedocs.io/en/v0.4.21/abi-spec.html).
+However, sometimes you're using a method that isn't in that database, and MetaMask simply
+displays **Contract Interaction** to the user.
+
+To register your contract's method names so they show in the MetaMask interface,
+[submit each method's signature to the Ethereum Signature Database](https://www.4byte.directory/submit/).

wallet/how-to/display/tokens.md → sdk/evm/connect/guides/display-tokens.md

@@ -97,10 +97,10 @@ The add NFT interfaces look like the following:
 
 <div class="imgRow">
     <div class="imgCol">
-        <img src={require("../../assets/watchasset-nft.png").default} alt="NFT confirmation" class="appScreen" />
+        <img src={require("../assets/watchasset-nft.png").default} alt="NFT confirmation" class="appScreen" />
     </div>
     <div class="imgCol">
-        <img src={require("../../assets/watchasset-nft-2.png").default} alt="Multiple NFTs confirmation" class="appScreen" />
+        <img src={require("../assets/watchasset-nft-2.png").default} alt="Multiple NFTs confirmation" class="appScreen" />
     </div>
 </div>
 

sdk/guides/authenticate-users.md → sdk/evm/connect/guides/manage-user-accounts.md

@@ -4,7 +4,7 @@ keywords: [SDK, Wagmi, JavaScript, authenticate, connect, sign, accounts, wallet
 toc_max_heading_level: 3
 ---
 
-# Authenticate users
+# Manage user accounts
 
 Connect and manage user wallet sessions in your [Wagmi](#use-wagmi) or
 [Vanilla JavaScript](#use-vanilla-javascript) dapp.

sdk/guides/handle-transactions.md → sdk/evm/connect/guides/send-transactions/index.md

@@ -4,7 +4,7 @@ keywords: [SDK, Wagmi, JavaScript, send, transaction, transactions, status, esti
 toc_max_heading_level: 2
 ---
 
-# Handle transactions
+# Send transactions
 
 Handle EVM transactions in your [Wagmi](#use-wagmi) or [Vanilla JavaScript](#use-vanilla-javascript) dapp.
 With the SDK, you can:

sdk/evm/connect/index.md

@@ -0,0 +1 @@
+# MM Connect for EVM networks

sdk/evm/index.md

@@ -0,0 +1,9 @@
+---
+sidebar_label: Introduction
+---
+
+# MetaMask SDK for EVM networks
+
+## MM Connect
+
+## MM Pay

sdk/index.md

@@ -1,6 +1,5 @@
 ---
-slug: /
-title: SDK introduction
+sidebar_label: Introduction
 description: Introduction page for MetaMask SDK documentation.
 keywords: [connect, sdk, integrate, dapp]
 ---

sdk/multichain/connect/guides/connect-to-multichain.md

@@ -0,0 +1 @@
+# Connect to multiple chains

sdk/multichain/connect/guides/send-transactions.md

@@ -0,0 +1 @@
+# Send multichain transactions

sdk/multichain/connect/index.md

@@ -0,0 +1 @@
+# MM Connect for multichain

sdk/multichain/connect/tutorials/create-multichain-dapp.md

@@ -0,0 +1 @@
+# Create a multichain dapp