SDK: New Docs

[chakra-guy]

Description

This PR restructures the MetaMask documentation to clearly separate the Wallet API from the SDK. Historically, both lived under a single “Wallet” section because they addressed similar needs (interacting with the MetaMask wallet). However, the SDK’s future scope now extends well beyond wallet connectivity—it’s evolving into a broader toolkit for building on-chain applications, connecting to multiple wallets, and integrating other Web3 services (e.g., on-ramps, swaps, smart accounts, and embedded wallets).

By splitting the Wallet API and the SDK into distinct sections, we create a more intuitive navigation and mental model for developers. Going forward, the Wallet API remains focused solely on the MetaMask Wallet itself, while the SDK becomes a fully versioned, standalone developer toolkit encompassing multiple modules.

Key changes:

• Top-level Restructure: Introduces separate top-level sections for the Wallet API and the SDK instead of a single “Wallet” section.
• Homepage Update: The documentation homepage now routes developers directly to the product area they need (e.g., Snaps, Wallet API, SDK), making it easier to identify the relevant path from the start.
• Wallet API Section: Retains and refines existing Wallet API content, removing or redirecting any SDK-related references.
• SDK Section: Establishes a new SDK structure, pulled from and expanded beyond the original Wallet docs. This includes organizing content around the broader on-chain application development toolkit vision.
• Versioning Ready: Splitting the two makes it straightforward to introduce versioning to the SDK without confusing Wallet API users or mixing product lifecycles.
• Vercel Redirects: Vercel redirect links have been updated to account for the split.

Issue(s) fixed

Fixes # (Add issue number if applicable)

Preview

(Include a preview link to the updated docs if available)

Checklist

• If this PR contains a major change to documentation content, add an entry to the top of the "What's new?" page.
• Changes reviewed and approved by a member of the documentation team.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
metamask-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jan 27, 2025 9:19pm

[vercel]

Deployment failed with the following error:

You don't have permission to create a Preview Deployment for this project.

View Documentation: https://vercel.com/docs/accounts/team-members-and-roles

[alexandratran]

I did a significant copy-edit of all the new content, and some existing content that is affected by the restructure. Made some file name and sidebar fixes, and fixed up the redirects and links. LGTM to merge for now, with additional improvements to come in future PRs.

I do have a question about these current pages that are not found in the new docs. Are they omitted on purpose?

• Make read-only requests
• Display custom modals
• SDK and Wagmi tutorial