¿Qué es el error interno JSON-RPC en MetaMask?

El error Internal JSON-RPC indica que MetaMask envió una solicitud a un nodo de blockchain y recibió un fallo en lugar de una respuesta utilizable. Internamente corresponde al código de error -32603 de la referencia JSON-RPC de MetaMask, un código genérico que el protocolo reserva para cargas útiles incorrectas o no válidas.

Como MetaMask depende de JSON-RPC para todo, el mensaje puede interrumpir las consultas de saldo, los swaps de tokens, las llamadas a contratos e incluso el cambio de red. Aparece con más frecuencia en Ethereum, en redes de Layer 2 como Base y Arbitrum, y en la testnet Sepolia, donde algunos endpoints se caen sin previo aviso.

Desde que MetaMask se convirtió en un wallet multicadena que abarca Ethereum, Solana, Bitcoin y TRON, el error también ha empezado a aparecer en solicitudes no EVM que las versiones anteriores, solo para Ethereum, nunca realizaban. Las soluciones que figuran a continuación cubren tanto las causas clásicas como las más recientes, introducidas por ese rediseño.

Cómo solucionar el error interno de JSON-RPC

La mayoría de los casos se deben a un único ajuste incorrecto y no a un problema más profundo de la wallet, así que repasar las comprobaciones siguientes en orden resuelve el error rápidamente.

Sigue estas siete soluciones por orden hasta que desaparezca el error:

1. Configuración de red: abre el menú de redes, edita la cadena que falla y confirma su URL de RPC y su Chain ID con la documentación oficial, o vuelve a añadirla automáticamente mediante ChainList.
2. Saldo de gas: ten suficiente token nativo de la red, como ETH, BNB o POL, antes de reintentarlo y consulta antes las comisiones en directo con nuestro rastreador de gas de Ethereum.
3. Actualización del wallet: instala la última versión de la extensión o de la aplicación móvil, ya que la arquitectura de cuentas multichain de MetaMask llegó con Extension 13.5 y Mobile 7.57, y las versiones anteriores interpretan mal las respuestas más recientes.
4. Endpoint RPC: cambia un endpoint lento o caído por otro de ChainList o de un proveedor especializado como Infura o Alchemy y luego reintenta la transacción fallida.
5. Hardware wallets: actualiza el firmware de Ledger o Trezor, activa los datos de contrato inteligente en la aplicación de Ethereum del dispositivo y vuelve a conectarte con el método que recomienda actualmente la guía de resolución de problemas de Ledger.
6. Restablecimiento de la cuenta: usa Borrar datos de la pestaña de actividad en Configuración avanzada para eliminar el historial de transacciones en caché y los nonces atascados, lo que obliga a MetaMask a resincronizarse limpiamente con el nodo.
7. Comprobación de testnet: confirma que la testnet que quieres usar sigue existiendo, porque Holesky se cerró tras la actualización Fusaka y sus antiguos endpoints ahora rechazan todas las solicitudes.

Si todos los pasos fallan, el Centro de ayuda de MetaMask ofrece diagnósticos más detallados, incluidos registros de estado que su equipo de soporte puede revisar directamente. Si los fallos persisten solo en una dApp, normalmente el problema está en las llamadas a contratos de esa aplicación y no en tu wallet, así que prueba otro sitio antes de escalar la incidencia.

Cómo añadir correctamente una RPC con ChainList

Introducir a mano los datos de RPC sigue siendo el desencadenante más habitual de este error, ya que un solo carácter incorrecto en una URL o en el Chain ID invalida todas las solicitudes que envíe después el wallet. ChainList elimina ese riesgo al mantener endpoints verificados de cientos de redes y añadirlos a MetaMask con un clic.

Usamos el mismo flujo en nuestra guía para añadir HyperEVM a MetaMask, así que los pasos siguientes sirven para casi cualquier cadena EVM, desde las principales redes de capa 2 hasta mainnets recién lanzadas. Cuatro pasos te llevan de una lista de redes vacía a una conexión verificada.

1. Conecta MetaMask a ChainList

ChainList lee los parámetros de red de un registro mantenido por la comunidad, de modo que, al conectar tu wallet, puede escribir esos datos verificados directamente en MetaMask sin copiar nada a mano.

Así puedes vincular tu wallet al sitio:

1. Abre ChainList: ve a chainlist.org y comprueba con atención cómo está escrita la dirección en la barra antes de conectarte, porque han circulado versiones clonadas del sitio con endpoints RPC maliciosos precargados.
2. Conectar el wallet: haz clic en el botón Connect Wallet de la esquina superior derecha, elige MetaMask entre las opciones y aprueba la solicitud de conexión que aparece en la ventana emergente de la extensión.
3. Revisa los permisos: el sitio solo necesita acceso de visualización para enviar los datos de la red, así que rechaza cualquier solicitud de firmas, aprobaciones de tokens o permisos de gasto de cualquier tipo.

2. Busca la red correcta

La mayoría de las cadenas lanzan varias versiones, y confundir una mainnet con su testnet provoca transacciones fallidas, saldos invisibles y nuevos errores de JSON-RPC en cuestión de minutos.

Sigue estas comprobaciones para llegar a la entrada correcta:

1. Busca con precisión: escribe el nombre exacto de la red, ya sea Base, Linea o una cadena más reciente como Monad, y activa el interruptor de testnets solo cuando necesites una.
2. Verifica los identificadores: compara el Chain ID que aparece con la documentación oficial del proyecto, ya que las redes fraudulentas a veces reutilizan nombres conocidos mientras apuntan a cadenas completamente distintas.
3. Ojo con las testnets: para probar en Ethereum, usa Sepolia para dApps y Hoodi para el trabajo de validador, porque la Ethereum Foundation retiró Holesky y sus listados ya no funcionan.

3. Añade la RPC a MetaMask

Cuando aparece la red correcta, ChainList pasa la configuración completa a MetaMask en una sola solicitud, lo que elimina los errores tipográficos que provoca la introducción manual.

Completa el traspaso con estas tres acciones rápidas:

1. Añadir red: pulsa Add to MetaMask junto a la entrada con la mejor puntuación de latencia, ya que ChainList clasifica cada endpoint público según su velocidad y fiabilidad medidas en directo.
2. Revisa la ventana emergente: lee la ventana de MetaMask que muestra la URL de RPC, el Chain ID, el símbolo de la moneda y el explorador de bloques, y compara cada valor antes de dar tu aprobación final.
3. Cambia de red: aprueba la incorporación y selecciona Cambiar de red cuando se te solicite; así la nueva cadena queda activa de inmediato y lista para una pequeña transacción de prueba.

4. Verifica los ajustes después

Incluso las entradas verificadas se desfasan con el tiempo a medida que los proveedores retiran endpoints, así que una revisión rápida en MetaMask confirma que todo se ha guardado correctamente y que sigue respondiendo hoy.

Haz esta comprobación final antes de mover fondos reales:

1. Abre los ajustes: ve al selector de red, elige la cadena recién añadida y haz clic en Editar para mostrar todos los parámetros almacenados que MetaMask usará en sus solicitudes.
2. Contraste: compara la URL de RPC, el Chain ID y el símbolo de la moneda con la documentación de la propia red, y no con un blog de terceros, una captura de pantalla o un mensaje no oficial de Discord.
3. Cambia de endpoint: si las solicitudes van lentas o fallan de forma intermitente, sustituye la URL por otra opción de ChainList, ya que MetaMask admite ahora varias URL de RPC guardadas por red.

¿Por qué se produce el error JSON-RPC?

Los fallos de JSON-RPC se reducen a una cosa: el nodo nunca recibió una solicitud válida o no pudo devolver una respuesta válida. La documentación para desarrolladores de MetaMask enumera 17 códigos de error de JSON-RPC distintos, y la variedad interna convive en esa tabla con los límites de frecuencia, los errores de análisis y las transacciones rechazadas.

Entender qué tipo de fallo tienes te ahorra tiempo, porque cada uno apunta a una solución distinta, desde cambiar de endpoint hasta simplemente esperar a que pase la congestión.

Estos son los motivos más habituales por los que fallan las solicitudes JSON-RPC:

• Solicitudes mal formadas: una dApp construye una llamada a un contrato con datos de entrada incorrectos o parámetros erróneos, de modo que el nodo rechaza la carga útil antes de que llegue a ejecutarse.
• Límites de uso: los endpoints públicos gratuitos y los niveles de Infura basados en créditos limitan el volumen de solicitudes, y los periodos de mucha actividad, como los lanzamientos de tokens, hacen que los wallets superen esos límites en pocos segundos.
• Nodos desactualizados: un nodo desincronizado ofrece un estado de la cadena obsoleto, lo que provoca saldos erróneos, transacciones bloqueadas y cotizaciones de swap que fallan en cuanto MetaMask intenta ejecutarlas.
• Reversión del contrato: un contrato inteligente se queda sin gas o se revierte durante la ejecución, algo que MetaMask muestra como un fallo de RPC durante el bridging, el staking o la reclamación de airdrop de tokens.
• Incompatibilidades de cadena: algunos endpoints omiten métodos que requieren las redes de Layer 2, así que los swaps o los despliegues fallan en esas cadenas aunque el Chain ID sea correcto.
• Testnets abandonados: las solicitudes dirigidas a redes de prueba retiradas, como Holesky o la antigua Goerli, fallan al instante, porque ya no hay nodos activos que respondan en esos endpoints obsoletos.
• Llamadas agrupadas: las funciones de cuenta inteligente EIP-7702 agrupan varias acciones en una sola transacción, y un único paso revertido dentro del lote puede hacer fallar toda la solicitud agrupada.

Algunos de estos factores están bajo tu control y otros no. La elección del endpoint, los saldos de gas y las versiones del software se arreglan en minutos, mientras que las caídas de los proveedores y la congestión de la red solo requieren paciencia o un cambio temporal a otro RPC hasta que se normalicen las condiciones.

Cómo han cambiado las recientes actualizaciones de MetaMask la resolución de problemas de RPC

MetaMask es muy distinta de la wallet que sufrió este error por primera vez. Entre 2025 y 2026 incorporó compatibilidad con Solana, Bitcoin, TRON, Sei y Monad, reconstruyó su sistema de cuentas y lanzó mejoras de cuentas inteligentes, todo lo cual cambió dónde y cómo aparecen los fallos de RPC.

Las cuentas multicadena fusionan todas las redes en una

Desde la extensión 13.5, cada cuenta de MetaMask agrupa una dirección EVM, una dirección de Solana y una dirección de Bitcoin bajo un único nombre, y la wallet enruta las solicitudes automáticamente. El fallo en una red ya no significa que toda tu wallet esté rota, así que prueba siempre una segunda cadena antes de suponer que hay corrupción.

Las cadenas Non-EVM usan su propia infraestructura de nodos, así que una caída de Solana produce síntomas distintos a la de Ethereum, incluso dentro de la misma interfaz. Cuando los errores afectan solo a un ecosistema, lo probable es que la causa sean problemas del endpoint de esa red concreta y no un fallo de tu instalación.

Las cuentas inteligentes añaden una nueva superficie de fallo

La actualización Pectra de Ethereum activó EIP-7702 en mayo de 2025, lo que permite que las cuentas normales de MetaMask se comporten temporalmente como contratos inteligentes para transacciones por lotes y patrocinio de gas. Estas operaciones agrupadas pasan por infraestructura adicional y, cuando un bundler o un paymaster falla, el wallet suele mostrarlo como un error interno genérico.

Si el error solo aparece cuando una dApp solicita una acción por lotes o una actualización de cuenta, rechaza el aviso de cuenta inteligente y vuelve a intentarlo como una transacción estándar. Así se aclara si el problema está en el flujo de delegación o en la conexión RPC subyacente, que revisarías de forma normal.

La reorganización de las testnet de Ethereum dejó obsoletas las configuraciones antiguas

La Fundación Ethereum retiró Holesky tras finalizar la actualización Fusaka, sustituyéndola por Hoodi para las pruebas de validador y recomendando Sepolia para el trabajo con contratos inteligentes. Cualquier configuración de Holesky que siga guardada en MetaMask genera ahora errores JSON-RPC en cada solicitud, y ningún ajuste la volverá a activar.

Los desarrolladores deberían eliminar por completo las entradas obsoletas de testnet y volver a añadir las actuales a través de ChainList. Sepolia sigue siendo la opción predeterminada para probar dApp, aunque ya está previsto un sucesor de Sepolia, así que cabe esperar que este ciclo de retirada de testnet siga produciendo errores RPC fantasma cada pocos años.

Cómo interpretar el código de error que hay detrás del mensaje

MetaMask suele esconder el código numérico entre los detalles del error, pero al desplegarlos te indica exactamente qué categoría de fallo se ha producido. Comparar el código con la tabla de referencia de MetaMask convierte un mensaje vago en un diagnóstico concreto y normalmente señala directamente la solución adecuada.

Un puñado de códigos explica casi todos los fallos que reportan los usuarios, así que reconocerlos de un vistazo agiliza mucho la resolución de problemas frente a probar a ciegas cada vez.

Estos son los códigos que conviene memorizar y su significado:

• Código -32603: el error interno clásico, provocado por una carga útil incorrecta o no válida, y el código que está detrás de la mayoría de las apariciones de este mensaje de error de MetaMask.
• Código -32000: entrada no válida, normalmente por parámetros ausentes o un bloque que el nodo aún no ha procesado, algo que a menudo se resuelve al cambiar a un endpoint RPC más estable.
• Código -32005: límite superado, es decir, tus solicitudes superaron el tope del proveedor, así que reduce el ritmo, espera un minuto o cambia a un endpoint público menos congestionado.
• Código -32602: argumento no válido, normalmente un error de formato, como la falta del prefijo 0x, que apunta al código de la dApp y no a tu wallet ni a la configuración de red.
• Código -32601: método no encontrado, es decir, el endpoint no admite lo que MetaMask ha solicitado, un problema frecuente en endpoints RPC públicos mínimos que dan servicio a cadenas más recientes.
• Código 429: Un error de capacidad de HTTP y no de JSON-RPC, que indica que el propio proveedor te ha limitado, algo que se soluciona fácilmente con planes superiores o rotando el endpoint.

Cómo evitar problemas de RPC en MetaMask

La prevención se reduce sobre todo a cuidar los endpoints. Añade las redes a través de ChainList o de la documentación oficial en lugar de tutoriales aleatorios, guarda una URL de RPC de respaldo para cada cadena que uses con regularidad y plantéate obtener una clave personal gratuita de un proveedor como Infura o Alchemy para dejar de competir por la capacidad pública compartida.

El mantenimiento rutinario es igual de importante. Mantén actualizadas la extensión y la aplicación móvil, borra los datos de actividad tras las transacciones fallidas en lugar de dejar que se acumulen errores obsoletos y elimina las redes que ya no uses, ya que cada entrada inactiva es un futuro error a la espera de un clic accidental.

Conclusiones

El error Internal JSON-RPC parece alarmante, pero casi nunca indica una pérdida de fondos, sino una conversación rota entre tu wallet y un nodo. Comprobar los datos de la red, cambiar de endpoint, añadir fondos para el gas y actualizar el software resuelve la inmensa mayoría de los casos sin necesidad de recurrir al soporte.

A medida que MetaMask sigue ampliándose a más cadenas, saber gestionar tú mismo las conexiones RPC se está convirtiendo en una habilidad básica con el wallet. Guarda ChainList en favoritos, aprende los códigos de error anteriores y, si estás valorando alternativas, nuestra guía de los mejores wallets cripto compara cómo resuelven los mismos problemas las distintas opciones.