Kernpunkte
- Wagmi verbindet Benutzeroberflächen über Integrationen und einen eigenständigen Kern mit Wallets und EVM-Contracts.
- Für Netzwerkoperationen und die Typisierung von Contracts stützt es sich auf Viem.
- Die Anwendung bleibt dafür verantwortlich, Signaturen, Fehler und Bestätigungen klar darzustellen.
Was ist Wagmi?
Wagmi bündelt Werkzeuge, um Anwendungen mit Wallets und EVM-Smart-Contracts zu verbinden. Seine React-Integration bietet Hooks und State-Management; das Ökosystem verfügt außerdem über einen eigenständigen Kern und eine Vue-Integration. Es sollte daher nicht als Lösung beschrieben werden, die ausschließlich für React verfügbar ist.
Es stützt sich für Blockchain-Operationen auf Viem und nutzt Query-Werkzeuge zur Verwaltung asynchroner Daten. Der Wert für eine Anwendung liegt darin, Verbindung, Lesevorgänge und die Verfolgung von Operationen zu koordinieren, ohne jeden State-Mechanismus von Grund auf bauen zu müssen.
So funktioniert es
Die Konfiguration deklariert Netzwerke, Transports und Wallet-Connectors. Die Komponenten fragen Daten ab oder fordern Aktionen auf Basis dieser Konfiguration an. Die Verfügbarkeit eines Connectors garantiert nicht, dass alle Wallets dieselben Funktionen unterstützen: Signaturen, Smart Accounts und Gas-Sponsoring müssen mit den ausgewählten Produkten geprüft werden.
Die Typen können aus der im Projekt enthaltenen ABI abgeleitet werden. Ändert sich diese ABI, hilft der Compiler, inkompatible Verwendungen zu erkennen, erkennt aber nicht von selbst eine Aktualisierung des Smart Contracts im Netzwerk. Die Deployment-Konfiguration muss Adresse, Netzwerk, Implementierung und ABI synchron halten.
Was Wagmi leistet
In einem Abstimmungs-Dashboard kann Wagmi das Lesen von Vorschlägen, die Kontoverbindung und das Absenden der Stimme koordinieren. Die Anwendung hält getrennte Zustände für ausstehende Signatur, gesendete Transaktion, Receipt und Fehler vor. Nach der Bestätigung invalidiert sie die betroffenen Abfragen, damit die Anzeige den neuen Stand widerspiegelt.
Konto- und Netzwerkwechsel erfordern dieselbe Sorgfalt. Ein Guthaben des vorherigen Kontos darf keine Aktion des neuen weiter freischalten. Die Tests umfassen Wiederverbindung, Abbruch der Signatur und Ersetzen von Transaktionen sowie das initiale Laden mit und ohne verfügbare Wallet.
Grenzen und Auswahlkriterien
Wagmi definiert nicht alle Regeln der Nutzererfahrung und gewährleistet nicht die Sicherheit des Smart Contracts. Die Anwendung entscheidet, wann sie abfragt, welche Daten sie als ausreichend aktuell betrachtet und wie sie Berechtigungen und Fehler erklärt. Eine Abfrage zu wiederholen ist nicht dasselbe wie eine Schreiboperation mit geschäftlichen Auswirkungen zu wiederholen.
In Umgebungen mit serverseitigem Rendering wird geprüft, wie der Verbindungsstatus wiederhergestellt wird und wie sich Abweichungen beim Hydrieren vermeiden lassen. Die Größe des Frontends wird anhand der tatsächlich eingebundenen Konnektoren und Komponenten gemessen. Für Skripte oder Dienste ohne Benutzeroberfläche kann der direkte Einsatz von Viem die Integration vereinfachen.
Auch bekannt als
- wagmi.sh
- Wagmi v2





