Phantom WalletをNFTマーケットプレイスに接続する方法

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

1. Phantom Wallet は、Magic Eden、Tensor、Solanart などの NFT マーケットプレイスを含む、Solana ベースの分散型アプリケーションへの非保管ゲートウェイとして動作します。

2. そのブラウザ拡張機能とモバイル アプリは、Solana ウォレット標準に準拠したウォレット接続 API を公開し、シームレスな dApp の相互運用性を可能にします。

3. EIP-1193 イベントに依存する Ethereum ウォレットとは異なり、Phantom は最新のフロントエンド フレームワークと互換性のあるsolana:connect イベントとsolana:disconnectイベントを発行します。

4. 接続の開始には明示的なユーザーの同意が必要です。Phantom のセキュリティ モデルでは自動認証またはサイレント認証は許可されません。

5. 接続すると、ウォレットは、NFT の鋳造または購入に必要な公開キー、最新のブロックハッシュ、およびトランザクション署名インターフェイスを公開します。

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

1. マーケットプレイスのフロントエンドは、まずブラウザーのコンテキストでwindow.solanaまたはwindow.phantomをチェックして、Phantom がインストールされているかどうかを検出する必要があります。

2. 検出された場合、サイトはphantom.connect()を呼び出し、ユーザーに接続の承認を求めるモーダルをトリガーします。

3. 承認されると、Phantom はウォレットの公開キーとSignTransactionメソッドを含む署名者オブジェクトを挿入します。

4. その後、マーケットプレイスは@solana/web3.jsを使用して Solana トランザクションを構築し、必要な命令 (トークン転送、メタデータ プログラムの呼び出しなど) を入力して、署名のために Phantom に渡します。

5. Phantom は命令のセマンティクスを検証し、料金の見積もりと宛先アカウントを表示し、明示的なユーザーの確認後にのみ署名します。

よくある接続障害

1. WalletNotConnectedError は、開発者が事前のconnect()呼び出しを行わずに署名しようとした場合、またはユーザーが切断した後に発生します。

2. BlockhashNotFoundErrorは、トランザクションが古いブロックハッシュで構築されている場合に発生します。マーケットプレイスは、送信する前に新しいブロックハッシュを取得する必要があります。

3.トランザクション構築の失敗は、不正なトークン生成アドレスやアカウント キーの不足など、命令パラメータがプログラムの期待と一致しない場合に発生します。

4. Phantom は、検証されていないプログラム ID を持つトランザクションを拒否します。マーケットプレイスは、Metaplex の Token Metadata Program や Bubblegum などのプログラムを事前にホワイトリストに登録する必要があります。

5. Mobile Phantom ユーザーは、 phantom://solana/connect経由で接続を開始した後に dApp が適切にリダイレクトできない場合、ディープ リンク タイムアウトが発生する可能性があります。

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

1. Phantom は秘密鍵をフロントエンド環境に公開しないため、マーケットプレイスは秘密鍵を (一時的であっても) 決して保存または記録してはなりません。

2. すべてのトランザクション ペイロードは、 signTransactionを呼び出す前に、クライアント側で受信者アドレスの正当性、金額の上限、およびプログラム ID の信頼性を検証する必要があります。

3. フィッシング耐性のあるドメイン バインディングが強制されます。Phantom は、ウォレット開発者のオンボーディング中に登録されたドメイン、または DNS TXT レコード経由で検証されたドメインからの接続のみを許可します。

4. 署名リクエストには人間が判読できるアクションの説明が含まれている必要があります。Phantom はこれらをそのままユーザーに表示して、ブラインド署名攻撃を防ぎます。

5. 再接続ロジックは自動再試行ループを回避する必要があります。接続試行が繰り返し失敗すると、Phantom の不正行為防止スロットル メカニズムがトリガーされます。

マルチチェーン互換性の制約

1. Phantom の Solana 統合はネイティブで完全に最適化されていますが、その Ethereum と Polygon のサポートは、レイテンシーとガス推定の差異を引き起こすクロスチェーン ブリッジの抽象化に依存しています。

2. 非 Solana チェーンで動作する NFT マーケットプレイスに接続すると、Phantom は MetaMask などの挿入されたプロバイダーに署名を委任し、統一された UI の一貫性が失われます。

3. Bitcoin 統合は読み取り専用のままです。Phantom は Bitcoin トランザクションの署名をサポートしていないため、Ordinals ベースの NFT プラットフォームでのユーティリティが制限されます。

4. Base 接続と Arbitrum 接続には、明示的なチェーン パラメーターの挿入が必要です。省略すると、ウォレットが検出されたにもかかわらず、サポートされていないチェーン エラーが発生します。

5.クロスチェーンNFTリスティングでは、チェーンごとに個別のウォレット接続フローが必要となり、フロントエンドの複雑さとユーザーの摩擦が増大します。

よくある質問

Q: Phantom は OpenSea のようなイーサリアムベースの NFT マーケットプレイスに接続できますか? A: はい。ただし、埋め込まれた MetaMask 互換プロバイダー層を介した場合のみです。 Solana スタイルの API への直接アクセスは、イーサリアム チェーンでは利用できません。

Q: Phantom がモバイル ブラウザで「接続がタイムアウトしました」と表示されることがあるのはなぜですか? A: Mobile Safari と Chrome はディープ リンク動作を制限します。 Phantom はユニバーサル リンクに依存しており、OS がリダイレクトをブロックする場合、またはアプリがインストールされていない場合は、通知なく失敗します。

Q: ユーザーの介入なしで Phantom を接続することは可能ですか? A: いいえ。Phantom はすべての接続セッションに対して明示的なオプトインを強制します。永続セッションでは、ブラウザを再起動するかタブを閉じた後に手動で再承認する必要があります。

Q: マーケットプレイスが無効なプログラム ID を使用してトランザクションに署名しようとするとどうなりますか? A: Phantom は、 InvalidProgramIdErrorでリクエストを即座に拒否し、認識できないコントラクト アドレスを示す警告を表示します。