Phantom Wallet を Solana DApp に接続する方法

ファントムウォレットの統合について

1. Phantom Wallet は、ユーザーが管理する秘密鍵と Solana ベースの分散アプリケーション間の直接通信を可能にする非保管インターフェースとして機能します。

2. その統合は、ウォレットの検出、アカウントの承認、トランザクションの送信のための標準化されたメソッドを提供するSolana Web3.js SDKに依存しています。

3. ウォレットはブラウザ環境でグローバルなwindow.solanaオブジェクトを公開し、DApp フロントエンドが外部依存関係なしにその存在を検出できるようにします。

4. 接続の開始により、公開鍵情報や署名機能を公開する前に明示的なユーザー承認を要求する安全なモーダルがトリガーされます。

5. 接続すると、DApp は読み取り専用の公開キー参照を受け取ります。秘密キーやシード フレーズがユーザーのデバイスから出ることはありません。

段階的な接続ワークフロー

1. DApp はまず、 window.solanaの存在を確認し、 isPhantomプロパティをサポートしていることを確認することによって、Phantom がインストールされているかどうかを確認する必要があります。

2. 開発者はsolana.connect()を呼び出し、Phantom 拡張機能にネットワーク コンテキストと要求されたスコープを含む許可ダイアログを表示するように指示します。

3. ユーザーが確認すると、Phantom はpublicKey 、 account 、およびchainId含むオブジェクトを返し、アドレス導出と残高クエリを有効にします。

4. 後続の対話ではsolana.signTransaction()またはsolana.signAllTransactions()を呼び出す必要があり、それぞれウォレット サンドボックス内のローカル暗号署名を呼び出します。

5. すべての署名されたトランザクションはシリアル化され、DApp の設定された RPC エンドポイント経由で送信されます。Phantom 自体はトランザクションを中継したりブロードキャストしたりしません。

接続時のセキュリティに関する考慮事項

1. Phantom は厳格な発信元検証を強制します。未登録または悪意のあるドメインからの接続は拡張レベルでブロックされます。

2. ウォレットはいかなるアクションも自動承認しません。すべての署名リクエストには、同じサイトで繰り返し操作を行う場合でも、手動によるユーザー操作が必要です。

3. セッションの永続性は現在のタブとドメインに限定されます。タブを閉じるか別の場所に移動すると、アクティブな接続が即座に終了します。

4. フィッシング耐性のあるアドレス表示により、ユーザーは確認モーダルで完全な 44 文字の SOL アドレスを確認できます (切り捨てられたり難読化されたバージョンではありません)。

5. トランザクション シミュレーション機能により、開発者は送信前に命令ロジックを事前検証できるため、操作の失敗やコストのかかるリスクが軽減されます。

統合によくある落とし穴

1. Phantom がすべてのブラウザで利用できると仮定します。Brave と Firefox では、インストール後でも拡張機能を手動で有効にする必要があります。

2. フォールバックなしで RPC エンドポイントをハードコーディングすると、ユーザーが選択したネットワーク (mainnet-beta、devnet、testnet) が DApp の構成と一致しない場合にエラーが発生します。

3. disconnectイベント リスナーを無視すると、セッションが終了しても「接続済み」インジケーターが表示されたままになる、古い UI 状態になります。

4. 接続が成功する前にsolana.publicKeyにアクセスしようとすると、null 参照エラーが発生し、フローの実行が中断されます。

5. 古い Web3.js バージョンを使用すると、バージョン管理されたトランザクション用の Phantom の更新されたメッセージ シリアル化形式との互換性が失われます。

よくある質問

Q: Phantom は同じ DApp セッション内で非 Solana チェーンに接続できますか?はい。 Phantom は Ethereum および Polygon ネットワークをサポートします。チェーンを切り替えると、自動アドレス再導出がトリガーされ、それに応じてchainIdフィールドが更新されます。

Q: Phantom は DApp 接続中のハードウェア ウォレットのペアリングをサポートしていますか?はい。 Ledger が接続され、Phantom がそれを使用するように設定されている場合、すべての署名操作は、ソフトウェア ベースのキー ストレージではなく Ledger デバイスを介してルーティングされます。

Q: ユーザーが接続リクエストを拒否した場合はどうなりますか? solana.connect()によって返される Promise はWalletConnectionErrorで拒否され、公開キーやセッション データは DApp に公開されません。

Q: Phantom がロックされているか、接続を開始する前にパスワード入力が必要かどうかを検出する方法はありますか?いいえ、Phantom はロック ステータスなどの内部状態を公開しません。接続フロー自体は、必要に応じてパスワードの入力を求められ、認証が成功した場合にのみ続行されます。