Merge branch 'main' into sdk-new-structure

# Conflicts:
#	wallet/concepts/wallet-interoperability.md
#	wallet/how-to/connect-extension.md

.github/workflows/ci.yml

@@ -19,7 +19,7 @@ jobs:
     name: Build
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Build
         uses: ConsenSys/github-actions/docs-build@main
 
@@ -30,7 +30,7 @@ jobs:
       matrix:
         folder: ['docs']
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Case check action
         uses: ConsenSys/github-actions/docs-case-check@main
         with:
@@ -41,7 +41,7 @@ jobs:
     name: Lint Code Base
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Lint
         uses: ConsenSys/github-actions/docs-lint-all@main
 
@@ -52,7 +52,7 @@ jobs:
       matrix:
         file-extensions: ['.md', '.mdx']
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Vale
         uses: Consensys/github-actions/docs-spelling-check@main
         with:
@@ -62,7 +62,7 @@ jobs:
     name: Link Checking
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: LinkCheck
         uses: ConsenSys/github-actions/docs-link-check@main
         with:

.github/workflows/crowdin.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Synchronize with Crowdin
         uses: crowdin/github-action@v2

.github/workflows/dependency_review.yml

@@ -16,7 +16,7 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
 
       - name: Dependency review
         uses: ConsenSys/github-actions/js-dependency-review@main

.github/workflows/nightly.yml

@@ -17,7 +17,7 @@
       permissions:
         contents: read
       steps:
-        - uses: actions/checkout@v5
+        - uses: actions/checkout@v6
         - name: LinkCheck mdx files
           uses: ConsenSys/github-actions/docs-link-check@main
           with:
@@ -32,7 +32,7 @@
       permissions:
         contents: read
       steps:
-        - uses: actions/checkout@v5
+        - uses: actions/checkout@v6
         - name: LinkCheck md files
           uses: ConsenSys/github-actions/docs-link-check@main
           with:

.github/workflows/security-code-scanner.yml

@@ -17,7 +17,7 @@ jobs:
       contents: read
       security-events: write
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: MetaMask Security Code Scanner
         uses: ConsenSys/github-actions/mm-security-scanner@main
         with:

.github/workflows/trivy-cache.yml

@@ -14,6 +14,6 @@ jobs:
     name: Run trivy scanner
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Trivy Cache
         uses: ConsenSys/github-actions/trivy-update-cache@main

.github/workflows/trivy.yml

@@ -10,7 +10,7 @@ jobs:
     name: Run trivy scanner
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Trivy
         uses: ConsenSys/github-actions/trivy@main
         with:

.linkspector.yml

@@ -32,6 +32,8 @@ ignorePatterns:
 - pattern: '^/snaps/'
 - pattern: '^/wallet/'
 - pattern: '^/tutorials/'
+- pattern: 'https://web3onboard.thirdweb.com'
+- pattern: 'https://0xfury.com/privacy'
 aliveStatusCodes:
 - 200
 - 206

CONTRIBUTING.md

@@ -10,6 +10,7 @@ guide in some places.
 - [Contribution workflow](#contribution-workflow)
 - [Preview locally](#preview-locally)
 - [Style guide](#style-guide)
+- [Format links](#format-links)
 - [Add images](#add-images)
 - [Test analytics](#test-analytics)
 
@@ -68,10 +69,10 @@ To contribute changes:
 
    > **Notes:**
    >
-   > - All documentation content is located in the `wallet`, `sdk`, `snaps`, `services`, and
-   >   `developer-tools` directories.
-   > - If you add a new documentation page, edit `wallet-sidebar.js`, `sdk-sidebar.js`, `snaps-sidebar.js`,
-   >   `services-sidebar.js`, or `dashboard-sidebar.js` to add the page to the
+   > - All documentation content is located in the `sdk`, `wallet`, `embedded-wallets`, `smart-accounts-kit`, `services`,
+   >   `developer-tools`, `snaps`, and `src/pages` directories.
+   > - If you add a new documentation page, edit `sdk-sidebar.js`, `wallet-sidebar.js`, `ew-sidebar.js`, `gator-sidebar.js`,
+   >   `services-sidebar.js`, `dashboard-sidebar.js`, or `snaps-sidebar.js` to add the page to the
    >   [sidebar](https://docs-template.consensys.io/create/configure-docusaurus#sidebar).
    > - If you delete, rename, or move a documentation file, add a
    >   [redirect](https://vercel.com/docs/edge-network/redirects#configuration-redirects).
@@ -113,10 +114,38 @@ To contribute changes:
 
 Refer to the [Consensys documentation style guide](https://docs-template.consensys.net/contribute/style-guide).
 
+## Format links
+
+Most links in the Markdown pages use *relative file paths*, for example:
+
+```md
+You can enable users to create a [MetaMask smart account](../../concepts/smart-accounts.md) directly in your dapp.
+```
+
+However, when linking between different product sections or using the `CardList` component, use *absolute URL paths*. For example:
+
+```md
+When a dapp requests to submit a batch of transactions atomically, MetaMask may prompt users to upgrade their
+externally owned account (EOA) to a [MetaMask smart account](/smart-accounts-kit/concepts/smart-accounts).
+```
+
+```md
+<CardList
+  items={[
+    {
+      href: '/snaps/learn/about-snaps',
+      title: 'About Snaps',
+      description: 'See a high-level, technical overview of the Snaps system.',
+    },
+    ...
+  ]}
+/>
+```
+
 ## Add images
 
-All images are located in the `wallet/assets`, `sdk/_assets`, `snaps/assets`, `services/images`, and
-`developer-tools/images` directories.
+All images are located in the `sdk/_assets`, `wallet/assets`, `smart-accounts-kit/assets`, `services/images`,
+`developer-tools/images`, `snaps/assets`, and `static/img` directories.
 When adding a new image, such as a screenshot or diagram, make sure the image has a white or
 `#1b1b1d` color background in order for it to be compatible with the site's light and dark modes.
 

developer-tools/dashboard/index.md

@@ -24,17 +24,17 @@ Select one of the cards below to learn more about using the dashboard.
 <CardList
   items={[
     {
-      href: "./get-started/create-api",
+      href: "/developer-tools/dashboard/get-started/create-api",
       title: "Create an API key",
       description: "Learn how to create an API key that allows you to make API calls."
     },
     {
-      href: "./how-to/secure-an-api/api-key",
+      href: "/developer-tools/dashboard/how-to/secure-an-api/api-key",
       title: "Secure your API key",
       description: "Learn how to secure your API key to avoid unwanted costs and unauthorized access."
     },
     {
-      href: "./how-to/dashboard-stats",
+      href: "/developer-tools/dashboard/how-to/dashboard-stats",
       title: "Monitor API call stats",
       description: "Learn how to use the dashboard to view API call stats."
     }

docusaurus.config.js

@@ -99,6 +99,9 @@ const config = {
     SENTRY_KEY: process.env.SENTRY_KEY,
     LINEA_ENS_URL: process.env.LINEA_ENS_URL,
     SEGMENT_ANALYTICS_KEY: process.env.SEGMENT_ANALYTICS_KEY,
+    DISCOURSE_API_KEY: process.env.DISCOURSE_API_KEY,
+    DISCOURSE_API_USERNAME: process.env.DISCOURSE_API_USERNAME,
+    DISCOURSE_CATEGORY_ID: process.env.DISCOURSE_CATEGORY_ID,
   },
 
   trailingSlash: true,
@@ -286,6 +289,164 @@ const config = {
         containerId: 'GTM-5FGPLC2Q',
       },
     ],
+    [
+      'docusaurus-plugin-llms',
+      {
+        // Set docsDir to site root to collect from all directories
+        docsDir: '.',
+        // Disable default files since we're generating section-specific files
+        generateLLMsTxt: false,
+        generateLLMsFullTxt: false,
+        // Ignore common non-doc directories
+        // Note: src/pages/** is not ignored so tutorials can be collected
+        // Each customLLMFiles entry filters by includePatterns, so only matching files are included
+        ignoreFiles: [
+          'node_modules/**',
+          'build/**',
+          '.docusaurus/**',
+          'static/**',
+          'src/components/**',
+          'src/theme/**',
+          'src/lib/**',
+          'src/config/**',
+          'src/hooks/**',
+          'src/utils/**',
+          'src/plugins/**',
+          'src/specs/**',
+          'src/client/**',
+          'src/scss/**',
+          'i18n/**',
+          '*.config.js',
+          '*.json',
+          '*.lock',
+          'README.md',
+          'CONTRIBUTING.md',
+          'gator_versioned_docs/**',
+        ],
+        excludeImports: true,
+        removeDuplicateHeadings: true,
+        // Path transformation to fix URL construction
+        // Since docsDir is '.', we need to remove 'docs/' prefix and handle src/pages paths
+        pathTransformation: {
+          ignorePaths: ['docs', 'src/pages'],
+        },
+        // Generate separate files for each section
+        customLLMFiles: [
+          {
+            filename: 'llms-embedded-wallets.txt',
+            includePatterns: ['embedded-wallets/**/*.{md,mdx}'],
+            fullContent: false,
+            title: 'MetaMask Embedded Wallets documentation',
+            description: 'Documentation links for MetaMask Embedded Wallets',
+          },
+          {
+            filename: 'llms-embedded-wallets-full.txt',
+            includePatterns: ['embedded-wallets/**/*.{md,mdx}'],
+            fullContent: true,
+            title: 'MetaMask Embedded Wallets documentation',
+            description: 'Complete documentation for MetaMask Embedded Wallets',
+          },
+          {
+            filename: 'llms-sdk.txt',
+            includePatterns: ['sdk/**/*.{md,mdx}'],
+            fullContent: false,
+            title: 'MetaMask SDK documentation',
+            description: 'Documentation links for MetaMask SDK',
+          },
+          {
+            filename: 'llms-sdk-full.txt',
+            includePatterns: ['sdk/**/*.{md,mdx}'],
+            fullContent: true,
+            title: 'MetaMask SDK documentation',
+            description: 'Complete documentation for MetaMask SDK',
+          },
+          {
+            filename: 'llms-smart-accounts-kit.txt',
+            includePatterns: ['smart-accounts-kit/**/*.{md,mdx}'],
+            fullContent: false,
+            title: 'MetaMask Smart Accounts Kit documentation',
+            description: 'Documentation links for MetaMask Smart Accounts Kit',
+          },
+          {
+            filename: 'llms-smart-accounts-kit-full.txt',
+            includePatterns: ['smart-accounts-kit/**/*.{md,mdx}'],
+            fullContent: true,
+            title: 'MetaMask Smart Accounts Kit documentation',
+            description: 'Complete documentation for MetaMask Smart Accounts Kit',
+          },
+          {
+            filename: 'llms-snaps.txt',
+            includePatterns: ['snaps/**/*.{md,mdx}'],
+            fullContent: false,
+            title: 'Snaps documentation',
+            description: 'Documentation links for Snaps',
+          },
+          {
+            filename: 'llms-snaps-full.txt',
+            includePatterns: ['snaps/**/*.{md,mdx}'],
+            fullContent: true,
+            title: 'Snaps documentation',
+            description: 'Complete documentation for Snaps',
+          },
+          {
+            filename: 'llms-wallet.txt',
+            includePatterns: ['wallet/**/*.{md,mdx}'],
+            fullContent: false,
+            title: 'Wallet API documentation',
+            description: 'Documentation links for Wallet API',
+          },
+          {
+            filename: 'llms-wallet-full.txt',
+            includePatterns: ['wallet/**/*.{md,mdx}'],
+            fullContent: true,
+            title: 'Wallet API documentation',
+            description: 'Complete documentation for Wallet API',
+          },
+          {
+            filename: 'llms-tutorials.txt',
+            includePatterns: ['src/pages/tutorials/**/*.{md,mdx}'],
+            fullContent: false,
+            title: 'Tutorials',
+            description: 'Documentation links for MetaMask tutorials',
+          },
+          {
+            filename: 'llms-tutorials-full.txt',
+            includePatterns: ['src/pages/tutorials/**/*.{md,mdx}'],
+            fullContent: true,
+            title: 'Tutorials',
+            description: 'Complete documentation for MetaMask tutorials',
+          },
+          {
+            filename: 'llms-dashboard.txt',
+            includePatterns: ['developer-tools/dashboard/**/*.{md,mdx}'],
+            fullContent: false,
+            title: 'Developer dashboard documentation',
+            description: 'Documentation links for MetaMask Developer dashboard',
+          },
+          {
+            filename: 'llms-dashboard-full.txt',
+            includePatterns: ['developer-tools/dashboard/**/*.{md,mdx}'],
+            fullContent: true,
+            title: 'Developer dashboard documentation',
+            description: 'Complete documentation for MetaMask Developer dashboard',
+          },
+          {
+            filename: 'llms-services.txt',
+            includePatterns: ['services/**/*.{md,mdx}'],
+            fullContent: false,
+            title: 'Services documentation',
+            description: 'Documentation links for MetaMask services',
+          },
+          {
+            filename: 'llms-services-full.txt',
+            includePatterns: ['services/**/*.{md,mdx}'],
+            fullContent: true,
+            title: 'Services documentation',
+            description: 'Complete documentation for MetaMask services',
+          },
+        ],
+      },
+    ],
   ],
   clientModules: [require.resolve('./src/client/scroll-fix.js')],
   themeConfig: