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

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

Poiché MetaMask si affida a JSON-RPC per tutto, il messaggio può interrompere i controlli del saldo, gli swap di token, le chiamate a contratti e persino il cambio di rete. Si manifesta più spesso su Ethereum, reti Layer 2 come Base e Arbitrum, e la testnet Sepolia, dove i singoli endpoint vanno offline senza preavviso.

Da quando MetaMask è diventato un wallet multichain che copre Ethereum, Solana, Bitcoin e TRON, l'errore ha iniziato ad apparire anche su richieste non-EVM che le build più vecchie, solo per Ethereum, non effettuavano. Le soluzioni seguenti coprono sia le cause classiche che quelle più recenti introdotte da tale riprogettazione.

Come Risolvere l'Errore JSON-RPC Interno

Nella maggior parte dei casi, l'errore è riconducibile a un'impostazione errata piuttosto che a un problema più profondo del wallet; pertanto, seguire i controlli elencati di seguito in ordine risolve rapidamente l'errore.

Segui queste sette soluzioni in ordine fino a quando l'errore non scompare:

1. Impostazioni di rete: Apri il menu di rete, modifica la chain che presenta problemi e conferma il suo URL RPC e il Chain ID rispetto alla documentazione ufficiale, oppure riaggiungila automaticamente tramite ChainList.
2. Saldo gas: Assicurati di avere 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 Ethereum gas tracker.
3. Aggiornamento del wallet: Installa l'ultima estensione o la versione mobile, poiché la multichain account architecture di MetaMask è stata introdotta nell'Estensione 13.5 e nella versione Mobile 7.57, e le build più vecchie interpretano erroneamente le risposte più recenti.
4. Endpoint RPC: Sostituisci un endpoint lento o non funzionante con un'alternativa da ChainList o da un provider dedicato come Infura o Alchemy, quindi riprova la transazione fallita.
5. Hardware wallet: Aggiorna il firmware di Ledger o Trezor, abilita i dati dei contratti smart nell'app Ethereum del dispositivo e riconnettiti tramite il metodo di connessione che la guida alla risoluzione dei problemi di Ledger raccomanda attualmente.
6. Reset dell'account: Usa "Cancella dati della scheda attività" nelle impostazioni avanzate per eliminare la cronologia delle transazioni memorizzate nella cache e i nonce bloccati, il che forza MetaMask a risincronizzarsi correttamente con il nodo.
7. Controllo testnet: Conferma che la testnet a cui ti stai connettendo esiste ancora, perché Holesky è stata disattivata dopo l'aggiornamento Fusaka e i suoi vecchi endpoint ora rifiutano ogni richiesta.

Se ogni passaggio fallisce, il MetaMask Help Center offre diagnostiche più approfondite, inclusi i log di stato che il suo team di supporto può esaminare direttamente. I fallimenti persistenti su una singola dApp di solito indicano che il problema risiede nelle chiamate ai contratti di quell'applicazione piuttosto che nel tuo wallet, quindi testa un altro sito prima di inoltrare il problema.

Come aggiungere correttamente un RPC utilizzando ChainList

I dettagli RPC digitati manualmente rimangono la causa più comune di questo errore, poiché un singolo carattere errato in un URL o in un Chain ID invalida ogni richiesta che il wallet invia successivamente. ChainList elimina questo rischio mantenendo endpoint verificati per centinaia di reti e inserendoli in MetaMask con un solo clic.

Utilizziamo il medesimo flusso nella nostra guida per aggiungere HyperEVM a MetaMask, quindi i passaggi seguenti si applicano a quasi tutte le chain EVM, dalle principali reti Layer 2 alle nuovissime mainnet. Quattro passaggi ti portano da un elenco di reti vuoto a una connessione verificata.

1. Collega MetaMask a ChainList

ChainList legge i parametri di rete da un registro gestito dalla community, quindi collegare il tuo wallet le consente di scrivere quei dettagli verificati direttamente 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 nella barra degli indirizzi prima di connetterti, perché sono circolate versioni clonate del sito con endpoint RPC malevoli precaricati.
2. Collega wallet: Clicca sul pulsante "Collega Wallet" nell'angolo in alto a destra, scegli MetaMask dalle opzioni e approva la richiesta di connessione che appare nel pop-up dell'estensione.
3. Controlla i permessi: Il sito necessita solo dell'accesso in visualizzazione per inviare i dettagli della rete, quindi rifiuta qualsiasi richiesta di firme, approvazioni di token o permessi di spesa di qualsiasi tipo.

2. Cerca la Rete Corretta

La maggior parte delle chain rilascia più versioni, e confondere una mainnet con la sua testnet porta a transazioni fallite, saldi invisibili e nuovi errori JSON-RPC in pochi minuti.

Segui questi controlli per trovare la voce corretta:

1. Cerca con precisione: Digita il nome esatto della rete, che si tratti di Base, Linea o di una chain più recente come Monad, e abilita l'interruttore delle testnet solo quando ne hai bisogno.
2. Verifica gli identificatori: Confronta il Chain ID mostrato con la documentazione ufficiale del progetto, poiché le reti scam a volte riutilizzano nomi familiari pur puntando a chain completamente diverse sottostanti.
3. Attenzione alle testnet: Per i test su Ethereum, usa Sepolia per le dApps e Hoodi per il lavoro dei validatori, perché la Ethereum Foundation ha ritirato Holesky e le sue liste non funzionano più.

3. Aggiungi l'RPC a MetaMask

Una volta visualizzata la rete corretta, ChainList trasferisce la configurazione completa a MetaMask in un'unica richiesta, eliminando gli errori di battitura che l'inserimento manuale comporta.

Completa il passaggio con queste tre rapide azioni:

1. Aggiungi rete: Premi Aggiungi a MetaMask accanto alla voce con il miglior punteggio di latenza, poiché ChainList classifica ogni endpoint pubblico in base alla velocità e all'affidabilità misurate in tempo reale.
2. Rivedi il pop-up: Leggi la finestra di MetaMask che mostra l'URL RPC, l'ID Catena, il simbolo della valuta e il block explorer, quindi confronta ogni valore prima di concedere la tua approvazione finale.
3. Passa alla rete: Approva l'aggiunta e seleziona Cambia Rete quando richiesto, il che rende la nuova catena attiva immediatamente e pronta per una piccola transazione di test.

4. Verifica le impostazioni in seguito

Anche le voci verificate possono variare nel tempo man mano che i provider ritirano gli endpoint, quindi una rapida revisione all'interno di MetaMask conferma che tutto è stato configurato correttamente e risponde ancora oggi.

Esegui questo controllo finale prima di spostare fondi reali:

1. Apri le impostazioni: Vai al selettore di rete, scegli la catena appena aggiunta e clicca su Modifica per visualizzare ogni parametro memorizzato che MetaMask utilizzerà per le sue richieste.
2. Verifica incrociata: Confronta l'URL RPC, l'ID Catena e il simbolo della valuta con la documentazione ufficiale della rete, piuttosto che con un blog di terze parti, uno screenshot o un messaggio Discord non ufficiale.
3. Ruota gli endpoint: Se le richieste risultano lente o falliscono a intermittenza, sostituisci l'URL con un'altra opzione di ChainList, poiché MetaMask ora supporta più URL RPC memorizzati per rete.

Perché si verifica l'errore JSON-RPC?

I fallimenti JSON-RPC si riducono a una cosa: il nodo o 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 la varietà interna si affianca a limiti di frequenza, errori di parsing e transazioni rifiutate in quella tabella.

Comprendere quale modalità di fallimento si sta riscontrando fa risparmiare tempo, perché ognuna indica una soluzione diversa, dal cambiare endpoint al semplice attendere che la congestione si risolva.

Queste sono le ragioni più comuni per cui le richieste JSON-RPC falliscono:

• Richieste malformate: Una dApp costruisce una chiamata di contratto con dati di input errati o parametri sbagliati, quindi il nodo rifiuta il payload prima che raggiunga l'esecuzione.
• Limiti di frequenza: Gli endpoint pubblici gratuiti e i livelli basati su crediti di Infura limitano il volume delle richieste, e periodi di intensa attività come i lanci di token spingono i wallet oltre tali limiti in pochi secondi.
• Nodi obsoleti: Un nodo non sincronizzato fornisce uno stato della catena obsoleto, producendo saldi errati, transazioni bloccate e quotazioni di swap che falliscono nel momento in cui MetaMask tenta di eseguirle.
• Revert di contratto: Un contratto smart esaurisce il gas o va in revert a metà esecuzione, e MetaMask lo segnala come un errore RPC durante il bridging, lo staking o la richiesta di airdrop di token.
• Discrepanze di catena: Alcuni endpoint saltano metodi che le reti Layer 2 richiedono, quindi gli swap o i deployment falliscono su quelle catene anche quando l'ID della catena è corretto.
• testnet inattive: Le richieste indirizzate a reti di test ritirate come Holesky o la più vecchia Goerli falliscono istantaneamente, perché nessun nodo attivo risponde più alle richieste su quegli endpoint deprecati.
• Chiamate in batch: Le funzionalità degli smart account EIP-7702 raggruppano diverse azioni in un'unica transazione, e un singolo passaggio che va in revert all'interno del batch può far fallire l'intera richiesta in bundle.

Alcuni di questi rientrano nel tuo controllo e altri no. La scelta dell'endpoint, i saldi di gas e le versioni del software sono risolvibili in pochi minuti, mentre le interruzioni del provider e la congestione della rete richiedono semplicemente pazienza o un passaggio temporaneo a un RPC diverso finché le condizioni non si ripristinano.

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

MetaMask è molto diverso dal wallet che questo errore ha afflitto per la prima volta. Tra il 2025 e il 2026 ha assorbito il supporto per Solana, Bitcoin, TRON, SEI e Monad, ha ricostruito il suo sistema di account e ha implementato aggiornamenti per gli smart account, tutto ciò ha rimodellato dove e come appaiono i fallimenti RPC.

Gli account multichain uniscono ogni rete in uno solo

Dall'Estensione 13.5, ogni account MetaMask raggruppa un indirizzo EVM, un indirizzo Solana e un indirizzo Bitcoin sotto un unico nome, con il wallet che instrada automaticamente le richieste. Un fallimento su una rete non significa più che l'intero wallet sia rotto, quindi testa sempre una seconda catena prima di presumere una corruzione.

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

Gli smart account aggiungono una nuova superficie di fallimento

L'aggiornamento Pectra di Ethereum ha attivato EIP-7702 a maggio 2025, permettendo agli account MetaMask ordinari di comportarsi temporaneamente come smart contract per transazioni in batch e sponsorizzazione del gas. Queste operazioni in bundle vengono instradate attraverso un'infrastruttura aggiuntiva, e quando un bundler o un paymaster si comporta in modo anomalo, il wallet spesso lo segnala come un errore interno generico.

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

Il riassetto delle testnet di Ethereum ha rotto le vecchie configurazioni

La Ethereum Foundation ha ritirato Holesky dopo la finalizzazione dell'aggiornamento Fusaka, sostituendolo con Hoodi per il testing dei validatori e raccomandando Sepolia per il lavoro sui smart contract. Qualsiasi configurazione Holesky ancora salvata in MetaMask ora genera errori JSON-RPC ad ogni richiesta, e nessuna modifica alle impostazioni la ripristinerà.

Gli sviluppatori dovrebbero eliminare completamente le voci testnet obsolete e riaggiungere quelle attuali tramite ChainList. Sepolia rimane la scelta predefinita per il testing delle dApp, mentre un successore di Sepolia è già in programma, quindi aspettatevi che questo ciclo di deprecazioni delle testnet continui a produrre errori RPC phantom 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 si scopre esattamente quale categoria di fallimento si è verificata. Controllare il codice rispetto alla tabella di riferimento di MetaMask trasforma un messaggio vago in una diagnosi specifica e di solito indica direttamente la soluzione corretta.

Una manciata di codici spiega quasi ogni fallimento segnalato dagli utenti, quindi riconoscerli a vista rende la risoluzione dei problemi notevolmente più veloce rispetto al tentare alla cieca ogni volta.

Ecco i codici da memorizzare e i loro significati:

• Codice -32603: Il classico errore interno, attivato da un payload errato o non valido, e il codice che si trova dietro la maggior parte delle occorrenze di questo esatto messaggio di errore di MetaMask.
• Codice -32000: Input non valido, solitamente 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 limite del provider, quindi rallenta, aspetta un minuto o semplicemente passa a un endpoint pubblico meno congestionato.
• Codice -32602: Argomento non valido, tipicamente un errore di formattazione come un prefisso 0x mancante, che indica il codice della dApp piuttosto che la configurazione del tuo wallet o della 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 catene più recenti.
• Codice 429: Un errore di throughput HTTP piuttosto che un errore JSON-RPC, che indica che il provider stesso ti ha limitato, e che piani aggiornati o la rotazione degli endpoint risolvono facilmente.

Come Evitare Problemi RPC in MetaMask

La prevenzione si riduce principalmente all'igiene degli endpoint. Aggiungi reti tramite ChainList o la documentazione ufficiale invece di tutorial casuali, memorizza un URL RPC di backup per ogni catena che usi regolarmente e considera una chiave personale gratuita da un provider come Infura o Alchemy in modo da smettere di competere per la capacità pubblica condivisa.

La manutenzione di routine è altrettanto importante. Mantieni l'estensione e l'app mobile aggiornate, cancella i dati di attività dopo transazioni fallite invece di lasciare che errori obsoleti si accumulino ed elimina le reti che non usi più, poiché ogni voce inattiva è un errore futuro in attesa di un clic accidentale.

Considerazioni finali

L'errore Internal JSON-RPC sembra allarmante ma quasi mai segnala fondi persi, solo una conversazione interrotta tra il tuo wallet e un nodo. Verificare i dettagli della rete, scambiare endpoint, finanziare il gas e aggiornare il software risolve la stragrande maggioranza dei casi senza mai aver bisogno di un intervento del supporto.

Poiché MetaMask continua ad espandersi tra le catene, sapere come gestire le connessioni RPC da soli sta diventando una competenza fondamentale del wallet. Aggiungi ChainList ai preferiti, impara i codici di errore sopra e, se stai valutando alternative, la nostra guida ai migliori crypto wallet confronta come le opzioni concorrenti gestiscono gli stessi problemi.