web3auth

MetaMask Embedded Wallets（Web3Auth）

コードを書く前に、ライブドキュメントとサンプルを取得するため、MCP ツールを使用してください。パッケージ名、API シグネチャ、設定を推測しないでください。

ダッシュボード：https://developer.metamask.io
ドキュメント：https://docs.metamask.io/embedded-wallets/
コミュニティ：https://builder.metamask.io/c/embedded-wallets/5

MCP ツール（順番に使用）

サンプルと SDK のソースは、GitHub からライブで検出されます。references/examples.md にあるのはフィルターレシピのみです。コード生成の前に、必ず get_example を呼び出してください。MCP のライブエンドポイント：https://mcp.web3auth.io

1. search_docs — ドキュメント（Algolia）とサンプルプロジェクトを検索します。
   • query（必須）
   • platform?：react | vue | js | react-native | android | ios | flutter | unity | unreal | node
   • chain?：evm | solana | other
   • category?：quick-start | custom-auth | blockchain | feature | playground
2. get_doc — URL（docs.metamask.io）でドキュメントページ全体を取得します。コード生成の前に、プラットフォームの SDK ドキュメントを読んでください。
3. get_example — GitHub から完全なサンプルソースを取得します（統合の主要な参照元）。
   • name?、platform?、chain?、category?、auth_method?（例：firebase、auth0、grouped）
   • 新しい統合では、必ずクイックスタートを取得してください。カスタム認証では、認証方式に応じたサンプルを取得してください。
   • フィルターレシピと eval アンカー名を確認してくださいreferences/examples.md
4. search_community — Builder Hub を検索します。query? またはスレッド全体を取得するための topic_id? を指定します。
5. get_sdk_reference — 型／シグネチャのデバッグ専用の SDK ソースです（機能の調査には使用しません）。
   • platform（必須）、module?（最初は省略してモジュール一覧を表示）、focus?：types | hooks | main-class | errors | all（デフォルトは types）

MCP を利用できない場合： https://docs.metamask.io/llms-embedded-wallets-full.txt（全ドキュメント）、https://docs.metamask.io/llms-embedded-wallets.txt（インデックス）。

前提条件 — ダッシュボードのセットアップ手順

1. developer.metamask.io でプロジェクトを作成 → Client ID。
2. Sapphire Devnet（ローカル）または Mainnet（本番環境）。
3. ドメイン（Web）またはバンドル ID とディープリンクスキーム（モバイル）を許可リストに追加します。
4. ダッシュボード（Web／Node）またはコード（RN、Android、iOS、Flutter、Unity、Unreal）でチェーンを設定します。
5. 認証：デフォルトのソーシャルログインまたはカスタム接続。
6. オプション：セッション期間、テストアカウント、鍵のエクスポート、ホワイトラベル。

https://docs.metamask.io/embedded-wallets/dashboard/ を読んでください。

鍵導出のルール（重要）

同じウォレットアドレスを使用するには、次のすべてが一致している必要があります。

• 同じ Client ID
• 同じ Sapphire ネットワーク（devnet または mainnet。混在させないでください）
• 同じ接続設定（同じ認証接続 ID）
• 統合間で同じ useSFAKey のブール値

いずれかを変更すると、アドレスは永久に異なるものになります。

• 本番環境では、Client ID または Sapphire ネットワークを絶対に変更しないでください。
• Sapphire はブロックチェーンの devnet／mainnet ではありません。Devnet では localhost が使用できますが、Mainnet では使用できません。
• ローカル開発とステージング：Sapphire Devnet。本番環境：Sapphire Mainnet のみ。Devnet を本番環境で使用しないでください。
• ユーザーがすでに使用している場合、またはウォレットの事前生成を希望している場合を除き、useSFAKey／useCoreKitKey のようなフラグをむやみに追加しないでください。ウォレットの事前生成は、useSFAKey／useCoreKitKey が true の場合にのみ機能します。

SDK の選択

選択肢	使用する場面
React（@web3auth/modal/react）	React、Next.js — フック
Vue（@web3auth/modal/vue）	Vue、Nuxt — コンポーザブル
JavaScript（@web3auth/modal）	Angular、Svelte、Vanilla JS
React Native（@web3auth/react-native-sdk）	Expo または Bare RN — フック
Android / iOS / Flutter	ネイティブモバイル SDK — 鍵のエクスポートとプラットフォームライブラリ（組み込みプロバイダーなし）
Unity / Unreal	ゲーム SDK — 鍵のエクスポートとプラットフォームライブラリ（組み込みプロバイダーなし）
Node.js（@web3auth/node-sdk）	バックエンド、AI エージェント — カスタム JWT のみ、ステートレス

プラットフォーム別の詳細と注意点：references/platforms.md

シナリオ

タスク別のワークフローを取得／トリップワイヤー／検証：references/scenarios.md

例のカタログ【最重要】

例はGitHubで公開されています。統合コードを作成する前に、get_example または search_docs を呼び出してください。MCP のフィルターレシピと評価アンカー名：references/examples.md

認証

接続、暗黙的フローと JWT フロー、グループ化された接続、JWT の iat ルール：references/authentication.md

移行

既存の統合のアップグレード — バージョン表、ワークフロー、従来の PnP／CoreKit／SFA：references/migration.md

概要： 各プラットフォームについて、最新のメジャーバージョンへのガイドを1つ用意しています（Web v11、RN v9、Android v9、iOS v10、Flutter v6）。各ガイドの AI 支援プロンプトを使用してください。意図的な変更でない限り、Client ID や Sapphire ネットワークを変更しないでください。

• 移行ガイドの一覧：https://docs.metamask.io/embedded-wallets/migration-guides/