Cos'è l'errore Internal JSON-RPC su MetaMask?

L'errore Internal JSON-RPC indica che MetaMask ha inviato una richiesta a un nodo blockchain e ha ricevuto un errore anziché una risposta utilizzabile. Sotto il cofano corrisponde al codice di errore -32603 nella guida JSON-RPC di MetaMask, un termine generico che il protocollo riserva a payload errati o non validi.

Poiché MetaMask si affida a JSON-RPC per qualsiasi operazione, il messaggio può interrompere il controllo dei saldi, i swap di token, le chiamate a contratti e persino il cambio di rete. Compare più spesso su Ethereum, Layer 2 networks come Base e Arbitrum, e sul testnet Sepolia, dove i singoli endpoint si interrompono senza preavviso.

Da quando MetaMask è diventato un wallet multichain che copre Ethereum, Solana, Bitcoin e TRON, l'errore ha iniziato a comparire anche su richieste Non-EVM che le vecchie build incentrate solo su Ethereum non effettuavano mai. Le correzioni seguenti coprono sia le cause classiche che quelle più recenti introdotte da quella riprogettazione.

Come risolvere l'errore interno JSON-RPC

La maggior parte dei casi è riconducibile a un'impostazione errata anziché a un problema più grave del wallet, quindi seguire le verifiche sottostanti in ordine risolverà rapidamente l'errore.

Segui queste sette correzioni in ordine finché l'errore non scompare:

1. Impostazioni di rete: apri il menu di rete, modifica la chain che presenta problemi e conferma l'URL RPC e il Chain ID rispetto alla documentazione ufficiale, oppure riaggiungila automaticamente tramite ChainList.
2. Saldo per il gas: tieni una quantità sufficiente del token nativo della rete, come ETH, BNB o POL, prima di riprovare, e controlla prima le commissioni in tempo reale con il nostro tracciatore del gas di Ethereum.
3. Aggiornamento del wallet: installa l'ultima versione dell'estensione o dell'app mobile, poiché l'architettura degli account multichain di MetaMask è stata introdotta nell'Estensione 13.5 e nella versione Mobile 7.57, e le build precedenti interpretano male le risposte più recenti.
4. Endpoint RPC: sostituisci un endpoint lento o non attivo con un'alternativa da ChainList o da un provider dedicato come Infura o Alchemy, quindi riprova la transazione non riuscita.
5. Hardware wallet: aggiorna il firmware di Ledger o Trezor, abilita i dati degli smart contract nell'app Ethereum del dispositivo e riconnettiti tramite il metodo di connessione consigliato dalla guida alla risoluzione dei problemi di Ledger.
6. Ripristino dell'account: usa Cancella i dati della scheda attività nelle Impostazioni avanzate per ripulire la cronologia delle transazioni memorizzata nella cache e i nonce bloccati, il che costringe MetaMask a risincronizzarsi correttamente con il nodo.
7. Controllo del testnet: conferma che il testnet a cui ti stai rivolgendo esista ancora, poiché Holesky è stato chiuso dopo l'aggiornamento Fusaka e i suoi vecchi endpoint ora rifiutano ogni richiesta.

Se ogni passaggio fallisce, il Centro assistenza di MetaMask offre diagnostiche più approfondite, inclusi i log di stato che il team di supporto può esaminare direttamente. I problemi persistenti su una singola dApp di solito significano che il problema riguarda le chiamate di contratto di quell'applicazione piuttosto che il tuo wallet, quindi testa un altro sito prima di procedere con l'escalation.

Come aggiungere correttamente un RPC tramite ChainList

I dettagli RPC inseriti manualmente restano la causa più comune di questo errore, poiché un solo carattere errato in un URL o in un Chain ID compromette qualsiasi richiesta inviata successivamente dal wallet. ChainList elimina questo rischio gestendo endpoint verificati per centinaia di reti e trasferendoli in MetaMask con un solo clic.

Utilizziamo la stessa procedura nella nostra guida per aggiungere HyperEVM a MetaMask, quindi i passaggi seguenti si applicano a quasi tutte le catene EVM, dalle principali reti Layer 2 alle nuovissime mainnet. Bastano quattro passaggi per passare da un elenco di reti vuoto a una connessione verificata.

1. Connetti MetaMask a ChainList

ChainList legge i parametri di rete da un registro gestito dalla community, quindi la connessione del tuo wallet consente di inserire direttamente quei dettagli verificati in MetaMask senza alcuna copia manuale.

Ecco come collegare il tuo wallet al sito:

1. Apri ChainList: vai su chainlist.org e controlla attentamente l'ortografia della barra degli indirizzi prima di connetterti, poiché sono circolate versioni clonate del sito con endpoint RPC dannosi precaricati.
2. Connetti il wallet: fai clic sul pulsante Connect Wallet nell'angolo in alto a destra, seleziona MetaMask tra le opzioni e approva la richiesta di connessione visualizzata nel popup dell'estensione.
3. Verifica i permessi: il sito richiede solo l'accesso in visualizzazione per inviare i dettagli di rete, quindi rifiuta qualsiasi richiesta che richieda firme, approvazioni di token o permessi di spesa di qualsiasi tipo.

2. Cerca la rete corretta

La maggior parte delle catene offre più versioni e confondere una mainnet con la sua testnet porta a transazioni fallite, saldi invisibili e nuovi errori JSON-RPC nel giro di pochi minuti.

Segui queste verifiche per trovare la voce giusta:

1. Cerca con precisione: digita il nome esatto della rete, che sia Base, Linea o una catena più recente come Monad, e attiva l'interruttore delle testnet solo quando te ne serve una.
2. Verifica gli identificatori: confronta il Chain ID mostrato con la documentazione ufficiale del progetto, poiché le reti truffaldine a volte riutilizzano nomi familiari puntando a catene completamente diverse sottostanti.
3. Attenzione alle testnet: per i test su Ethereum, usa Sepolia per le dApps e Hoodi per il lavoro dei validatori, poiché la Ethereum Foundation ha ritirato Holesky e i suoi elenchi non funzionano più.

3. Aggiungi l'RPC a MetaMask

Una volta visualizzata la rete corretta, ChainList trasferisce l'intera configurazione a MetaMask in un unico prompt, eliminando gli errori di digitazione causati dall'inserimento manuale.

Completa il trasferimento con queste tre rapide azioni:

1. Aggiungi rete: premi Add to MetaMask accanto alla voce con il punteggio di latenza migliore, poiché ChainList classifica ciascun endpoint pubblico in base alla velocità e all'affidabilità misurate in tempo reale.
2. Rivedi il popup: leggi la finestra di MetaMask che mostra l'URL RPC, il Chain ID, il simbolo della valuta e il block explorer, quindi confronta ciascun valore prima di concedere l'approvazione finale.
3. Passa alla nuova rete: approva l'aggiunta e seleziona Switch Network quando richiesto, rendendo la nuova catena immediatamente attiva e pronta per una piccola transazione di prova.

4. Verifica le impostazioni in seguito

Anche le voci verificate possono variare nel tempo poiché i provider dismettono gli endpoint, quindi un rapido controllo all'interno di MetaMask conferma che tutto sia arrivato correttamente e risponda ancora oggi.

Esegui questo controllo finale prima di trasferire fondi reali:

1. Apri le impostazioni: vai al selettore della rete, scegli la catena appena aggiunta e clicca su Modifica per visualizzare tutti i parametri salvati che MetaMask utilizzerà per le sue richieste.
2. Verifica incrociata: confronta l'URL RPC, l'ID della catena e il simbolo della valuta con la documentazione ufficiale della rete anziché affidarti a blog di terze parti, screenshot o messaggi non ufficiali su Discord.
3. Ruota gli endpoint: se le richieste sembrano lente o falliscono a intermittenza, sostituisci l'URL con un'altra opzione di ChainList, poiché ora MetaMask supporta più URL RPC memorizzati per ciascuna rete.

Perché si verifica l'errore JSON-RPC?

I problemi legati al JSON-RPC si riducono a un fattore chiave: il nodo non ha mai ricevuto una richiesta valida o non è riuscito a restituire una risposta valida. La documentazione per sviluppatori di MetaMask elenca 17 codici di errore JSON-RPC distinti, e questa varietà interna si affianca a limiti di velocità, errori di analisi e transazioni rifiutate in quella tabella.

Comprendere quale tipo di problema stai riscontrando fa risparmiare tempo, poiché ciascuno di essi punta a una soluzione diversa, dalla sostituzione degli endpoint al semplice attender la fine della congestione.

Questi sono i motivi più comuni per cui le richieste JSON-RPC falliscono:

• Richieste malformate: una dApp crea una chiamata a un contratto con dati di input errati o parametri sbagliati, quindi il nodo rifiuta il payload prima ancora che raggiunga l'esecuzione.
• Limiti di velocità: gli endpoint pubblici gratuiti e i livelli basati su crediti di Infura pongono un limite al volume delle richieste, e i periodi di forte attività, come i lanci di token, spingono i wallet oltre tali soglie nel giro di pochi secondi.
• Nodi non aggiornati: un nodo non sincronizzato fornisce uno stato della catena obsoleto, producendo saldi errati, transazioni bloccate e preventivi di swap che falliscono nel momento esatto in cui MetaMask tenta di eseguirli.
• Ritororni di contratto (revert): uno smart contract esaurisce il gas o si interrompe a metà esecuzione, situazione che MetaMask segnala come errore RPC durante il bridging, lo staking o la riscossione di un airdrop di token.
• Disallineamenti di catena: alcuni endpoint saltano i metodi richiesti dalle reti Layer 2, quindi gli swap o i rilasci falliscono su tali catene anche quando l'ID della catena è corretto.
• Testnet non più attive: le richieste indirizzate a reti di test ormai dismesse come Holesky o la precedente Goerli falliscono all'istante, poiché non vi sono più nodi attivi che rispondono alle richieste su quegli endpoint deprecati.
• Chiamate raggruppate: le funzionalità di smart account EIP-7702 raggruppano diverse azioni in un'unica transazione e una singola fase di interruzione all'interno del batch può far fallire l'intera richiesta raggruppata.

Alcuni di questi aspetti dipendono da te, altri no. La scelta dell'endpoint, i saldi di gas e le versioni del software si possono correggere in pochi minuti, mentre le interruzioni dei provider e la congestione della rete richiedono semplicemente pazienza o un passaggio temporaneo a un RPC diverso fino al ripristino delle condizioni ottimali.

Come i recenti aggiornamenti di MetaMask hanno cambiato la risoluzione dei problemi RPC

MetaMask appare molto diverso dal wallet che ha affrontato per primo questo errore. Tra il 2025 e il 2026 ha integrato il supporto a Solana, Bitcoin, TRON, SEI e Monad, ha ricostruito il suo sistema di account e ha introdotto aggiornamenti per gli smart account, tutti elementi che hanno ridefinito dove e come compaiono gli errori RPC.

Gli account multichain uniscono ogni rete in un'unica soluzione

A partire dall'Extension 13.5, ciascun account MetaMask raggruppa un indirizzo EVM, un indirizzo Solana e un indirizzo Bitcoin sotto un unico nome, mentre il wallet instrada le richieste automaticamente. Un errore su una rete non significa più che l'intero wallet sia compromesso, quindi testa sempre una seconda catena prima di supporre che ci sia un problema di corruzione.

Le catene Non-EVM utilizzano un'infrastruttura di nodi propria, quindi un'interruzione su Solana produce sintomi diversi rispetto a una su Ethereum, anche all'interno della stessa interfaccia. Quando gli errori colpiscono un solo ecosistema, la causa probabile è un problema di endpoint su quella specifica rete piuttosto che un difetto della tua installazione.

Gli smart account aggiungono una nuova superficie di errore

L'aggiornamento Pectra di Ethereum ha attivato EIP-7702 a maggio 2025, consentendo ai normali account MetaMask di comportarsi temporaneamente come smart contract per transazioni raggruppate e sponsorizzazione del gas. Queste operazioni in bundle transitano attraverso un'infrastruttura aggiuntiva e, quando un bundler o un paymaster non funziona correttamente, il wallet spesso lo segnala come un generico errore interno.

Se l'errore compare solo quando una dApp richiede un'azione raggruppata o un aggiornamento dell'account, rifiuta il prompt dello smart account e riprova come transazione standard. Questo isola il problema, verificando se risiede nel flusso di delega o nella connessione RPC sottostante che risolveresti normalmente.

Il cambiamento delle testnet di Ethereum ha compromesso le vecchie configurazioni

La Ethereum Foundation ha ritirato Holesky dopo il completamento dell'aggiornamento Fusaka, sostituendolo con Hoodi per i test dei validatori e raccomandando Sepolia per lo sviluppo di smart contract. Qualsiasi configurazione di Holesky ancora salvata in MetaMask restituisce ora errori JSON-RPC a ogni richiesta, e nessuna modifica delle impostazioni potrà ripristinarla.

Gli sviluppatori dovrebbero eliminare completamente le voci di testnet obsolete e riaggiungere quelle attuali tramite ChainList. Sepolia rimane la scelta predefinita per i test delle dApp, mentre un successore di Sepolia è già in fase di pianificazione, quindi è prevedibile che questo ciclo di deprecazioni delle testnet continui a generare errori RPC fantasma ogni pochi anni.

Come leggere il codice di errore dietro il messaggio

MetaMask spesso nasconde il codice numerico all'interno dei dettagli dell'errore, ma espandendoli scoprirai esattamente quale categoria di errore si è verificata. Verificare il codice rispetto alla tabella di riferimento di MetaMask trasforma un messaggio vago in una diagnosi specifica e di solito punta direttamente alla soluzione corretta.

Una manciata di codici copre quasi ogni errore segnalato dagli utenti, quindi riconoscerli a colpo d'occhio rende la risoluzione dei problemi notevolmente più rapida rispetto a tirare a indovinare ogni volta.

Ecco i codici che vale la pena memorizzare e i loro significati:

• Codice -32603: Il classico errore interno, attivato da un payload errato o non valido, e il codice alla base della maggior parte delle comparse di questo specifico messaggio di errore di MetaMask.
• Codice -32000: Input non valido, solitamente con parametri mancanti o un blocco che il nodo non ha ancora elaborato, che spesso si risolve dopo il passaggio a un endpoint RPC più stabile.
• Codice -32005: Limite superato, il che significa che le tue richieste hanno superato il tetto massimo del provider; quindi rallenta, attendi un minuto o passa semplicemente a un endpoint pubblico meno congestionato.
• Codice -32602: Argomento non valido, in genere un errore di formato come un prefisso 0x mancante, che indica il codice della dApp anziché la configurazione del tuo wallet o della tua rete.
• Codice -32601: Metodo non trovato, il che significa che l'endpoint non supporta ciò che MetaMask ha richiesto, un problema frequente sugli endpoint RPC pubblici minimali che servono chain più recenti.
• Codice 429: Un errore di throughput HTTP anziché JSON-RPC, che mostra come il provider stesso ti abbia limitato, problema facilmente risolvibile con piani superiori o la rotazione degli endpoint.

Come evitare problemi RPC in MetaMask

La prevenzione dipende principalmente dall'igiene degli endpoint. Aggiungi reti tramite ChainList o la documentazione ufficiale anziché tutorial casuali, memorizza un URL RPC di backup per ogni chain che usi regolarmente e considera una chiave personale gratuita da un provider come Infura o Alchemy per smettere di competere per la capacità pubblica condivisa.

La manutenzione di routine è altrettanto importante. Mantieni aggiornate l'estensione e l'app mobile, cancella i dati delle attività dopo transazioni fallite anziché lasciare accumulare errori obsoleti e rimuovi le reti che non usi più, poiché ogni voce obsoleta è un potenziale errore in attesa di un clic accidentale.

Considerazioni finali

L'errore interno JSON-RPC sembra allarmante ma quasi mai segnala fondi persi, bensì una comunicazione interrotta tra il tuo wallet e un nodo. Verificare i dettagli della rete, cambiare endpoint, finanziare il gas e aggiornare il software risolve la stragrande maggioranza dei casi senza richiedere l'intervento del supporto.

Man mano che MetaMask continua a espandersi su più chain, saper gestire autonomamente le connessioni RPC sta diventando una competenza fondamentale per l'utilizzo del wallet. Aggiungi ChainList ai preferiti, impara i codici di errore sopra indicati e, se stai valutando delle alternative, la nostra guida ai migliori crypto wallet confronta il modo in cui le opzioni concorrenti gestiscono gli stessi problemi.