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 の呼び出しには、Agent プランを含め、--email、--first-name、--last-name が必要です。ウォレットは支払いにのみ使用され、連絡先情報の代わりにはなりません。ホスト型リンク経由で支払いを行った後に既存のサインアップを完了する helius signup --resume には、ほかのフラグは必要ありません。

キーペアを生成する

helius keygen

出力：

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

To use this wallet, fund it with:
  - ~0.001 SOL for transaction fees
  - USDC for your chosen plan:
      agent          $10 (one-time)
      developer      $49/mo
      business       $499/mo
      professional   $999/mo

Then run: helius signup --email <email> --first-name <name> --last-name <name>
  Options: --plan <plan> --period monthly|yearly --coupon <code> --pay

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

アカウントを作成する

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を使用してください：

ドルで表示されている価格はすべて米ドル（USD）です。

プラン	料金	クレジット	`--plan` の値
Agent	$10（1回限り）	1,000,000	`agent`
Developer	$49/月	10,000,000	`developer`
Business	$499/月	100,000,000	`business`
Professional	$999/月	200,000,000	`professional`

Agent プラン（agent）がデフォルトです。不正利用を防止するため、料金は $10（USDC で支払い）で、1,000,000 クレジットが付与されます。より高いレート制限と多くのクレジットが必要な場合は、有料プランでサインアップするか、後からアップグレードしてください。

特定のプランで登録する

# Default: Agent plan ($10)
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> を使用できます。

Full Command Reference

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

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

次のステップ

Agents Overview

エージェント向けの API ガイダンス、ワークフロー、エラー処理

Helius MCP

AI ツールを Helius API に直接接続します

View Plans

Helius のプランとアップグレードオプションを確認します

Dashboard

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

サポート

Discord Community

リアルタイムのヘルプやコミュニティサポートを利用するには、Discord に参加してください

Email Support

サポートチームに直接お問い合わせください

​インストール

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

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

​プランと価格

​特定のプランで登録する

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

​更新料金を支払う

​コマンドリファレンス

Full Command Reference

​JSON 出力モード

​終了コード

​設定

​API キーの解決順序

​グローバルオプション

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

​次のステップ

Agents Overview

Helius MCP

View Plans

Dashboard

​サポート

Discord Community

Email Support

インストール

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

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

プランと価格

特定のプランで登録する

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

更新料金を支払う

コマンドリファレンス

JSON 出力モード

終了コード

設定

API キーの解決順序

グローバルオプション

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

次のステップ

サポート