Phantom を dApp にリンクするにはどうすればよいですか? (ウォレットコネクト)

Phantom Wallet を dApp に接続する

1. Phantom がブラウザ拡張機能またはモバイル アプリとしてターゲット デバイスにインストールされていることを確認します。サポートされているブラウザには、Chrome、Brave、Firefox、Edge が含まれます。モバイル ユーザーは、iOS または Android Phantom アプリケーションをアクティブにし、バージョン 3.79 に更新する必要があります。

2. 互換性のあるブラウザを使用して dApp のインターフェイスに移動します。サイトは HTTPS 経由で提供され、ブラウザのセキュリティ プロトコルによって悪意のあるものとしてフラグが立てられていない必要があります。

3. ウォレット接続ボタンを見つけます。通常は「ウォレット接続」または「接続」というラベルが付いているか、ページの右上隅近くにあるウォレット アイコンで表されます。

4. ボタンをクリックし、表示された使用可能なウォレットのリストから「Phantom」を選択します。 Phantom が表示されない場合は、ページを更新するか、ブラウザの設定で拡張機能が有効になっていることを確認してください。

5. Phantom ポップアップ ウィンドウが表示され、パブリック アドレスとネットワーク コンテキストへのアクセス許可を要求します。承認する前に、要求された権限を注意深く確認してください。

権限の範囲とセッションの動作

1. Phantom は、最初の接続時にウォレットの公開キーと現在のチェーン コンテキスト (Solana メインネット、イーサリアム セポリアなど) への読み取り専用アクセスを許可します。

2. 接続中に秘密キー、シード フレーズ、またはトランザクション署名機能が公開されることはありません。署名は、トランザクション フロー内のユーザー アクションによって明示的にトリガーされた場合にのみ発生します。

3. 「接続されたサイト」で Phantom の内部ウォレット設定を介して手動で切断または取り消さない限り、セッションはページのリロード後も持続します。

4. 各 dApp は一意のセッション ID を受け取ります。 Phantom はドメイン間でセッション データを共有しないため、厳密な発信元の分離が強制されます。

5. 1 つの dApp から切断しても、他の dApp やネットワークと確立された接続には影響しません。

ネットワークの不一致の処理

1. 現在の Phantom 構成でサポートされていないネットワークで dApp が動作している場合 (たとえば、dApp が Polygon zkEVM を使用しているが、Phantom が Solana に設定されている場合)、手動でネットワークを切り替えるよう求めるアラートが表示されます。

2. Phantom は、ネイティブにサポートされているすべてのチェーン (Solana、Ethereum、Polygon、Base、Sui、およびラップされたアセット経由の Bitcoin) をリストするドロップダウン メニューを表示します。

3. 新しいネットワークを選択すると、ウォレットの再インポートや再認証を必要とせずに、RPC エンドポイントの自動再構成がトリガーされます。

4. 新しく選択したチェーンに固有の資産がすでに保有されている場合、残高パネルに即座に表示されます。それ以外の場合、入金が発生するまでインターフェイスには残高ゼロが表示されます。

5. 一致しないネットワーク上でトランザクションに署名しようとすると、署名が生成される前に、Phantom の内部バリデータ層によって即座に拒否されます。

一般的な接続障害のトラブルシューティング

1. ブラウザのツールバーにファントム アイコンが表示されない場合は、拡張機能が無効になっているか、広告/トラッカー ブロッカーによってブロックされているか、現在のブラウザ バージョンと互換性がないことを示しています。

2. 空白またはフリーズした接続モーダルは、古い Phantom バージョンに起因することがよくあります。 phantom.app/changelogの公式変更ログで現在のリリースが v3.79 であることを確認してください。

3. dApp ドメインが DNSSEC 検証に失敗した場合、または MetaMask または Phantom の組み込み脅威インテリジェンス フィードによってフィッシングとしてフラグが立てられた場合、「接続が拒否されました」エラーが発生することがあります。

4. 承認後に繰り返される「無効な署名」メッセージは、通常、デバイスと NTP サーバーの間のクロック スキューが ±30 秒を超えていることを示しています。システム時刻を修正すると、この問題は即座に解決されます。

5. iOS WebKit はモバイル ビューで特定のウォレット インジェクション API を制限するため、モバイル Safari ユーザーは Phantom Web3 との完全な互換性を得るために「デスクトップ サイト」モードを手動で有効にする必要があります。

よくある質問

Q: ウォレットアドレスを公開せずに Phantom を dApp に接続できますか? A: いいえ。dApp とのやり取りにはパブリック アドレスの開示が必須です。 Phantom は秘密キーやシード フレーズを共有しませんが、ID を確立して署名を検証するには公開キーが表示される必要があります。

Q: dApp に接続すると資金が流出することになりますか? A: いいえ。接続だけでは支出権限はゼロです。資金は、Phantom の安全な UI を通じて、署名された各トランザクションをユーザーが明示的に確認した後にのみ移動できます。

Q: dApp が Solana 互換性を主張しているにもかかわらず、Phantom が時々「サポートされていないチェーン」と表示されるのはなぜですか? A: Phantom がメインネットにロックされているときに、dApp を Solana devnet または testnet 用に構成することも、その逆の場合も同様です。 dApp のフロントエンド設定と Phantom のネットワーク セレクターの両方でチェーン ID の一貫性を確認します。

Q: 開発中に Phantom を使用して、localhost でホストされている dApp に接続できますか? A: はい、ローカルサーバーが有効な証明書を使用して HTTPS 上で実行されているか、Phantom の開発者設定で有効になっているローカルホスト例外処理を使用している場合に限ります。