Qu'est-ce que l'erreur interne JSON-RPC sur MetaMask ?

L'erreur Internal JSON-RPC indique que MetaMask a envoyé une requête à un nœud blockchain et a reçu un échec au lieu d'une réponse exploitable. Techniquement, elle correspond au code d'erreur -32603 dans la référence JSON-RPC de MetaMask, un code fourre-tout que le protocole réserve aux charges utiles incorrectes ou invalides.

Comme MetaMask s'appuie sur JSON-RPC pour tout, ce message peut interrompre les vérifications de solde, les échanges de jetons, les appels de contrats et même le changement de réseau. Il apparaît le plus souvent sur Ethereum, sur les réseaux de couche 2 tels que Base et Arbitrum, et sur le testnet Sepolia, où des points d'accès individuels tombent en panne sans prévenir.

Depuis que MetaMask est devenu un wallet multichaîne couvrant Ethereum, Solana, Bitcoin et TRON, l'erreur apparaît aussi sur des requêtes non EVM que les anciennes versions, limitées à Ethereum, n'émettaient jamais. Les correctifs ci-dessous couvrent à la fois les causes classiques et les nouvelles causes introduites par cette refonte.

Comment corriger l'erreur JSON-RPC interne

La plupart des cas proviennent d'un seul paramètre défectueux plutôt que d'un problème plus profond du wallet ; en suivant les vérifications ci-dessous dans l'ordre, vous résoudrez rapidement l'erreur.

Appliquez ces sept correctifs dans l'ordre jusqu'à la disparition de l'erreur :

1. Paramètres réseau : ouvrez le menu du réseau, modifiez la chaîne défaillante et vérifiez son URL RPC et son Chain ID dans la documentation officielle, ou ajoutez-la de nouveau automatiquement via ChainList.
2. Solde de gas : détenez suffisamment du jeton natif du réseau, comme ETH, BNB ou POL, avant de réessayer, et vérifiez d'abord les frais en direct avec notre suivi du gas d'Ethereum.
3. Mise à jour du wallet : installez la dernière version de l'extension ou de l'application mobile, car l'architecture de compte multichaîne de MetaMask est arrivée avec l'extension 13.5 et l'application mobile 7.57, et les anciennes versions interprètent mal les nouvelles réponses.
4. Point de terminaison RPC : remplacez un point de terminaison lent ou hors service par une alternative issue de ChainList ou d'un fournisseur dédié comme Infura ou Alchemy, puis relancez la transaction échouée.
5. Hardware wallets : mettez à jour le firmware de Ledger ou de Trezor, activez les données de contrat intelligent dans l'application Ethereum de l'appareil, puis reconnectez-vous avec la méthode actuellement recommandée par le guide de dépannage de Ledger.
6. Réinitialisation du compte : utilisez l'option Effacer les données de l'onglet d'activité dans les paramètres avancés pour supprimer l'historique de transactions en cache et les nonces bloqués, ce qui force MetaMask à se resynchroniser correctement avec le nœud.
7. Vérification du testnet : confirmez que le testnet que vous visez existe toujours, car Holesky a été arrêté après la mise à niveau Fusaka et ses anciens points d'accès rejettent désormais toutes les requêtes.

Si toutes les étapes échouent, le centre d'aide MetaMask propose des diagnostics plus approfondis, notamment des journaux d'état que son équipe d'assistance peut examiner directement. Des échecs persistants sur une seule dApp signifient généralement que le problème vient des appels de contrat de cette application plutôt que de votre wallet ; testez donc un autre site avant de faire remonter le problème.

Comment ajouter correctement un RPC avec ChainList

Les paramètres RPC saisis manuellement restent la cause la plus fréquente de cette erreur, car un seul caractère erroné dans une URL ou un Chain ID fait échouer toutes les requêtes envoyées ensuite par le wallet. ChainList élimine ce risque en maintenant des points d'accès vérifiés pour des centaines de réseaux et en les ajoutant à MetaMask en un clic.

Nous utilisons le même processus dans notre guide pour ajouter HyperEVM à MetaMask, de sorte que les étapes ci-dessous s'appliquent à presque toutes les chaînes EVM, des principaux réseaux de couche 2 aux tout nouveaux mainnets. Quatre étapes vous mènent d'une liste de réseaux vide à une connexion vérifiée.

1. Connecter MetaMask à ChainList

ChainList lit les paramètres réseau depuis un registre maintenu par la communauté ; en connectant votre wallet, il peut donc inscrire ces informations vérifiées directement dans MetaMask, sans aucune copie manuelle.

Voici comment lier votre wallet au site :

1. Ouvrez ChainList : rendez-vous sur chainlist.org et vérifiez soigneusement l'orthographe dans la barre d'adresse avant de vous connecter, car des versions clonées du site ont circulé avec des points de terminaison RPC malveillants préchargés.
2. Connecter le wallet : cliquez sur le bouton Connect Wallet en haut à droite, choisissez MetaMask parmi les options et approuvez la demande de connexion qui apparaît dans la fenêtre contextuelle de l'extension.
3. Vérifiez les autorisations : le site n'a besoin que d'un accès en lecture pour transmettre les détails du réseau ; refusez donc toute demande de signatures, d'approbations de jetons ou d'autorisations de dépense, quelles qu'elles soient.

2. Recherchez le réseau correct

La plupart des chaînes proposent plusieurs versions, et confondre un mainnet avec son testnet entraîne en quelques minutes des transactions échouées, des soldes invisibles et de nouvelles erreurs JSON-RPC.

Suivez ces vérifications pour arriver à la bonne entrée :

1. Recherchez avec précision : saisissez le nom exact du réseau, qu'il s'agisse de Base, de Linea ou d'une chaîne plus récente comme Monad, et activez l'option testnets uniquement lorsque vous en avez besoin.
2. Vérifiez les identifiants : comparez l'ID de chaîne affiché avec la documentation officielle du projet, car des réseaux frauduleux réutilisent parfois des noms familiers tout en pointant vers des chaînes complètement différentes.
3. Attention aux testnets : pour tester sur Ethereum, utilisez Sepolia pour les dApps et Hoodi pour le travail de validateur, car l'Ethereum Foundation a retiré Holesky et ses listes ne fonctionnent plus.

3. Ajouter le RPC à MetaMask

Une fois le bon réseau affiché, ChainList transmet toute la configuration à MetaMask en une seule invite, ce qui élimine les fautes de frappe qu'entraîne la saisie manuelle.

Terminez le transfert avec ces trois actions rapides :

1. Ajouter le réseau : cliquez sur Add to MetaMask à côté de l'entrée ayant le meilleur score de latence, car ChainList classe chaque point d'accès public selon sa vitesse et sa fiabilité mesurées en direct.
2. Vérifiez la fenêtre contextuelle : lisez la fenêtre MetaMask affichant l'URL RPC, le Chain ID, le symbole de la devise et l'explorateur de blocs, puis comparez chaque valeur avant de donner votre approbation finale.
3. Basculer : approuvez l'ajout et sélectionnez Switch Network lorsque vous y êtes invité, ce qui active immédiatement le nouveau réseau et le rend prêt pour une petite transaction de test.

4. Vérifier ensuite les paramètres

Même les entrées vérifiées se dégradent avec le temps, car les fournisseurs retirent des points d'accès ; un rapide contrôle dans MetaMask permet donc de confirmer que tout a été correctement enregistré et répond toujours aujourd'hui.

Effectuez cette dernière vérification avant de transférer de vrais fonds :

1. Ouvrez les paramètres : accédez au sélecteur de réseau, choisissez la chaîne que vous venez d'ajouter, puis cliquez sur Modifier pour afficher tous les paramètres enregistrés que MetaMask utilisera pour ses requêtes.
2. Vérification croisée : comparez l'URL RPC, l'ID de chaîne et le symbole de la devise avec la documentation du réseau lui-même, plutôt qu'avec un blog tiers, une capture d'écran ou un message Discord non officiel.
3. Changez de point d'accès : si les requêtes semblent lentes ou échouent par intermittence, remplacez l'URL par une autre option de ChainList, car MetaMask prend désormais en charge plusieurs URL RPC enregistrées par réseau.

Pourquoi l'erreur JSON-RPC se produit-elle ?

Les échecs JSON-RPC se résument à une chose : le nœud n'a jamais reçu de requête valide ou n'a pas pu renvoyer de réponse valide. La documentation pour développeurs de MetaMask répertorie 17 codes d'erreur JSON-RPC distincts, et les erreurs internes figurent dans ce tableau à côté des limites de débit, des erreurs d'analyse et des transactions rejetées.

Comprendre le mode de défaillance auquel vous faites face fait gagner du temps, car chacun appelle une solution différente, du changement de endpoint à la simple attente de la fin de la congestion.

Voici les raisons les plus courantes d'échec des requêtes JSON-RPC :

• Requêtes malformées : une dApp construit un appel de contrat avec des données d'entrée erronées ou de mauvais paramètres, de sorte que le nœud rejette la charge utile avant même qu'elle n'atteigne l'exécution.
• Limites de débit : les points de terminaison publics gratuits et les paliers d'Infura fondés sur des crédits plafonnent le volume de requêtes, et les périodes d'affluence, comme les lancements de jetons, poussent les wallets au-delà de ces plafonds en quelques secondes.
• Nœuds obsolètes : un nœud désynchronisé fournit un état de la chaîne périmé, ce qui entraîne des soldes erronés, des transactions bloquées et des cotations de swap qui échouent dès que MetaMask tente de les exécuter.
• Échecs de contrat : un contrat intelligent à court de gas ou qui échoue en cours d'exécution, ce que MetaMask affiche comme une erreur RPC lors d'un bridging, d'un staking ou de réclamations d'airdrop de jetons.
• Incompatibilités de chaîne : certains endpoints ne prennent pas en charge des méthodes requises par les réseaux Layer 2, de sorte que les swaps ou les déploiements échouent sur ces chaînes même lorsque le Chain ID est correct.
• Testnets abandonnés : les requêtes visant des réseaux de test retirés comme Holesky ou l'ancien Goerli échouent instantanément, car plus aucun nœud actif ne répond sur ces points d'accès obsolètes.
• Appels groupés : les fonctions de compte intelligent EIP-7702 regroupent plusieurs actions en une seule transaction, et une seule étape en échec dans le lot peut faire échouer toute la requête groupée.

Certains de ces éléments dépendent de vous, d'autres non. Le choix du point de terminaison, les soldes de gas et les versions des logiciels se corrigent en quelques minutes, tandis que les pannes de fournisseurs et la congestion du réseau exigent simplement de la patience ou un passage temporaire à un autre RPC jusqu'au retour à la normale.

Comment les récentes mises à jour de MetaMask ont changé le dépannage des RPC

MetaMask ne ressemble plus du tout au wallet que cette erreur a d'abord touché. Entre 2025 et 2026, il a intégré la prise en charge de Solana, Bitcoin, TRON, Sei et Monad, reconstruit son système de comptes et déployé des mises à niveau de smart accounts, ce qui a modifié l'endroit et la manière dont les échecs RPC apparaissent.

Les comptes multichaînes fusionnent tous les réseaux en un seul

Depuis l'extension 13.5, chaque compte MetaMask regroupe une adresse EVM, une adresse Solana et une adresse Bitcoin sous un seul nom, le wallet acheminant automatiquement les requêtes. La défaillance d'un réseau ne signifie plus que tout votre wallet est cassé ; testez donc toujours une seconde chaîne avant de conclure à une corruption.

Les chaînes Non-EVM utilisent leur propre infrastructure de nœuds : une panne de Solana produit donc des symptômes différents de celle d'Ethereum, même dans la même interface. Lorsque les erreurs ne touchent qu'un seul écosystème, la cause probable est un problème de point de terminaison sur ce réseau précis, plutôt qu'un défaut de votre installation.

Les comptes intelligents ajoutent une nouvelle surface de défaillance

La mise à niveau Pectra d'Ethereum a activé l'EIP-7702 en mai 2025, permettant aux comptes MetaMask ordinaires de se comporter temporairement comme des contrats intelligents pour des transactions groupées et la prise en charge des frais de gas. Ces opérations groupées passent par une infrastructure supplémentaire, et lorsqu'un bundler ou un paymaster dysfonctionne, le wallet l'indique souvent comme une erreur interne générique.

Si l'erreur n'apparaît que lorsqu'une dApp demande une action groupée ou une mise à niveau de compte, refusez l'invite de compte intelligent et réessayez en transaction standard. Cela permet de déterminer si le problème vient du flux de délégation ou de la connexion RPC sous-jacente, que vous dépanneriez normalement.

Le remaniement des testnets d'Ethereum a rendu obsolètes les anciennes configurations

La Fondation Ethereum a mis hors service Holesky après la finalisation de la mise à niveau Fusaka, en le remplaçant par Hoodi pour les tests de validateurs et en recommandant Sepolia pour le travail sur les contrats intelligents. Toute configuration Holesky encore enregistrée dans MetaMask renvoie désormais des erreurs JSON-RPC à chaque requête, et aucun réglage ne la remettra en service.

Les développeurs doivent supprimer entièrement les anciennes entrées testnet et rajouter les entrées actuelles via ChainList. Sepolia reste le choix par défaut pour tester une dApp, mais un successeur de Sepolia est déjà prévu ; il faut donc s'attendre à ce que ce cycle d'abandon des testnet continue de produire des erreurs RPC fantômes tous les quelques années.

Comment interpréter le code d'erreur associé au message

MetaMask enfouit souvent le code numérique dans les détails de l'erreur, mais les développer vous indique précisément la catégorie de défaillance survenue. Comparer le code avec le tableau de référence de MetaMask transforme un message vague en diagnostic précis et indique généralement directement la bonne solution.

Une poignée de codes explique presque toutes les défaillances signalées par les utilisateurs ; les reconnaître au premier coup d'œil accélère donc considérablement le dépannage, par rapport à des tâtonnements à l'aveugle à chaque fois.

Voici les codes à retenir et leur signification :

• Code -32603 : l'erreur interne classique, déclenchée par une charge utile incorrecte ou invalide, et le code à l'origine de la plupart des apparitions de ce message d'erreur MetaMask précis.
• Code -32000 : entrée invalide, généralement due à des paramètres manquants ou à un bloc que le nœud n'a pas encore traité, ce qui disparaît souvent après le passage à un point de terminaison RPC plus fiable.
• Code -32005 : limite dépassée, ce qui signifie que vos requêtes ont dépassé le plafond du fournisseur ; ralentissez, attendez une minute ou passez simplement à un point d'accès public moins encombré.
• Code -32602 : argument invalide, généralement une erreur de format comme un préfixe 0x manquant, ce qui renvoie au code de la dApp plutôt qu'à votre propre wallet ou à la configuration de votre réseau.
• Code -32601 : Method not found, c'est-à-dire que le point de terminaison ne prend pas en charge ce que MetaMask a demandé, un problème fréquent sur les points de terminaison RPC publics minimalistes qui desservent des chaînes récentes.
• Code 429 : une erreur de débit HTTP plutôt que de JSON-RPC, qui montre que le fournisseur lui-même vous a limité ; un forfait supérieur ou la rotation des points de terminaison la résolvent facilement.

Comment éviter les problèmes de RPC dans MetaMask

La prévention tient surtout à l'hygiène des points d'accès. Ajoutez les réseaux via ChainList ou la documentation officielle plutôt que via des tutoriels au hasard, conservez une URL RPC de secours pour chaque chaîne que vous utilisez régulièrement, et envisagez une clé personnelle gratuite auprès d'un fournisseur comme Infura ou Alchemy afin de ne plus être en concurrence pour la capacité publique partagée.

La maintenance courante compte tout autant. Gardez l'extension et l'application mobile à jour, effacez les données d'activité après des transactions échouées plutôt que de laisser s'accumuler des erreurs obsolètes, et supprimez les réseaux que vous n'utilisez plus, car chaque entrée inutile est une future erreur qui n'attend qu'un clic accidentel.

Conclusion

L'erreur Internal JSON-RPC paraît alarmante, mais elle signale presque jamais une perte de fonds : il s'agit simplement d'un échange rompu entre votre wallet et un nœud. Vérifier les paramètres du réseau, changer de point d'accès, alimenter en gas et mettre à jour le logiciel permet de résoudre l'immense majorité des cas sans recourir au support.

Alors que MetaMask continue de s'étendre sur plusieurs chaînes, savoir gérer soi-même les connexions RPC devient une compétence essentielle du wallet. Ajoutez ChainList à vos favoris, apprenez les codes d'erreur ci-dessus et, si vous comparez des alternatives, notre guide des meilleurs wallets crypto compare la façon dont les différentes options gèrent les mêmes problèmes.