Wie kann ich beheben, dass MetaMask auf einer dApp „Kette nicht unterstützt“ anzeigt?

Fehler bei nicht unterstützter Kette verstehen

1. Der Fehler tritt auf, wenn eine dApp versucht, mit einem Blockchain-Netzwerk zu interagieren, das derzeit nicht in der aktiven Netzwerkliste von MetaMask konfiguriert ist.

2. Dies tritt häufig bei frühen Tests neuer Layer-2-Rollups oder benutzerdefinierter Testnetze auf, bei denen die Ketten-ID, RPC-URL oder Block-Explorer-URL nicht manuell hinzugefügt wurde.

3. MetaMask validiert jede Kette anhand ihrer internen Registrierung; Nicht erkannte Ketten lösen eine sofortige Ablehnung ohne Fallback-Logik aus.

4. Einige dApps betten fest codierte Kettenparameter ein, die mit vom Benutzer ausgewählten Netzwerken in Konflikt stehen, was zu stillen Nichtübereinstimmungen führt, selbst wenn die richtige Kette ausgewählt zu sein scheint.

5. Beim Browser-Caching bleiben möglicherweise veraltete Kettenmetadaten erhalten, was zu veralteten Validierungsprüfungen anhand aktueller dApp-Anforderungen führt.

Überprüfen der Netzwerkkonfiguration

1. Öffnen Sie die MetaMask-Einstellungen und navigieren Sie zu Netzwerke → Netzwerk hinzufügen → Benutzerdefinierter RPC.

2. Bestätigen Sie, dass die Ketten-ID genau mit den Angaben in der dApp-Dokumentation übereinstimmt – Groß-/Kleinschreibung beachten und nur Zahlen (z. B. 8453 für Base Mainnet, nicht „base“).

3. Fügen Sie den offiziellen RPC-Endpunkt direkt aus dem Entwicklerportal der dApp ein – nicht aus Aggregatoren von Drittanbietern oder von der Community verwalteten Listen.

4. Stellen Sie sicher, dass das Feld „Währungssymbol“ den genauen Ticker verwendet, der durch den Token-Standard der Kette definiert ist (z. B. „ETH“ bei Ethereum, „MATIC“ bei Polygon, nicht „matic“ oder „Matic“).

5. Überprüfen Sie das Block-Explorer-URL-Format: Es muss sich in eine Live-Explorer-Seite auflösen, auf der die letzten Blöcke angezeigt werden, wenn es in einem neuen Tab geöffnet wird.

Umgang mit dApp-seitigen Nichtübereinstimmungen

1. Überprüfen Sie die Frontend-JavaScript-Konsole der dApp auf Warnungen „nicht unterstützte Ketten-ID“ – diese zeigen die genaue Ketten-ID an, die die App erwartet.

2. Verwenden Sie die Entwicklertools des Browsers, um den Initialisierungscode des Web3-Anbieters zu finden und zu überprüfen, ob er ethereum.request({ method: 'wallet_addEthereumChain' }) mit den richtigen Parametern aufruft.

3. Wenn die dApp die automatische Umschaltung initiiert, deaktivieren Sie vorübergehend die Einstellung „Auto-Lock“ von MetaMask, um eine Sitzungsunterbrechung während der Kettenaushandlung zu verhindern.

4. Löschen Sie Site-Cookies und den lokalen Speicher für die dApp-Domäne, bevor Sie die Verbindung wiederherstellen. Der zwischengespeicherte Anbieterstatus behält möglicherweise den vorherigen Kettenkontext bei.

5. Vermeiden Sie die Verwendung der mobilen App von MetaMask zum Debuggen; Die Desktop-Erweiterung bietet eine vollständige RPC-Inspektion über Einstellungen → Erweitert → RPC-Aufrufe anzeigen.

Debuggen mit Entwicklertools

1. Starten Sie Chrome DevTools und gehen Sie zur Registerkarte „Netzwerk“. Filtern Sie dann nach „rpc“- oder „json-rpc“-Anfragen, um fehlgeschlagene Payload-Antworten zu beobachten.

2. Führen Sie auf der Registerkarte „Konsole“ ethereum.chainId aus, um die aktuell erkannte Ketten-ID abzurufen und sie mit dem erwarteten Wert zu vergleichen.

3. Führen Sie „await ethereum.request({ method: 'eth_chainId' })“ manuell aus, um zu bestätigen, ob MetaMask dieselbe ID zurückgibt, die in seiner Benutzeroberfläche angezeigt wird.

4. Überprüfen Sie die IndexedDB-Einträge unter Anwendung → Speicher → IndexedDB auf beschädigte Kettenmetadaten in der „Metamask“-Datenbank.

5. Überwachen Sie die Ausgabe des Ereignis-Listeners „Provider Error“, um zwischen Netzwerk-Timeout, ungültiger Antwortstruktur oder nicht unterstützten Methodenfehlern zu unterscheiden.

Häufig gestellte Fragen

F: Warum zeigt meine dApp „Kette nicht unterstützt“ an, auch nachdem das richtige Netzwerk hinzugefügt wurde? A: Die dApp erzwingt möglicherweise eine zusätzliche Validierung über die Ketten-ID hinaus – z. B. die Anforderung spezifischer EIP-1559-Unterstützungsflags oder die Durchsetzung strenger Blockzeitstempelfenster, die nicht mit dem Synchronisierungsstatus Ihres Knotens übereinstimmen.

F: Kann ich mehrere Ketten gleichzeitig hinzufügen, ohne manuell umzuschalten? A: Ja. MetaMask speichert alle benutzerdefinierten Netzwerke dauerhaft; Benutzer können über das Netzwerk-Dropdown-Menü sofort zwischen ihnen wechseln, ohne dass eine Neukonfiguration erforderlich ist.

F: Beeinflusst die Deaktivierung des Datenschutzmodus die Kettenerkennung? A: Ja. Wenn der Datenschutzmodus aktiviert ist, beschränkt MetaMask den dApp-Zugriff auf Ketteninformationen bis zur ausdrücklichen Zustimmung des Benutzers – was zu anfänglichen Erkennungsfehlern führt, bis die Erlaubnis erteilt wird.

F: Was passiert, wenn zwei dApps unterschiedliche Versionen derselben Ketten-ID anfordern? A: MetaMask behandelt sie als identisch, es sei denn, ihre RPC-Endpunkte unterscheiden sich. Widersprüchliche Block-Explorer oder Währungssymbole können zu Inkonsistenzen in der Benutzeroberfläche führen, unterbrechen jedoch nicht die Konnektivität.