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

El error interno de JSON-RPC indica que MetaMask envió una solicitud a un nodo de blockchain y recibió un fallo en lugar de una respuesta utilizable. Internamente se corresponde con el código de error -32603 en la referencia JSON-RPC de MetaMask, un comodín que el protocolo reserva para cargas útiles erróneas o inválidas.

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

Desde que MetaMask se convirtió en una multichain wallet que abarca Ethereum, Solana, Bitcoin y TRON, el error también ha comenzado a aparecer en solicitudes Non-EVM que las versiones anteriores centradas solo en Ethereum nunca realizaban. Las soluciones a continuación cubren tanto las causas clásicas como las más nuevas introducidas por ese rediseño.

Cómo solucionar el error interno de JSON-RPC

La mayoría de los casos se deben a una configuración rota en lugar de a un problema más profundo de la wallet, por lo que seguir las comprobaciones en orden resolverá el error rápidamente.

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

1. Configuración de red: Abre el menú de red, edita la cadena con errores y confirma su URL de RPC y Chain ID con la documentación oficial, o vuelve a agregarla automáticamente a través de ChainList.
2. Saldo de gas: Mantén una cantidad suficiente del token nativo de la red, como ETH, BNB o POL, antes de volver a intentarlo, y consulta primero las tarifas en tiempo real con nuestro rastreador de gas de Ethereum.
3. Actualización de la wallet: Instala la última extensión o versión móvil, ya que la arquitectura de cuentas multichain de MetaMask llegó en la Extensión 13.5 y Móvil 7.57, y las versiones anteriores interpretan mal las respuestas nuevas.
4. Endpoint de RPC: Cambia un endpoint lento o inactivo por una alternativa de ChainList o un proveedor dedicado como Infura o Alchemy, y luego vuelve a intentar la transacción fallida.
5. Hardware wallets: Actualiza el firmware de Ledger o Trezor, habilita los datos de contratos inteligentes en la aplicación de Ethereum del dispositivo y vuelve a conectar a través del método de conexión que la guía de solución de problemas de Ledger recomienda actualmente.
6. Restablecimiento de cuenta: Utiliza borrar datos de la pestaña de actividad en la configuración avanzada para eliminar el historial de transacciones en caché y los nonces atascados, lo que obliga a MetaMask a volver a sincronizarse limpiamente con el nodo.
7. Verificación de testnet: Confirma que la testnet a la que apuntas todavía existe, porque Holesky se cerró después de la actualización de 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 profundos, incluidos registros de estado que su equipo de soporte puede revisar directamente. Los fallos persistentes en una sola dApp suelen significar que el problema radica en las llamadas a contratos de esa aplicación y no en tu wallet, así que prueba otro sitio antes de escalar el problema.

Cómo añadir correctamente un RPC usando ChainList

Los detalles del RPC introducidos manualmente siguen siendo la causa más común de este error, ya que un solo carácter incorrecto en una URL o Chain ID invalida cada solicitud que el wallet envía posteriormente. ChainList elimina ese riesgo al mantener endpoints verificados para cientos de redes y añadirlos a MetaMask con un solo clic.

Utilizamos el mismo flujo en nuestra guía para añadir HyperEVM a MetaMask, por lo que los pasos a continuación se aplican a casi cualquier red EVM, desde importantes redes Layer 2 hasta mainnets totalmente nuevas. Cuatro pasos te llevan desde una lista de redes vacía hasta una conexión verificada.

1. Conectar MetaMask a ChainList

ChainList lee los parámetros de red de un registro mantenido por la comunidad, por lo que conectar tu wallet le permite escribir esos detalles verificados directamente en MetaMask sin necesidad de copiarlos manualmente.

Así es como puedes vincular tu wallet al sitio web:

1. Abrir ChainList: Ve a chainlist.org y revisa cuidadosamente la ortografía de la barra de direcciones antes de conectar, ya que han circulado versiones clonadas del sitio con endpoints RPC maliciosos preconfigurados.
2. Conectar wallet: Haz clic en el botón Conectar wallet en la esquina superior derecha, selecciona MetaMask entre las opciones y aprueba la solicitud de conexión que aparece en la ventana emergente de la extensión.
3. Revisar permisos: El sitio solo necesita acceso de lectura para enviar los detalles de la red, así que rechaza cualquier aviso que solicite firmas, aprobaciones de tokens o permisos de gasto de cualquier tipo.

2. Buscar la red correcta

La mayoría de las cadenas ofrecen múltiples 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 dar con la entrada correcta:

1. Buscar con precisión: Escribe el nombre exacto de la red, ya sea Base, Linea o una cadena más nueva como Monad, y activa el interruptor de testnets únicamente cuando necesites una.
2. Verificar identificadores: Compara el Chain ID mostrado con la documentación oficial del proyecto, ya que las redes fraudulentas a veces reutilizan nombres familiares mientras apuntan a cadenas completamente diferentes por debajo.
3. Atención a las testnets: Para las pruebas en Ethereum, utiliza Sepolia para dApps y Hoodi para el trabajo de validadores, ya que la Fundación Ethereum retiró Holesky y sus listados ya no funcionan.

3. Añadir el RPC a MetaMask

Una vez que aparece la red correcta, ChainList transfiere la configuración completa a MetaMask en una sola solicitud, lo que elimina los errores tipográficos que propicia la entrada manual.

Completa la transferencia con estas tres rápidas acciones:

1. Añadir red: Pulsa Añadir a 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. Revisar la ventana emergente: Lee la ventana de MetaMask que muestra la URL del RPC, el Chain ID, el símbolo de la moneda y el explorador de bloques, y luego compara cada valor antes de otorgar tu aprobación final.
3. Cambiar de red: Aprueba la adición y selecciona Cambiar red cuando se te solicite, lo que hace que la nueva cadena esté activa de inmediato y lista para una pequeña transacción de prueba.

4. Verificar la configuración posteriormente

Incluso las entradas verificadas se desvían con el tiempo a medida que los proveedores retiran los puntos de acceso (endpoints), por lo que una revisión rápida en MetaMask confirma que todo llegó correctamente y sigue respondiendo hoy.

Ejecute esta comprobación final antes de transferir fondos reales:

1. Abrir configuración: Vaya al selector de red, elija la cadena recién añadida y haga clic en Editar para mostrar todos los parámetros almacenados que MetaMask utilizará para sus solicitudes.
2. Cotejar: Compare la URL RPC, el Chain ID y el símbolo de la moneda con la documentación propia de la red en lugar de con un blog de terceros, una captura de pantalla o un mensaje no oficial de Discord.
3. Rotar puntos de acceso: Si nota las solicitudes lentas o fallan de manera intermitente, reemplace la URL con otra opción de ChainList, ya que ahora MetaMask admite múltiples URLs RPC almacenadas por red.

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

Los fallos de JSON-RPC se reducen a una sola 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 se sitúa junto a los límites de velocidad (rate limits), los errores de análisis y las transacciones rechazadas en dicha tabla.

Entender qué tipo de fallo está experimentando ahorra tiempo, porque cada uno apunta a una solución diferente, desde cambiar los puntos de acceso hasta simplemente esperar a que pase la congestión.

Estas son las razones más comunes por las 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, por lo que el nodo rechaza la carga útil antes de que llegue a ejecutarse.
• Límites de velocidad: Los puntos de acceso públicos gratuitos y los niveles basados en créditos de Infura limitan el volumen de solicitudes, y los periodos de gran actividad como los lanzamientos de tokens empujan a las wallets más allá de esos topes en pocos segundos.
• Nodos desactualizados: Un nodo desincronizado ofrece un estado de cadena obsoleto, lo que produce saldos incorrectos, transacciones estancadas y cotizaciones de swap que fallan en el momento en que MetaMask intenta ejecutarlas.
• Reversiones de contratos: Un contrato inteligente se queda sin gas o se revierte a mitad de ejecución, lo que MetaMask muestra como un fallo de RPC durante el bridging, el staking o las reclamaciones de airdrop de tokens.
• Desajustes de cadena: Algunos puntos de acceso omiten métodos que las redes Layer 2 requieren, por lo que los swaps o despliegues fallan en esas cadenas incluso cuando el Chain ID es correcto.
• Testnets inactivas: 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 a las solicitudes en esos puntos de acceso obsoletos.
• Llamadas por lotes: Las funciones de cuentas inteligentes de EIP-7702 agrupan varias acciones en una sola transacción, y un solo paso que se revierte dentro del lote puede hacer que falle toda la solicitud agrupada.

Algunos de estos aspectos están bajo su control y otros no. La elección del punto de acceso, los saldos de gas y las versiones de software se pueden solucionar en cuestión de minutos, mientras que las interrupciones del proveedor y la congestión de la red simplemente requieren paciencia o un cambio temporal a un RPC diferente hasta que las condiciones se recuperen.

Cómo las actualizaciones recientes de MetaMask cambiaron la solución de problemas de RPC

MetaMask se ve muy diferente de la wallet que sufrió este error por primera vez. Entre 2025 y 2026 absorbió la compatibilidad con Solana, Bitcoin, TRON, Sei y Monad, reconstruyó su sistema de cuentas y lanzó actualizaciones de cuentas inteligentes, todo lo cual redefinió dónde y cómo aparecen los fallos de RPC.

Las cuentas multicadena fusionan cada red en una sola

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 solo nombre, y la wallet enruta las solicitudes automáticamente. Un fallo en una red ya no significa que toda su wallet esté rota, así que pruebe siempre una segunda cadena antes de asumir que hay corrupción.

Las cadenas Non-EVM utilizan su propia infraestructura de nodos, por lo que una caída en Solana produce síntomas diferentes a una en Ethereum, incluso dentro de la misma interfaz. Cuando los errores afectan a un solo ecosistema, es probable que se deba a problemas con el punto de acceso en esa red específica y no a un fallo en su instalación.

Las cuentas inteligentes añaden una nueva superficie de fallos

La actualización Pectra de Ethereum activó EIP-7702 en mayo de 2025, lo que permite que las cuentas ordinarias de MetaMask se comporten temporalmente como contratos inteligentes para transacciones por lotes y patrocinio de gas. Estas operaciones agrupadas se enrutan a través de infraestructura adicional y, cuando un bundler o paymaster funciona mal, el wallet a menudo lo reporta 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, rechace el aviso de smart account e inténtelo de nuevo como una transacción estándar. Eso aísla si el problema reside en el flujo de delegación o en la conexión RPC subyacente que solucionaría normalmente.

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

La Ethereum Foundation retiró Holesky después de que finalizara la actualización Fusaka, reemplazándola por Hoodi para las pruebas de validadores y recomendando Sepolia para el trabajo con contratos inteligentes. Cualquier configuración de Holesky aún guardada en MetaMask ahora arroja errores JSON-RPC en cada solicitud, y ningún ajuste de configuración la revivirá.

Los desarrolladores deben eliminar por completo las entradas de testnet obsoletas y volver a añadir las actuales a través de ChainList. Sepolia sigue siendo la opción predeterminada para las pruebas de dApp, mientras que ya se planifica un sucesor de Sepolia, por lo que cabe esperar que este ciclo de descontinuaciones de testnets siga produciendo errores RPC fantasma cada pocos años.

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

MetaMask a menudo oculta el código numérico dentro de los detalles del error, pero expandirlos le indica exactamente qué categoría de falla ocurrió. Comparar el código con la tabla de referencia de MetaMask convierte un mensaje vago en un diagnóstico específico y por lo general apunta directamente a la solución correcta.

Un puñado de códigos representan casi todas las fallas que los usuarios reportan, por lo que reconocerlos a simple vista hace que la solución de problemas sea drásticamente más rápida que adivinar a ciegas cada vez.

Estos son los códigos que vale la pena memorizar y sus significados:

• Código -32603: El clásico error interno, provocado por una carga útil incorrecta o no válida, y el código que se encuentra detrás de la mayoría de las apariciones de este mensaje de error exacto de MetaMask.
• Código -32000: Entrada no válida, por lo general parámetros faltantes o un bloque que el nodo aún no ha procesado, lo que a menudo se soluciona después de cambiar a un endpoint RPC más saludable.
• Código -32005: Límite excedido, lo que significa que sus solicitudes superaron el tope del proveedor, así que reduzca la velocidad, espere un minuto o simplemente cámbiese a un endpoint público menos congestionado.
• Código -32602: Argumento no válido, típicamente un error de formato como la falta de un prefijo 0x, que apunta al código de la dApp en lugar de a su propio wallet o configuración de red.
• Código -32601: Método no encontrado, lo que significa que el endpoint no admite lo que MetaMask solicitó, un problema frecuente en endpoints RPC públicos mínimos que dan servicio a cadenas más nuevas.
• Código 429: Un error de rendimiento HTTP en lugar de uno JSON-RPC, que muestra que el proveedor mismo le aplicó limitación de velocidad, algo que los planes mejorados o la rotación de endpoints resuelven fácilmente.

Cómo evitar problemas de RPC en MetaMask

La prevención se reduce principalmente a la higiene de los endpoints. Añada redes a través de ChainList o documentación oficial en lugar de tutoriales aleatorios, guarde una URL de RPC de respaldo para cada cadena que use regularmente y considere una clave personal gratuita de un proveedor como Infura o Alchemy para dejar de competir por la capacidad pública compartida.

El mantenimiento rutinario importa tanto como lo demás. Mantenga la extensión y la aplicación móvil actualizadas, borre los datos de actividad después de transacciones fallidas en lugar de dejar que los errores obsoletos se acumulen, y elimine las redes que ya no use, ya que cada entrada muerta es un futuro error a la espera de un clic accidental.

Conclusión

El error interno JSON-RPC parece alarmante, pero casi nunca indica fondos perdidos, solo una conversación rota entre su wallet y un nodo. Verificar los detalles de la red, cambiar los endpoints, fondear gas y actualizar el software resuelve la gran mayoría de los casos sin necesidad de intervención de soporte.

A medida que MetaMask continúa expandiéndose por las cadenas, saber cómo administrar las conexiones RPC por su cuenta se está convirtiendo en una habilidad fundamental del wallet. Marque ChainList, aprenda los códigos de error anteriores y, si está sopesando alternativas, nuestra guía sobre los best crypto wallets compara cómo las opciones de la competencia manejan los mismos problemas.