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

# Helius CLI

> Interface en ligne de commande pour Helius avec plus de 95 commandes pour la gestion de comptes, les requêtes Solana, l'envoi de transactions, les webhooks, le streaming et l'automatisation du staking.

Le [Helius CLI](https://www.npmjs.com/package/helius-cli) est une interface en ligne de commande complète pour la plateforme Helius. Elle offre plus de 95 commandes pour la gestion de comptes, les requêtes de données blockchain, l'envoi de transactions, les webhooks, le streaming en temps réel, le staking, la compression ZK, et bien plus — avec une sortie JSON lisible par machine pour chaque commande.

<Tip>
  **Vous utilisez un outil AI compatible MCP ?** Le [serveur Helius MCP](/docs/fr/agents/mcp) est le moyen recommandé pour que les agents AI interagissent avec Helius — il fournit 10 outils routés avec des entrées/sorties structurées, y compris l'inscription intégrée des comptes. Utilisez le CLI pour les scripts shell, les pipelines CI/CD, ou lorsque MCP n'est pas disponible.
</Tip>

## Installation

```bash theme={"system"}
npm install -g helius-cli
```

## Démarrage rapide — Utilisateurs existants

Si vous avez déjà une clé API Helius, configurez-la simplement et commencez :

```bash theme={"system"}
helius config set-api-key YOUR_API_KEY
```

Obtenez votre clé sur [dashboard.helius.dev](https://dashboard.helius.dev). C'est tout — passez les étapes d'inscription ci-dessous.

## Démarrage rapide — Nouveaux utilisateurs

<Note>
  Les invocations de création de compte `helius signup` nécessitent `--email`, `--first-name`, et `--last-name` — y compris le plan Agent. `helius signup --resume`, qui finalise une inscription existante après paiement via le lien hébergé, n'a besoin d'aucun autre drapeau.
</Note>

<Steps>
  <Step title="Générer une paire de clés">
    ```bash theme={"system"}
    helius keygen
    ```

    Sortie :

    ```
    ✓ Keypair generated
    Path: ~/.helius/keypair.json
    Address: 7xKp...3nQm

    To use this wallet, fund it with:
      • ~0.001 SOL for transaction fees
      • 1 USDC for Helius signup
    ```

    L'indication de financement ci-dessus ne s'applique que si vous utilisez autopay — passez le financement si vous prévoyez de payer via le lien hébergé.
  </Step>

  <Step title="Créer un compte">
    Deux modes de paiement : lien hébergé (paiement depuis n'importe quel portefeuille, pas de financement nécessaire) ou autopay (paiement en USDC depuis la paire de clés locale, qui doit contenir \~0,001 SOL + le montant du plan).

    ```bash theme={"system"}
    # Default: print a hosted payment link, pay with any wallet in the browser
    helius signup --email you@example.com --first-name Jane --last-name Doe

    # After paying via link, finalize the account
    helius signup --resume

    # Or autopay from the local keypair
    helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe
    ```
  </Step>

  <Step title="Obtenez vos clés API et points de terminaison">
    ```bash theme={"system"}
    helius projects
    helius apikeys <project-id>
    helius rpc <project-id>
    ```
  </Step>
</Steps>

<Warning>
  Votre clé API est une information sensible qui accorde l'accès à votre compte Helius. Ne l'exposez jamais dans le code côté client, les dépôts publics ou les zones accessibles par navigateur.
</Warning>

## Plans et Tarification

Vous pouvez acheter n'importe quel plan partagé Helius directement via le CLI. Passez `--plan` lors de l'inscription ou utilisez `helius upgrade` ultérieurement :

| Plan          | Prix          | Crédits     | Valeur `--plan` |
| ------------- | ------------- | ----------- | --------------- |
| Agent         | 1 \$ une fois | 1,000,000   | `agent`         |
| Développeur   | 49 \$/mois    | 10,000,000  | `developer`     |
| Entreprise    | 499 \$/mois   | 100,000,000 | `business`      |
| Professionnel | 999 \$/mois   | 200,000,000 | `professional`  |

<Note>
  Le plan **Agent** (`agent`) est celui par défaut. Il coûte 1 \$ (payé en USDC) pour prévenir les abus et vous donne 1,000,000 de crédits. Pour des limites de taux plus élevées et plus de crédits, inscrivez-vous à un plan payant ou passez à un niveau supérieur plus tard.
</Note>

### Inscription avec un plan spécifique

```bash theme={"system"}
# Default: Agent plan ($1)
helius signup --email you@example.com --first-name Jane --last-name Doe

# Developer plan ($49/mo)
helius signup --plan developer --email you@example.com --first-name Jane --last-name Doe

# Yearly billing (paid plans only)
helius signup --plan business --period yearly --email you@example.com --first-name Jane --last-name Doe
```

### Passer à un compte existant

```bash theme={"system"}
helius upgrade --plan developer --email you@example.com --first-name Jane --last-name Doe
```

### Payer un renouvellement

Lorsqu'un renouvellement d'abonnement est dû (mensuel ou annuel), Helius crée une **intention de paiement** — un paiement en attente avec un identifiant unique, un montant et une expiration. Vous recevrez l'identifiant de l'intention de paiement par email ou sur le [tableau de bord](https://dashboard.helius.dev).

```bash theme={"system"}
helius pay <payment-intent-id>
```

La commande récupère les détails de l'intention, affiche le montant et l'expiration, demande confirmation, puis envoie le paiement USDC à partir de votre portefeuille de paire de clés.

## Référence de Commande

Le CLI propose plus de 95 commandes réparties en 14 catégories. Chaque commande prend en charge `--json` pour une sortie lisible par machine et `--api-key <key>` / `--network <net>` pour les substitutions globales.

<Card title="Référence Complète des Commandes" icon="terminal" href="/docs/fr/agents/cli/commands">
  Toutes les plus de 95 commandes — gestion de comptes, requêtes blockchain, API DAS, portefeuille, webhooks, envoi de transactions, WebSockets, staking, compression ZK, et plus
</Card>

## Mode de Sortie JSON

Ajoutez `--json` à toute commande pour une sortie lisible par machine :

```bash theme={"system"}
helius projects --json
helius balance Gh9ZwEm... --json
helius asset owner 86xCnPe... --json
```

Exemple :

```json theme={"system"}
{
  "projects": [
    {
      "id": "67b9d260-726b-4ba3-8bb0-dbbf794641bf",
      "name": "My Project",
      "plan": "free"
    }
  ]
}
```

## Codes de Sortie

Les agents doivent vérifier les codes de sortie pour une automatisation fiable :

| Code | Signification             |
| ---- | ------------------------- |
| 0    | Succès                    |
| 1    | Erreur générale           |
| 10   | Non connecté              |
| 11   | Paire de clés non trouvée |
| 20   | SOL insuffisant           |
| 21   | USDC insuffisant          |
| 30   | Aucun projet trouvé       |
| 31   | Projet non trouvé         |
| 40   | Erreur API                |

## Configuration

La configuration est stockée dans `~/.helius/` :

```
~/.helius/
├── config.json    # JWT token, API key, network, default project
└── keypair.json   # Solana keypair (if generated with keygen)
```

Gérer la configuration avec :

```bash theme={"system"}
helius config show              # View current config
helius config set-api-key <key> # Set API key
helius config set-network devnet # Switch to devnet
helius config set-project <id>  # Set default project
helius config clear             # Reset everything
```

### Ordre de Résolution des Clés API

Les clés API sont résolues dans cet ordre :

1. Drapeau `--api-key <key>` (substitution par commande)
2. Variable d'environnement `HELIUS_API_KEY`
3. `~/.helius/config.json` (définie via `helius config set-api-key`)

## Options Globales

Toutes les commandes acceptent ces drapeaux :

| Drapeau                | Description                                                                   |
| ---------------------- | ----------------------------------------------------------------------------- |
| `--api-key <key>`      | Remplacer la clé API configurée                                               |
| `--network <net>`      | Remplacer le réseau (`mainnet` ou `devnet`)                                   |
| `--json`               | Sortie au format JSON                                                         |
| `-k, --keypair <path>` | Chemin vers le fichier de paire de clés (commandes nécessitant une signature) |

## Flux de Travail Complet de l'Agent

```bash theme={"system"}
# Step 1: Generate keypair
helius keygen

# Step 2: Create account (default: hosted payment link, pay from any wallet)
helius signup --email you@example.com --first-name Jane --last-name Doe
helius signup --resume   # Finalize after paying via link
# Or autopay from the local keypair (requires ~0.001 SOL + plan USDC):
# helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe

# Step 3: Get API keys
helius projects
helius apikeys <project-id>

# Step 4: Get RPC endpoints
helius rpc <project-id>

# Step 5: Start querying
helius balance <address>
helius asset owner <wallet-address>
helius tx history <address> --limit 10
```

## Prochaines Étapes

<CardGroup cols={2}>
  <Card title="Aperçu des Agents" icon="robot" href="/docs/fr/agents/overview">
    Conseils API, flux de travail, et gestion des erreurs pour les agents
  </Card>

  <Card title="Helius MCP" icon="plug" href="/docs/fr/agents/mcp">
    Connectez directement les outils IA aux APIs Helius
  </Card>

  <Card title="Voir les Plans" icon="credit-card" href="/docs/fr/billing/plans">
    Comprendre les plans Helius et les options de mise à niveau
  </Card>

  <Card title="Tableau de Bord" icon="chart-line" href="https://dashboard.helius.dev">
    Surveillez votre utilisation de l'API et gérez les clés
  </Card>
</CardGroup>

## Support

<CardGroup cols={2}>
  <Card title="Communauté Discord" icon="discord" href="https://discord.com/invite/6GXdee3gBj">
    Rejoignez notre Discord pour obtenir de l'aide en temps réel et du support communautaire
  </Card>

  <Card title="Support Email" icon="envelope" href="mailto:support@helius.xyz">
    Contactez directement notre équipe de support
  </Card>
</CardGroup>