¿Qué es un nodo de Polygon y cómo se ejecuta o se conecta a uno?

Decisión rápida: ¿ejecutar tu propio nodo de Polygon o usar un proveedor de RPC?

Antes de profundizar en la arquitectura de nodos, decide cómo quieres interactuar con Polygon. Si necesitas control total sobre el nodo, quieres ejecutar un validador o requieres trazabilidad personalizada, el autoalojamiento tiene sentido. Si quieres concentrarte en construir tu dApp sin administrar infraestructura, un proveedor de RPC administrado como el endpoint de Polygon de OnFinality es el camino más rápido.

Aquí tienes una guía rápida:

• Eres un desarrollador de dApps – Usa un proveedor de RPC administrado. Obtienes un endpoint confiable, soporte de WebSocket y escalabilidad sin mantenimiento de nodos.
• Eres un validador o necesitas acceso profundo a la cadena – Ejecuta tu propio nodo. Necesitarás tanto Bor como Heimdall.
• Necesitas datos de archivo o alto rendimiento – Considera un nodo dedicado de un proveedor, que ofrece recursos dedicados y estado histórico.

¿Qué es un nodo de Polygon?

Un nodo de Polygon es una computadora que ejecuta el software de cliente de Polygon PoS, manteniendo una copia de la blockchain y participando en la red. A diferencia de una cadena de un solo cliente, Polygon utiliza una arquitectura de dos capas:

• Bor – La capa de ejecución, una bifurcación de Geth que maneja el procesamiento de transacciones y la ejecución de contratos inteligentes.
• Heimdall – La capa de consenso, basada en Tendermint, que gestiona validadores, checkpoints y sincronización de estado con Ethereum.

Los nodos pueden ser nodos completos (que almacenan todo el estado de la cadena) o nodos de archivo (que almacenan todos los estados históricos). Los nodos validadores además participan en la producción de bloques y el consenso.

¿Por qué ejecutar un nodo de Polygon?

Ejecutar tu propio nodo te brinda:

• Acceso directo – Sin intermediarios entre tú y la cadena.
• Personalización – Puedes modificar el cliente o agregar indexación personalizada.
• Privacidad – Tus solicitudes no son registradas por un proveedor.
• Control de costos – Para uso de alto volumen, el autoalojamiento puede ser más barato que los planes de RPC pagados.

Sin embargo, conlleva cargas operativas: hardware, almacenamiento, monitoreo y mantener el nodo sincronizado. Para la mayoría de los desarrolladores, el equilibrio favorece a un proveedor administrado.

Cómo ejecutar un nodo de Polygon

Requisitos de hardware

Polygon recomienda lo siguiente para un nodo completo:

• CPU: 8+ núcleos
• RAM: 16 GB (32 GB para archivo)
• Almacenamiento: 2.5 TB SSD (crece con el tiempo)
• Ancho de banda: 100 Mbps+ con transferencia sin límite

Pasos de configuración

1. Instala dependencias – Docker, o compila desde el código fuente.
2. Descarga los archivos génesis – Para mainnet, usa las instantáneas oficiales de Polygon.
3. Inicia Heimdall – Inicializa y arranca el servicio de Heimdall.
4. Inicia Bor – Configura Bor para conectarse a Heimdall y arranca el servicio.
5. Verifica la sincronización – Revisa los registros y usa eth_blockNumber para confirmar que el nodo está sincronizando.

Aquí tienes un ejemplo simplificado de Docker Compose:

version: '3'
services:
  heimdall:
    image: 0xpolygon/heimdall:latest
    command: heimdall start
    volumes:
      - ./heimdall:/heimdall
    ports:
      - "26657:26657"
  bor:
    image: 0xpolygon/bor:latest
    command: bor server
    volumes:
      - ./bor:/bor
    ports:
      - "8545:8545"

Conectarse a Polygon mediante RPC

Una vez que tu nodo esté en ejecución, expone un endpoint RPC (por defecto http://localhost:8545). También puedes usar un endpoint público de un proveedor como OnFinality:

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

Para suscripciones WebSocket:

const WebSocket = require('ws');
const ws = new WebSocket('wss://polygon.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(data.toString());
});

Tipos de nodos de Polygon y sus casos de uso

Autoalojamiento vs RPC administrado: qué considerar

Al decidir, evalúa:

• Tiempo de implementación – El autoalojamiento puede tomar días para sincronizar; los proveedores administrados ofrecen endpoints instantáneos.
• Mantenimiento – Debes manejar actualizaciones, monitoreo y copias de seguridad.
• Escalabilidad – Los proveedores administrados pueden manejar picos de tráfico con balanceo de carga.
• Costo – El autoalojamiento tiene costos de hardware fijos; los planes administrados escalan con el uso.

Para la mayoría de las aplicaciones de producción, un proveedor administrado como OnFinality ofrece un equilibrio entre confiabilidad y simplicidad. Consulta nuestros precios de RPC para planes transparentes.

Errores comunes y solución de problemas

• Nodo desincronizado – Revisa los registros de Heimdall y Bor. Asegúrate de que el reloj del sistema sea preciso.
• Almacenamiento lleno – Poda datos antiguos o aumenta el espacio en disco.
• Tiempos de espera de RPC – Aumenta los tiempos de espera de solicitud o usa un proveedor con mejor infraestructura.
• Desconexiones de WebSocket – Implementa lógica de reconexión en tu cliente.

Si usas un proveedor administrado, la mayoría de estos problemas se manejan por ti.

Conclusiones clave

• Los nodos de Polygon ejecutan Bor y Heimdall, cada uno con un rol distinto.
• El autoalojamiento brinda control pero requiere un esfuerzo operativo significativo.
• Los proveedores de RPC administrados como OnFinality ofrecen endpoints rápidos y confiables para desarrolladores.
• Elige el tipo de nodo según tus necesidades: completo, de archivo o validador.

Preguntas frecuentes

¿Cuál es la diferencia entre un nodo completo de Polygon y un nodo de archivo?

Un nodo completo almacena el estado actual y puede consultar datos recientes, mientras que un nodo de archivo almacena todos los estados históricos, lo que permite consultas en cualquier bloque pasado.

¿Cuánto tiempo toma sincronizar un nodo de Polygon?

Con instantáneas, puede tomar desde unas horas hasta un día, dependiendo del hardware y la velocidad de la red.

¿Puedo usar un endpoint RPC público para producción?

Los endpoints públicos son adecuados para desarrollo, pero para producción debes usar un endpoint dedicado o de pago para evitar límites de tasa y garantizar confiabilidad.

¿OnFinality admite WebSocket para Polygon?

Sí, OnFinality proporciona soporte de WebSocket para Polygon. Consulta la página de red de Polygon para más detalles.

¿Cómo agrego Polygon a MetaMask?

Usa los detalles de red: Chain ID 137, URL RPC https://polygon.api.onfinality.io/public, símbolo POL, explorador https://polygonscan.com.

Para más redes, visita nuestra página de redes compatibles.