Skip to content

Update title and sidebar for services introduction#2961

Open
j01413174-a11y wants to merge 711 commits into
MetaMask:1616-add-Linea-methods-sandboxfrom
j01413174-a11y:patch-1
Open

Update title and sidebar for services introduction#2961
j01413174-a11y wants to merge 711 commits into
MetaMask:1616-add-Linea-methods-sandboxfrom
j01413174-a11y:patch-1

Conversation

@j01413174-a11y

@j01413174-a11y j01413174-a11y commented Jun 21, 2026

Copy link
Copy Markdown

Description

Issue(s) fixed

Fixes #

Preview

Checklist

  • If this PR updates or adds documentation content that changes or adds technical meaning, it has received an approval from an engineer or DevRel from the relevant team.
  • If this PR updates or adds documentation content, it has received an approval from a technical writer.

External contributor checklist

  • I've read the contribution guidelines.
  • I've created a new issue (or assigned myself to an existing issue) describing what this PR addresses.

Note

High Risk
A corrupted front-matter opener can prevent the Services intro page from rendering correctly in the docs site.

Overview
The PR title suggests updating the Services introduction page title and sidebar label, but the only change in the diff is to the first line of services/index.md: the opening YAML delimiter is no longer --- and is prefixed with a stray string (Hvfb2aL6NfzOE2rWJJTV/...).

That would break valid Docusaurus front matter parsing for this page. There are no edits in the diff to title, sidebar_label, or body content—so the intended title/sidebar update is not present in what’s shown.

Reviewed by Cursor Bugbot for commit 4cd6c68. Bugbot is set up for automated code reviews on this repo. Configure here.

alexandratran and others added 30 commits November 6, 2025 16:09
* Add trivial contribution guidlines

* update toc

* revert trivial guideline, add PR checklist item

* add external contributor checklist
* update supported network

* update supported networks for ERC-7715

* update names
* Fix mobile UX issues

* change import

* update comments
* Update link workflow and fix links

* fix links
* add new supported networks

* fix typo
* Smart Accounts Kit update URLs and final rebranding

* fix quickstart link

* minor edits
* Add Scaffold-ETH page

* minor edits

* update scaffold eth section

* fix the broken links

* minor edits

---------

Co-authored-by: AyushBherwani1998 <ayush.bherwani@consensys.net>
Co-authored-by: Ayush Bherwani <ayush.bherwani1998@gmail.com>
Signed-off-by: m4sterbunny <harrie.bickle-ext@consensys.net>
* lock files for smart accounts kit

* update version 0.1.0 docs

* fix asset issue

* add changelog

* remove 0.11.0 version

* fix minor issues

* fix passkey tutorial
* Fix private key export call

* Add Solana Pay tutorial

* Add SNS Tutorial

* Fix build issuescausing the CI to fail.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* edit tutorials

* Update src/pages/tutorials/integrate-solana-pay.mdx

Co-authored-by: Byron Gravenorst <50852695+bgravenorst@users.noreply.github.com>

---------

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
Co-authored-by: bgravenorst <byron.gravenorst@consensys.net>
Co-authored-by: Alexandra Carrillo <alexandra.carrillo@consensys.net>
Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>
Co-authored-by: Byron Gravenorst <50852695+bgravenorst@users.noreply.github.com>
Update solana.md to include Web3Auth under third-party library

Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>
* Update all CardList links to absolute and add guidance

* edit contribution guide

* fix linkspector errors
…sk#2491)

* update docs for advanced permissions

* fix broken anchor

* Apply suggestion from @m4sterbunny

Co-authored-by: m4sterbunny <m4sterbunny@gmail.com>

* edits

* minor fixes

---------

Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>
Co-authored-by: m4sterbunny <m4sterbunny@gmail.com>
Co-authored-by: Alexandra Carrillo <alexandra.carrillo@consensys.net>
* Edit Vue SDK content.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Addressed feedback.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

---------

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
* Add monad.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Update index.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Update logo.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Update index page.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Add Monad mainnet support.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Add Monad support.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Update to mainnet.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Fix link issue.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Fix link issue.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Update services/reference/monad/json-rpc-methods/eth_getblockreceipts.mdx

* Update services/reference/monad/json-rpc-methods/eth_getblockreceipts.mdx

Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>

---------

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
Co-authored-by: m4sterbunny <m4sterbunny@gmail.com>
Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>
* Fix bundler admonition.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Used incorrect link.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

---------

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
Co-authored-by: Byron Gravenorst <50852695+bgravenorst@users.noreply.github.com>
* Edit Flutter EW builder.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

* Apply suggestions from code review

Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>

* Convert to lowercase.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

---------

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>
* Generate llms.txt and llms-full.txt files per section

* remove script and add global page

* update dependencies

* add path transformation config

* edit llms.txt and clean up comments
* Add integration for discourse comments

* Update index.jsx

* Added shorter content snippet

* Update index.tsx

---------

Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
Co-authored-by: Byron Gravenorst <50852695+bgravenorst@users.noreply.github.com>
* lock files for v0.1

* update delegation API reference
Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
* adds encode and decode delegation methods reference

* expose llm context

* minor fixes

* update link

* Apply suggestions from code review

Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>

---------

Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>
* exclude mdx files from llms-services-full.txt

* exclude mdx from llms-services.txt

* fix
Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
* Add note for CAIP-25 multichain API

* update caip-25 links
* starts updates for trace methods

Signed-off-by: m4sterbunny <harrie.bickle-ext@consensys.net>

* createMethod confirmed with test, table hierachy improved to reflect response object

Signed-off-by: m4sterbunny <harrie.bickle-ext@consensys.net>

* Update services/reference/ethereum/json-rpc-methods/trace-methods/index.md

Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>

* Update services/reference/ethereum/json-rpc-methods/trace-methods/index.md

Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>

* responds to review

* confused by feedback: attempting to respond

* responds to review

Signed-off-by: m4sterbunny <harrie.bickle-ext@consensys.net>

---------

Signed-off-by: m4sterbunny <harrie.bickle-ext@consensys.net>
Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com>
AyushBherwani1998 and others added 17 commits June 1, 2026 15:34
* update docs for v1.6 release

* fix typo
* release docs for v1.6

* improve changelog

* remove v0.3.0 version
…iscoverability directives (MetaMask#2929)

* llms: regenerate markdown, inject directives

Add turndown + gfm dependencies and enhance llms-html-injector to derive per-page .md files from rendered HTML (cheerio + turndown), prepend llms.txt directive to .md files, inject <link rel="alternate" type="text/markdown"> into HTML heads and an sr-only body directive, prune stale links from llms-*.txt, and generate llms-all-*.txt indexes from sitemap.xml. Also mark various DocItem UI chrome with data-markdown-ignore so HTML→MD parity ignores UI-only elements, and update static/llms.txt to reference the new complete indexes. package.json and package-lock.json updated to include the new dependencies.

* Replace turndown with node-html-markdown

Swap turndown/turndown-plugin-gfm for node-html-markdown and update llms HTML->MD pipeline. package.json/package-lock: add node-html-markdown and remove turndown deps. src/plugins/llms-html-injector: replace TurndownService with NodeHtmlMarkdown, add custom translators/options to preserve <details>/<summary> and narrow escaping for parity, change injected markdown alt link to use path-only hrefs, and add Vercel preview detection + host-rewrite logic to rewrite production URLs to the preview origin for llms*.txt and per-page .md files. src/theme/DocItem/Layout/index.jsx: change data-markdown-ignore wrapper from <span> to <div> around CopyPageButton so it is stripped correctly during MD generation.

* Prefer VERCEL_BRANCH_URL for previews

Add cheerio dependency and update preview URL handling for Vercel deployments.

resolvePreviewSiteUrl now prefers VERCEL_BRANCH_URL and falls back to VERCEL_URL, with expanded JSDoc explaining Vercel env vars and rationale. postProcessLlmsOutput logs which env var was used and rewrites build artifacts to point at the preview host so AFDocs checks (llms txt/markdown link checks) work correctly on branch/preview/development deployments.

* Regenerate MD, mark KaTeX, add Vercel header

Regenerate per-page .md files from their rendered HTML and mark KaTeX MathML spans to improve HTML/Markdown parity. Renamed and expanded the HTML->MD flow (regenerateMdFromHtml): walk build/**/index.html, convert article content to markdown, create missing .md siblings, and report regenerated/created/skipped counts. Add a regex and injection step to mark <span class="katex-mathml"> with data-markdown-ignore (idempotent) and log how many spans were marked. Improve katex handling in htmlToMarkdown by extracting the visual .katex-html text into a <code> node to avoid duplicated math content and by flattening Docusaurus chrome inside <details> so NHM output matches the rendered HTML. Tweak node-html-markdown options/translators (details/summary handling and line-start escaping) and update injector return values and logging. Also add a Vercel route header to serve llms*.txt as text/markdown with utf-8 charset.

* Route root to /llms.txt and add headers

Rewrite requests for the site root to /llms.txt in middleware because the homepage has no .md sibling (the root index.html is skipped by the llms-html-injector), ensuring the documentation index is served as text/markdown. Add a Content-Signal line to static/robots.txt to advertise search/AI allowances (search=yes, ai-input=yes, ai-train=yes). Add a Link header for "/" in vercel.json pointing to </llms.txt> as rel="service-doc" and rel="alternate"; type="text/markdown" so clients can discover the markdown service doc.

* Use internal MetaMask provider link in EVM docs

Replace external MetaMask Provider URL with the internal /metamask-connect/evm/reference/provider-api/ link across many embedded-wallets EVM React Native docs. Also include minor updates to SDK docs, plugins, example maps, static images/logos and vercel.json to keep assets and tooling in sync.

* Make /quickstart route canonical, remove splat

Register the plugin-provided /quickstart route as the single canonical page and prevent the pages plugin from auto-generating a duplicate module-less route. Exclude quickstart/index.jsx in docusaurus.config.js and remove the `${routePath}/*` splat route in the virtual-files plugin; navigation uses query strings so no catch-all child route is needed and the splat produced malformed `/quickstart/*/` sitemap entries.

* Update Algolia indexName to project name

Change the Algolia indexName in docusaurus.config.js from 'mmdocs' to 'MetaMask Documentation' to reflect the project's full name in search configuration. Verify that the corresponding Algolia index exists and that the provided appId/apiKey remain valid after this change.

* Normalize sitemap before reading URLs

Move normalizeSitemap earlier in postProcessLlmsOutput so the sitemap is normalized (dropping <loc> entries shadowed by vercel.json redirects and stripping trailing slashes from dotted-segment routes) before readSitemapUrls, pruneStaleLlmsLinks, and generateAllPagesIndex run. This ensures generated llms-all-*.txt indexes and pruning operate on the same 200-only URL set the deployed sitemap exposes and avoids pointing agents at redirecting pages. Add console logging for skipped or processed sitemap normalization.
Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
* mm-connect: remove version mentions for web3auth

* Update the EW Web SDK to v11

* update connection api docs

* Update migration guides

* Fixes

* Add RBAC, 7702, connect and sign details

* Fix issues

---------

Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
* add react native v9 docs

* update react native migration

* Add consent screen for web v11

* Update everything for metamask style guide

* fixes

* vale fixes

* run vale locally

* remove emdashes

* Update migration guide

* update migration guide with more scenarios

---------

Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
* Update v11 code examples

* useIdentityToken -> useAuthTokenInfo

* Update examples for v11

* Update switch-chain.mdx

* Update web.mdx

* fix vale

* Update _aa-address.mdx

* Fix style guide related issues

---------

Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
* Add initial docs

* Update agent wallet doc structure

* fix vale and style guide issues

* Update Products.html

* Language changes

* vale fixes

* nits

* Update product headings

* nits

* revert product name changes

---------

Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
* nits

* Update vercel.json

---------

Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
* Update build-with-ai.mdx

* Update build-with-ai.mdx

---------

Co-authored-by: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com>
…Mask#2959)

* docs: update MetaMask Connect v2 guides & API

Update docs for MetaMask Connect v2: document that @metamask/connect-evm and @metamask/connect-solana now require explicit @metamask/connect-multichain peer installation; update installation quickstarts and notes. Clarify client behaviors (async createEVMClient/createMultichainClient, singleton merging semantics and that the initial dapp object is never overwritten), add guidance on session restoration (wallet_sessionChanged) and forceRequest option for connect. Revise provider and JSON-RPC notes: provider auto-announcement (EIP-6963) with skipAutoAnnounce, new error codes (-32002, 4902, 1013), eth_coinbase returns a single address, and wallet_requestPermissions result shape. Misc: move/rename options (analytics.enabled, skipAutoAnnounce, ui.showInstallModal, debug), Solana changes (solana_signMessage + .signature result, testnet/devnet availability in extension only), polyfill notes for Event when using wagmi, and other small clarity/formatting fixes across reference and quickstart files.

* Docs: update multichain peer-dep and Solana APIs

Remove guidance to explicitly install @metamask/connect-multichain for single-ecosystem packages and simplify install commands across EVM and Solana quickstarts. Rename Solana methods and Wallet Standard features (solana_signMessage → signMessage, solana_signAndSendTransaction/signAndSendAllTransactions → signAndSendTransaction) and update batch guidance to use the variadic signAndSendTransaction call. Revise error handling docs to use the new multichain error classes (RPCInvokeMethodErr, RPCHttpErr, RPCReadonlyResponseErr, RPCReadonlyRequestErr) and expose wallet RPC codes on err.rpcCode; remove the internal transport 1013 note from provider docs. Misc: update Wagmi quickstart to require @metamask/connect-evm@^2.1.0 and adjust examples/usages across multichain, evm, solana, reference, and troubleshooting pages to match the new APIs and patterns.

* Standardize Wagmi capitalization in docs

Add a terminology rule for Wagmi and update docs for consistent capitalization. Changes touch the terminology rules and multiple MetaMask Connect docs (quickstarts, guides, troubleshooting, supported-platforms, and references) to use “Wagmi” consistently and include small copy/formatting fixes (polyfill guidance and minor punctuation/lineflow adjustments).

* Clarify Solana network support notes

Update Solana quickstart docs to clarify network support: state that Devnet and Testnet are supported only in the MetaMask browser extension and that on mobile (including QR flows) only Solana mainnet is supported. Remove the explicit reference and link to MetaMask Flask. Changes applied to nodejs.md and react-native.md.

* Vale fixes
@j01413174-a11y j01413174-a11y requested review from a team as code owners June 21, 2026 23:25
@vercel

vercel Bot commented Jun 21, 2026

Copy link
Copy Markdown

@j01413174-a11y is attempting to deploy a commit to the Consensys Team on Vercel.

A member of the Team first needs to authorize it.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Reviewed by Cursor Bugbot for commit 4cd6c68. Configure here.

Comment thread services/index.md
@@ -1,4 +1,4 @@
---
Hvfb2aL6NfzOE2rWJJTV/oHITB2MKqIkDeekGqBivkfGBzmxBO4PJg---

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Corrupted frontmatter opening delimiter

High Severity

Line 1 of services/index.md prepends a random token to the YAML frontmatter opener instead of a lone ---. Docusaurus expects frontmatter to begin with --- on its own line, so metadata like title and sidebar_label may not apply and the token can appear in the built page or break the build.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 4cd6c68. Configure here.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4cd6c6839e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread services/index.md
@j01413174-a11y j01413174-a11y changed the base branch from main to 1616-add-Linea-methods-sandbox June 22, 2026 07:04
@j01413174-a11y j01413174-a11y requested review from a team as code owners June 22, 2026 07:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.