Amoy Polygon: ¿Qué es y cuándo deberías usarlo?

Amoy Polygon es la testnet actual de Polygon proof-of-stake (PoS). Si has estado buscando "amoy polygon" después de ver un aviso de deprecación en Mumbai, la versión corta es: Amoy reemplazó a Mumbai como la testnet canónica de Polygon, usa chain ID 80002 y ejecuta el mismo stack de cliente Bor/Heimdall que Polygon mainnet. Eso significa que los contratos, las herramientas y los métodos RPC se comportan casi idénticamente a producción, que es exactamente lo que quieres de una testnet.

Esta página responde qué es Amoy y luego te ayuda a decidir cómo conectarte a él. Si ya sabes que necesitas un endpoint, salta a la tabla de configuración de la cadena y a los ejemplos de conexión. Si todavía estás evaluando si Amoy es la red adecuada para tu flujo de trabajo, comienza con la sección de idoneidad a continuación.

Cuándo Amoy es la red adecuada para tu trabajo

Amoy es una testnet, así que la decisión no se trata tanto de "¿es esta una buena infraestructura?" sino de "¿es esta la red correcta para la tarea que tengo delante?". Usa lo siguiente como un filtro rápido.

Si tu tarea está en la mitad superior de esa tabla, Amoy es la red correcta. Si está en la mitad inferior, querrás Polygon mainnet, que OnFinality también soporta a través de su página de red Polygon.

Configuración de la cadena Amoy Polygon de un vistazo

Estos son los valores que necesitas para agregar Amoy a una billetera, una configuración de Hardhat o un servicio backend. Mantenlos consistentes en todos los entornos para evitar errores sutiles.

El chain ID es el valor que la gente suele equivocar con más frecuencia. Mumbai usaba 80001; Amoy usa 80002. Si una herramienta apunta silenciosamente al chain ID incorrecto, las transacciones pueden parecer exitosas localmente mientras fallan contra la red que realmente pretendías.

Conectarse a Amoy a través de un endpoint RPC

Un endpoint RPC es la dirección HTTP o WebSocket que tu billetera, script o backend usa para leer y escribir en la cadena. OnFinality expone un endpoint público de Amoy que puedes usar para pruebas ligeras:

https://polygon-amoy.api.onfinality.io/public

Para cualquier cosa más allá de pruebas manuales ocasionales, deberías usar una clave API o un nodo dedicado en lugar del endpoint público compartido. Los endpoints públicos tienen límite de velocidad y se comparten entre muchos usuarios, lo que los hace inadecuados para pipelines de CI, indexadores o cualquier cosa que consulte con frecuencia.

Verificación rápida con curl

La forma más rápida de confirmar que un endpoint está activo y devuelve la cadena que esperas es una llamada eth_chainId:

curl -s https://polygon-amoy.api.onfinality.io/public \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Una respuesta correcta devuelve 0x13882, que es 80002 en decimal. Si obtienes un valor diferente, estás hablando con la red incorrecta.

Configuración de MetaMask y billeteras

En MetaMask, agrega una red manualmente e ingresa los valores de la tabla anterior. Los dos campos que causan más confusión son el chain ID (80002) y el símbolo de la moneda (POL, no MATIC). Los tutoriales más antiguos todavía listan MATIC porque el token fue renombrado, pero las nuevas configuraciones de red deberían usar POL.

Ejemplo de JavaScript con ethers

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider(
  "https://polygon-amoy.api.onfinality.io/public",
  { chainId: 80002, name: "polygon-amoy" }
);

const block = await provider.getBlockNumber();
console.log("Amoy head block:", block);

Pasar el chain ID explícitamente permite que ethers detecte un desajuste temprano en lugar de fallar más tarde con un error confuso.

Obtener POL de testnet desde un faucet

Amoy usa POL para gas, así que necesitas POL de testnet antes de poder desplegar o enviar transacciones. Los faucets para Amoy suelen estar restringidos por una verificación de saldo de billetera o un pequeño paso de verificación social para reducir el abuso. El flujo general es:

1. Agrega Amoy a tu billetera usando la configuración anterior.
2. Copia la dirección de tu billetera.
3. Solicita POL de testnet desde un faucet de Polygon Amoy.
4. Confirma que el saldo llegue antes de ejecutar despliegues.

La disponibilidad de los faucets y las cantidades que entregan cambian con el tiempo, así que trata cualquier URL de faucet específica como algo que debes verificar en lugar de una constante permanente. Si un faucet está seco, las causas habituales son una IP compartida, una billetera que ya ha reclamado recientemente o una interrupción temporal del propio faucet.

Modos de fallo comunes y cómo depurarlos

La mayoría de los problemas de Amoy son problemas de configuración, no problemas de red. La siguiente tabla relaciona síntomas con causas probables.

Si estás migrando desde Mumbai, el problema más común es un chain ID obsoleto o una URL RPC de Mumbai codificada en un archivo de configuración. Busca en tu repositorio 80001 y mumbai antes de asumir que la red está rota.

Endpoint público vs RPC gestionado vs nodo dedicado

Una vez que Amoy funciona localmente, la siguiente decisión es dónde ejecutarlo para tu equipo. Las tres opciones comunes difieren principalmente en cuánto control y aislamiento necesitas.

OnFinality ofrece tanto acceso RPC gestionado a través de su servicio API como nodos dedicados a través de Nodo Dedicado. Para la mayoría de los equipos que prueban en Amoy, un endpoint gestionado con una clave API es el punto de partida correcto. Pasa a un nodo dedicado cuando necesites rendimiento constante, suscripciones WebSocket a escala o aislamiento de otros usuarios.

Si estás comparando proveedores de manera más amplia, la guía de selección de proveedor RPC cubre los criterios de evaluación con más profundidad, y Precios de RPC explica cómo se suele medir el uso.

Migrar de Mumbai a Amoy

Mumbai está obsoleto, así que si todavía tienes referencias a Mumbai en tu base de código, planifica una migración. Los pasos suelen ser pequeños pero fáciles de pasar por alto:

1. Reemplaza el chain ID 80001 por 80002 en todos los lugares donde aparezca.
2. Reemplaza las URL RPC de Mumbai por un endpoint de Amoy.
3. Actualiza la URL del explorador de bloques a https://amoy.polygonscan.com.
4. Vuelve a solicitar POL de testnet desde un faucet de Amoy.
5. Vuelve a desplegar contratos y ejecuta de nuevo las pruebas de integración.
6. Actualiza cualquier dirección de contrato codificada, ya que diferirán en Amoy.

Una búsqueda rápida de mumbai, 80001 y maticmum normalmente revelará cada lugar que necesita atención.

Lista de verificación operativa para equipos que usan Amoy

Antes de tratar Amoy como una parte estable de tu flujo de trabajo, confirma lo siguiente:

• Cada entorno (local, CI, staging) apunta al mismo chain ID y endpoint.
• Los secretos como las claves API se almacenan en variables de entorno, no se confirman.
• Tu cliente tiene lógica de reintento y tiempo de espera para fallos RPC transitorios.
• Los clientes WebSocket se reconectan automáticamente después de desconexiones.
• Tienes un endpoint de respaldo en caso de que el principal no esté disponible.
• La monitorización alerta sobre llamadas RPC fallidas, no solo sobre errores de aplicación.

Estos son los mismos hábitos que necesitarás en Polygon mainnet, así que construirlos en Amoy da sus frutos más adelante. La página de redes RPC compatibles de OnFinality lista las redes disponibles si quieres ejecutar la misma configuración en testnet y mainnet.

Puntos clave

• Amoy es la testnet actual de Polygon PoS, que reemplaza a la red obsoleta Mumbai.
• Usa chain ID 80002, POL como token de gas nativo y el stack de cliente Bor/Heimdall.
• El endpoint público de Amoy de OnFinality es adecuado para pruebas ligeras, pero la infraestructura gestionada o dedicada es mejor para CI, indexadores y cargas de trabajo similares a producción.
• La mayoría de los problemas de Amoy son problemas de configuración: chain ID incorrecto, falta de POL de testnet o una URL de Mumbai obsoleta.
• Migrar desde Mumbai significa principalmente actualizar chain IDs, endpoints, URL de explorador y direcciones de contratos.

Preguntas frecuentes

¿Qué es Amoy Polygon?

Amoy es la testnet proof-of-stake de Polygon. Reemplazó a Mumbai y ejecuta el mismo software de cliente que Polygon mainnet, por lo que los contratos y las herramientas se comportan de manera similar sin arriesgar activos reales.

¿Cuál es el chain ID de Amoy Polygon?

Amoy usa chain ID 80002. Esto es diferente del 80001 de Mumbai, y confundirlos es una fuente común de errores.

¿Cuál es el endpoint RPC de Amoy Polygon?

OnFinality proporciona un endpoint público de Amoy en https://polygon-amoy.api.onfinality.io/public. Para uso regular, se recomienda una clave API o un nodo dedicado en lugar del endpoint público compartido.

¿Amoy es lo mismo que Polygon mainnet?

No. Amoy es una testnet sin valor real. Refleja el comportamiento de mainnet lo suficientemente bien para desarrollo y pruebas, pero nunca debes tratar los tokens o el estado de testnet como datos de producción.

¿Cómo obtengo POL de testnet en Amoy?

Usa un faucet de Polygon Amoy. La disponibilidad y las cantidades que entregan cambian, así que verifica el faucet actual antes de depender de él en un flujo de trabajo.

¿Puedo usar Amoy para pruebas de carga?

No. Las testnets no reflejan el rendimiento de mainnet ni el comportamiento de los validadores. Usa Amoy para pruebas de corrección y un entorno similar a mainnet para trabajo de rendimiento.

¿Qué reemplazó a Mumbai?

Amoy reemplazó a Mumbai como la testnet canónica de Polygon. Si todavía tienes referencias a Mumbai, migralas a Amoy.