¿Qué es la blockchain de la red peaq y cómo te conectas a ella?

peaq es una blockchain de Capa 1 diseñada para máquinas en lugar de personas. Está dirigida a vehículos, robots, sensores y otros dispositivos que necesitan una identidad verificable, una forma de pagar y un lugar para publicar datos. Si buscaste la blockchain de la red peaq, probablemente quieras una de tres cosas: una explicación sencilla de qué es, la configuración de la cadena para conectar una billetera o aplicación, o un endpoint RPC al que puedas llamar desde el código. Esta página cubre las tres, y luego te ayuda a decidir qué hacer a continuación.

Empieza aquí: ¿qué necesitas realmente de peaq?

Antes de copiar cualquier endpoint, determina cuál de estos coincide con tu situación. Te evita configurar una billetera cuando en realidad necesitabas un nodo backend, o alquilar infraestructura antes de haber escrito una sola solicitud.

Si todavía estás explorando, sigue leyendo. Si ya sabes que necesitas un endpoint, salta a la sección de configuración de la cadena y vuelve para la guía operativa más adelante.

Para qué está construida la blockchain de la red peaq

La mayoría de las cadenas de Capa 1 optimizan para usuarios humanos: billeteras, DeFi, NFT, aplicaciones sociales. peaq invierte eso. Sus primitivas centrales están dirigidas a máquinas que actúan en su propio nombre. Eso significa identidad (una máquina puede tener una dirección y probar que es ella misma), pagos (transferencia de valor de máquina a máquina sin un humano en el circuito) y datos (lecturas de sensores y eventos de dispositivos registrados on-chain).

Dos decisiones de diseño importan para los desarrolladores. Primero, peaq es compatible con EVM, por lo que los contratos Solidity, ethers, viem, Hardhat y Foundry funcionan con un cambio de red en lugar de una reescritura. Segundo, está construido sobre Substrate, por lo que verás tanto herramientas estilo EVM como herramientas estilo Substrate en el mismo ecosistema. En la práctica, la mayoría de los desarrolladores de aplicaciones se mantienen en el lado EVM y nunca tocan la capa Substrate directamente.

El token nativo se usa para gas y para staking, y la cadena expone la superficie JSON-RPC EVM habitual: consultas de bloques, saldos, llamadas a contratos, logs y envío de transacciones. Esa es la superficie que tu proveedor de RPC debe servir bien.

Configuración de la cadena peaq de un vistazo

Usa estos valores al agregar peaq a una billetera como MetaMask, o al configurar una biblioteca cliente. Siempre confirma los valores actuales en la página de la red peaq antes de lanzar, porque los metadatos de la cadena pueden cambiar.

Una entrada de configuración de red de billetera se ve así:

{
  "chainId": "0xCFA",
  "chainName": "peaq",
  "nativeCurrency": {
    "name": "PEAQ",
    "symbol": "PEAQ",
    "decimals": 18
  },
  "rpcUrls": ["<your peaq RPC endpoint>"],
  "blockExplorerUrls": ["<peaq explorer URL>"]
}

Ten en cuenta que 0xCFA es la forma hexadecimal del chain ID 3338. Si una billetera rechaza el valor decimal, usa la forma hex. Para la URL RPC exacta que se colocará en rpcUrls, usa el endpoint publicado en la página de la red peaq en lugar de un valor codificado de un tutorial, ya que los endpoints rotan.

Haciendo tus primeras llamadas JSON-RPC

Una vez que tengas un endpoint, la verificación más rápida es una llamada HTTP sin procesar. Esto confirma que el endpoint es accesible y que estás hablando con la cadena correcta antes de depurar cualquier código de aplicación.

curl -s <your peaq RPC endpoint> \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_chainId",
    "params": []
  }'

Una respuesta correcta devuelve el chain ID en hex. Si obtienes 0xCFA, estás en peaq mainnet. Si obtienes algo más, estás apuntando a la red incorrecta, que es la causa más común de errores confusos de saldo y contratos.

Desde JavaScript, la misma verificación con ethers se ve así:

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("<your peaq RPC endpoint>");

const network = await provider.getNetwork();
console.log("chainId:", network.chainId.toString());

const block = await provider.getBlockNumber();
console.log("latest block:", block);

const balance = await provider.getBalance("0xYourAddress");
console.log("balance:", balance.toString());

Si getBlockNumber avanza entre llamadas, el nodo está sincronizado y siguiendo la cabeza de la cadena. Si está congelado, estás en un nodo obsoleto o en una testnet que ha dejado de producir bloques.

¿API RPC compartida o nodo peaq dedicado?

Esta es la decisión que la mayoría de los equipos toman mal, generalmente por comprar en exceso demasiado pronto o comprar de menos justo antes del lanzamiento. La respuesta correcta depende de tu patrón de solicitudes, no del tamaño de tu proyecto.

OnFinality ofrece ambos: un servicio de API RPC gestionado para equipos que quieren empezar rápido, y nodos dedicados para cargas de trabajo que necesitan capacidad aislada, límites personalizados o acceso a archive y trace. Puedes revisar los precios de RPC para comparar los dos modelos con tu volumen de solicitudes esperado, y explorar las redes RPC compatibles si peaq es una de varias cadenas que operas.

Una regla práctica: empieza en un endpoint compartido, instrumenta tu volumen de solicitudes y tasa de errores, y pasa a un nodo dedicado cuando puedas señalar una métrica específica que la capacidad compartida está perjudicando. Esa métrica suele ser la latencia de consultas de logs, la estabilidad de WebSocket o el rendimiento de escritura durante horas pico.

Depurando problemas comunes de conexión a peaq

La mayoría de los problemas de peaq no son problemas de la cadena. Son problemas de configuración. Revisa esta lista en orden.

Para cualquiera de estos, el primer paso de diagnóstico es siempre el mismo: ejecuta eth_chainId y eth_blockNumber contra el endpoint y confirma que ambos se ven correctos. Esa única verificación elimina la mayoría de las falsas alarmas.

Trabajo en testnet en peaq agung

Si estás construyendo antes del despliegue en mainnet, peaq agung es el entorno de testnet. Tiene su propio chain ID y su propio endpoint, y es una red separada de mainnet. No mezcles las dos en un solo archivo de configuración, y no reutilices claves de mainnet en testnet ni viceversa.

Los tokens de testnet provienen de un faucet en lugar de una compra. La disponibilidad y los límites de tasa del faucet cambian con el tiempo, así que verifica el enlace actual del faucet en la página de la red peaq en lugar de confiar en una URL en caché. Cuando tu integración de testnet pase, cambia el endpoint y el chain ID a los valores de mainnet y vuelve a ejecutar tus pruebas de humo antes de dirigir tráfico real hacia ella.

Lista de verificación operativa antes de salir en vivo

Antes de lanzar una integración con peaq, confirma cada uno de estos:

• El chain ID y el endpoint están fijados en la configuración, no dispersos por el código.
• Tienes un endpoint o proveedor de respaldo para que una sola interrupción no derribe tu aplicación.
• Los clientes WebSocket se reconectan con backoff exponencial y se vuelven a suscribir después de reconectarse.
• Las consultas de logs se paginan por rango de bloques en lugar de solicitarse en un solo tramo grande.
• Monitoreas la tasa de éxito de solicitudes, la latencia y los códigos de error, no solo si la aplicación carga.
• La configuración de testnet y mainnet están claramente separadas.
• Conoces tus solicitudes por segundo pico esperadas y las has emparejado con un plan.

Ese último punto es donde la elección del proveedor se vuelve concreta. Si no puedes indicar tu RPS pico, no estás listo para dimensionar la infraestructura, y pagarás de más o alcanzarás límites en el peor momento.

Puntos clave

• peaq es una Capa 1 compatible con EVM dirigida a máquinas, dispositivos y sistemas autónomos, con identidad, pagos y datos como primitivas centrales.
• Debido a que es compatible con EVM, las herramientas estándar de Ethereum funcionan con un cambio de red.
• Lo primero que debes verificar en cualquier endpoint es eth_chainId; debería devolver el chain ID de peaq.
• Las API RPC compartidas son adecuadas para prototipado y la mayoría del tráfico de frontend; los nodos dedicados son adecuados para indexadores, consultas pesadas de logs y backends de alto rendimiento predecible.
• OnFinality proporciona tanto acceso gestionado a API RPC como infraestructura de nodo dedicado, con detalles en la página de la red peaq.
• Testnet (peaq agung) y mainnet son redes separadas con configuraciones separadas.

Preguntas frecuentes

¿peaq es compatible con EVM?

Sí. peaq expone un entorno de ejecución compatible con EVM, por lo que los contratos Solidity y las bibliotecas estándar de Ethereum como ethers y viem funcionan con un cambio de configuración de red.

¿Cuál es el chain ID de peaq?

peaq mainnet usa el chain ID 3338, que es 0xCFA en hexadecimal. Confirma el valor actual en la página de la red peaq antes de lanzar, ya que los metadatos de la cadena pueden actualizarse.

¿Cómo agrego peaq a MetaMask?

Agrega una red personalizada con el nombre de la red, el chain ID, el símbolo de moneda, la URL RPC y la URL del explorador de bloques de la tabla de configuración de la cadena anterior. Usa el chain ID en hex si la billetera lo requiere.

¿Necesito un nodo dedicado para construir en peaq?

No. Una API RPC compartida es suficiente para la mayoría del desarrollo, pruebas y tráfico de frontend. Considera un nodo dedicado cuando ejecutes indexadores, necesites consultas grandes de logs o requieras rendimiento predecible para escrituras backend.

¿Cómo obtengo tokens de testnet en peaq?

Usa el faucet enlazado desde la página de la red peaq. Los límites y la disponibilidad del faucet cambian, así que siempre verifica el enlace actual en lugar de uno en caché.

¿Qué debo verificar primero cuando fallan las llamadas a peaq?

Ejecuta eth_chainId y eth_blockNumber. Si el chain ID es incorrecto, estás en la red incorrecta; si el número de bloque está congelado, tu nodo no está sincronizado. Ambas verificaciones toman segundos y descartan la mayoría de los errores de configuración.