So verbinden Sie Talisman Wallet mit einer Polkadot dApp

Grundlegendes zur Talisman Wallet-Integration

1. Talisman Wallet ist eine Browser-Erweiterung und mobile Anwendung, die speziell für das Polkadot-Ökosystem entwickelt wurde und Parachains wie Astar, Moonbeam und Litentry unterstützt.

2. Es implementiert den Polkadot-JS-Erweiterungsschnittstellenstandard und ermöglicht so eine nahtlose Interaktion mit dApps, die auf Substrate-basierten Ketten basieren.

3. Im Gegensatz zu Ethereum-Wallets, die auf der window.ethereum-Injection basieren, injiziert Talisman window.talismanEthereum- und window.injectedWeb3-Objekte, um seine Signatur- und Kontoverwaltungsfunktionen verfügbar zu machen.

4. Das Wallet unterstützt sowohl Standard-Substrat-Extrinsics als auch EVM-kompatible Transaktionen, wenn es mit EVM-fähigen Parachains verbunden ist.

5. Seine UI-Ebene rendert Transaktionsbestätigungen direkt im Browserkontext, ohne dass externe Weiterleitungen oder Deep-Links erforderlich sind.

Voraussetzungen für den Verbindungsaufbau

1. Benutzer müssen die offizielle Talisman-Browsererweiterung von https://talisman.xyz/download installieren – Builds von Drittanbietern werden nicht unterstützt und können die Schlüsselsicherheit gefährden.

2. Die dApp muss die Polkadot-JS-API mit @polkadot/api v12+ initialisieren und geeignete Typdefinitionen für die Laufzeit der Zielparachain enthalten.

3. Der Frontend-Code muss window.injectedWeb3 erkennen, bevor eine Verbindung hergestellt werden kann, da das Fehlen darauf hinweist, dass die Wallet nicht installiert oder deaktiviert ist.

4. Die Netzwerkkonfiguration muss mit der beabsichtigten Kette der dApp übereinstimmen – Talisman validiert RPC-Endpunkte anhand bekannter vertrauenswürdiger Anbieter und lehnt standardmäßig nicht überprüfte benutzerdefinierte URLs ab.

5. Für mobile Benutzer muss die mobile Talisman-App über das Scannen des QR-Codes gekoppelt werden. Dadurch wird eine verschlüsselte Sitzung mithilfe von Noise Protocol Framework-Handshakes aufgebaut.

Schritt-für-Schritt-Verbindungsablauf

1. Die dApp ruft web3Enable('MyDapp') von @polkadot/extension-dapp auf, um die Erlaubnis zum Zugriff auf injizierte Anbieter anzufordern.

2. Talisman antwortet mit einer Liste der verfügbaren Konten, von denen jedes verschlüsselte Adressen-, GenesisHash- und NetworkId-Metadaten enthält.

3. Die dApp wählt ein Konto aus und initiiert einen signAndSendTransaction-Aufruf über api.tx.*-Methoden, wodurch das modale Overlay von Talisman ausgelöst wird.

4. Der Benutzer überprüft extrinsische Details, einschließlich Gebührenschätzung, Gewicht und Palettenabrufstruktur, bevor er sie genehmigt oder ablehnt.

5. Nach der Genehmigung signiert Talisman die Nutzlast mit den Schlüsseln Schnorrkel (sr25519) oder Ed25519 und sendet die signierte Transaktion zur Übermittlung an die dApp zurück.

Umgang mit Verbindungsfehlern

1. Wenn window.injectedWeb3 nicht definiert ist, sollte die dApp eine Eingabeaufforderung anzeigen, die Benutzer anweist, die Erweiterung zu installieren oder zu aktivieren.

2. Ein „Anbieter nicht gefunden“-Fehler während web3Enable bedeutet normalerweise, dass Talisman im privaten Modus läuft oder den aktuellen Ursprung blockiert hat.

3. Die Ablehnung der Signatur führt zu einem Fehlerobjekt mit dem Code 1011, was eher auf einen Benutzerabbruch als auf einen kryptografischen Fehler hinweist.

4. Eine ungültige genesisHash-Nichtübereinstimmung löst den Fehlercode 1002 aus – dies tritt auf, wenn die dApp eine Verbindung zu einem Testnetz herstellt, während Talisman für das Mainnet konfiguriert ist oder umgekehrt.

5. Timeout-Fehler beim QR-Pairing sind auf abgelaufene Sitzungstoken zurückzuführen; Neue QR-Codes müssen alle 90 Sekunden neu generiert werden.

Häufig gestellte Fragen

F: Unterstützt Talisman die Integration von Hardware-Wallets? A: Ja, Talisman unterstützt nativ Ledger-Geräte für Polkadot- und Kusama-Netzwerke. Benutzer müssen die Polkadot-App auf Ledger installieren und Blind Signing in den Talisman-Einstellungen aktivieren.

F: Kann ich Talisman mit Ethereum-kompatiblen dApps verbinden? A: Nur wenn diese dApps auf EVM-fähigen Polkadot-Parachains wie Moonbeam oder Moonriver bereitgestellt werden. Talisman macht window.ethereum nicht im Ethereum-Mainnet verfügbar.

F: Warum lehnt Talisman meinen benutzerdefinierten RPC-Endpunkt ab? A: Talisman führt eine kuratierte Liste geprüfter RPC-Anbieter. Benutzerdefinierte Endpunkte erfordern eine manuelle Whitelisting über den Entwicklermodus-Schalter im Erweiterungs-Popup.

F: Gibt es eine Möglichkeit, programmgesteuert zu erkennen, ob Talisman gesperrt oder entsperrt ist? A: Nein. Talisman verbirgt absichtlich den internen Zustand, um Seitenkanallecks zu verhindern. Das einzige erkennbare Signal ist eine erfolgreiche Reaktion auf web3Accounts() oder ein Fehler mit bestimmten Fehlercodes.