Passer au contenu principal
Le 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.
Vous utilisez un outil AI compatible MCP ? Le serveur Helius 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.

Installation

Démarrage rapide — Utilisateurs existants

Si vous avez déjà une clé API Helius, configurez-la simplement et commencez :
Obtenez votre clé sur dashboard.helius.dev. C’est tout — passez les étapes d’inscription ci-dessous.

Démarrage rapide — Nouveaux utilisateurs

Les appels à helius signup qui créent un compte nécessitent --email, --first-name et --last-name — y compris pour le forfait Agent. Votre portefeuille sert uniquement au paiement ; il ne remplace pas vos coordonnées. helius signup --resume, qui finalise une inscription existante après un paiement via le lien hébergé, ne nécessite aucune autre option.
1

Générer une paire de clés

Sortie :
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é.
2

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).
3

Obtenez vos clés API et points de terminaison

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.

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 :
Tous les prix affichés en dollars sont exprimés en dollars des États-Unis (USD).
Le forfait Agent (agent) est sélectionné par défaut. Il coûte 10 $ (payés en USDC) afin d’empêcher les abus et vous accorde 1 000 000 de crédits. Pour bénéficier de limites de débit plus élevées et de davantage de crédits, inscrivez-vous avec un forfait payant ou passez ultérieurement à une offre supérieure.

S’inscrire avec une offre spécifique

Mettre à niveau un compte existant

Payer un renouvellement

Lorsqu’un renouvellement d’abonnement arrive à échéance (mensuelle ou annuelle), Helius crée une intention de paiement — un paiement en attente doté d’un identifiant unique, d’un montant et d’une date d’expiration. Vous recevrez l’identifiant de l’intention de paiement par e-mail ou via le tableau de bord.
La commande récupère les détails de l’intention, affiche le montant et la date d’expiration, demande une confirmation, puis envoie le paiement en USDC depuis le portefeuille associé à votre paire de clés.

Référence des commandes

La CLI fournit plus de 95 commandes réparties en 14 catégories. Chaque commande prend en charge --json pour produire une sortie lisible par machine, ainsi que les options globales de remplacement --api-key <key> et --network <net>.

Full Command Reference

Plus de 95 commandes — gestion des comptes, requêtes blockchain, API DAS, portefeuille, webhooks, envoi de transactions, WebSockets, staking, compression ZK et bien plus encore

Mode de sortie JSON

Ajoutez --json à n’importe quelle commande pour obtenir une sortie lisible par machine :
Exemple :

Codes de sortie

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

Configuration

La configuration est stockée dans ~/.helius/ :
Gérez la configuration avec :

Ordre de résolution des clés API

Les clés API sont résolues dans l’ordre suivant :
  1. Option --api-key <key> (remplacement pour chaque commande)
  2. Variable d’environnement HELIUS_API_KEY
  3. ~/.helius/config.json (défini via helius config set-api-key)

Options globales

Toutes les commandes acceptent ces options :

Workflow complet d’un agent

Étapes suivantes

Agents Overview

Conseils sur l’API, workflows et gestion des erreurs pour les agents

Helius MCP

Connectez directement les outils d’IA aux API Helius

View Plans

Découvrez les offres Helius et les options de mise à niveau

Dashboard

Surveillez votre utilisation de l’API et gérez vos clés

Assistance

Discord Community

Rejoignez notre serveur Discord pour obtenir de l’aide en temps réel et bénéficier du soutien de la communauté

Email Support

Contactez directement notre équipe d’assistance