RPC de la Testnet Polygon Amoy: Endpoints, Configuración de Red y Cómo Conectarse

Referencia rápida: Configuración de la red Polygon Amoy

Antes de conectarte, aquí tienes los detalles esenciales de la red para Polygon Amoy. Estos son los valores que necesitarás al agregar la red a una billetera o configurar tu dApp.

Nota: Los endpoints RPC públicos a menudo tienen límites de tasa y pueden no ser adecuados para producción o pruebas intensivas. Para un acceso confiable, considera un proveedor RPC dedicado como OnFinality.

Por qué Polygon Amoy es importante para los desarrolladores

Polygon Amoy es la testnet oficial de Polygon PoS, lanzada a principios de 2024 para reemplazar la testnet Mumbai obsoleta. Utiliza la testnet Sepolia de Ethereum como su cadena raíz, alineándose con la estrategia de testnets de Ethereum. Para los desarrolladores, Amoy proporciona un entorno de bajo riesgo para implementar y probar contratos inteligentes, dApps e infraestructura antes de pasar a mainnet.

Debido a que Amoy refleja la mainnet de Polygon PoS (ID de cadena 137), puedes probar tu código con confianza, sabiendo que el comportamiento será similar en producción. Esto es especialmente importante para aplicaciones que dependen de características específicas de Polygon, como tiempos de bloque rápidos (2-3 segundos) y bajos costos de transacción.

Cómo conectarse a Polygon Amoy

Conectarse a Polygon Amoy es sencillo. Puedes agregarlo a una billetera como MetaMask o configurar el cliente RPC de tu dApp. Aquí tienes los métodos comunes.

Agregar a MetaMask

1. Abre MetaMask y haz clic en el menú desplegable de redes en la parte superior.
2. Haz clic en "Agregar red" o "Agregar una red manualmente".
3. Ingresa los siguientes detalles:
   • Nombre de la red: Polygon Amoy Testnet
   • Nueva URL RPC: https://polygon-amoy.drpc.org (o el endpoint de tu proveedor)
   • ID de cadena: 80002
   • Símbolo de moneda: POL
   • URL del explorador de bloques: https://amoy.polygonscan.com
4. Haz clic en "Guardar".

Alternativamente, puedes usar un botón de un solo clic de servicios como ChainList, pero la entrada manual es igual de fácil.

Configura tu dApp con ethers.js o viem

Si estás construyendo una dApp, necesitarás configurar la URL RPC y el ID de cadena en tu código. Aquí tienes un ejemplo usando ethers.js:

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://polygon-amoy.drpc.org");
const wallet = new ethers.Wallet("YOUR_PRIVATE_KEY", provider);

// Verificar conexión
const network = await provider.getNetwork();
console.log("Conectado al ID de cadena:", network.chainId); // Debería ser 80002

Y con viem:

import { createPublicClient, http } from 'viem';
import { polygonAmoy } from 'viem/chains';

const client = createPublicClient({
  chain: polygonAmoy,
  transport: http('https://polygon-amoy.drpc.org')
});

const blockNumber = await client.getBlockNumber();
console.log("Bloque actual:", blockNumber);

Probando tu endpoint RPC

Una vez que tengas una URL RPC, puedes probarla con una simple llamada JSON-RPC usando curl:

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

Una respuesta exitosa se verá así:

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

El result es el número de bloque más reciente en hexadecimal. Si obtienes un error, verifica tu endpoint y la conectividad de red.

Elegir el proveedor RPC adecuado para Amoy

Los endpoints RPC públicos son convenientes para pruebas rápidas, pero a menudo tienen límites de tasa y pueden ser poco confiables bajo carga. Para desarrollo serio, deberías considerar un proveedor RPC administrado. Aquí tienes una comparación rápida para ayudarte a decidir:

Para la mayoría del desarrollo y pruebas, un proveedor RPC administrado ofrece el mejor equilibrio entre confiabilidad y costo. OnFinality proporciona endpoints RPC para Polygon Amoy con opciones generosas de nivel gratuito y planes escalables. Puedes consultar precios de RPC para más detalles.

Errores comunes y solución de problemas

Incluso con el endpoint correcto, podrías encontrar problemas. Aquí tienes algunos problemas comunes y cómo solucionarlos:

• ID de cadena incorrecto: Asegúrate de usar 80002 para Amoy, no 137 (mainnet) ni 80001 (Mumbai).
• Límite de tasa: Si recibes errores 429, estás alcanzando los límites de tasa. Cambia a un proveedor con límites más altos u obtén una clave API.
• Endpoints desactualizados: Algunos endpoints antiguos de Mumbai pueden seguir apareciendo en línea. Usa siempre los endpoints oficiales de Amoy de la documentación de Polygon.
• Problemas con el faucet: Si no puedes obtener POL de prueba, verifica el faucet de Polygon y asegúrate de estar en la red correcta.
• Fallos de conexión WebSocket: Si necesitas actualizaciones en tiempo real, usa el endpoint WSS (ej., wss://polygon-amoy.drpc.org). Algunos proveedores pueden no admitir WebSockets en los niveles gratuitos.

Conclusiones clave

• Polygon Amoy es la testnet oficial de Polygon PoS, que usa Sepolia como su cadena raíz.
• El ID de cadena es 80002, y el token nativo es POL.
• Los endpoints RPC públicos están disponibles pero pueden tener límites de tasa; considera un proveedor administrado para un acceso confiable.
• Siempre prueba tu conexión RPC con una simple llamada JSON-RPC antes de construir sobre ella.
• Para infraestructura de nivel de producción, explora los servicios RPC de OnFinality y las redes compatibles.

Preguntas frecuentes

¿Cuál es la diferencia entre Polygon Amoy y Mumbai?

Amoy es el sucesor de Mumbai, que fue descontinuada junto con Goerli. Amoy usa Sepolia como su cadena raíz, mientras que Mumbai usaba Goerli. Amoy es ahora la testnet principal de Polygon PoS.

¿Puedo usar el mismo código para Amoy y la mainnet de Polygon?

Sí, dado que Amoy está diseñada para reflejar la mainnet, la mayoría del código funcionará con solo cambiar la URL RPC y el ID de cadena. Sin embargo, siempre prueba a fondo, ya que puede haber diferencias menores.

¿Cómo obtengo POL de prueba en Amoy?

Usa el faucet oficial de Polygon. Necesitarás conectar tu billetera y solicitar tokens de prueba.

¿Hay un endpoint WebSocket para Amoy?

Sí, muchos proveedores ofrecen endpoints WSS, como wss://polygon-amoy.drpc.org. Consulta con tu proveedor para ver la disponibilidad.

¿Qué debo hacer si mis solicitudes RPC fallan?

Primero, verifica tu endpoint y ID de cadena. Luego, revisa los límites de tasa o problemas de red. Si los problemas persisten, prueba con otro proveedor o contacta al soporte de tu proveedor RPC.

¿OnFinality admite Polygon Amoy?

Sí, OnFinality proporciona endpoints RPC públicos y privados para Polygon Amoy. Puedes encontrar más detalles en la página de la red Polygon.