Logo
RPC Assistant

¿Cuál es el endpoint RPC de peaq mainnet?

Resumen

peaq mainnet es una cadena de bloques Layer-1 compatible con EVM construida sobre Substrate y conectada al ecosistema de Polkadot. Su RPC permite que las carteras y aplicaciones lean datos de la cadena, envíen transacciones y se suscriban a eventos usando el ID de cadena 3338 y el token nativo PEAQ.

Este artículo cubre los ajustes de cadena de peaq mainnet, ejemplos de JSON-RPC, selección de endpoints y problemas comunes de depuración para que puedas añadir soporte de peaq a tu aplicación sin conjeturas.

peaq es una cadena de bloques Layer-1 compatible con EVM construida sobre Substrate y conectada al ecosistema de Polkadot. Está diseñada para redes DePIN (redes descentralizadas de infraestructura física) y aplicaciones orientadas a máquinas, pero desde la perspectiva de RPC se comporta como una cadena EVM estándar con ID de cadena 3338 y el token nativo PEAQ. Este artículo cubre la configuración de RPC de peaq mainnet, ajustes de la cadena, ejemplos de JSON-RPC, selección de endpoints y problemas comunes que puedes encontrar al conectar carteras o servicios backend.

Lista de verificación para decidir sobre el RPC de peaq mainnet

Antes de añadir peaq a tu cartera o integrar peaq RPC en tu backend, repasa la siguiente lista:

  • Confirma que el ID de cadena sea 3338 (0xd0a). Un ID de cadena incorrecto provocará errores de firma de transacciones en carteras y librerías.
  • Usa HTTPS para JSON-RPC sobre HTTP y WSS para suscripciones WebSocket. HTTP y WS planos solo deben usarse en pruebas locales.
  • Prefiere un endpoint gestionado o un nodo dedicado para el tráfico de producción en lugar de una URL pública compartida. Las URL públicas pueden estar limitadas por tasa o cambiarse sin previo aviso.
  • Verifica que el endpoint admita los métodos JSON-RPC de Ethereum que necesitas, como eth_chainId, eth_blockNumber, eth_getLogs y eth_sendRawTransaction.
  • Comprueba si necesitas métodos específicos de Substrate. peaq se ejecuta en Substrate, por lo que algunos proveedores también exponen métodos como chain_getBlock y chain_getFinalizedHead.
  • Prueba el patrón de solicitudes de tu aplicación antes del lanzamiento. Las consultas grandes de eth_getLogs, el sondeo repetido y las suscripciones WebSocket afectan el comportamiento del endpoint.
  • Decide si necesitas datos de archivo. Si tu aplicación lee saldos históricos o eventos pasados, es posible que necesites un nodo de archivo o un plan RPC compatible con archivo.
  • Supervisa la latencia, las tasas de error y el comportamiento de conmutación por error. Una única URL RPC puede ser un cuello de botella en producción.

¿Qué es peaq mainnet?

peaq es una red Layer-1 que respalda la "Economía de las Cosas" al ofrecer a las máquinas y la infraestructura física un lugar para registrar identidades, realizar transacciones y monetizar datos. La red está construida con Substrate y opera como una parachain de Polkadot. Ofrece dos entornos de ejecución: contratos inteligentes EVM escritos en Solidity y pallets de Substrate escritos en Rust.

Para los desarrolladores, este modelo de ejecución dual significa que el RPC de peaq mainnet no es solo un endpoint JSON-RPC compatible con Ethereum. El mismo nodo puede exponer métodos JSON-RPC de estilo Polkadot. En la práctica, la mayoría de las herramientas EVM funcionan sin configuración adicional: Hardhat, Foundry, ethers.js, viem y MetaMask pueden interactuar con peaq una vez que configures los ajustes de red correctos. Si trabajas con herramientas basadas en Substrate, también puedes consultar la cadena mediante métodos RPC del ecosistema de la API de Polkadot.

Ajustes de la cadena peaq mainnet de un vistazo

La siguiente tabla enumera los ajustes que con mayor probabilidad necesitarás al añadir peaq a una cartera, un indexador o un servicio de middleware.

CriterioQué comprobarPor qué es importante
ID de cadena3338 (0xd0a)Se usa para la firma y la protección contra reproducción en transacciones EVM.
Moneda nativaPEAQLas tarifas de gas y las transferencias de valor están denominadas en PEAQ.
Transporte RPCHTTPS y WSSHTTPS maneja llamadas de solicitud/respuesta; WSS es necesario para suscripciones en vivo.
Explorador de bloquesSubscan en https://peaq.subscan.ioTe permite verificar el estado de las transacciones y depurar eventos.
Tiempo de bloque aproximadoUnos 6 segundosDefine las expectativas en cuanto a la confirmación de transacciones y la finalidad.
Compatibilidad EVMJSON-RPC de Ethereum más métodos de SubstrateDetermina qué SDK y herramientas pueden conectarse sin adaptadores personalizados.
Estado de parachainParachain de PolkadotAfecta los mensajes entre cadenas y el comportamiento de finalidad mediante XCM.

Puedes verificar la lista actual de endpoints públicos y metadatos de la cadena en agregadores como ChainList, pero siempre confirma el endpoint con la documentación oficial de la red antes de usarlo en producción.

Cómo conectarse al RPC de peaq mainnet

La forma más sencilla de probar un endpoint RPC de peaq es enviar una solicitud JSON-RPC y comparar el ID de cadena devuelto. Una solicitud curl se ve así:

curl -sS -X POST https://peaq.api.onfinality.io/public -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

Si el endpoint está sano, la respuesta contiene "result":"0xd0a", que es la representación hexadecimal de 3338.

Puedes hacer la misma verificación en JavaScript con ethers.js:

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://peaq.api.onfinality.io/public");
const network = await provider.getNetwork();
console.log(network.chainId.toString()); // 3338

Para aplicaciones de producción, reemplaza la URL pública con un endpoint de la cuenta de tu proveedor de RPC. Los proveedores gestionados suelen darte una clave API y un panel donde puedes monitorear el uso y rotar la clave cuando sea necesario.

¿Qué debes comprobar antes de usar un endpoint RPC de peaq mainnet?

Un endpoint que funcione es el mínimo absoluto. Antes de depender de él, verifica cómo se comporta bajo la carga de trabajo que tu aplicación realmente generará.

Cobertura de métodos

peaq admite métodos RPC de estilo Ethereum y Substrate. Un proveedor puede exponer toda la superficie JSON-RPC de Ethereum, o solo un subconjunto. Si tu aplicación llama a eth_subscribe para transacciones pendientes o registros de eventos, confirma que el proveedor admita ese método sobre WSS. Si tu aplicación necesita métodos de Substrate, confirma que también estén disponibles.

Soporte de archivo y trace

Los nodos de archivo conservan el estado histórico, lo que es útil para indexadores, análisis y dapps que muestran saldos históricos. No todos los endpoints RPC de peaq proporcionan datos de archivo. Si sabes que tu aplicación consultará estado pasado, elige un proveedor que ofrezca nodos con capacidad de archivo o trace. Los métodos de trace son menos comunes en el RPC de peaq, por lo que verifica su disponibilidad antes de crear funciones que dependan de ellos.

Fiabilidad de WebSocket

Las carteras y los paneles en tiempo real dependen de conexiones WebSocket para recibir nuevos bloques, registros y confirmaciones de transacciones. Un endpoint WSS estable es tan importante como el endpoint HTTPS. Si solo pruebas con curl, podrías pasar por alto caídas de conexión, altas tasas de reconexión o límites de suscripción que solo aparecen con un uso sostenido.

Límites de tasa

Los endpoints RPC compartidos o públicos a menudo responden a muchas solicitudes de muchos usuarios a la vez. Bajo carga, es posible que veas respuestas HTTP 429 o limitación de conexiones. Los proveedores de RPC gestionados ofrecen límites más altos y métricas de uso más claras, mientras que un nodo dedicado te da un endpoint que no se comparte con otras cargas de trabajo.

¿RPC público, RPC gestionado o nodo dedicado para peaq?

Tu elección depende de si estás creando un prototipo, ejecutando una aplicación de producción pequeña u operando infraestructura con estrictos requisitos de control.

  • Los endpoints RPC públicos son útiles para pruebas rápidas, tutoriales y desarrollo local. No son una base estable para producción porque su disponibilidad y límites pueden cambiar.
  • Una API RPC gestionada, como la API RPC de OnFinality, te ofrece un endpoint alojado con gestión de claves API, monitoreo de uso y configuración específica de red. Es un buen punto intermedio para equipos que quieren evitar la operación de nodos.
  • Un nodo dedicado te ofrece un nodo peaq aislado que puedes usar para cargas de trabajo intensivas en datos, consultas de archivo, ajustes personalizados y escenarios en los que no quieras compartir infraestructura con otros proyectos. OnFinality ofrece aprovisionamiento de nodos dedicados para equipos que necesitan este nivel de control.

Puedes comparar las opciones actuales en la página de precios de RPC y ver qué redes están cubiertas en la página de redes compatibles. Para peaq específicamente, la página de red de peaq enumera las opciones de endpoint actuales y los detalles de conexión.

Depuración de problemas comunes de RPC de peaq

Incluso con los ajustes de cadena correctos, puedes encontrar problemas al conectarte a peaq mainnet. Estos son modos de fallo comunes y cómo abordarlos.

ID de cadena incorrecto en la cartera o SDK

Si la firma de tu transacción falla o la cartera muestra la red incorrecta, revisa el ID de cadena. peaq mainnet es 3338. Algunas herramientas aceptan el ID de cadena en hexadecimal, por ejemplo 0xd0a. Ten cuidado de no usar por error el ID de cadena de la testnet de peaq.

HTTP 429 o limitación de tasa

Cuando una solicitud falla con 429 Too Many Requests, el endpoint está limitando tu tráfico. Reduce el tamaño de los lotes, añade retroceso (backoff) o cambia a un proveedor gestionado o dedicado. Los endpoints públicos no deben tratarse como infraestructura ilimitada.

Tiempos de espera en eth_getLogs

Consultar registros en un amplio rango de bloques puede agotar el tiempo de espera, especialmente en un endpoint compartido. Usa rangos de bloques más pequeños y ejecuta la consulta en paralelo, o usa un indexador si la aplicación necesita regularmente análisis de registros extensos.

Desconexiones de WebSocket

Las conexiones WebSocket pueden caer debido a cambios de red, tiempos de espera por inactividad o límites del proveedor. Implementa una estrategia de reconexión con retroceso exponencial y suscríbete a un endpoint WSS que admita tu caso de uso.

Métodos RPC de Substrate faltantes

Si una herramienta espera chain_getBlockHash o métodos similares de Substrate, confirma que el endpoint sea un nodo peaq compatible con Substrate. Algunos proveedores exponen solo la superficie EVM; en ese caso, usa un proveedor que exponga ambas superficies.

Uso de OnFinality para el RPC de peaq mainnet

OnFinality proporciona infraestructura RPC alojada para peaq y muchas otras redes. Si necesitas un endpoint RPC de peaq mainnet sin operar tu propio nodo, puedes crear una clave API y usar la API RPC gestionada. OnFinality también ofrece nodos dedicados para equipos que necesitan infraestructura aislada para consultas de archivo, altos volúmenes de solicitudes o requisitos personalizados. Las capacidades y planes exactos están documentados en la página de red de peaq y en la página de precios de RPC.

Debido a que peaq es una cadena basada en Substrate con compatibilidad EVM, es posible que quieras usar tanto métodos JSON-RPC de Ethereum como métodos de Substrate en la misma aplicación. OnFinality admite la red a través de su servicio general de API RPC y servicio de nodo dedicado. Consulta la página de la red para conocer los formatos de endpoint actuales y los detalles de acceso antes de comenzar.

Conclusiones clave

  • peaq mainnet usa el ID de cadena 3338 y el token nativo PEAQ.
  • Puedes conectarte con herramientas JSON-RPC estándar de Ethereum porque peaq es compatible con EVM.
  • WSS es necesario para suscripciones en tiempo real; HTTPS es suficiente para llamadas de solicitud/respuesta.
  • Los endpoints públicos son adecuados para pruebas, pero las cargas de trabajo de producción deben usar un proveedor de RPC gestionado o un nodo dedicado.
  • Verifica la cobertura de métodos del endpoint, el soporte de archivo y los límites de tasa antes de escalar.
  • OnFinality ofrece opciones de RPC gestionado y nodo dedicado para peaq; consulta la página de la red para obtener los detalles actuales.

Preguntas frecuentes

¿Cuál es el ID de cadena del RPC de peaq mainnet?

El ID de cadena de peaq mainnet es 3338, que es 0xd0a en hexadecimal.

¿Es peaq mainnet compatible con EVM?

Sí. peaq está construido sobre Substrate, pero admite la API JSON-RPC de Ethereum, por lo que las carteras y SDK EVM pueden conectarse a él con los ajustes de cadena correctos.

¿Qué token se usa para el gas en peaq mainnet?

El token nativo PEAQ se usa para el gas y las transferencias de valor en peaq mainnet.

¿Puedo usar un endpoint RPC público de peaq en producción?

Los endpoints públicos son aceptables para pruebas, pero son compartidos y pueden estar sujetos a límites de tasa. Para producción, usa un servicio RPC gestionado o un nodo dedicado para tener acceso estable y límites de uso claros.

Base de conocimiento RPC

Detalles RPC relacionados

Nunca te preocupes por la infraestructura nuevamente

OnFinality elimina la carga pesada de DevOps para que puedas construir de forma más inteligente y rápida.

Comenzar