Comment connecter le portefeuille Talisman à une dApp Polkadot

Comprendre l'intégration du portefeuille Talisman

1. Talisman Wallet est une extension de navigateur et une application mobile conçue spécifiquement pour l'écosystème Polkadot, prenant en charge les parachaines comme Astar, Moonbeam et Litentry.

2. Il implémente la norme d'interface d'extension Polkadot-JS, permettant une interaction transparente avec les dApp construites sur des chaînes basées sur un substrat.

3. Contrairement aux portefeuilles Ethereum qui reposent sur l'injection window.ethereum, Talisman injecte les objets window.talismanEthereum et window.injectedWeb3 pour exposer ses capacités de signature et de gestion de compte.

4. Le portefeuille prend en charge à la fois les transactions extrinsèques de substrat standard et les transactions compatibles EVM lorsqu'il est connecté à des parachains compatibles EVM.

5. Sa couche d'interface utilisateur restitue les confirmations de transaction directement dans le contexte du navigateur sans nécessiter de redirections externes ni de liens profonds.

Conditions préalables à la configuration de la connexion

1. Les utilisateurs doivent installer l'extension officielle du navigateur Talisman à partir de https://talisman.xyz/download — les versions tierces ne sont pas prises en charge et peuvent compromettre la sécurité des clés.

2. La dApp doit initialiser l'API Polkadot-JS à l'aide de @polkadot/api v12+ et inclure les définitions de type appropriées pour le temps d'exécution de la parachain cible.

3. Le code frontal doit détecter window.injectedWeb3 avant de tenter de se connecter, car son absence indique que le portefeuille n'est pas installé ou désactivé.

4. La configuration réseau doit correspondre à la chaîne prévue de la dApp — Talisman valide les points de terminaison RPC par rapport à des fournisseurs de confiance connus et rejette par défaut les URL personnalisées non vérifiées.

5. Pour les utilisateurs mobiles, l'application mobile Talisman doit être couplée via la numérisation du code QR ; cela établit une session cryptée à l’aide des poignées de main Noise Protocol Framework.

Flux de connexion étape par étape

1. La dApp appelle web3Enable('MyDapp') depuis @polkadot/extension-dapp pour demander l'autorisation d'accéder aux fournisseurs injectés.

2. Talisman répond avec une liste de comptes disponibles, chacun portant une adresse codée, des métadonnées GenesisHash et networkId.

3. La dApp sélectionne un compte et lance un appel signAndSendTransaction via les méthodes api.tx.*, déclenchant la superposition modale de Talisman.

4. L'utilisateur examine les détails extrinsèques, notamment l'estimation des frais, le poids et la structure des appels de palettes, avant d'approuver ou de rejeter.

5. Après approbation, Talisman signe la charge utile à l'aide des clés Schnorrkel (sr25519) ou Ed25519 et renvoie la transaction signée à la dApp pour soumission.

Gestion des erreurs de connexion

1. Si window.injectedWeb3 n'est pas défini, la dApp doit afficher une invite demandant aux utilisateurs d'installer ou d'activer l'extension.

2. Une erreur « Fournisseur introuvable » lors de web3Enable signifie généralement que Talisman s'exécute en mode privé ou a bloqué l'origine actuelle.

3. Le rejet de la signature entraîne un objet Erreur avec le code 1011, indiquant une annulation par l'utilisateur plutôt qu'un échec cryptographique.

4. Une incompatibilité GenesisHash invalide génère le code d'erreur 1002 - cela se produit lorsque la dApp se connecte à un réseau de test alors que Talisman est configuré pour le réseau principal ou vice versa.

5. Les erreurs de délai d'attente lors du couplage QR proviennent de jetons de session expirés ; les nouveaux codes QR doivent être régénérés toutes les 90 secondes.

Foire aux questions

Q : Talisman prend-il en charge l'intégration de portefeuilles matériels ? R : Oui, Talisman prend en charge nativement les appareils Ledger pour les réseaux Polkadot et Kusama. Les utilisateurs doivent installer l'application Polkadot sur Ledger et activer la signature aveugle dans les paramètres Talisman.

Q : Puis-je connecter Talisman à des dApps compatibles Ethereum ? R : Uniquement si ces dApps sont déployées sur des parachains Polkadot compatibles EVM telles que Moonbeam ou Moonriver. Talisman n'expose pas window.ethereum sur le réseau principal Ethereum.

Q : Pourquoi Talisman rejette-t-il mon point de terminaison RPC personnalisé ? R : Talisman maintient une liste organisée de fournisseurs RPC audités. Les points de terminaison personnalisés nécessitent une liste blanche manuelle via le mode développeur dans la fenêtre contextuelle de l'extension.

Q : Existe-t-il un moyen de détecter par programme si Talisman est verrouillé ou déverrouillé ? R : Non. Talisman cache intentionnellement l’état interne pour éviter les fuites par canal secondaire. Le seul signal observable est une réponse réussie à web3Accounts() ou un échec avec des codes d'erreur spécifiques.