Helius CLI - Helius Docs

Helius CLIは、Heliusプラットフォームのためのフル機能のコマンドラインインターフェースです。アカウント管理、ブロックチェーンデータクエリ、トランザクション送信、Webhook、リアルタイムストリーミング、ステーキング、ZK Compressionなど、95以上のコマンドを提供し、すべてのコマンドに機械可読のJSON出力を備えています。

MCP互換のAIツールを使用していますか？ Helius MCP サーバは、AIエージェントがHeliusと対話するための推奨方法です。構造化された入力/出力を持つ10のツールを提供し、アカウントのサインアップを内蔵しています。CLIは、シェルスクリプト、CI/CDパイプライン、またはMCPが利用できない場合に使用してください。

インストール

npm install -g helius-cli

クイックスタート — 既存のユーザー

既にHelius APIキーをお持ちの場合は、設定してすぐに使い始めることができます：

helius config set-api-key YOUR_API_KEY

dashboard.helius.devからキーを取得してください。これで完了です。以下のサインアップ手順は省略可能です。

クイックスタート — 新規ユーザー

すべてのhelius signup呼び出しには、--email、--first-name、および--last-nameが必要です — エージェントプランを含みます。

キーペアを生成する

helius keygen

出力：

✓ 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

上記のファンディングヒントは自動払いを使用する場合にのみ適用されます。ホストリンクで支払う予定の場合は、ファンディングをスキップしてください。

アカウントを作成する

2つの支払いモードがあります：ホストリンク（任意のウォレットから支払い；ファンディング不要）または自動払い（ローカルキーペアからUSDCで支払い；この場合、約0.001 SOL + プランの金額を保持する必要があります）。

# 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

APIキーとエンドポイントを取得する

helius projects
helius apikeys <project-id>
helius rpc <project-id>

APIキーはHeliusアカウントにアクセスするための重要な情報です。クライアントサイドのコード、公開リポジトリ、ブラウザでアクセス可能な場所で公開しないでください。

プランと価格

CLIを介して任意のHelius共有プランを直接購入できます。サインアップ時に--planを渡すか、後でhelius upgradeを使用してください：

プラン	価格	クレジット	`--plan`の値
エージェント	1ドル（一次）	1,000,000	`agent`
デベロッパー	月額49ドル	10,000,000	`developer`
ビジネス	月額499ドル	100,000,000	`business`
プロフェッショナル	月額999ドル	200,000,000	`professional`

エージェントプラン（agent）がデフォルトです。1ドル（USDCで支払い）で、1,000,000クレジットを提供します。より高いレート制限とより多くのクレジットが必要な場合、有料プランへのサインアップまたは後でのアップグレードを検討してください。

特定のプランでサインアップ

# 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

既存アカウントのアップグレード

helius upgrade --plan developer --email you@example.com --first-name Jane --last-name Doe

更新の支払い

サブスクリプションの更新が期限になると（毎月または毎年）、Heliusは支払いインテントを作成します—これは一意のID、金額、および有効期限を持つ未決済の支払いです。支払いインテントIDはメールまたはダッシュボードを通じて受け取ります。

helius pay <payment-intent-id>

このコマンドはインテントの詳細をフェッチし、金額と有効期限を表示し、確認を求めた後、キーペアウォレットからUSDC支払いを送信します。

コマンドリファレンス

CLIは14のカテゴリにわたって95以上のコマンドを提供しています。すべてのコマンドは機械可読出力のための--jsonをサポートし、グローバルオーバーライドとして--api-key <key> / --network <net>を使用できます。

完全なコマンドリファレンス

すべての95以上のコマンド — アカウント管理、ブロックチェーンクエリ、DAS API、ウォレット、Webhook、トランザクション送信、WebSocket、ステーキング、ZK圧縮など

JSON出力モード

任意のコマンドに--jsonを追加して機械可読の出力を得る：

helius projects --json
helius balance Gh9ZwEm... --json
helius asset owner 86xCnPe... --json

例：

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

終了コード

エージェントは信頼できる自動化のために終了コードを確認する必要があります：

コード	意味
0	成功
1	一般的なエラー
10	ログインしていない
11	キーペアが見つからない
20	不十分なSOL
21	不十分なUSDC
30	プロジェクトが見つからない
31	プロジェクトが見つからない
40	APIエラー

設定

設定は~/.helius/に保存されます：

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

設定を管理するには：

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

APIキー解決順序

APIキーは以下の順序で解決されます：

--api-key <key>フラグ（コマンドごとのオーバーライド）
HELIUS_API_KEY環境変数
~/.helius/config.json（helius config set-api-keyを介して設定）

グローバルオプション

すべてのコマンドはこれらのフラグを受け入れます：

フラグ	説明
`--api-key <key>`	設定されたAPIキーをオーバーライド
`--network <net>`	ネットワークをオーバーライド（`mainnet`または`devnet`）
`--json`	JSON形式での出力
`-k, --keypair <path>`	キーペアファイルのパス（署名が必要なコマンド）

完全なエージェントワークフロー

# 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

次のステップ

エージェント概要

エージェント向けのAPIガイダンス、ワークフロー、エラーハンドリングを提供

Helius MCP

AIツールをHelius APIに直接接続

プランを見る

Heliusのプランとアップグレードオプションを理解

ダッシュボード

API使用状況を監視し、キーを管理

サポート

Discordコミュニティ

リアルタイムのヘルプとコミュニティサポートのためにDiscordに参加

メールサポート

サポートチームに直接連絡

​インストール

​クイックスタート — 既存のユーザー

​クイックスタート — 新規ユーザー

​プランと価格

​特定のプランでサインアップ

​既存アカウントのアップグレード

​更新の支払い

​コマンドリファレンス

完全なコマンドリファレンス

​JSON出力モード

​終了コード

​設定

​APIキー解決順序

​グローバルオプション

​完全なエージェントワークフロー

​次のステップ

エージェント概要

Helius MCP

プランを見る

ダッシュボード

​サポート

Discordコミュニティ

メールサポート

インストール

クイックスタート — 既存のユーザー

クイックスタート — 新規ユーザー

プランと価格

特定のプランでサインアップ

既存アカウントのアップグレード

更新の支払い

コマンドリファレンス

JSON出力モード

終了コード

設定

APIキー解決順序

グローバルオプション

完全なエージェントワークフロー

次のステップ

サポート