API de Astar: Cómo conectarse a la red Astar y a los endpoints de datos RPC

Recomendación rápida: ¿Qué API de Astar deberías usar?

Antes de entrar en detalles, aquí tienes una guía rápida para ayudarte a decidir qué API de Astar se adapta a tu caso de uso:

• Para interacciones estándar con blockchain (leer saldos, enviar transacciones, consultar bloques): usa la API JSON-RPC de Astar a través de un proveedor de RPC. Esta es la API principal para dApps y billeteras.
• Para datos de precio y suministro de tokens: usa la API de Token de Astar (api.astar.network) para obtener información sobre el precio de ASTR, capitalización de mercado y suministro.
• Para datos de staking de dApps: usa la API de dApp Staking o el índice GraphQL para consultar estadísticas de staking, recompensas e información de stakers.
• Para cargas de trabajo de producción de alta demanda: considera un nodo dedicado o un servicio de RPC gestionado que ofrezca fiabilidad y escalabilidad, ya que la API de token pública tiene restricciones de uso.

Si estás construyendo una aplicación de producción, necesitas un proveedor de RPC que ofrezca rendimiento consistente, soporte WebSocket y datos de archivo. OnFinality proporciona endpoints RPC de Astar y nodos dedicados que pueden manejar tu carga de trabajo.

¿Qué es la API de Astar?

La API de Astar es un conjunto de interfaces que permiten a los desarrolladores interactuar con la red Astar. Incluye:

• API JSON-RPC: métodos compatibles con Ethereum para leer y escribir datos de blockchain, como eth_blockNumber, eth_getBalance y eth_sendRawTransaction.
• API de Token: endpoints RESTful para estadísticas de tokens, como precio de ASTR, capitalización de mercado y suministro.
• API de dApp Staking: endpoints RESTful para consultar datos de staking de dApps, como TVL, stakers y recompensas.
• Índice GraphQL: un endpoint GraphQL para consultas avanzadas sobre datos de staking de dApps.

Astar es una plataforma de contratos inteligentes multicadena que soporta tanto contratos inteligentes EVM como WebAssembly (Wasm). Como parachain de Polkadot, ofrece interoperabilidad entre cadenas. La API JSON-RPC es familiar para los desarrolladores de Ethereum, lo que facilita la migración de dApps existentes.

API JSON-RPC de Astar: Conexión a la red

Para interactuar con la red Astar, necesitas un endpoint RPC. Puedes usar un endpoint público, un proveedor gestionado o tu propio nodo. Aquí tienes un ejemplo usando el endpoint público de OnFinality:

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

Esta solicitud devuelve el número de bloque más reciente. Puedes usar el mismo endpoint con librerías como ethers.js o viem:

import { createPublicClient, http } from 'viem';

const client = createPublicClient({
  chain: astar,
  transport: http('https://astar.api.onfinality.io/public')
});

const blockNumber = await client.getBlockNumber();
console.log('Número de bloque actual:', blockNumber);

Para soporte WebSocket, puedes usar wss://astar.api.onfinality.io/public/ws para suscripciones en tiempo real.

API de Token de Astar: Obtención de datos de precio y suministro

La API de Token de Astar proporciona estadísticas de tokens para ASTR. Está disponible en https://api.astar.network/api/v3/astar/token. La API está documentada con Swagger UI en https://api.astar.network/.

Ejemplo de solicitud para obtener estadísticas del token ASTR:

curl https://api.astar.network/api/v3/astar/token

Esto devuelve JSON con campos como price, market_cap, circulating_supply y total_supply. Ten en cuenta que esta API es un servicio complementario con uso restringido y puede no ser adecuada para escenarios de alta demanda. Para producción, considera alojar tu propia instancia o usar un servicio de datos dedicado.

API de dApp Staking e índice

La API de dApp Staking te permite consultar datos de staking en Astar. Los endpoints incluyen:

• /api/v3/{network}/dapps-staking/chaindapps - lista de dApps registradas
• /api/v3/{network}/dapps-staking/tvl/{period} - TVL para un período dado
• /api/v3/{network}/dapps-staking/stakerslist/{contractAddress} - lista de stakers para una dApp
• /api/v3/{network}/dapps-staking/rewards/{period} - eventos de recompensas

Para consultas más complejas, el índice GraphQL está disponible en https://squid.subsquid.io/dapps-staking-indexer-astar/graphql. Esto te permite consultar datos de staking con GraphQL.

Cómo elegir un proveedor de RPC para Astar

Al seleccionar un proveedor de RPC para Astar, considera los siguientes factores:

OnFinality ofrece endpoints RPC de Astar con opciones públicas y privadas, así como nodos dedicados para cargas de trabajo de alto rendimiento. Puedes comparar precios de RPC para encontrar un plan que se adapte a tus necesidades.

Errores comunes y solución de problemas

• Límite de tasa: Los endpoints públicos a menudo tienen límites de tasa. Si alcanzas los límites, considera un plan de pago o un nodo dedicado.
• Desconexiones de WebSocket: Asegúrate de que tu cliente maneje las reconexiones correctamente.
• ID de cadena incorrecto: El ID de cadena de la red principal de Astar es 592. Asegúrate de que tu billetera o dApp use el ID correcto.
• Consistencia de datos: Al usar datos de archivo, verifica que el proveedor soporte el rango de bloques requerido.

Conclusiones clave

• La API de Astar incluye endpoints JSON-RPC, de token y de staking de dApps.
• Para aplicaciones de producción, elige un proveedor de RPC confiable que ofrezca rendimiento y soporte.
• Las API públicas tienen restricciones de uso; considera infraestructura dedicada para escenarios de alta demanda.
• OnFinality proporciona endpoints RPC de Astar y nodos dedicados para apoyar tu desarrollo.

Preguntas frecuentes

¿Qué es la API de Astar?

La API de Astar es un conjunto de interfaces para interactuar con la red Astar, incluyendo métodos JSON-RPC para datos de blockchain, estadísticas de tokens y datos de staking de dApps.

¿Cómo obtengo un endpoint RPC de Astar?

Puedes usar un endpoint público como https://astar.api.onfinality.io/public o registrarte en un proveedor gestionado como OnFinality para obtener un endpoint privado.

¿Es gratuita la API de Token de Astar?

Sí, la API de Token de Astar es gratuita pero tiene restricciones de uso. Para aplicaciones de alta demanda, considera alojar tu propia instancia o usar un servicio de datos dedicado.

¿Puedo usar WebSocket con Astar?

Sí, muchos proveedores de RPC ofrecen endpoints WebSocket para suscripciones en tiempo real. OnFinality proporciona soporte WebSocket para Astar.

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

El ID de cadena de la red principal de Astar es 592. Para testnets, usa el ID apropiado.

¿Cómo elijo entre RPC público y dedicado?

Los endpoints públicos son adecuados para desarrollo y uso ligero. Para aplicaciones de producción con alto tráfico, los nodos dedicados ofrecen mejor rendimiento y fiabilidad. Compara precios de RPC para decidir.

Para más información, visita la página de la red Astar y explora las redes compatibles.