¿Qué es la API de Solana y cómo se usa?

¿Qué es la API de Solana?

La API de Solana es una interfaz JSON-RPC que permite a las aplicaciones comunicarse con la blockchain de Solana. Sigue la especificación JSON-RPC 2.0 y admite transporte HTTP y WebSocket. A través de esta API, los desarrolladores pueden consultar saldos de cuentas, enviar transacciones, obtener datos de bloques y suscribirse a eventos en tiempo real.

La documentación oficial de Solana proporciona una lista completa de métodos RPC, pero para aplicaciones en producción, no se recomienda depender de endpoints públicos debido a límites de tasa y problemas de confiabilidad. En su lugar, los desarrolladores suelen usar proveedores RPC de terceros que ofrecen infraestructura dedicada.

• Use HTTP POST for request-response methods.
• Set Content-Type: application/json.
• Check the error object in responses for RPC-specific failures.

Resumen de Métodos de la API de Solana

La API de Solana incluye docenas de métodos organizados en categorías: cuentas, tokens, transacciones, bloques, información del clúster y economía. Algunos de los métodos más utilizados son:

• getBalance – Devuelve el saldo de SOL de una cuenta.
• getTransaction – Recupera una transacción confirmada por su firma.
• sendTransaction – Envía una transacción firmada al clúster.
• getProgramAccounts – Devuelve todas las cuentas propiedad de un programa.
• getLatestBlockhash – Obtiene el último hash de bloque para la construcción de transacciones.
• simulateTransaction – Simula una transacción sin confirmarla.
• getSlot – Devuelve el número de slot actual.
• getBlock – Obtiene un bloque por su número de slot.

Conexión a Clústeres de Solana

Solana opera tres clústeres principales: Mainnet, Devnet y Testnet. Cada clúster tiene un endpoint RPC público, pero estos son compartidos y tienen límites de tasa. Para aplicaciones en producción, debes usar un proveedor RPC dedicado que ofrezca mayor rendimiento y confiabilidad.

Los endpoints públicos son:

Mainnet: https://api.mainnet.solana.com

Devnet: https://api.devnet.solana.com

Testnet: https://api.testnet.solana.com

• Mainnet – Red de producción que usa SOL real. Úsala para dApps en vivo.
• Devnet – Red de pruebas para desarrolladores con SOL gratuito del faucet. Ideal para desarrollo y pruebas.
• Testnet – Red de pruebas para validadores. Se usa para pruebas de rendimiento de la red.

Realizando tu Primera Llamada a la API

Aquí tienes un ejemplo simple usando curl para llamar al método getSlot en Mainnet de Solana a través de un endpoint público:

curl https://api.mainnet.solana.com -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"getSlot","params":[]}'

Para producción, reemplazarías el endpoint público con una URL específica del proveedor. Por ejemplo, usando el endpoint RPC de Solana de OnFinality:

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

• 1. Call getLatestBlockhash
• 2. Build and sign transaction with your keypair
• 3. Test with simulateTransaction
• 4. Submit with sendTransaction
• 5. Confirm with getSignatureStatuses or signatureSubscribe

Suscripciones WebSocket

La API de Solana también admite suscripciones WebSocket para actualizaciones en tiempo real. Puedes suscribirte a cambios de cuentas, logs de programas y actualizaciones de slots. Esto es útil para construir dApps receptivas que reaccionen a eventos en la cadena.

Ejemplo de suscripción a cambios de cuenta:

wscat -c wss://api.mainnet.solana.com

> {"jsonrpc":"2.0","id":1,"method":"accountSubscribe","params":["PUBLIC_KEY",{"commitment":"finalized"}]}

• accountSubscribe – account data changes
• logsSubscribe – program logs
• programSubscribe – program-owned account updates
• signatureSubscribe – transaction confirmation
• slotSubscribe – new slot notifications

Elegir un Proveedor RPC de Solana

Al seleccionar un proveedor RPC de Solana para producción, considera los siguientes criterios:

¿Por qué usar OnFinality para RPC de Solana?

OnFinality ofrece endpoints RPC de Solana confiables con soporte para Mainnet, Devnet y Testnet. Nuestra infraestructura está diseñada para cargas de trabajo en producción, con baja latencia y alta disponibilidad. Ya sea que necesites un endpoint público compartido o un nodo dedicado, OnFinality proporciona opciones flexibles para adaptarse a tu escala.

Comienza con una clave API gratuita y experimenta el rendimiento y la confiabilidad que OnFinality ofrece.

• Test the exact request patterns your frontend and backend will use.
• Confirm WebSocket access if you use subscriptions.
• Check archive support if you need historical data beyond recent slots.
• Verify rate limits and upgrade paths for sustained traffic.
• Use devnet for staging and test SOL from the official faucet.
• Monitor error rates, latency, and usage before full rollout.

Preguntas frecuentes