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

> Antarmuka baris perintah untuk Helius dengan lebih dari 95 perintah untuk pengelolaan akun, kueri Solana, pengiriman transaksi, webhook, streaming, dan otomatisasi staking.

[Helius CLI](https://www.npmjs.com/package/helius-cli) adalah antarmuka baris perintah berfitur lengkap untuk platform Helius. Antarmuka ini menyediakan lebih dari 95 perintah untuk pengelolaan akun, kueri data blockchain, pengiriman transaksi, webhook, streaming waktu nyata, staking, ZK Compression, dan lainnya — dengan keluaran JSON yang dapat dibaca mesin untuk setiap perintah.

<Tip>
  **Menggunakan alat AI yang kompatibel dengan MCP?** [Server Helius MCP](/docs/id/agents/mcp) adalah cara yang direkomendasikan bagi agen AI untuk berinteraksi dengan Helius — server ini menyediakan 10 alat terarah dengan masukan/keluaran terstruktur, termasuk pendaftaran akun bawaan. Gunakan CLI untuk skrip shell, pipeline CI/CD, atau saat MCP tidak tersedia.
</Tip>

## Instalasi

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

## Mulai Cepat — Pengguna Lama

Jika Anda sudah memiliki kunci API Helius, cukup atur kunci tersebut dan mulai:

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

Dapatkan kunci Anda dari [dashboard.helius.dev](https://dashboard.helius.dev). Selesai — lewati langkah-langkah pendaftaran di bawah ini.

## Mulai Cepat — Pengguna Baru

<Note>
  Pemanggilan `helius signup` yang membuat akun memerlukan `--email`, `--first-name`, dan `--last-name` — termasuk paket Agent. `helius signup --resume`, yang menyelesaikan pendaftaran yang sudah ada setelah pembayaran melalui tautan yang dihosting, tidak memerlukan flag lain.
</Note>

<Steps>
  <Step title="Generate a keypair">
    ```bash theme={"system"}
    helius keygen
    ```

    Keluaran:

    ```
    ✓ 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
    ```

    Petunjuk pendanaan di atas hanya berlaku jika Anda akan menggunakan pembayaran otomatis — lewati pendanaan jika Anda berencana membayar melalui tautan yang dihosting.
  </Step>

  <Step title="Create account">
    Tersedia dua metode pembayaran: tautan yang dihosting (bayar dari dompet mana pun, tanpa perlu mendanai apa pun) atau pembayaran otomatis (bayar USDC dari pasangan kunci lokal, yang harus menyimpan sekitar 0,001 SOL + jumlah biaya paket).

    ```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="Get your API keys and endpoints">
    ```bash theme={"system"}
    helius projects
    helius apikeys <project-id>
    helius rpc <project-id>
    ```
  </Step>
</Steps>

<Warning>
  Kunci API Anda adalah informasi sensitif yang memberikan akses ke akun Helius Anda. Jangan pernah mengeksposnya dalam kode sisi klien, repositori publik, atau area yang dapat diakses melalui browser.
</Warning>

## Paket & Harga

Anda dapat membeli paket bersama Helius apa pun secara langsung melalui CLI. Teruskan `--plan` saat mendaftar atau gunakan `helius upgrade` nanti:

| Paket        | Harga            | Kredit      | Nilai `--plan` |
| ------------ | ---------------- | ----------- | -------------- |
| Agent        | \$1 sekali bayar | 1.000.000   | `agent`        |
| Developer    | \$49/bln         | 10.000.000  | `developer`    |
| Business     | \$499/bln        | 100.000.000 | `business`     |
| Professional | \$999/bln        | 200.000.000 | `professional` |

<Note>
  Paket **Agent** (`agent`) adalah paket default. Paket ini berharga \$1 (dibayar dalam USDC) untuk mencegah penyalahgunaan dan memberi Anda 1.000.000 kredit. Untuk batas laju yang lebih tinggi dan lebih banyak kredit, daftarlah dengan paket berbayar atau lakukan peningkatan nanti.
</Note>

### Mendaftar dengan paket tertentu

```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
```

### Meningkatkan akun yang sudah ada

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

### Membayar perpanjangan

Saat perpanjangan langganan jatuh tempo (bulanan atau tahunan), Helius membuat **intensi pembayaran** — pembayaran tertunda dengan ID unik, jumlah, dan waktu kedaluwarsa. Anda akan menerima ID intensi pembayaran melalui email atau [dasbor](https://dashboard.helius.dev).

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

Perintah tersebut mengambil detail intensi, menampilkan jumlah dan waktu kedaluwarsa, meminta konfirmasi, lalu mengirim pembayaran USDC dari dompet pasangan kunci Anda.

## Referensi Perintah

CLI menyediakan lebih dari 95 perintah dalam 14 kategori. Setiap perintah mendukung `--json` untuk keluaran yang dapat dibaca mesin serta penggantian global `--api-key <key>` / `--network <net>`.

<Card title="Full Command Reference" icon="terminal" href="/docs/id/agents/cli/commands">
  Seluruh lebih dari 95 perintah — pengelolaan akun, kueri blockchain, DAS API, dompet, webhook, pengiriman transaksi, WebSocket, staking, kompresi ZK, dan lainnya
</Card>

## Mode Keluaran JSON

Tambahkan `--json` ke perintah apa pun untuk mendapatkan keluaran yang dapat dibaca mesin:

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

Contoh:

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

## Kode Keluar

Agen harus memeriksa kode keluar untuk otomatisasi yang andal:

| Kode | Arti                            |
| ---- | ------------------------------- |
| 0    | Berhasil                        |
| 1    | Kesalahan umum                  |
| 10   | Belum masuk                     |
| 11   | Pasangan kunci tidak ditemukan  |
| 20   | SOL tidak mencukupi             |
| 21   | USDC tidak mencukupi            |
| 30   | Tidak ada proyek yang ditemukan |
| 31   | Proyek tidak ditemukan          |
| 40   | Kesalahan API                   |

## Konfigurasi

Konfigurasi disimpan di `~/.helius/`:

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

Kelola konfigurasi dengan:

```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
```

### Urutan Resolusi Kunci API

Kunci API ditentukan dalam urutan berikut:

1. Flag `--api-key <key>` (penggantian per perintah)
2. Variabel lingkungan `HELIUS_API_KEY`
3. `~/.helius/config.json` (diatur melalui `helius config set-api-key`)

## Opsi Global

Semua perintah menerima flag berikut:

| Flag                   | Deskripsi                                                                       |
| ---------------------- | ------------------------------------------------------------------------------- |
| `--api-key <key>`      | Ganti kunci API yang dikonfigurasi                                              |
| `--network <net>`      | Ganti jaringan (`mainnet` atau `devnet`)                                        |
| `--json`               | Keluarkan dalam format JSON                                                     |
| `-k, --keypair <path>` | Jalur ke berkas pasangan kunci (untuk perintah yang memerlukan penandatanganan) |

## Alur Kerja Agen Lengkap

```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
```

## Langkah Berikutnya

<CardGroup cols={2}>
  <Card title="Agents Overview" icon="robot" href="/docs/id/agents/overview">
    Panduan API, alur kerja, dan penanganan kesalahan untuk agen
  </Card>

  <Card title="Helius MCP" icon="plug" href="/docs/id/agents/mcp">
    Hubungkan alat AI langsung ke API Helius
  </Card>

  <Card title="View Plans" icon="credit-card" href="/docs/id/billing/plans">
    Pahami paket Helius dan opsi peningkatan
  </Card>

  <Card title="Dashboard" icon="chart-line" href="https://dashboard.helius.dev">
    Pantau penggunaan API Anda dan kelola kunci
  </Card>
</CardGroup>

## Dukungan

<CardGroup cols={2}>
  <Card title="Discord Community" icon="discord" href="https://discord.com/invite/6GXdee3gBj">
    Bergabunglah dengan Discord kami untuk mendapatkan bantuan waktu nyata dan dukungan komunitas
  </Card>

  <Card title="Email Support" icon="envelope" href="mailto:support@helius.xyz">
    Hubungi tim dukungan kami secara langsung
  </Card>
</CardGroup>