> ## 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
> Heliusのためのフル機能のコマンドラインインターフェース。アカウント管理、ブロックチェーンクエリ、トランザクション送信、Webhook、ストリーミング、ステーキングなどに対応した95以上のコマンドが利用可能です。エージェントと自動化のために設計されています。
[Helius CLI](https://www.npmjs.com/package/helius-cli)は、Heliusプラットフォームのためのフル機能のコマンドラインインターフェースです。アカウント管理、ブロックチェーンデータクエリ、トランザクション送信、Webhook、リアルタイムストリーミング、ステーキング、ZK Compressionなど、95以上のコマンドを提供し、すべてのコマンドに機械可読のJSON出力を備えています。
**MCP互換のAIツールを使用していますか？** [Helius MCP サーバ](/ja/agents/mcp)は、AIエージェントがHeliusと対話するための推奨方法です。構造化された入力/出力を持つ10のツールを提供し、アカウントのサインアップを内蔵しています。CLIは、シェルスクリプト、CI/CDパイプライン、またはMCPが利用できない場合に使用してください。
## インストール
```bash theme={"system"}
npm install -g helius-cli
```
## クイックスタート — 既存のユーザー
既にHelius APIキーをお持ちの場合は、設定してすぐに使い始めることができます：
```bash theme={"system"}
helius config set-api-key YOUR_API_KEY
```
[dashboard.helius.dev](https://dashboard.helius.dev)からキーを取得してください。これで完了です。以下のサインアップ手順は省略可能です。
## クイックスタート — 新規ユーザー
すべての`helius signup`呼び出しには、`--email`、`--first-name`、および`--last-name`が必要です — エージェントプランを含みます。
```bash theme={"system"}
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 + プランの金額を保持する必要があります）。
```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
```
```bash theme={"system"}
helius projects
helius apikeys
helius rpc
```
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クレジットを提供します。より高いレート制限とより多くのクレジットが必要な場合、有料プランへのサインアップまたは後でのアップグレードを検討してください。
### 特定のプランでサインアップ
```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
```
### 既存アカウントのアップグレード
```bash theme={"system"}
helius upgrade --plan developer --email you@example.com --first-name Jane --last-name Doe
```
### 更新の支払い
サブスクリプションの更新が期限になると（毎月または毎年）、Heliusは**支払いインテント**を作成します—これは一意のID、金額、および有効期限を持つ未決済の支払いです。支払いインテントIDはメールまたは[ダッシュボード](https://dashboard.helius.dev)を通じて受け取ります。
```bash theme={"system"}
helius pay
```
このコマンドはインテントの詳細をフェッチし、金額と有効期限を表示し、確認を求めた後、キーペアウォレットからUSDC支払いを送信します。
## コマンドリファレンス
CLIは14のカテゴリにわたって95以上のコマンドを提供しています。すべてのコマンドは機械可読出力のための`--json`をサポートし、グローバルオーバーライドとして`--api-key ` / `--network `を使用できます。
すべての95以上のコマンド — アカウント管理、ブロックチェーンクエリ、DAS API、ウォレット、Webhook、トランザクション送信、WebSocket、ステーキング、ZK圧縮など
## JSON出力モード
任意のコマンドに`--json`を追加して機械可読の出力を得る：
```bash theme={"system"}
helius projects --json
helius balance Gh9ZwEm... --json
helius asset owner 86xCnPe... --json
```
例：
```json theme={"system"}
{
"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)
```
設定を管理するには：
```bash theme={"system"}
helius config show # View current config
helius config set-api-key # Set API key
helius config set-network devnet # Switch to devnet
helius config set-project # Set default project
helius config clear # Reset everything
```
### APIキー解決順序
APIキーは以下の順序で解決されます：
1. `--api-key `フラグ（コマンドごとのオーバーライド）
2. `HELIUS_API_KEY`環境変数
3. `~/.helius/config.json`（`helius config set-api-key`を介して設定）
## グローバルオプション
すべてのコマンドはこれらのフラグを受け入れます：
| フラグ | 説明 |
| ---------------------- | ------------------------------------ |
| `--api-key ` | 設定されたAPIキーをオーバーライド |
| `--network ` | ネットワークをオーバーライド（`mainnet`または`devnet`） |
| `--json` | JSON形式での出力 |
| `-k, --keypair ` | キーペアファイルのパス（署名が必要なコマンド） |
## 完全なエージェントワークフロー
```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
# Step 4: Get RPC endpoints
helius rpc
# Step 5: Start querying
helius balance
helius asset owner
helius tx history --limit 10
```
## 次のステップ
エージェント向けのAPIガイダンス、ワークフロー、エラーハンドリングを提供
AIツールをHelius APIに直接接続
Heliusのプランとアップグレードオプションを理解
API使用状況を監視し、キーを管理
## サポート
リアルタイムのヘルプとコミュニティサポートのためにDiscordに参加
サポートチームに直接連絡