¿Qué es un nodo RPC MATIC y cómo te conectas a Polygon Mainnet?

Lista de verificación para decidir sobre un nodo RPC MATIC

Antes de conectar un endpoint a una wallet, dApp o backend, decide lo siguiente:

• ¿A qué red te diriges? Polygon Mainnet usa el ID de cadena 137; la testnet es Amoy (ID de cadena 80002). No son intercambiables.
• ¿Necesitas WebSocket? Las wallets y los indexadores a menudo usan pub/sub para transacciones pendientes y nuevos bloques; no todos los RPC públicos exponen una URL WSS estable.
• ¿Qué métodos llaman tus usuarios? Los métodos estándar eth_* cubren la mayoría de las aplicaciones. Los métodos de debug/trace y el estado de archivo a menudo requieren un endpoint de pago o dedicado.
• ¿Cuál es tu patrón de tráfico? El tráfico ráfaga de un indexador o bot se comporta de manera diferente a la carga constante de una interfaz de usuario; los límites de tasa y los topes de rendimiento importan.
• ¿Necesitas una clave de acceso o rotación de URL? Los endpoints públicos pueden ser bloqueados o limitados sin previo aviso. Una API RPC gestionada te da una URL estable, claves y conmutación por error.
• ¿Cómo monitorearás las fallas? Planifica un RPC de respaldo para rutas críticas; no dejes que un solo endpoint se convierta en un punto único de falla.

El resto de esta referencia explica la configuración de la cadena, las solicitudes de prueba y los criterios de evaluación para que puedas responder esas preguntas rápidamente.

¿Qué es un nodo RPC MATIC?

Un nodo RPC MATIC es otra forma de decir un nodo completo de Polygon PoS expuesto a través de JSON-RPC. Aunque Polygon ha transicionado su token nativo de gas de MATIC a POL, la cadena "matic" todavía se usa ampliamente en URLs de RPC, nombres de red en wallets y documentación de API. Lo verás en endpoints como https://1rpc.io/matic, https://rpc-mainnet.matic.quiknode.pro, y en conceptos heredados como MATIC RPC.

Cuando alguien busca un "nodo RPC MATIC", generalmente necesita una de tres cosas:

• Una URL para conectar una wallet o dApp a Polygon Mainnet o Amoy.
• Un proveedor de nodos que pueda manejar tráfico de producción sin límites de tasa estrictos.
• Instrucciones para hacer la primera llamada JSON-RPC contra Polygon.

Este artículo se centra en las tres. Si necesitas una comparación más amplia de proveedores de RPC para múltiples redes, consulta Cómo elegir un proveedor de RPC.

Configuración de cadenas de Polygon Mainnet y Amoy

Cuando configuras una red en MetaMask, wagmi o un cliente RPC de backend, la configuración de la cadena debe coincidir. Polygon Mainnet es la cadena EVM de producción con ID de cadena 137. Amoy es la testnet principal, con ID de cadena 80002, y reemplazó a Mumbai después de la deprecación de Mumbai.

La tabla a continuación enumera endpoints de uso común de la documentación de Polygon y registros de cadenas. Son adecuados para pruebas, pero verifica la URL actual, el símbolo del token y la política de límite de tasa antes de confiar en cualquier endpoint público en producción.

Antes de continuar, compara estos valores con cualquier URL de RPC que ya tengas. Un ID de cadena incorrecto es la causa más común de errores de "red incorrecta" en wallets EVM.

Cómo probar un endpoint RPC MATIC con curl

Una verificación de salud rápida para cualquier endpoint RPC de Polygon es eth_blockNumber. Confirma que el nodo está sincronizado y es accesible sin requerir una clave de API en la mayoría de los endpoints.

Usa curl con un cuerpo JSON-RPC:

curl https://polygon-rpc.com \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Una respuesta normal contiene un número de bloque hexadecimal, por ejemplo:

{"jsonrpc":"2.0","id":1,"result":"0x57c0f2d"}

A continuación, compara eth_chainId con el ID de cadena que configuraste:

curl https://polygon-rpc.com \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

El resultado debe ser 0x89 (137) en Mainnet y 0x13880 (80002) en Amoy. Si el ID de cadena devuelto no coincide, estás conectado a la red incorrecta.

Para código de dApp, puedes usar el mismo JSON-RPC a través de un proveedor configurado. Con ethers v6, puedes mantener la configuración de la cadena en un solo lugar:

import { JsonRpcProvider } from "ethers";

const maticRpcNode = "https://polygon-rpc.com";
const provider = new JsonRpcProvider(maticRpcNode, 137, {
  staticNetwork: true
});

const block = await provider.getBlockNumber();
console.log(block);

Nodos RPC MATIC públicos vs gestionados

Un RPC público como los de la tabla anterior es un endpoint compartido operado por un tercero. Funciona para experimentos, proyectos de hackathon e integraciones ligeras de wallets, pero los endpoints públicos generalmente tienen límites de tasa comunitarios y pueden ser limitados durante períodos de congestión.

Los proveedores de RPC gestionados ejecutan nodos de Polygon en tu nombre y los exponen a través de URLs estables. OnFinality, por ejemplo, ofrece acceso RPC a Polygon a través del servicio de API de OnFinality y nodos dedicados. Con un proveedor gestionado típicamente obtienes:

• Una URL HTTPS y WSS estable que puedes compartir con clientes.
• Claves de API para rastrear el uso y depurar problemas.
• Acceso a métodos adicionales (incluyendo debug/trace y datos de archivo en planes compatibles).
• Endpoints redundantes para reducir el riesgo de pérdida de conexión.

Cuando el tráfico crece, puedes pasar de claves de API compartidas a un nodo RPC MATIC dedicado. Los nodos dedicados te dan un endpoint de un solo inquilino, lo que elimina los efectos de vecino ruidoso, y son útiles para indexadores, validadores y aplicaciones de alto volumen.

La elección depende de tu carga de trabajo, no solo de "gratis vs de pago". Un frontend de DEX de alto tráfico y un script de testnet tienen necesidades diferentes. Si quieres una comparación sistemática, lee Cómo elegir un proveedor de RPC.

Cómo evaluar un nodo RPC MATIC

Usa la siguiente tabla para comparar cualquier nodo RPC MATIC, ya sea público o gestionado. Ten en cuenta la lista de verificación mientras pruebas candidatos.

Errores comunes de RPC MATIC

• ID de cadena incorrecto: Reutilizar la configuración de Ethereum Mainnet en una wallet de Polygon causa errores de "red incorrecta". Verifica dos veces 0x89 vs 0x1.
• Mezclar testnet y mainnet: Después del retiro de Mumbai, la mayoría de los tutoriales de testnet usan Amoy (80002). El código que hardcodea Mumbai fallará.
• Asumir que los endpoints públicos son nodos de archivo: Los RPC públicos generalmente sirven solo el estado reciente. Consultar bloques antiguos puede devolver errores de nodo trie faltante.
• Límites de tasa que aparecen como tiempos de espera: Algunos endpoints devuelven 429, otros cortan conexiones sin un error claro. Envuelve las llamadas en lógica de reintento con backoff.
• Sin respaldo de WebSocket: Si tu aplicación requiere datos en tiempo real, necesitas soporte tanto HTTPS como WSS. No todos los endpoints proporcionan ambos.
• Confusión del símbolo del token: Después de la migración de MATIC a POL, las transacciones y el gas se denominan en POL. Una aplicación que muestra "MATIC" como único símbolo puede confundir a los usuarios, aunque "MATIC" sigue siendo el ticker utilizado en muchas URLs de endpoints RPC y wallets de terceros.

Conclusiones clave

• Un nodo RPC MATIC es un nodo de Polygon PoS expuesto vía JSON-RPC; "MATIC" aparece en muchas URLs de endpoints aunque la red ahora use POL como token de gas.
• Polygon Mainnet usa el ID de cadena 137; la testnet Amoy usa 80002.
• Los endpoints públicos son buenos para desarrollo, pero difíciles de usar para tráfico de producción debido a límites de tasa y restricciones de métodos.
• Gestiona tu propio failover: prueba eth_chainId, eth_blockNumber y suscripciones WSS antes del lanzamiento.
• Cuando necesites límites predecibles, métodos de archivo o capacidad dedicada, evalúa proveedores de RPC gestionados como el RPC de Polygon y nodos dedicados de OnFinality.
• Compara costos y límites cuidadosamente; consulta los detalles actuales en precios de RPC y redes RPC compatibles.

Preguntas frecuentes

¿Para qué se usa un nodo RPC MATIC?

Un nodo RPC MATIC se usa para leer datos de la blockchain de Polygon y enviar transacciones desde dApps, wallets, indexadores y servicios backend. El nombre proviene del ticker MATIC, que sigue siendo común en URLs de RPC como 1rpc.io/matic.

¿Es suficiente un endpoint RPC gratuito de Polygon?

Los endpoints públicos gratuitos funcionan para desarrollo y proyectos pequeños, pero generalmente tienen límites de tasa y pueden no soportar métodos de archivo, debug o trace. Para cualquier cosa que dependa de baja latencia, alto volumen o datos históricos, una API RPC gestionada es más segura.

¿Cómo obtengo una URL RPC de Polygon?

Puedes usar un endpoint público de la documentación de Polygon o crear uno desde un proveedor. Los proveedores te dan una URL, a menudo con una clave, para la cadena Mainnet o Amoy. OnFinality expone RPC de Polygon a través de su servicio de API; consulta la página de red Polygon para endpoints y métodos actuales.

¿OnFinality soporta RPC de testnet de Polygon?

Debes consultar la lista de redes compatibles para ver la cobertura actual de testnets. Si el RPC de Amoy está disponible, la configuración anterior usa el ID de cadena 80002.

¿Cuál es la diferencia entre MATIC y POL?

Polygon expandió MATIC a POL como un token unificado de gas y staking, pero muchas rutas de endpoints RPC y etiquetas de wallets aún dicen "matic". El ID de cadena, no el símbolo del token, determina a qué red te conectas.

¿Por qué me están limitando la tasa en un RPC de Polygon?

Los endpoints públicos compartidos tienen límites comunitarios; si los golpeas con solicitudes paralelas, eventualmente serás limitado. Un nodo RPC dedicado o un proveedor gestionado con un nivel superior te da más margen.