> ## 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 TypeScript Helius Solana

> SDK TypeScript officiel de Helius pour le développement Solana. Installez helius-sdk, récupérez des actifs avec l'API DAS et gérez les erreurs courantes et les codes de statut RPC.

Le SDK TypeScript Helius ([`helius-sdk`](https://github.com/helius-labs/helius-sdk)) facilite le développement sur Solana en TypeScript — dans Node.js, le navigateur, ou tout autre environnement d'exécution. Cette page couvre l'installation et l'utilisation du SDK, la gestion des erreurs courantes, et où trouver la documentation la plus récente.

Notez que le SDK a été réécrit à partir de la version 2.0.0. Cela a été fait pour utiliser `@solana/kit` et supprimer la dépendance aux versions de `@solana/web3.js` supérieures à 1.73.2. Pour ceux qui migrent vers la dernière version, veuillez vous référer à notre [guide de migration](https://github.com/helius-labs/helius-sdk/blob/main/MIGRATION.md).

<CardGroup cols={1}>
  <Card title="Dépôt GitHub" icon="js" href="https://github.com/helius-labs/helius-sdk">
    SDK TypeScript officiel de Helius pour le développement Solana
  </Card>
</CardGroup>

## Installation

Le SDK TypeScript Helius peut être installé avec l'un des gestionnaires de paquets suivants :

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

## Démarrage rapide

Voici un exemple simple de l'utilisation du SDK TypeScript pour récupérer une liste d'actifs possédés par une adresse donnée :

```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);
  }
})();
```

## Documentation

Le [répertoire des exemples](https://github.com/helius-labs/helius-sdk/tree/main/examples) est rempli d'exemples de code détaillés couvrant chaque méthode et utilisation de base, organisés par espace de noms. Pour la documentation de référence de l'API, consultez notre [documentation](/docs/fr/api-reference) et la [documentation officielle de Solana](https://solana.com/docs/rpc) pour l'aide générale sur l'API RPC JSON de Solana. Pour l'aide générale avec Kit, veuillez vous référer à la [documentation de Kit](https://www.solanakit.com/).

## Gestion des erreurs

Un message d'erreur sera généré lorsque l'API renvoie un statut non réussi (c'est-à-dire, code de statut 4xx ou 5xx).

Par exemple, ci-dessous se trouve une erreur 401 générée pour un appel getAsset incorrect :

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

### Codes d'erreur courants

Lors de l'utilisation du SDK Helius, vous pouvez rencontrer plusieurs codes d'erreur. Ci-dessous se trouve un tableau détaillant certains des codes d'erreur courants avec des informations supplémentaires pour vous aider à résoudre les problèmes :

<AccordionGroup>
  <Accordion title="400: Mauvaise requête">
    Cela se produit lorsque les paramètres d'une requête sont invalides.
  </Accordion>

  <Accordion title="401: Non autorisé">
    Cela se produit lorsqu'une clé API invalide est fournie ou que l'accès est restreint en raison des règles RPC.
  </Accordion>

  <Accordion title="429: Trop de requêtes">
    Cela indique que l'utilisateur a dépassé la limite de requêtes dans un délai donné ou n'a plus de crédits.
  </Accordion>

  <Accordion title="5XX: Erreur interne du serveur">
    Il s'agit d'un message d'erreur générique pour les problèmes côté serveur. Veuillez contacter le support Helius pour assistance.
  </Accordion>
</AccordionGroup>

Si vous rencontrez l'une de ces erreurs :

<Steps>
  <Step title="Consultez la documentation des erreurs">
    Référez-vous aux [erreurs de Kit](https://www.solanakit.com/docs/concepts/errors) pour une liste des erreurs que vous pouvez rencontrer
  </Step>

  <Step title="Examinez la documentation">
    Consultez la [documentation Helius](/docs/) pour plus d'orientations
  </Step>

  <Step title="Contactez le support">
    Contactez l'équipe de support Helius pour une assistance plus détaillée
  </Step>
</Steps>

## Contribuer

Nous accueillons toutes les contributions à nos SDKs ! Lisez le [guide des contributions](https://github.com/helius-labs/helius-sdk/blob/main/CONTRIBUTING.md) avant d'ouvrir une demande de tirage.