Was ist der interne JSON-RPC-Fehler in MetaMask?

Der Internal JSON-RPC error zeigt an, dass MetaMask eine Anfrage an einen Blockchain-Node gesendet und statt einer verwertbaren Antwort einen Fehler erhalten hat. Intern entspricht er dem Fehlercode -32603 in der JSON-RPC-Referenz von MetaMask, einem Sammelcode, den das Protokoll für fehlerhafte oder ungültige Payloads reserviert.

Da MetaMask für alles auf JSON-RPC angewiesen ist, kann die Meldung Guthabenabfragen, Token-Swaps, Contract-Aufrufe und sogar den Netzwerkwechsel unterbrechen. Am häufigsten tritt sie auf Ethereum, Layer-2-Netzwerken wie Base und Arbitrum sowie im Sepolia-Testnet auf, wo einzelne Endpunkte ohne Vorwarnung ausfallen.

Seit MetaMask zu einer Multichain-Wallet für Ethereum, Solana, Bitcoin und TRON geworden ist, tritt der Fehler auch bei Nicht-EVM-Anfragen auf, die die älteren, nur für Ethereum gedachten Versionen nie gestellt haben. Die folgenden Lösungen decken sowohl die klassischen Ursachen als auch die neueren ab, die durch diese Neugestaltung entstanden sind.

So beheben Sie den internen JSON-RPC-Fehler

Die meisten Fälle gehen auf eine einzelne fehlerhafte Einstellung zurück und nicht auf ein tieferliegendes Wallet-Problem. Wenn Sie die folgenden Prüfungen der Reihe nach durchgehen, lässt sich der Fehler daher schnell beheben.

Gehen Sie diese sieben Lösungen der Reihe nach durch, bis der Fehler verschwindet:

1. Netzwerkeinstellungen: Öffnen Sie das Netzwerkmenü, bearbeiten Sie die fehlerhafte Chain und prüfen Sie RPC-URL und Chain-ID anhand der offiziellen Dokumentation, oder fügen Sie sie automatisch über ChainList erneut hinzu.
2. Gas-Guthaben: Halten Sie vor einem erneuten Versuch genügend vom nativen Token des Netzwerks, etwa ETH, BNB oder POL, und prüfen Sie zuerst die aktuellen Gebühren mit unserem Ethereum-Gas-Tracker.
3. Wallet-Update: Installieren Sie die neueste Erweiterung oder mobile Version, da die Multichain-Kontoarchitektur von MetaMask mit Extension 13.5 und Mobile 7.57 eingeführt wurde und ältere Versionen neuere Antworten falsch interpretieren.
4. RPC-Endpunkt: Tauschen Sie einen langsamen oder ausgefallenen Endpunkt gegen eine Alternative von ChainList oder einem spezialisierten Anbieter wie Infura oder Alchemy aus und wiederholen Sie dann die fehlgeschlagene Transaktion.
5. Hardware-Wallets: Aktualisieren Sie die Firmware von Ledger oder Trezor, aktivieren Sie Smart-Contract-Daten in der Ethereum-App des Geräts und verbinden Sie es erneut über die Verbindungsmethode, die Ledgers Leitfaden zur Fehlerbehebung derzeit empfiehlt.
6. Konto zurücksetzen: Verwenden Sie in den erweiterten Einstellungen die Option „Daten des Aktivitäts-Tabs löschen“, um zwischengespeicherte Transaktionshistorie und hängende Nonces zu löschen. Dadurch muss MetaMask sich sauber neu mit dem Node synchronisieren.
7. Testnet-Prüfung: Vergewissern Sie sich, dass das anvisierte Testnet noch existiert, denn Holesky wurde nach dem Fusaka-Upgrade abgeschaltet und seine alten Endpunkte lehnen inzwischen jede Anfrage ab.

Wenn jeder Schritt scheitert, bietet das MetaMask Help Center tiefergehende Diagnosen, darunter Zustandsprotokolle, die das Support-Team direkt prüfen kann. Anhaltende Fehler bei einer einzelnen dApp deuten meist darauf hin, dass das Problem bei den Kontraktaufrufen dieser Anwendung liegt und nicht bei Ihrer Wallet. Testen Sie daher eine andere Website, bevor Sie eskalieren.

So fügen Sie einen RPC korrekt mit ChainList hinzu

Manuell eingegebene RPC-Angaben bleiben der häufigste Auslöser dieses Fehlers, da ein falsches Zeichen in einer URL oder Chain-ID jede danach von der Wallet gesendete Anfrage scheitern lässt. ChainList beseitigt dieses Risiko, indem es verifizierte Endpunkte für Hunderte von Netzwerken pflegt und sie mit einem Klick in MetaMask überträgt.

Wir verwenden denselben Ablauf in unserer Anleitung zum Hinzufügen von HyperEVM zu MetaMask, daher gelten die folgenden Schritte für nahezu jede EVM-Chain, von großen Layer-2-Netzwerken bis zu brandneuen Mainnets. Vier Schritte führen Sie von einer leeren Netzwerkliste zu einer verifizierten Verbindung.

1. MetaMask mit ChainList verbinden

ChainList liest Netzwerkparameter aus einem von der Community gepflegten Register. Wenn Sie Ihr Wallet verbinden, kann es diese geprüften Angaben daher direkt in MetaMask eintragen, ohne dass Sie etwas manuell kopieren müssen.

So verknüpfen Sie Ihre Wallet mit der Website:

1. ChainList öffnen: Rufen Sie chainlist.org auf und prüfen Sie die Schreibweise in der Adressleiste sorgfältig, bevor Sie eine Verbindung herstellen, denn es sind geklonte Versionen der Website im Umlauf, in die bösartige RPC-Endpunkte vorab eingetragen wurden.
2. Wallet verbinden: Klicken Sie oben rechts auf die Schaltfläche „Connect Wallet“, wählen Sie MetaMask aus den Optionen und bestätigen Sie die Verbindungsanfrage, die im Pop-up der Erweiterung erscheint.
3. Berechtigungen prüfen: Die Website benötigt nur Lesezugriff, um Netzwerkdetails zu übermitteln. Lehnen Sie daher jede Aufforderung ab, die Signaturen, Token-Freigaben oder Ausgabeberechtigungen jeglicher Art verlangt.

2. Suchen Sie nach dem richtigen Netzwerk

Die meisten Chains haben mehrere Versionen, und wer ein Mainnet mit seinem Testnet verwechselt, erhält innerhalb von Minuten fehlgeschlagene Transaktionen, unsichtbare Guthaben und neue JSON-RPC-Fehler.

Mit diesen Prüfungen landen Sie beim richtigen Eintrag:

1. Genau suchen: Geben Sie den exakten Netzwerknamen ein, sei es Base, Linea oder eine neuere Chain wie Monad, und aktivieren Sie den Testnet-Schalter nur, wenn Sie ein Testnet benötigen.
2. Kennungen prüfen: Gleichen Sie die angezeigte Chain-ID mit der offiziellen Dokumentation des Projekts ab, da Betrugsnetzwerke manchmal bekannte Namen wiederverwenden, aber auf völlig andere Chains verweisen.
3. Beachten Sie Testnets: Verwenden Sie für Ethereum-Tests Sepolia für dApps und Hoodi für Validator-Arbeit, denn die Ethereum Foundation hat Holesky eingestellt und dessen Angebote funktionieren nicht mehr.

3. RPC zu MetaMask hinzufügen

Sobald das richtige Netzwerk erscheint, übergibt ChainList die vollständige Konfiguration in einer einzigen Abfrage an MetaMask. Das beseitigt die Tippfehler, die bei der manuellen Eingabe leicht entstehen.

Schließen Sie die Übergabe mit diesen drei schnellen Schritten ab:

1. Netzwerk hinzufügen: Klicken Sie bei dem Eintrag mit der besten Latenzbewertung auf „Add to MetaMask“, da ChainList jeden öffentlichen Endpunkt nach live gemessener Geschwindigkeit und Zuverlässigkeit einstuft.
2. Pop-up prüfen: Lesen Sie das MetaMask-Fenster mit RPC-URL, Chain-ID, Währungssymbol und Block-Explorer und vergleichen Sie jeden Wert, bevor Sie Ihre endgültige Zustimmung erteilen.
3. Wechseln: Bestätigen Sie die Hinzufügung und wählen Sie auf Aufforderung „Switch Network“. Dadurch wird die neue Chain sofort aktiv und ist bereit für eine kleine Testtransaktion.

4. Einstellungen anschließend überprüfen

Auch geprüfte Einträge veralten mit der Zeit, wenn Anbieter Endpunkte abschalten. Eine kurze Kontrolle in MetaMask bestätigt daher, dass alles korrekt übernommen wurde und heute noch antwortet.

Führen Sie diese letzte Prüfung durch, bevor Sie echte Gelder übertragen:

1. Einstellungen öffnen: Gehen Sie zur Netzwerkauswahl, wählen Sie die neu hinzugefügte Chain und klicken Sie auf „Edit“, um alle gespeicherten Parameter anzuzeigen, die MetaMask für seine Anfragen verwendet.
2. Gegenprüfung: Vergleichen Sie RPC-URL, Chain-ID und Währungssymbol mit der eigenen Dokumentation des Netzwerks und nicht mit einem Drittanbieter-Blog, einem Screenshot oder einer inoffiziellen Discord-Nachricht.
3. Endpunkte wechseln: Wenn Anfragen langsam sind oder zeitweise fehlschlagen, ersetzen Sie die URL durch eine andere ChainList-Option, da MetaMask inzwischen mehrere gespeicherte RPC-URLs pro Netzwerk unterstützt.

Warum tritt der JSON-RPC-Fehler auf?

JSON-RPC-Fehler lassen sich auf eines zurückführen: Der Node hat entweder nie eine gültige Anfrage erhalten oder konnte keine gültige Antwort zurückgeben. Die Entwicklerdokumentation von MetaMask listet 17 verschiedene JSON-RPC-Fehlercodes auf, und die internen Varianten stehen in dieser Tabelle neben Ratenlimits, Parse-Fehlern und abgelehnten Transaktionen.

Wenn Sie verstehen, welche Art von Ausfall vorliegt, sparen Sie Zeit, denn jede Variante verweist auf eine andere Lösung – vom Wechsel der Endpunkte bis zum bloßen Abwarten einer Überlastung.

Dies sind die häufigsten Gründe, warum JSON-RPC-Anfragen fehlschlagen:

• Fehlerhafte Anfragen: Eine dApp erstellt einen Kontraktaufruf mit fehlerhaften Eingabedaten oder falschen Parametern, sodass der Node die Nutzdaten ablehnt, bevor sie die Ausführung erreichen.
• Ratenbegrenzungen: Kostenlose öffentliche Endpunkte und die kreditbasierten Stufen von Infura begrenzen das Anfragevolumen, und in stark ausgelasteten Phasen wie Token-Launches überschreiten Wallets diese Grenzen innerhalb weniger Sekunden.
• Veraltete Nodes: Ein nicht synchronisierter Node liefert einen veralteten Chain-Zustand, was zu falschen Kontoständen, hängenden Transaktionen und swap-Kursen führt, die in dem Moment scheitern, in dem MetaMask sie ausführen will.
• Contract-Reverts: Ein Smart Contract geht das Gas aus oder wird mitten in der Ausführung zurückgesetzt, was MetaMask bei Bridging, Staking oder Token-Airdrop-Claims als RPC-Fehler anzeigt.
• Chain-Abweichungen: Manche Endpunkte überspringen Methoden, die Layer-2-Netzwerke benötigen, sodass Swaps oder Deployments auf diesen Chains fehlschlagen, selbst wenn die Chain-ID korrekt ist.
• Inaktive Testnets: Anfragen an stillgelegte Testnetzwerke wie Holesky oder das ältere Goerli schlagen sofort fehl, weil auf diesen veralteten Endpunkten keine aktiven Nodes mehr antworten.
• Gebündelte Aufrufe: Smart-Account-Funktionen nach EIP-7702 bündeln mehrere Aktionen in einer Transaktion, und ein einzelner fehlschlagender Schritt innerhalb des Bündels kann die gesamte gebündelte Anfrage scheitern lassen.

Manche dieser Faktoren haben Sie selbst in der Hand, andere nicht. Die Wahl des Endpunkts, Gas-Guthaben und Softwareversionen lassen sich in Minuten beheben, während bei Ausfällen von Anbietern und Netzwerküberlastung nur Geduld oder ein vorübergehender Wechsel zu einem anderen RPC hilft, bis sich die Lage normalisiert.

Wie aktuelle MetaMask-Updates die Fehlersuche bei RPC verändert haben

MetaMask sieht ganz anders aus als das Wallet, das dieser Fehler zuerst plagte. Zwischen 2025 und 2026 kamen Unterstützung für Solana, Bitcoin, TRON, Sei und Monad hinzu, das Kontosystem wurde neu aufgebaut und Upgrades für Smart Accounts wurden eingeführt. All das hat verändert, wo und wie RPC-Fehler auftreten.

Multichain-Konten führen alle Netzwerke in einem zusammen

Seit Extension 13.5 bündelt jedes MetaMask-Konto eine EVM-Adresse, eine Solana-Adresse und eine Bitcoin-Adresse unter einem Namen, wobei die Wallet Anfragen automatisch weiterleitet. Ein Ausfall in einem Netzwerk bedeutet nicht mehr, dass Ihre gesamte Wallet defekt ist. Testen Sie daher immer eine zweite Chain, bevor Sie von einer Beschädigung ausgehen.

Non-EVM-Chains nutzen eine eigene Node-Infrastruktur, sodass ein Solana-Ausfall selbst in derselben Oberfläche andere Symptome zeigt als ein Ethereum-Ausfall. Treten Fehler nur in einem Ökosystem auf, liegt die Ursache wahrscheinlich bei Endpunkt-Problemen in diesem Netzwerk und nicht an Ihrer Installation.

Smart Accounts schaffen eine neue Fehlerquelle

Ethereums Pectra-Upgrade aktivierte im Mai 2025 EIP-7702, wodurch gewöhnliche MetaMask-Konten für gebündelte Transaktionen und Gas-Sponsoring vorübergehend wie Smart Contracts funktionieren können. Diese gebündelten Vorgänge laufen über zusätzliche Infrastruktur, und wenn ein Bundler oder Paymaster fehlerhaft arbeitet, meldet das Wallet dies oft als allgemeinen internen Fehler.

Wenn der Fehler nur auftritt, wenn eine dApp eine gebündelte Aktion oder ein Konto-Upgrade anfordert, lehnen Sie die Smart-Account-Abfrage ab und versuchen Sie es als normale Transaktion erneut. So lässt sich eingrenzen, ob das Problem im Delegierungsablauf oder in der zugrunde liegenden RPC-Verbindung liegt, die Sie wie gewohnt untersuchen würden.

Der Testnet-Umbruch bei Ethereum machte alte Konfigurationen unbrauchbar

Die Ethereum Foundation hat Holesky eingestellt, nachdem das Fusaka-Upgrade abgeschlossen war, und ersetzt es durch Hoodi für Validator-Tests, während sie Sepolia für die Arbeit mit Smart Contracts empfiehlt. Jede in MetaMask noch gespeicherte Holesky-Konfiguration löst nun bei jeder Anfrage JSON-RPC-Fehler aus, und keine Änderung der Einstellungen kann sie wiederbeleben.

Entwickler sollten veraltete testnet-Einträge vollständig löschen und aktuelle über ChainList neu hinzufügen. Sepolia bleibt die Standardwahl für dApp-Tests, während bereits ein Nachfolger von Sepolia geplant ist. Man sollte also damit rechnen, dass dieser Zyklus von testnet-Abkündigungen alle paar Jahre weiterhin Phantom-RPC-Fehler verursacht.

So lesen Sie den Fehlercode hinter der Meldung

MetaMask versteckt den numerischen Code oft in den Fehlerdetails, doch das Aufklappen zeigt genau, welche Fehlerkategorie vorliegt. Wenn Sie den Code mit der Referenztabelle von MetaMask abgleichen, wird aus einer vagen Meldung eine konkrete Diagnose, die meist direkt zur richtigen Lösung führt.

Eine Handvoll Codes macht nahezu alle gemeldeten Fehler aus. Wer sie auf einen Blick erkennt, behebt Probleme deutlich schneller, als jedes Mal blind zu raten.

Diese Codes und ihre Bedeutungen sollten Sie sich merken:

• Code -32603: Der klassische interne Fehler, ausgelöst durch eine fehlerhafte oder ungültige Payload, und der Code hinter den meisten Anzeigen genau dieser MetaMask-Fehlermeldung.
• Code -32000: Ungültige Eingabe, meist fehlende Parameter oder ein Block, den der Node noch nicht verarbeitet hat. Das Problem lässt sich oft durch den Wechsel zu einem zuverlässigeren RPC-Endpunkt beheben.
• Code -32005: Limit überschritten. Das bedeutet, dass Ihre Anfragen das Limit des Anbieters überschritten haben. Verlangsamen Sie also, warten Sie eine Minute oder wechseln Sie einfach zu einem weniger ausgelasteten öffentlichen Endpunkt.
• Code -32602: Ungültiges Argument, typischerweise ein Formatierungsfehler wie ein fehlendes Präfix 0x, was auf den Code der dApp hindeutet und nicht auf Ihre eigene Wallet- oder Netzwerkkonfiguration.
• Code -32601: Method not found. Das bedeutet, dass der Endpunkt nicht unterstützt, was MetaMask angefragt hat – ein häufiges Problem bei minimalen öffentlichen RPC-Endpunkten für neuere Chains.
• Code 429: Ein HTTP-Durchsatzfehler und kein JSON-RPC-Fehler, der zeigt, dass der Anbieter selbst Sie gedrosselt hat. Höhere Tarife oder der Wechsel des Endpunkts beheben das problemlos.

So vermeiden Sie RPC-Probleme in MetaMask

Vorbeugung ist größtenteils eine Frage der Endpunkt-Hygiene. Fügen Sie Netzwerke über ChainList oder die offizielle Dokumentation hinzu statt über beliebige Tutorials, hinterlegen Sie für jede regelmäßig genutzte Chain eine Backup-RPC-URL und erwägen Sie einen kostenlosen persönlichen Schlüssel von einem Anbieter wie Infura oder Alchemy, damit Sie nicht mehr um geteilte öffentliche Kapazität konkurrieren.

Regelmäßige Wartung ist ebenso wichtig. Halten Sie die Erweiterung und die mobile App aktuell, löschen Sie Aktivitätsdaten nach fehlgeschlagenen Transaktionen, statt veraltete Fehler anzusammeln, und entfernen Sie Netzwerke, die Sie nicht mehr nutzen, denn jeder tote Eintrag ist ein künftiger Fehler, der auf einen versehentlichen Klick wartet.

Fazit

Der Fehler „Internal JSON-RPC“ wirkt alarmierend, deutet aber fast nie auf verlorene Gelder hin, sondern nur auf eine gestörte Kommunikation zwischen Ihrer Wallet und einem Node. Das Prüfen der Netzwerkdetails, der Wechsel von Endpunkten, das Aufladen von Gas und das Aktualisieren der Software lösen die überwiegende Mehrheit der Fälle, ohne dass der Support eingreifen muss.

Da MetaMask weiter auf neue Chains expandiert, wird die eigenständige Verwaltung von RPC-Verbindungen zu einer zentralen Wallet-Fähigkeit. Setzen Sie ein Lesezeichen für ChainList, lernen Sie die oben genannten Fehlercodes, und wenn Sie Alternativen abwägen, vergleicht unser Leitfaden zu den besten Krypto-Wallets, wie konkurrierende Optionen mit denselben Problemen umgehen.