Skip to main content
El SDK de TypeScript de Helius (helius-sdk) facilita el desarrollo en Solana con TypeScript, ya sea en Node.js, el navegador o cualquier otro entorno de ejecución. Esta página explica cómo instalar y usar el SDK, cómo gestionar errores comunes y dónde encontrar la documentación más reciente. Ten en cuenta que el SDK se reescribió a partir de la versión 2.0.0. Esto se hizo para usar @solana/kit y eliminar la dependencia de versiones de @solana/web3.js posteriores a la 1.73.2. Si estás migrando a la versión más reciente, consulta nuestra guía de migración.

GitHub Repository

SDK oficial de TypeScript de Helius para desarrollar en Solana

Instalación

Puedes instalar el SDK de TypeScript de Helius con cualquiera de los siguientes gestores de paquetes:

Inicio rápido

A continuación, se muestra un ejemplo sencillo de cómo usar el SDK de TypeScript para obtener una lista de los activos que pertenecen a una dirección determinada:

Documentación

El directorio de ejemplos contiene ejemplos de código detallados que abarcan cada método y el uso básico, organizados por espacio de nombres. Para consultar la documentación de referencia de la API, revisa nuestra documentación y la documentación oficial de Solana, donde encontrarás ayuda general sobre la API JSON RPC de Solana. Para obtener ayuda general sobre Kit, consulta la documentación de Kit.

Gestión de errores

Se generará un mensaje de error cuando la API devuelva un resultado no exitoso, es decir, un código de estado 4xx o 5xx. Por ejemplo, a continuación se muestra un error 401 generado por una llamada incorrecta a getAsset:

Códigos de error comunes

Al trabajar con el SDK de Helius, puedes encontrar varios códigos de error. A continuación, se detallan algunos de los códigos de error comunes junto con información adicional para ayudarte a resolverlos:
Esto ocurre cuando una solicitud contiene parámetros no válidos.
Esto ocurre cuando se proporciona una clave de API no válida o el acceso está restringido debido a las reglas de RPC.
Esto indica que el usuario superó el límite de solicitudes durante un período determinado o se quedó sin créditos.
Este es un mensaje de error genérico para problemas del servidor. Comunícate con el equipo de soporte de Helius para obtener ayuda.
Si encuentras alguno de estos errores:
1

Check error documentation

Consulta los errores de Kit para ver una lista de los errores que puedes encontrar
2

Review the documentation

Consulta la documentación de Helius para obtener más orientación
3

Contact support

Comunícate con el equipo de soporte de Helius para obtener ayuda más detallada

Contribuciones

¡Agradecemos todas las contribuciones a nuestros SDK! Lee la guía de contribuciones antes de abrir una solicitud de incorporación de cambios.