¿Cuáles son los endpoints RPC de IoTeX y cómo conectarse?

IoTeX es una blockchain de capa 1 compatible con EVM optimizada para DePIN (Redes de Infraestructura Física Descentralizada) y la economía de las máquinas. Para construir en IoTeX, necesitas un endpoint RPC que permita a tu wallet, dApp o backend comunicarse con la cadena. Esta guía cubre todo lo que necesitas: endpoints oficiales, configuraciones de cadena, conexiones de ejemplo y una lista de verificación para elegir el proveedor RPC adecuado.

Lista de verificación de decisión de RPC de IoTeX

Usa esta lista al configurar tu conexión a IoTeX:

• Verifica el ID de cadena correcto (4689 para mainnet, 4690 para testnet)
• Elige entre un nodo completo (ligero, rápido) o un nodo de archivo (soporta consultas de estado histórico)
• Evalúa la latencia y estabilidad del proveedor con una llamada de prueba
• Confirma el soporte de WebSocket si tu dApp necesita eventos en tiempo real
• Comprende los límites de tasa: los endpoints públicos pueden limitar el tráfico alto
• Decide entre un RPC público compartido y un endpoint dedicado o privado para cargas de trabajo de producción
• Verifica la disponibilidad de testnet para desarrollo y staging

Configuración de cadena de red de IoTeX

Endpoints RPC de IoTeX

La Fundación IoTeX y varios proveedores externos ofrecen endpoints RPC públicos. A continuación se muestran opciones comunes para mainnet y testnet.

Endpoints de nodo completo de mainnet

Endpoints de nodo de archivo de mainnet

Endpoints de testnet

Cómo conectarse a IoTeX

Usando ethers.js (JavaScript)

import { ethers } from "ethers";

// Connect to IoTeX mainnet
const provider = new ethers.JsonRpcProvider("https://babel-api.mainnet.iotex.io");

// Get chain ID to verify connection
const network = await provider.getNetwork();
console.log(`Connected to chain ID: ${network.chainId}`); // Should be 4689n

// Get current block number
const blockNumber = await provider.getBlockNumber();
console.log(`Current block: ${blockNumber}`);

// Query an address balance
const balance = await provider.getBalance("0xYourIoTeXAddress");
console.log(`Balance: ${ethers.formatEther(balance)} IOTX`);

Usando curl

# Get the latest block number
curl -X POST https://babel-api.mainnet.iotex.io \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

# Check ETH balance (IOTX)
curl -X POST https://babel-api.mainnet.iotex.io \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0xYourIoTeXAddress", "latest"],"id":1}'

Añadiendo IoTeX a MetaMask

Abre MetaMask → Redes → Añadir red manualmente y completa:

• Nombre de la red: IoTeX Mainnet
• URL RPC: cualquier endpoint de nodo completo (ej. https://babel-api.mainnet.iotex.io)
• ID de cadena: 4689
• Símbolo: IOTX
• URL del explorador: https://iotexscan.io

Cómo elegir un proveedor RPC de IoTeX

No todos los endpoints RPC son iguales. Usa los criterios a continuación para evaluar proveedores según las necesidades de tu proyecto.

RPC público vs dedicado

• RPC público: Gratuito y fácil de empezar, pero compartido entre muchos usuarios. Los límites de tasa y la congestión ocasional pueden afectar la confiabilidad.
• RPC dedicado: Un endpoint privado con capacidad reservada, rendimiento consistente y a menudo acceso a API de archivo o trace. Ideal para dApps de producción.

OnFinality ofrece nodos IoTeX dedicados para equipos que necesitan rendimiento y soporte predecibles. Consulta la página de red de IoTeX para más detalles.

Configuración de un nodo RPC local de IoTeX

Si prefieres tener control total, puedes ejecutar tu propio nodo completo de IoTeX. La documentación de IoTeX proporciona una guía de inicio para implementación basada en Docker. Necesitarás descargar una instantánea (incluyendo índices de base de datos para consultas RPC) y exponer el puerto 15014 para la puerta de enlace JSON-RPC de Ethereum. Este enfoque te da solicitudes ilimitadas pero requiere mantenimiento continuo de infraestructura.

Solución de problemas comunes de RPC de IoTeX

• Tiempo de espera de conexión: Asegúrate de que tu cortafuegos permita tráfico saliente al endpoint RPC. Prueba con otro proveedor si un endpoint es lento.
• Límite de tasa: Si recibes errores HTTP 429, reduce la frecuencia de solicitudes o cambia a un proveedor con límites más altos.
• ID de cadena incorrecto: Verifica que el ID de cadena sea 4689 (mainnet) o 4690 (testnet). Usar el ID incorrecto puede causar rechazos de transacciones.
• Falta de datos de archivo: Para consultas históricas, usa un endpoint de archivo. Los nodos completos solo mantienen el estado reciente.

Conclusiones clave

• IoTeX utiliza RPC compatible con EVM: puedes reutilizar las herramientas estándar de desarrollo de Ethereum.
• Los endpoints oficiales son gratuitos pero pueden tener límites de tasa; para producción, evalúa a los proveedores según latencia, soporte de archivo, WebSocket y precios.
• OnFinality ofrece RPC público de IoTeX y nodos dedicados con rendimiento y soporte consistentes.
• Siempre verifica el ID de cadena (4689) y prueba con una simple llamada eth_blockNumber antes de integrar.

Para obtener una lista completa de redes compatibles y comparar opciones de infraestructura, visita OnFinality Networks.