> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK de TypeScript de Helius para Solana

> SDK oficial de TypeScript de Helius para desarrollar en Solana. Instala helius-sdk, obtén activos con la API de DAS y gestiona errores comunes y códigos de estado RPC.

El SDK de TypeScript de Helius ([`helius-sdk`](https://github.com/helius-labs/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](https://github.com/helius-labs/helius-sdk/blob/main/MIGRATION.md).

<CardGroup cols={1}>
  <Card title="GitHub Repository" icon="js" href="https://github.com/helius-labs/helius-sdk">
    SDK oficial de TypeScript de Helius para desarrollar en Solana
  </Card>
</CardGroup>

## Instalación

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

<Tabs>
  <Tab title="npm">
    ```bash theme={"system"}
    npm install helius-sdk
    ```
  </Tab>

  <Tab title="pnpm">
    ```bash theme={"system"}
    pnpm install helius-sdk
    ```
  </Tab>

  <Tab title="Yarn">
    ```bash theme={"system"}
    yarn add helius-sdk
    ```
  </Tab>
</Tabs>

## 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:

```typescript theme={"system"}
import { createHelius } from "helius-sdk";

(async () => {
  const apiKey = ""; // From Helius dashboard
  const helius = createHelius({ apiKey });

  try {
    const assets = await helius.getAssetsByOwner({
      ownerAddress: "owner_address_goes_here",
      page: 1,
      limit: 50,
      sortBy: { sortBy: "created", sortDirection: "asc" },
    });

    console.log("Fetched assets:", assets);
  } catch (error) {
    console.error("Error:", error);
  }
})();
```

## Documentación

El [directorio de ejemplos](https://github.com/helius-labs/helius-sdk/tree/main/examples) 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](/docs/es/api-reference) y la [documentación oficial de Solana](https://solana.com/docs/rpc), donde encontrarás ayuda general sobre la API JSON RPC de Solana. Para obtener ayuda general sobre Kit, consulta la [documentación de Kit](https://www.solanakit.com/).

## 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:

```typescript theme={"system"}
{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Authentication failed. Missing or invalid API key."
  },
  "id": "1"
}
```

### 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:

<AccordionGroup>
  <Accordion title="400: Bad Request">
    Esto ocurre cuando una solicitud contiene parámetros no válidos.
  </Accordion>

  <Accordion title="401: Unauthorized">
    Esto ocurre cuando se proporciona una clave de API no válida o el acceso está restringido debido a las reglas de RPC.
  </Accordion>

  <Accordion title="429: Too Many Requests">
    Esto indica que el usuario superó el límite de solicitudes durante un período determinado o se quedó sin créditos.
  </Accordion>

  <Accordion title="5XX: Internal Server Error">
    Este es un mensaje de error genérico para problemas del servidor. Comunícate con el equipo de soporte de Helius para obtener ayuda.
  </Accordion>
</AccordionGroup>

Si encuentras alguno de estos errores:

<Steps>
  <Step title="Check error documentation">
    Consulta los [errores de Kit](https://www.solanakit.com/docs/concepts/errors) para ver una lista de los errores que puedes encontrar
  </Step>

  <Step title="Review the documentation">
    Consulta la [documentación de Helius](/docs/) para obtener más orientación
  </Step>

  <Step title="Contact support">
    Comunícate con el equipo de soporte de Helius para obtener ayuda más detallada
  </Step>
</Steps>

## Contribuciones

¡Agradecemos todas las contribuciones a nuestros SDK! Lee la [guía de contribuciones](https://github.com/helius-labs/helius-sdk/blob/main/CONTRIBUTING.md) antes de abrir una solicitud de incorporación de cambios.