Endpoint RPC de Polygon Amoy: Configuración de red, faucet y depuración

Referencia rápida: Endpoint y configuración de red de Polygon Amoy

Si estás desarrollando en Polygon Amoy, la testnet de la red PoS de Polygon, necesitas el endpoint RPC correcto y la configuración de cadena para conectar tu billetera, desplegar contratos o ejecutar pruebas automatizadas. Aquí tienes la información esencial de un vistazo:

Este endpoint público es gratuito para desarrollo y pruebas. Para cargas de trabajo de testnet de nivel de producción, considera un nodo dedicado o un servicio RPC de nivel superior para evitar límites de tasa y garantizar la fiabilidad. OnFinality proporciona servicios RPC para Polygon Amoy y muchas otras redes, con opciones de precios flexibles.

Guía de decisión: Elegir el acceso RPC adecuado para Amoy

Antes de empezar a programar, decide cómo accederás al RPC de Amoy. Tu elección depende de tu carga de trabajo y necesidades de fiabilidad:

• Prototipado rápido o scripts puntuales: Usa el endpoint público. Es gratuito y suficiente para solicitudes ocasionales.
• Desarrollo activo con llamadas frecuentes: Un servicio RPC compartido con límites de tasa más altos es mejor. Los endpoints públicos pueden limitar o fallar bajo carga.
• CI/CD automatizado o pruebas de carga: Considera un nodo dedicado para garantizar un rendimiento constante y evitar la limitación por IP.
• dApp de producción que usa testnet para staging: Se recomienda un servicio RPC gestionado con SLA y conmutación por error.

Para la mayoría de los desarrolladores, empezar con el endpoint público está bien, pero si alcanzas los límites de tasa o necesitas soporte WebSocket, actualiza a un servicio gestionado. OnFinality ofrece opciones tanto compartidas como dedicadas, y puedes comparar planes en nuestra página de precios de RPC.

¿Qué es Polygon Amoy y por qué usarlo?

Polygon Amoy es la testnet oficial de Polygon PoS, que reemplaza a la antigua testnet Mumbai. Permite a los desarrolladores probar contratos inteligentes y dApps en un entorno que refleja mainnet sin gastar fondos reales. Características clave:

• ID de cadena 80002 – distinto de mainnet (137) para evitar la repetición de transacciones.
• Token POL – el token nativo para gas, obtenido de un faucet.
• PolygonScan Amoy – explorador de bloques para verificar transacciones y contratos.

Usar una testnet es esencial para el desarrollo porque te permite iterar rápidamente, depurar fallos y simular interacciones de usuario sin riesgo financiero. Amoy también es utilizada por proveedores de infraestructura para probar nuevas funciones antes del despliegue en mainnet.

Configuración de tu billetera o dApp

Para conectar una billetera como MetaMask o una dApp usando ethers.js o viem, necesitas añadir la red Amoy. Así es como se configura manualmente en MetaMask:

1. Abre MetaMask y haz clic en el menú desplegable de redes.
2. Haz clic en "Agregar red" y completa los detalles:
   • Nombre de la red: Amoy
   • Nueva URL RPC: https://polygon-amoy.api.onfinality.io/public
   • ID de cadena: 80002
   • Símbolo de moneda: POL
   • URL del explorador de bloques: https://amoy.polygonscan.com
3. Guarda y cambia a la red Amoy.

Para acceso programático, aquí tienes un ejemplo usando ethers.js:

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://polygon-amoy.api.onfinality.io/public");
const network = await provider.getNetwork();
console.log("Chain ID:", network.chainId); // 80002

Y con viem:

import { createPublicClient, http } from 'viem';

const client = createPublicClient({
  chain: {
    id: 80002,
    name: 'Amoy',
    nativeCurrency: { name: 'POL', symbol: 'POL', decimals: 18 },
    rpcUrls: { default: { http: ['https://polygon-amoy.api.onfinality.io/public'] } },
  },
  transport: http()
});

const blockNumber = await client.getBlockNumber();
console.log("Block number:", blockNumber);

Obtener POL de prueba del faucet

Para pagar el gas en Amoy, necesitas POL de prueba. El faucet oficial está disponible en faucet.polygon.technology. Deberás conectar una billetera y solicitar tokens. También existen algunos faucets de la comunidad, pero verifica siempre su legitimidad.

Si estás automatizando pruebas, puedes solicitar POL programáticamente, pero ten en cuenta los límites de tasa. Para CI/CD, considera prefondear una billetera y usar una clave privada en tu entorno de pruebas.

Errores comunes de RPC y cómo solucionarlos

Al trabajar con el RPC de Amoy, puedes encontrar errores. Aquí tienes una tabla rápida de solución de problemas:

Para problemas de nonce, puedes consultar el nonce pendiente:

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

RPC público vs. compartido vs. dedicado para Amoy

Elegir el modelo de acceso RPC adecuado es crucial para tu flujo de trabajo de desarrollo. Aquí tienes una comparación:

OnFinality ofrece opciones tanto compartidas como dedicadas. Nuestra página de precios de RPC detalla los planes, y puedes ver todas las redes compatibles en nuestra página de redes.

Depuración con WebSocket y JSON-RPC

Para aplicaciones en tiempo real, es posible que necesites soporte WebSocket. El endpoint público anterior es solo HTTP, pero OnFinality proporciona endpoints WebSocket para nodos dedicados. Para probar la conectividad WebSocket, puedes usar un script simple:

const WebSocket = require('ws');
const ws = new WebSocket('wss://polygon-amoy.api.onfinality.io/public');

ws.on('open', () => {
  ws.send(JSON.stringify({jsonrpc: '2.0', method: 'eth_subscribe', params: ['newHeads'], id: 1}));
});

ws.on('message', (data) => {
  console.log('Received:', data.toString());
});

Nota: El endpoint público puede no soportar WebSocket; consulta la documentación de tu proveedor. Para producción, usa un nodo dedicado con soporte WebSocket.

Conclusiones clave

• Polygon Amoy es la testnet de Polygon PoS con ID de cadena 80002 y POL como token de gas.
• El endpoint RPC público es https://polygon-amoy.api.onfinality.io/public.
• Configura tu billetera o dApp con la configuración de cadena correcta para evitar errores.
• Obtén POL de prueba del faucet oficial para pagar las transacciones.
• Para un acceso fiable y de alto volumen, considera un servicio RPC gestionado o un nodo dedicado de OnFinality.
• Prueba siempre en Amoy antes de desplegar en la mainnet de Polygon.

Preguntas frecuentes

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

El endpoint RPC público es https://polygon-amoy.api.onfinality.io/public. También puedes usar otros proveedores, pero este es gratuito y fiable para el desarrollo.

¿Cómo agrego Amoy a MetaMask?

Ve a Configuración > Redes > Agregar red e introduce los detalles de la cadena: URL RPC, ID de cadena 80002, símbolo POL y URL del explorador.

¿Dónde puedo obtener POL de prueba?

Usa el faucet oficial de Polygon en faucet.polygon.technology. Conecta tu billetera y solicita tokens.

¿Puedo usar WebSocket con Amoy?

El endpoint público puede no soportar WebSocket. Para WebSocket, necesitarás un nodo dedicado o un proveedor que lo ofrezca. Los nodos dedicados de OnFinality soportan WebSocket.

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

Mumbai está obsoleta. Amoy es la testnet actual con un ID de cadena diferente (80002 vs 80001) y usa POL en lugar de MATIC.

¿El endpoint público tiene límite de tasa?

Sí, los endpoints públicos suelen tener límites de tasa para prevenir abusos. Para uso intensivo, considera un servicio RPC de pago.

¿Cómo compruebo si mi conexión RPC funciona?

Usa un comando curl simple para llamar a eth_chainId y verifica que la respuesta sea 0x13882 (80002 en hexadecimal).