¿Cómo me conecto a la API de Solana devnet para realizar pruebas?

Recomendación rápida: ¿qué endpoint de devnet debería usar?

Para la mayoría del trabajo de desarrollo, el endpoint público de Solana devnet https://api.devnet.solana.com es suficiente para comenzar. Es operado por la Fundación Solana y es el predeterminado para la CLI de Solana y web3.js. Sin embargo, los endpoints públicos pueden congestionarse durante períodos de prueba pico y son compartidos por muchos desarrolladores. Si está ejecutando pruebas de integración, pruebas de carga o un pipeline de integración continua, es posible que desee un endpoint más confiable.

OnFinality proporciona un endpoint RPC de Solana devnet administrado que puede usar con sus herramientas existentes. Está diseñado para desarrolladores que necesitan un rendimiento constante y límites de velocidad más altos que los endpoints públicos típicos. Puede encontrar los detalles del endpoint en la página de red de Solana Devnet. Para cargas de trabajo de mainnet de producción, consulte las opciones de RPC de Solana mainnet.

Guía de decisión:

• ¿Solo está experimentando? Use el endpoint público de devnet o un nivel gratuito de un proveedor.
• ¿Está construyendo una dApp o bot que necesita tiempo de actividad confiable? Considere un servicio RPC administrado como OnFinality para evitar límites de velocidad y tiempo de inactividad.
• ¿Está ejecutando un validador o necesita control total? Puede ejecutar su propio nodo de devnet, pero eso agrega gastos operativos.

¿Qué es la API de Solana devnet?

Solana devnet es un clúster de prueba que imita el entorno de mainnet. Ejecuta el mismo software y usa la misma API JSON-RPC, pero usa tokens de prueba (SOL de devnet) que no tienen valor real. Los desarrolladores usan la API de devnet para:

• Implementar y probar programas de Solana (contratos inteligentes)
• Enviar transacciones y probar integraciones de billeteras
• Validar la lógica del lado del cliente y el manejo de errores
• Ejecutar pruebas automatizadas sin gastar SOL real

La API se basa en JSON-RPC, similar al JSON-RPC de Ethereum, pero con métodos específicos de Solana. Puede interactuar con ella usando la CLI de Solana, web3.js o cualquier cliente HTTP que pueda enviar solicitudes JSON-RPC.

Configuración de la cadena de Solana devnet de un vistazo

Nota: Solana no usa ID de cadena como las cadenas EVM. En su lugar, especifica el clúster (devnet, testnet, mainnet-beta) en su configuración.

Configurando su CLI de Solana para devnet

Si está usando la CLI de Solana, puede cambiar a devnet con un solo comando:

solana config set --url https://api.devnet.solana.com

Para verificar la configuración, ejecute:

solana config get

Debería ver la URL RPC configurada en el endpoint de devnet. Ahora puede crear una billetera y obtener SOL de prueba:

solana-keygen new --outfile ~/.config/solana/devnet.json
solana config set --keypair ~/.config/solana/devnet.json
solana airdrop 1

El comando solana airdrop solicita SOL de devnet del faucet. Si necesita más, puede usar el faucet de Solana o el comando solana airdrop con una cantidad mayor (sujeto a límites de velocidad).

Conectándose con web3.js

Para desarrolladores de JavaScript, la biblioteca @solana/web3.js es la forma estándar de interactuar con Solana. Aquí hay un ejemplo básico de conexión a devnet y verificación del saldo:

import { Connection, LAMPORTS_PER_SOL, PublicKey } from '@solana/web3.js';

// Use el endpoint público de devnet o su endpoint de OnFinality
const connection = new Connection('https://api.devnet.solana.com', 'confirmed');

// Reemplace con la dirección de su billetera de devnet
const address = new PublicKey('YOUR_DEVNET_WALLET_ADDRESS');

const balance = await connection.getBalance(address);
console.log(`Balance: ${balance / LAMPORTS_PER_SOL} SOL`);

Si está usando un proveedor RPC personalizado, reemplace la URL con la proporcionada por OnFinality. Para soporte de WebSocket, puede usar el endpoint wss:// para suscripciones.

Usando la API JSON-RPC directamente

También puede interactuar con la API de Solana devnet usando solicitudes JSON-RPC sin procesar. Esto es útil para depurar o para lenguajes sin un SDK nativo. Aquí hay un ejemplo usando curl para obtener el último blockhash:

curl https://api.devnet.solana.com -X POST -H "Content-Type: application/json" -d '
  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getLatestBlockhash"
  }
'

La respuesta incluirá un blockhash que puede usar para construir transacciones. Para obtener una lista completa de métodos, consulte la documentación de RPC de Solana.

Obteniendo SOL de prueba del faucet de devnet

Para probar transacciones, necesita SOL de devnet. El faucet oficial está en https://faucet.solana.com. Puede solicitar SOL ingresando la dirección de su billetera. También hay faucets de la comunidad, pero tenga cuidado y use solo fuentes confiables.

Si está usando la CLI, el comando solana airdrop es conveniente, pero tiene límites de velocidad. Para pruebas automatizadas, considere solicitar una cantidad mayor una vez y reutilizar la billetera.

Problemas comunes de la API de devnet y cómo depurarlos

Incluso con un endpoint confiable, puede encontrar problemas. Aquí hay problemas comunes y sus soluciones:

Para una depuración más profunda, puede habilitar el registro de RPC en la CLI de Solana:

solana config set --url https://api.devnet.solana.com -v

La bandera -v habilita la salida detallada, que muestra las solicitudes y respuestas JSON-RPC.

Elegir entre RPC de devnet público y administrado

Los endpoints públicos son gratuitos y fáciles de usar, pero tienen limitaciones:

• Límites de velocidad: Los endpoints públicos a menudo limitan las solicitudes por segundo, lo que puede romper sus pruebas si realiza muchas llamadas.
• Tiempo de actividad: Pueden caerse por mantenimiento o sobrecargarse.
• Sin soporte: Si tiene problemas, no hay a quién contactar.

Los proveedores de RPC administrados como OnFinality ofrecen:

• Límites de velocidad más altos: Adecuados para pruebas de carga y pipelines de CI/CD.
• Mejor tiempo de actividad: La infraestructura redundante reduce el riesgo de tiempo de inactividad.
• Soporte: Puede obtener ayuda del proveedor si encuentra problemas.

Para aplicaciones de mainnet de producción, un RPC administrado es casi siempre recomendado. Para devnet, depende de sus necesidades. Si solo está aprendiendo, el endpoint público es suficiente. Si está construyendo un proyecto serio, considere un servicio administrado para evitar sorpresas.

Cómo cambiar de devnet a mainnet más tarde

Cuando esté listo para implementar en mainnet, necesitará cambiar su endpoint RPC y usar SOL real. El proceso es similar:

1. Actualice su configuración de CLI para apuntar al endpoint de mainnet: solana config set --url https://api.mainnet-beta.solana.com
2. Actualice la URL de conexión de su web3.js al endpoint de mainnet.
3. Asegúrese de que su billetera tenga SOL real para las tarifas de transacción.

Si está usando OnFinality, puede usar la misma clave API para devnet y mainnet, pero necesitará cambiar la red en su panel de control. Consulte la página de red de Solana mainnet para obtener detalles.

Conclusiones clave

• La API de Solana devnet es un entorno de prueba gratuito que refleja la funcionalidad de mainnet.
• Use el endpoint público https://api.devnet.solana.com para pruebas simples, pero considere un RPC administrado para un rendimiento confiable.
• Configure su CLI y web3.js con la URL de devnet para comenzar a construir.
• Obtenga SOL de prueba del faucet para financiar sus transacciones.
• Depure problemas comunes como límites de velocidad y fallas de transacción con los consejos anteriores.
• Cuando se mueva a producción, cambie a un endpoint de mainnet y use SOL real.

Preguntas frecuentes

¿Cuál es la diferencia entre Solana devnet y testnet?

Solana tiene múltiples clústeres de prueba. Devnet es el entorno de desarrollo principal donde los desarrolladores implementan y prueban programas. Testnet se usa para pruebas de validadores y actualizaciones de red. Devnet es más estable y es la opción recomendada para la mayoría de los desarrolladores.

¿Puedo usar la misma clave API para devnet y mainnet?

Sí, con OnFinality puede usar la misma clave API en todas las redes, pero debe especificar la red en su solicitud o usar el endpoint específico de la red. Consulte la documentación de la red para obtener detalles.

¿Cómo obtengo más SOL de devnet si el faucet tiene límite de velocidad?

Puede esperar e intentar de nuevo más tarde, o usar un faucet diferente. Algunos faucets de la comunidad ofrecen cantidades mayores, pero tenga cuidado al compartir su clave privada.

¿La API de devnet es la misma que la API de mainnet?

Sí, los métodos JSON-RPC son idénticos. La única diferencia es el estado de la red y el valor de los tokens. Esto facilita cambiar entre devnet y mainnet cambiando la URL del endpoint.

¿Cuáles son los límites de velocidad para el endpoint público de devnet?

Los límites exactos no se publican y pueden cambiar. Si experimenta límites de velocidad, considere usar un proveedor RPC administrado como OnFinality, que ofrece límites más altos y mejor confiabilidad.

Para obtener más información sobre precios de RPC y redes compatibles, visite la página de precios de RPC y la página de redes compatibles.