Talisman ウォレットを Polkadot dApp に接続する方法

Talisman ウォレットの統合について

1. Talisman Wallet は、Polkadot エコシステム用に特別に設計されたブラウザ拡張機能およびモバイル アプリケーションであり、Astar、Moonbeam、Litentry などのパラチェーンをサポートします。

2. Polkadot-JS 拡張インターフェイス標準を実装し、Substrate ベースのチェーン上に構築された dApps とのシームレスな対話を可能にします。

3. window.ethereum インジェクションに依存する Ethereum ウォレットとは異なり、Talisman は window.talismanEthereum オブジェクトと window.injectedWeb3 オブジェクトをインジェクトして、署名機能とアカウント管理機能を公開します。

4. ウォレットは、EVM 対応のパラチェーンに接続されている場合、標準のサブストレート外部機能と EVM 互換のトランザクションの両方をサポートします。

5. その UI レイヤーは、外部リダイレクトやディープリンクを必要とせずに、ブラウザーのコンテキストでトランザクション確認を直接レンダリングします。

接続セットアップの前提条件

1. ユーザーは、 https://talisman.xyz/downloadから公式の Talisman ブラウザ拡張機能をインストールする必要があります。サードパーティのビルドはサポートされておらず、主要なセキュリティが侵害される可能性があります。

2. dApp は、@polkadot/api v12+ を使用して Polkadot-JS API を初期化し、ターゲット パラチェーンのランタイムに適切な型定義を含める必要があります。

3. フロントエンド コードは、接続を試行する前に window.injectedWeb3 を検出する必要があります。これは、ウォレットがインストールされていないか無効になっていることを示しているためです。

4. ネットワーク設定は、dApp の意図したチェーンと一致する必要があります。Talisman は、既知の信頼できるプロバイダーに対して RPC エンドポイントを検証し、未検証のカスタム URL をデフォルトで拒否します。

5. モバイル ユーザーの場合、Talisman モバイル アプリは QR コード スキャンでペアリングする必要があります。これにより、ノイズ プロトコル フレームワークのハンドシェイクを使用して暗号化されたセッションが確立されます。

段階的な接続フロー

1. dApp は @polkadot/extension-dapp から web3Enable('MyDapp') を呼び出し、挿入されたプロバイダーへのアクセス許可を要求します。

2. Talisman は、使用可能なアカウントのリストで応答します。各アカウントには、エンコードされたアドレス、genesisHash、および networkId メタデータが含まれています。

3. dApp はアカウントを選択し、api.tx.* メソッドを通じて SignAndSendTransaction 呼び出しを開始し、Talisman のモーダル オーバーレイをトリガーします。

4. ユーザーは、承認または拒否する前に、料金の見積もり、重量、パレットコール構造などの付随的な詳細を確認します。

5. 承認されると、Talisman は Schnorrkel (sr25519) または Ed25519 キーを使用してペイロードに署名し、署名されたトランザクションを送信のために dApp に返します。

接続エラーの処理

1. window.injectedWeb3 が定義されていない場合、dApp はユーザーに拡張機能をインストールまたは有効にするように指示するプロンプトを表示します。

2. web3Enable 中の「プロバイダーが見つかりません」エラーは、通常、Talisman がプライベート モードで実行されているか、現在のオリジンがブロックされていることを意味します。

3. 署名が拒否されると、コード 1011 のエラー オブジェクトが生成され、暗号化の失敗ではなくユーザーのキャンセルを示します。

4. 無効なgenesisHashの不一致によりエラー コード 1002 がスローされます。これは、Talisman がメインネット用に構成されているときに dApp がテストネットに接続する場合、またはその逆の場合に発生します。

5. QR ペアリング中のタイムアウト エラーは、セッション トークンの期限切れが原因で発生します。新しい QR コードは 90 秒ごとに再生成する必要があります。

よくある質問

Q: Talisman はハードウェア ウォレットの統合をサポートしていますか? A: はい、Talisman は、Polkadot および Kusama ネットワーク用の Ledger デバイスをネイティブにサポートしています。ユーザーは Ledger に Polkadot アプリをインストールし、Talisman 設定でブラインド署名を有効にする必要があります。

Q: Talisman をイーサリアム互換の dApps に接続できますか? A: これらの dApp が Moonbeam や Moonriver などの EVM 対応の Polkadot パラチェーンにデプロイされている場合のみ。 Talisman はイーサリアムメインネット上で window.ethereum を公開しません。

Q: Talisman がカスタム RPC エンドポイントを拒否するのはなぜですか? A: Talisman は、監査済みの RPC プロバイダーの厳選されたリストを管理しています。カスタム エンドポイントでは、拡張機能ポップアップの開発者モードの切り替えを介して手動でホワイトリストに登録する必要があります。

Q: Talisman がロックされているかアンロックされているかをプログラム的に検出する方法はありますか? A: いいえ。Talisman はサイドチャネル リークを防ぐために内部状態を意図的に隠します。唯一の観察可能な信号は、web3Accounts() に対する成功応答、または特定のエラー コードによる失敗です。