Resumen
Polygon Mainnet es la cadena proof-of-stake compatible con EVM identificada por el chain ID 137. Si buscaste "polygon mainnet", lo más probable es que necesites conectar una wallet, una dApp o un servicio backend y quieras la configuración correcta de la cadena y un endpoint RPC funcional sin adivinar.
Esta página te da primero la configuración de la cadena, luego un endpoint público de OnFinality que puedes probar de inmediato y después las comprobaciones que separan una demo rápida de una conexión lista para producción. También explica cuándo un endpoint público es suficiente y cuándo tiene más sentido un nodo dedicado o un plan de RPC gestionado.
Polygon Mainnet no es lo mismo que Polygon Amoy, la testnet. Mantén ambas separadas en tu configuración: el chain ID de mainnet es 137, mientras que Amoy usa 80002. Confundirlas es una de las razones más comunes por las que un despliegue parece conectado pero nunca confirma una transacción.
Puntos clave
- Polygon Mainnet usa el chain ID 137, la moneda nativa POL con 18 decimales y el explorador en polygonscan.com.
- Un endpoint público de OnFinality para Polygon Mainnet es https://polygon.api.onfinality.io/public; es útil para pruebas y lecturas ligeras.
- Las configuraciones de wallet, dApp y backend deben apuntar todas al chain ID 137, no al chain ID 80002 de la testnet Amoy.
- Las cargas de trabajo en producción normalmente necesitan un endpoint gestionado o dedicado con límites de tasa claros, soporte de WebSocket y monitoreo.
- La mayoría de los fallos de conexión se remontan a un chain ID incorrecto, un endpoint obsoleto o limitado por tasa, o un método que el endpoint no soporta.
- OnFinality ofrece acceso a la API RPC de Polygon y opciones de nodos dedicados; consulta la página de la red y la de precios para obtener detalles actuales.
Configuración de Polygon Mainnet de un vistazo
Antes de tocar cualquier código, confirma los cuatro valores que toda herramienta EVM necesita: chain ID, símbolo de moneda, decimales y una URL RPC funcional. Para Polygon Mainnet estos son estables y ampliamente usados, por lo que una discrepancia casi siempre significa un error de copiar y pegar o un valor de testnet olvidado.
La siguiente tabla es la referencia que puedes pegar en una wallet, una configuración de Hardhat o una definición de cadena de viem. Si una herramienta solicita tanto network ID como chain ID, usa 137 para ambos en Polygon Mainnet.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Chain ID | 137 (hex 0x89) | Un chain ID incorrecto envía transacciones a la red equivocada o provoca el rechazo de la wallet. |
| Moneda nativa | POL, 18 decimales | El gas se paga en POL; las configuraciones antiguas que aún dicen MATIC pueden confundir a los usuarios, pero la red es la misma. |
| URL RPC pública de OnFinality | https://polygon.api.onfinality.io/public | Un endpoint rápido para probar lecturas y conexión de wallet. |
| Explorador de bloques | https://polygonscan.com | Úsalo para confirmar transacciones, direcciones de contratos y números de bloque. |
| Transporte | HTTP y WebSocket | HTTP es adecuado para llamadas de solicitud/respuesta; WebSocket es necesario para suscripciones. |
Recomendación rápida: ¿endpoint público o plan gestionado?
Usa el endpoint público de OnFinality cuando estés configurando una wallet, ejecutando un script rápido o comprobando que la dirección de tu contrato resuelve. Es una forma rápida de confirmar la configuración de la cadena sin registrarte en nada.
Pasa a una clave API RPC gestionada o a un nodo dedicado cuando tu aplicación tenga usuarios reales, trabajos en segundo plano o indexadores que consulten Polygon Mainnet continuamente. Los endpoints públicos compartidos no están diseñados para absorber tráfico de producción, y un solo cliente ruidoso puede degradar la experiencia de todos.
Si no estás seguro, empieza con el público, mide tu volumen de solicitudes durante un día y luego decide. La página de precios de RPC y la página de la red Polygon te dan las opciones concretas para comparar.
- Prototipo o configuración de wallet: el endpoint público es suficiente.
- Staging con tráfico realista: clave API RPC gestionada.
- Lecturas de alto volumen, indexadores o escrituras sensibles a la latencia: evalúa nodos dedicados.
- Necesitas suscripciones WebSocket en producción: confirma el soporte de transporte antes de comprometerte.
Conéctate con curl, viem y una wallet
La comprobación rápida más sencilla es una única llamada JSON-RPC. Si eth_chainId devuelve 0x89, estás hablando con Polygon Mainnet. Si devuelve 0x13882, estás en Amoy y necesitas cambiar de endpoint.
Para el código de la aplicación, viem te permite definir una cadena y apuntarla a cualquier URL RPC. Mantén la URL en una variable de entorno para poder alternar entre endpoints públicos, gestionados y dedicados sin editar el código fuente.
curl -X POST https://polygon.api.onfinality.io/public -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'- Espera el resultado 0x89 para Polygon Mainnet.
- En viem, crea un objeto de cadena con id 137 y rpcUrls.default.http configurado con tu endpoint.
- En MetaMask, agrega una red con chain ID 137, símbolo POL y la URL RPC anterior.
Modos de fallo y cómo depurarlos
La mayoría de los problemas de conexión con Polygon Mainnet se engloban en un pequeño conjunto de categorías. Relaciona el síntoma con la causa probable antes de cambiar el código, porque la solución suele ser de configuración y no de lógica.
Si una llamada funciona en curl pero falla en tu aplicación, compara la URL exacta, las cabeceras y el chain ID que usa la aplicación. Las variables de entorno copiadas de una configuración de testnet son un culpable frecuente.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| La wallet muestra la red incorrecta | El chain ID es 137, no 80002 | Amoy es una testnet; las transacciones allí no afectan los saldos de mainnet. |
| eth_call devuelve vacío o revierte | La dirección del contrato y el ABI coinciden con el despliegue en mainnet | Las direcciones de testnet a menudo difieren de las de mainnet. |
| Errores 429 intermitentes o timeouts | El volumen de solicitudes frente a los límites del endpoint | Los endpoints públicos son compartidos; la carga sostenida necesita un plan gestionado. |
| Se caen las suscripciones WebSocket | Soporte de transporte y lógica de reconexión | Las suscripciones de larga duración necesitan un proveedor que soporte ws y un cliente que se reconecte. |
| eth_getLogs agota el tiempo | Tamaño del rango de bloques y especificidad del filtro | Las consultas de logs muy amplias son costosas; reduce el rango o usa un indexador. |
Lista de verificación para producción
Antes de dirigir usuarios reales a un endpoint de Polygon Mainnet, revisa los elementos a continuación. Marcan la diferencia entre una demo que funciona en tu portátil y un servicio que se comporta de manera predecible bajo carga.
Mantén al menos un endpoint de respaldo configurado. Incluso un proveedor bien gestionado puede tener ventanas de mantenimiento, y una URL de respaldo en la configuración de tu cliente convierte una caída total en una degradación breve.
- URL del endpoint almacenada en la configuración de entorno, no codificada directamente.
- Chain ID verificado al inicio para que un entorno mal configurado falle rápido.
- URL RPC de respaldo configurada para rutas de lectura.
- Monitoreo de tasa de errores, latencia y retraso en la altura de bloque.
- Lógica de reconexión WebSocket si usas suscripciones.
- Retención de logs de transacciones fallidas para poder reproducir problemas.
Cuándo pasar de RPC público a la infraestructura de OnFinality
OnFinality proporciona acceso a la API RPC e infraestructura de nodos dedicados para Polygon Mainnet. La API RPC es el siguiente paso natural después del endpoint público: obtienes una URL gestionada y una visión más clara de tu uso. Los nodos dedicados son para equipos que necesitan capacidad aislada o requisitos de transporte específicos.
No tienes que decidirlo todo de una vez. Empieza con el endpoint público, pasa a un plan gestionado cuando crezca el tráfico y evalúa nodos dedicados cuando tu carga de trabajo sea lo suficientemente predecible para dimensionarla. La página de redes RPC compatibles muestra qué más está disponible si ejecutas infraestructura multicadena.
- API RPC gestionada: buena opción por defecto para la mayoría de las aplicaciones en producción.
- Nodo dedicado: mejor para alto rendimiento sostenido o aislamiento estricto.
- Equipos multicadena: mantén convenciones de endpoint consistentes entre redes.
- Confirma siempre el soporte de transporte y los límites actuales en la página de la red.
Preguntas frecuentes
¿Cuál es el chain ID de Polygon Mainnet?
Polygon Mainnet usa el chain ID 137, que en hexadecimal es 0x89. Polygon Amoy, la testnet, usa 80002. Confirma siempre el chain ID que reporta tu wallet o aplicación antes de enviar transacciones.
¿Cuál es la URL RPC pública de OnFinality para Polygon Mainnet?
El endpoint público es https://polygon.api.onfinality.io/public. Soporta HTTP y WebSocket y es adecuado para pruebas y uso ligero. Para tráfico de producción, usa una clave API RPC gestionada o un nodo dedicado.
¿Polygon Mainnet es lo mismo que Polygon PoS?
Polygon Mainnet se conoce comúnmente como Polygon PoS. Es una cadena proof-of-stake compatible con EVM que envía checkpoints a Ethereum. El token nativo de gas es POL, que reemplazó a MATIC en la denominación.
¿Cómo agrego Polygon Mainnet a MetaMask?
Abre la configuración de redes, agrega una red personalizada e introduce el chain ID 137, el símbolo de moneda POL, la URL RPC de OnFinality y https://polygonscan.com como explorador. Guarda y cambia a esa red.
¿Por qué falla mi llamada a Polygon Mainnet con un error de límite de tasa?
Los endpoints públicos son compartidos y tienen límites. Si ves respuestas 429 o timeouts bajo carga, pasa a un plan RPC gestionado o a un nodo dedicado para que tu tráfico tenga su propia capacidad.
Ethereum
Solana
Polygon
Base
Arbitrum
BNB Chain
Polkadot
Optimism
