Wie verbinde ich Coinbase Wallet mit einer DApp?

Wallet-Integrationsarchitektur

1. Coinbase Wallet fungiert als injizierter Anbieter, der mit den Standards EIP-1193 und EIP-1474 kompatibel ist. Es stellt ein globales Ethereum- Objekt im Browserkontext bereit, wenn es als Browsererweiterung installiert oder über mobiles Deep Linking gestartet wird.

2. Das Wallet unterstützt sowohl das Ethereum-Mainnet als auch mehrere EVM-kompatible Ketten, darunter Base, Optimism, Arbitrum und Polygon. Die Kettenkonfiguration muss mit den Zielnetzwerkparametern der DApp übereinstimmen.

3. Die Verbindungsinitiierung erfordert die ausdrückliche Zustimmung des Benutzers über eine modale Schnittstelle. Gemäß den aktuellen Sicherheitsrichtlinien, die vom clientseitigen SDK von Coinbase Wallet durchgesetzt werden, ist keine automatische oder stille Authentifizierung zulässig.

4. Die Sitzungspersistenz basiert auf lokalem Speicher, der auf den Domänenursprung beschränkt ist. Jede dApp behält ihren eigenen isolierten Sitzungsstatus bei und verhindert so einen standortübergreifenden Wallet-Statusverlust.

5. Trennungsereignisse führen zum sofortigen Widerruf aller zuvor erteilten Berechtigungen, einschließlich der Kontofreigabe und der Transaktionssignaturfunktionen.

Schritte zur Frontend-Implementierung

1. Importieren Sie das offizielle Coinbase Wallet SDK über npm: npm install @coinbase/wallet-sdk . Dieses Paket enthält typisierte Schnittstellen, Dienstprogramme zur Fehlerbehandlung und kettenfähige Anbieter-Wrapper.

2. Instanziieren Sie den Wallet-Connector mithilfe von CoinbaseWalletSDK mit Pflichtfeldern: appName, appLogoUrl und jsonRpcUrl entsprechend dem Ziel-Blockchain-RPC-Endpunkt.

3. Initialisieren Sie die Anbieterinstanz und rufen Sie activate() auf, um den Verbindungsfluss zu starten. Dadurch wird ein natives Modal geöffnet, in dem der Benutzer aufgefordert wird, den Zugriff zu genehmigen oder zu verweigern.

4. Bei Erfolg gibt das zurückgegebene Anbieterobjekt die Ereignisse „accountsChanged“ und „chainChanged“ aus und ermöglicht so reaktive UI-Updates für die verbundene Adresse und den Netzwerkstatus.

5. Alle nachfolgenden Vertragsaufrufe oder Transaktionseinreichungen müssen über diese Anbieterinstanz weitergeleitet werden, um sicherzustellen, dass das Signaturrouting mit der aktiven Sitzung konsistent bleibt.

Mechanismen zur Sicherheitsdurchsetzung

1. Jede Transaktionsanforderung wird vor der Signaturerstellung auf dem Gerät validiert. Das Wallet zeigt vollständige Details zur Nutzlast an, einschließlich Empfänger, Wert, Gasparameter und Funktionsaufrufdaten.

2. Intelligente Vertragsinteraktionen erfordern eine explizite Überprüfung des Funktionsnamens und des Parametertyps. Die ABI-Dekodierung wird lokal in der Sandbox-Laufzeitumgebung des Wallets durchgeführt.

3. Abgelehnte Transaktionen werden im internen Audit-Trail des Wallets mit Zeitstempeln und Vorgangs-Hashes protokolliert und sind nur für den Benutzer über die Registerkarte „Verlauf“ des Wallets zugänglich.

4. Die Phishing-Erkennung erfolgt in Echtzeit für bekannte bösartige Domänen. Jeder Verbindungsversuch von einem auf der schwarzen Liste stehenden Ursprungsort löst sofort ein Warnbanner aus und blockiert weitere Interaktionen.

5. Privates Schlüsselmaterial verlässt niemals die sichere Enklave des Geräts. Signierungsvorgänge erfolgen ausschließlich innerhalb des isolierten kryptografischen Moduls der Wallet.

Allgemeine Berechtigungsbereiche

1. eth_accounts : Gewährt schreibgeschützten Zugriff auf die aktuell ausgewählte Ethereum-Adresse. Erforderlich für die grundlegende Wallet-Erkennung und Kontostandanzeige.

2. eth_signTypedData_v4 : Ermöglicht strukturierte Nachrichtensignierung gemäß EIP-712. Wird für Anmeldeflüsse und Off-Chain-Bescheinigungen verwendet.

3. eth_sendTransaction : Autorisiert die Übertragung signierter Ethereum-Transaktionen. Wird nur nach manueller Benutzerbestätigung ausgelöst.

4. personal_sign : Unterstützt herkömmliche Klartextsignierung. Veraltet zugunsten typisierter Daten, aber aus Gründen der Abwärtskompatibilität beibehalten.

5. eth_sign : Ermöglicht Roh-Hash-Signierung. Beschränkt auf dApps auf der Whitelist mit verifizierten Domain-Reputationswerten.

Häufig gestellte Fragen

F: Warum lehnt Coinbase Wallet während der Entwicklung Verbindungsversuche von localhost ab? A: Standardmäßig erzwingt das Wallet aus Sicherheitsgründen ausschließlich HTTPS-Ursprünge. Entwickler müssen ihre lokale dApp über HTTPS mit Tools wie mkcert bereitstellen oder den Entwicklermodus-Schalter des Wallets verwenden, der in den Einstellungen verfügbar ist.

F: Kann ich nach der Verbindung programmgesteuert zwischen Netzwerken wechseln? A: Ja, über die RPC-Methode wallet_switchEthereumChain . Das Wallet zeigt einen Bestätigungsbildschirm mit der Zielketten-ID, der Block-Explorer-URL und dem Symbol der nativen Währung an, bevor die Änderung übernommen wird.

F: Was passiert, wenn der Benutzer sein ausgewähltes Konto im Wallet ändert, während er verbunden ist? A: Das Wallet gibt ein AccountsChanged- Ereignis aus, das das neue Adressarray enthält. DApps müssen auf dieses Ereignis warten und UI-Elemente entsprechend aktualisieren, ohne dass eine erneute Verbindung erforderlich ist.

F: Ist es möglich zu erkennen, ob Coinbase Wallet installiert ist, ohne eine Verbindungsaufforderung auszulösen? A: Ja, indem Sie prüfen, ob window.ethereum?.isCoinbaseWallet vorhanden ist, bevor Sie Aktivierungsmethoden aufrufen. Diese Eigenschaft gibt nur dann „true“ zurück, wenn die offizielle Wallet-Erweiterung oder mobile App erkannt wird.