¿Qué es el error Internal 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, 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 no válidas.

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

Desde que MetaMask se convirtió en una wallet multichain que abarca Ethereum, Solana, Bitcoin y TRON, el error también ha comenzado a aparecer en solicitudes non-EVM que las versiones más antiguas, solo para Ethereum, nunca realizaban. Las soluciones 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 JSON-RPC

La mayoría de los casos se remontan a una configuración defectuosa en lugar de un problema más profundo de la wallet, por lo que seguir los pasos de verificación a continuación en orden resuelve el error rápidamente.

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

1. Configuración de red: Abra el menú de red, edite la cadena que está fallando y confirme su URL de RPC y Chain ID con la documentación oficial, o vuelva a añadirla automáticamente a través de ChainList.
2. Saldo de gas: Disponga de suficientes tokens nativos de la red, como ETH, BNB o POL, antes de reintentar, y consulte primero las tarifas en tiempo real con nuestro Ethereum gas tracker.
3. Actualización de wallet: Instale la última extensión o versión móvil, ya que la arquitectura de cuenta multichain de MetaMask llegó en la Extensión 13.5 y la Móvil 7.57, y las versiones anteriores interpretan incorrectamente las respuestas más recientes.
4. Endpoint RPC: Cambie un endpoint lento o inactivo por una alternativa de ChainList o un proveedor dedicado como Infura o Alchemy, luego reintente la transacción fallida.
5. Hardware wallets: Actualice el firmware de Ledger o Trezor, habilite los datos de contratos inteligentes en la aplicación de Ethereum del dispositivo y vuelva a conectar mediante el método de conexión que la guía de solución de problemas de Ledger recomienda actualmente.
6. Restablecimiento de cuenta: Utilice la opción 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. Verificación de testnet: Confirme que la testnet a la que se dirige aún existe, porque Holesky fue cerrada 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, incluyendo registros de estado que su equipo de soporte puede revisar directamente. Los fallos persistentes en una única dApp suelen significar que el problema reside en las llamadas a contratos de esa aplicación y no en su wallet, así que pruebe otro sitio antes de escalar el problema.

Cómo añadir correctamente un RPC usando ChainList

Los detalles de RPC introducidos manualmente siguen siendo el desencadenante más común de este error, ya que un carácter incorrecto en una URL o un Chain ID invalida cada solicitud que la wallet envía posteriormente. ChainList elimina ese riesgo al mantener endpoints verificados para cientos de redes e insertarlos en 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 cadena EVM, desde las principales redes Layer 2 hasta las mainnets más recientes. Cuatro pasos le llevarán de una lista de redes vacía a 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 su wallet le permite escribir esos detalles verificados directamente en MetaMask sin necesidad de copia manual.

Así es como puede vincular su wallet al sitio:

1. Abrir ChainList: Vaya a chainlist.org y verifique cuidadosamente la ortografía de la barra de direcciones antes de conectar, porque han circulado versiones clonadas del sitio con endpoints RPC maliciosos precargados.
2. Conectar wallet: Haga clic en el botón Connect Wallet en la esquina superior derecha, elija MetaMask entre las opciones y apruebe la solicitud de conexión que aparece en la ventana emergente de la extensión.
3. Verificar permisos: El sitio solo necesita acceso de visualización para insertar los detalles de la red, así que rechace cualquier solicitud que pida firmas, aprobaciones de tokens o permisos de gasto de cualquier tipo.

2. Busque la Red Correcta

La mayoría de las cadenas distribuyen múltiples versiones, y confundir una mainnet con su testnet conduce a transacciones fallidas, saldos invisibles y nuevos errores JSON-RPC en cuestión de minutos.

Siga estas verificaciones para encontrar la entrada correcta:

1. Busque con precisión: Escriba el nombre exacto de la red, ya sea Base, Linea o una cadena más nueva como Monad, y active el interruptor de testnets solo cuando lo necesite.
2. Verifique los identificadores: Compare 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. Tenga en cuenta las testnets: Para pruebas de Ethereum, use Sepolia para dApps y Hoodi para el trabajo de validador, porque 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 entrega la configuración completa a MetaMask en una sola solicitud, lo que elimina los errores tipográficos que la entrada manual puede generar.

Complete la transferencia con estas tres acciones rápidas:

1. Añadir red: Presione Añadir a MetaMask junto a la entrada con la mejor puntuación de latencia, ya que ChainList clasifica cada endpoint público por velocidad y fiabilidad medidas en tiempo real.
2. Revise la ventana emergente: Lea la ventana de MetaMask que muestra la URL RPC, el Chain ID, el símbolo de la moneda y el explorador de bloques, luego compare cada valor antes de otorgar su aprobación final.
3. Cambiar: Apruebe la adición y seleccione Cambiar Red cuando se le solicite, lo que hace que la nueva cadena esté activa de inmediato y lista para una pequeña transacción de prueba.

4. Verifique la configuración después

Incluso las entradas verificadas pueden cambiar con el tiempo a medida que los proveedores retiran los endpoints, por lo que una revisión rápida dentro de MetaMask confirma que todo se configuró correctamente y sigue respondiendo hoy.

Realice esta verificación final antes de mover 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 cada parámetro almacenado que MetaMask utilizará para sus solicitudes.
2. Verifique con referencias cruzadas: 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 un blog de terceros, una captura de pantalla o un mensaje no oficial de Discord.
3. Rotar endpoints: Si las solicitudes se sienten lentas o fallan intermitentemente, reemplace la URL con otra opción de ChainList, ya que MetaMask ahora admite múltiples URL de RPC almacenadas por red.

¿Por qué ocurre el error JSON-RPC?

Las fallas 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 JSON-RPC distintos, y la variedad interna se encuentra junto a los límites de tasa, errores de análisis y transacciones rechazadas en esa tabla.

Comprender qué modo de falla está experimentando ahorra tiempo, porque cada uno apunta a una solución diferente, desde cambiar endpoints 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 de 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 la ejecución.
• Límites de tasa: Los endpoints públicos gratuitos y los niveles basados en créditos de Infura limitan el volumen de solicitudes, y los períodos de alta actividad, como los lanzamientos de tokens, empujan a las wallets más allá de esos límites en pocos segundos.
• Nodos obsoletos: Un nodo desincronizado sirve un estado de cadena obsoleto, produciendo saldos incorrectos, transacciones atascadas y cotizaciones de swap que fallan en el momento en que MetaMask intenta ejecutarlas.
• Reversiones de contrato: Un contrato inteligente se queda sin gas o revierte a mitad de la ejecución, lo que MetaMask muestra como una falla de RPC durante el bridging, staking o las reclamaciones de airdrop de tokens.
• Desajustes de cadena: Algunos endpoints 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 testnets retiradas como Holesky o la antigua Goerli fallan instantáneamente, porque ya no hay nodos activos que respondan a las solicitudes en esos endpoints deprecados.
• Llamadas por lotes: Las características de cuenta inteligente de EIP-7702 agrupan varias acciones en una sola transacción, y un solo paso de reversión dentro del lote puede hacer que falle toda la solicitud agrupada.

Algunas de estas están bajo su control y otras no. La elección del endpoint, los saldos de gas y las versiones de software se pueden solucionar en 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 resolución de problemas de RPC

MetaMask se ve muy diferente de la wallet que este error afectó por primera vez. Entre 2025 y 2026 absorbió el soporte para Solana, Bitcoin, TRON, Sei y Monad, reconstruyó su sistema de cuentas e implementó actualizaciones de cuentas inteligentes, todo lo cual redefinió dónde y cómo aparecen las fallas de RPC.

Las cuentas multi-chain 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, con la wallet enrutando las solicitudes automáticamente. Una falla en una red ya no significa que toda su wallet esté rota, así que siempre pruebe una segunda cadena antes de asumir una corrupción.

Las cadenas Non-EVM utilizan su propia infraestructura de nodos, por lo que una interrupción de Solana produce síntomas diferentes a los de Ethereum incluso dentro de la misma interfaz. Cuando los errores afectan solo a un ecosistema, un problema de endpoint en esa red específica es la causa probable, en lugar de algo incorrecto en su instalación.

Las cuentas inteligentes añaden una nueva superficie de falla

La actualización Pectra de Ethereum activó EIP-7702 en mayo de 2025, permitiendo 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 se comporta mal, la 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 la solicitud de cuenta inteligente y reintente 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 normalmente solucionaría.

La reestructuración de la testnet de Ethereum rompió configuraciones antiguas

La Fundación Ethereum retiró Holesky después de que finalizara la actualización Fusaka, reemplazándolo con Hoodi para pruebas de validadores mientras recomendaba 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 lo revivirá.

Los desarrolladores deberían eliminar por completo las entradas obsoletas de la testnet y volver a añadir las actuales a través de ChainList. Sepolia sigue siendo la opción predeterminada para las pruebas de dApps, mientras que ya se está planificando un sucesor de Sepolia, así que espere que este ciclo de deprecaciones de testnet siga produciendo errores RPC fantasma cada pocos años.

Cómo leer 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 al expandirlos se revela exactamente qué categoría de fallo ocurrió. Verificar el código con la tabla de referencia de MetaMask convierte un mensaje vago en un diagnóstico específico y generalmente apunta directamente a la solución correcta.

Un puñado de códigos explican casi todos los fallos que reportan los usuarios, por lo que reconocerlos a primera vista hace que la resolución de problemas sea drásticamente más rápida que adivinar a ciegas cada vez.

Aquí están los códigos que vale la pena memorizar y sus significados:

• Código -32603: El error interno clásico, provocado por una carga útil (payload) incorrecta o inválida, y el código que subyace a la mayoría de las apariciones de este mensaje de error exacto de MetaMask.
• Código -32000: Entrada inválida, generalmente parámetros faltantes o un bloque que el nodo aún no ha procesado, lo que a menudo se resuelve al cambiar a un endpoint RPC más saludable.
• Código -32005: Límite excedido, lo que significa que sus solicitudes superaron el límite del proveedor, así que reduzca la velocidad, espere un minuto o simplemente cambie a un endpoint público menos congestionado.
• Código -32602: Argumento inválido, típicamente un error de formato como un prefijo 0x faltante, lo que apunta al código de la dApp en lugar de a su propia wallet o configuración de red.
• Código -32601: Método no encontrado, lo que significa que el endpoint no soporta lo que MetaMask solicitó, un problema frecuente en endpoints RPC públicos mínimos que sirven a cadenas más nuevas.
• Código 429: Un error de rendimiento HTTP en lugar de uno de JSON-RPC, que indica que el propio proveedor lo ha limitado, lo que los planes actualizados 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 RPC de respaldo para cada cadena que use regularmente, y considere una clave personal gratuita de un proveedor como Infura o Alchemy para que deje de competir por la capacidad pública compartida.

El mantenimiento rutinario es igual de importante. 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 se acumulen errores obsoletos, y elimine las redes que ya no utiliza, ya que cada entrada inactiva es un error futuro esperando un clic accidental.

Consideraciones finales

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

A medida que MetaMask sigue expandiéndose a través de las cadenas, saber cómo gestionar las conexiones RPC por sí mismo se está convirtiendo en una habilidad CORE de la wallet. Marque ChainList, aprenda los códigos de error anteriores, y si está sopesando alternativas, nuestra guía de las mejores crypto wallets compara cómo las opciones competidoras manejan los mismos problemas.