¿Qué es el RPC de la red peaq y cómo me conecto a él?

El RPC de la red peaq es el endpoint que las aplicaciones usan para leer y escribir datos en la blockchain peaq, una capa 1 compatible con EVM para redes de infraestructura física descentralizadas (DePIN) y la economía de las máquinas. Si estás conectando una billetera, ejecutando un indexador o construyendo un servicio de automatización en peaq, el endpoint RPC es donde comienza esa integración. Esta referencia cubre la configuración de la cadena peaq, los conceptos básicos de JSON-RPC, los criterios de evaluación de proveedores, los modos de fallo comunes y cómo pasar de un endpoint de prueba público a un acceso de grado de producción.

Lista de verificación para el RPC de la red peaq

Antes de conectar tu aplicación a un endpoint RPC de peaq, revisa esta lista.

• Confirma los detalles de la cadena peaq: ID de cadena 3338, nombre de red peaq, símbolo PEAQ y 18 decimales.
• Elige un endpoint para cada entorno: endpoints públicos para staging, RPC gestionado o dedicado para producción.
• Verifica que los métodos JSON-RPC de los que dependes existan en tu endpoint seleccionado, incluidos eth_getLogs, eth_sendRawTransaction y suscripciones WebSocket.
• Comprueba el soporte de WebSocket si tu dApp necesita actualizaciones de bloques o registros en tiempo real.
• Prueba los límites de tasa con cargas de trabajo representativas en lugar de una sola llamada eth_blockNumber.
• Decide si necesitas datos de archivo, métodos de rastreo o RPC de pallets específicos de peaq.
• Planifica la conmutación por error: mantén al menos dos endpoints o usa un proveedor que enrute a través de múltiples regiones.

¿Qué es el RPC de la red peaq?

El RPC de la red peaq (Llamada a Procedimiento Remoto) es la puerta de enlace API entre tu aplicación y la blockchain peaq. Te permite consultar el estado de la cadena, estimar gas, enviar transacciones y suscribirte a eventos. Debido a que peaq es una red compatible con EVM construida sobre un runtime de Substrate, expone métodos JSON-RPC estándar de Ethereum junto con sus propias características de economía de máquinas. La mayoría de las herramientas Web3 pueden conectarse a peaq de la misma manera que se conectan a cualquier cadena EVM, siempre que tengan la configuración de cadena correcta.

peaq se describe a sí misma como la infraestructura económica para máquinas. La cadena admite identidades de máquinas, reputación, pagos y propiedad tokenizada para robots, vehículos, sensores y agentes de IA. Para los desarrolladores, eso significa que el tráfico RPC en peaq puede verse diferente al de una cadena DeFi típica. Puedes ver escrituras de telemetría de alta frecuencia, transacciones de agentes autónomos o grandes consultas de registros de sensores DePIN. Esas cargas de trabajo hacen que la selección de RPC y la planificación de capacidad sean más importantes que en cadenas con uso simple de lectura intensiva.

Internamente, peaq utiliza un runtime basado en Substrate con una capa de compatibilidad EVM. Las solicitudes RPC se pueden enviar a través de interfaces JSON-RPC estándar de Ethereum, mientras que los módulos específicos de peaq para identidad, crédito y ganancias de máquinas permanecen disponibles a nivel de Substrate. Para la mayoría de los desarrolladores de aplicaciones, la interfaz EVM es suficiente. Agregas la configuración de red de peaq a tus herramientas y comienzas a llamar métodos.

Configuración de la cadena de la red peaq

Cuando agregues la red peaq a una billetera o configures una biblioteca Web3, usa los siguientes valores.

Estos endpoints públicos son convenientes para prototipos, pero pueden tener límites de tasa o cambiar con el tiempo. Consulta ChainList o la documentación de peaq para obtener la lista actual. Para aplicaciones de producción, usa un proveedor de RPC gestionado con un endpoint que admita escalado, WebSockets y conmutación por error. La página de red de peaq de OnFinality muestra las opciones gestionadas disponibles.

Aquí tienes un ejemplo de objeto de configuración que puedes usar en una billetera o en una biblioteca como viem:

const peaqNetwork = {
  id: 3338,
  name: 'peaq',
  nativeCurrency: {
    name: 'peaq',
    symbol: 'PEAQ',
    decimals: 18,
  },
  rpcUrls: {
    default: { http: ['https://quicknode1.peaq.xyz'] },
    public: { http: ['https://quicknode1.peaq.xyz'] },
  },
  blockExplorers: {
    default: { name: 'Subscan', url: 'https://peaq.subscan.io' },
  },
}

Cómo probar un endpoint RPC de peaq

Puedes probar cualquier endpoint RPC de peaq con una simple solicitud JSON-RPC. El siguiente comando curl devuelve el ID de cadena. Si el endpoint devuelve 0xd0a (3338), tu conexión está funcionando.

curl -X POST <TU_URL_RPC_PEAQ> \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

Reemplaza <TU_URL_RPC_PEAQ> con un endpoint de la tabla anterior o el proporcionado por tu proveedor de RPC. Para verificar el número de bloque más reciente, usa:

curl -X POST <TU_URL_RPC_PEAQ> \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Si estás usando un cliente JavaScript, las mismas llamadas se ven así:

import { createPublicClient, http } from 'viem'

const client = createPublicClient({
  chain: peaqNetwork,
  transport: http(),
})

const blockNumber = await client.getBlockNumber()
console.log('Último bloque de peaq:', blockNumber)

Métodos JSON-RPC clave para desarrolladores de peaq

Debido a que peaq es compatible con EVM, puedes usar métodos JSON-RPC estándar de Ethereum:

• eth_chainId — verifica que estás conectado a la cadena 3338.
• eth_blockNumber — obtén el último bloque finalizado.
• eth_getBalance — lee saldos de cuentas.
• eth_call — ejecuta llamadas de contrato de solo lectura.
• eth_sendRawTransaction — transmite transacciones firmadas.
• eth_getTransactionReceipt — confirma resultados de transacciones.
• eth_getLogs — consulta registros de eventos para indexación o monitoreo.
• eth_subscribe — suscríbete a nuevos encabezados, registros o transacciones pendientes a través de WebSocket.

Los proyectos DePIN en peaq a menudo dependen de eth_getLogs para la indexación de telemetría. Consultar rangos de registros muy grandes puede causar tiempos de espera en endpoints compartidos. Divide el rango en fragmentos más pequeños o usa un nodo dedicado si tus cargas de trabajo son pesadas.

Para acceso a nivel de Substrate, peaq también expone métodos RPC para sus pallets específicos de cadena. La mayoría de las características de peaqOS están disponibles a través de contratos, por lo que las herramientas EVM son suficientes para la mayoría de las construcciones.

Cómo elegir un proveedor de RPC de peaq

Los endpoints RPC públicos de peaq funcionan para desarrollo, pero las dApps de producción necesitan un plan de infraestructura. La siguiente tabla resume qué evaluar al comparar proveedores de RPC para la red peaq.

Una consideración específica de peaq es la forma de la carga de trabajo. Las aplicaciones DePIN a menudo envían muchas escrituras pequeñas desde muchos dispositivos. Un endpoint público compartido puede tratar eso como tráfico abusivo. Un proveedor gestionado con límites de rendimiento explícitos o un nodo dedicado te da margen predecible. También debes verificar si las políticas de endpoint del proveedor manejan límites de conexión WebSocket, porque las máquinas autónomas pueden mantener suscripciones de larga duración abiertas.

Si estás evaluando proveedores, comienza con la guía de selección de proveedores de RPC para formalizar tus criterios. La página de redes compatibles enumera las cadenas que OnFinality gestiona, incluida peaq, y la página de precios de RPC explica la diferencia entre niveles público, de pago y dedicado.

Errores comunes de RPC de peaq y cómo solucionarlos

Incluso con la configuración de cadena correcta, te encontrarás con errores. Aquí están los más comunes.

Desajuste de ID de cadena

Si una billetera o dApp dice que el ID de cadena es incorrecto, probablemente ingresaste 3338 como decimal pero el proveedor espera un valor hexadecimal o viceversa. El valor hexadecimal para peaq es 0xd0a.

Límite de tasa excedido

Los endpoints públicos de peaq a menudo devuelven 429 Too Many Requests o respuestas vacías bajo carga. Mitigación: almacena en caché las lecturas, agrupa solicitudes, usa un endpoint gestionado o cambia a un nodo dedicado.

Tiempo de espera de eth_getLogs

Escanear un rango de bloques amplio en una sola solicitud puede exceder el límite de tiempo de respuesta de una puerta de enlace. Mitigación: consulta rangos más pequeños, pagina o ejecuta un indexador con un RPC dedicado.

Nonce demasiado bajo

Esto sucede cuando una billetera reintenta una transacción con un nonce obsoleto. En peaq, como en otras cadenas EVM, rastrea el nonce pendiente por dirección y reintenta con eth_getTransactionCount(address, 'pending').

Respuesta RPC vacía o nula

Si eth_call devuelve null en un contrato que debería tener un valor, confirma que estás usando la etiqueta de bloque correcta y que la dirección existe en la cadena 3338.

Transacción pendiente atascada

Si una transacción está pendiente durante mucho tiempo, el endpoint puede no haber propagado el envío o el precio del gas puede estar por debajo del mínimo actual. Monitorea el mempool y reenvía con una tarifa actualizada si es necesario.

Usa OnFinality para el RPC de la red peaq

OnFinality proporciona endpoints de API RPC de peaq como parte de su servicio de infraestructura gestionada. La red está listada en el directorio de redes compatibles, y puedes obtener detalles de conexión desde la página de red de peaq. OnFinality también ofrece infraestructura de nodos dedicados para equipos que necesitan capacidad aislada, cobertura de métodos personalizada o datos de archivo. Para equipos que aún están estimando tráfico, el servicio de API proporciona acceso RPC compartido y escalable sin ejecutar hardware de nodo.

Cuando compares OnFinality con ejecutar tu propio nodo peaq, considera el costo operativo. Un nodo peaq debe mantenerse sincronizado, monitoreado y actualizado después de los lanzamientos de red. Un RPC gestionado elimina esa carga de trabajo para que tu equipo pueda enfocarse en la capa de aplicación de la economía de máquinas.

Conclusiones clave

• La red peaq usa el ID de cadena 3338, el token nativo PEAQ y el explorador Subscan en https://peaq.subscan.io.
• peaq expone métodos JSON-RPC estándar de EVM, por lo que la mayoría de las herramientas de Ethereum funcionan con una configuración de red simple.
• Los endpoints RPC públicos de peaq son adecuados para prototipos pero pueden limitar tu tráfico; las aplicaciones de producción deben usar infraestructura gestionada o dedicada.
• Verifica el soporte de WebSocket, el comportamiento de eth_getLogs y la capacidad dedicada antes de elegir un proveedor.
• OnFinality ofrece API RPC de peaq y opciones de nodos dedicados. Consulta la página de red de peaq para detalles y la página de precios de RPC para comparaciones de niveles.

Preguntas frecuentes

¿Qué es el RPC de la red peaq?

El RPC de la red peaq es el endpoint API que permite a las aplicaciones consultar el estado de la cadena y enviar transacciones en la blockchain peaq. Admite métodos JSON-RPC estándar de Ethereum porque peaq es compatible con EVM.

¿Cuál es el ID de cadena de peaq?

El ID de cadena de peaq es 3338. En hexadecimal, eso es 0xd0a.

¿Cuál es la URL RPC oficial de peaq?

No hay una única URL RPC pública oficial. Los endpoints públicos mantenidos por la comunidad son actualmente https://quicknode1.peaq.xyz, https://quicknode2.peaq.xyz y https://quicknode3.peaq.xyz. Para producción, usa un proveedor gestionado y consulta la página de red de peaq para la configuración del endpoint.

¿El RPC de peaq admite suscripciones WebSocket?

Peaq expone endpoints WebSocket a través de proveedores gestionados y algunos endpoints públicos. Si tu dApp depende de eth_subscribe, confirma el soporte de WebSocket con tu proveedor antes de producción.

¿Necesito un nodo dedicado para peaq?

Eso depende de tu carga de trabajo. Un nodo dedicado de peaq ayuda si indexas grandes cantidades de datos eth_getLogs, envías transacciones de máquinas de alta frecuencia o necesitas latencia consistente. Comienza con un RPC compartido para desarrollo y actualiza cuando veas límites de tasa o degradación del rendimiento.