> ## 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 untuk Agen
> Semua yang dibutuhkan agen AI untuk membangun di Solana dengan Helius: pendaftaran terprogram, akses API, SDK, integrasi MCP, dan alur kerja yang direkomendasikan.
Helius menyediakan dukungan kelas satu bagi agen AI yang membangun di Solana. Mulai dari pembuatan akun terprogram hingga streaming data waktu nyata, agen dapat mengakses seluruh kemampuan Helius tanpa intervensi manual.
* [Helius MCP](/docs/id/agents/mcp) — 10 alat dengan perutean yang mencakup kueri blockchain, pengiriman transaksi, streaming, dan lainnya
* [Plugin Claude Code](/docs/id/agents/claude-code-plugin) — Plugin Claude Code resmi pertama dan saat ini satu-satunya dari perusahaan kripto. Satu instalasi: server MCP + keterampilan + berkas referensi
* [Keterampilan](/docs/id/agents/skills/overview) — Kumpulan instruksi pakar untuk Claude: [Build](/docs/id/agents/skills/build), [Phantom](/docs/id/agents/skills/phantom), [Jupiter](/docs/id/agents/skills/jupiter), [DFlow](/docs/id/agents/skills/dflow), [OKX](/docs/id/agents/skills/okx), [SVM](/docs/id/agents/skills/svm)
* [SDK TypeScript](/docs/id/agents/typescript-sdk) — Metode yang aman terhadap tipe untuk semua API Helius
* [SDK Rust](/docs/id/agents/rust-sdk) — SDK Rust berkinerja tinggi untuk API Helius
* [Helius CLI](/docs/id/agents/cli) — Pengelolaan akun dan pembuatan skrip shell
Versi yang dapat dibaca mesin dari bagian ini tersedia di [agents/llms.txt](https://www.helius.dev/docs/agents/llms.txt) untuk digunakan oleh agen AI.
## MCP vs CLI
[Server Helius MCP](/docs/id/agents/mcp) adalah cara yang direkomendasikan bagi agen AI untuk berinteraksi dengan Helius. Server ini menyediakan 10 alat dengan perutean yang memberi AI akses langsung dan terstruktur ke Solana — tanpa perintah shell, penguraian output, atau panggilan API manual.
| | [MCP](/docs/id/agents/mcp) | [CLI](/docs/id/agents/cli) |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Paling sesuai untuk** | Agen AI di Claude Code, Cursor, Claude Desktop, dan alat apa pun yang kompatibel dengan MCP | Skrip shell, pipeline CI/CD, alur kerja terminal |
| **Antarmuka** | Panggilan alat terstruktur dengan input/output bertipe | Baris perintah dengan output `--json` |
| **Kemampuan** | 10 alat dengan perutean (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …) yang mencakup kueri blockchain, transaksi, webhook, streaming, analisis dompet, dokumentasi, dan pendaftaran | Lebih dari 95 perintah: kemampuan yang sama, ditambah pengelolaan konfigurasi dan alur interaktif |
| **Penyiapan akun** | Bawaan: tindakan `heliusAccount` `generateKeypair` → `signup` (tautan atau pembayaran otomatis) — tidak memerlukan alat eksternal | `helius keygen` → `helius signup` |
| **Kapan digunakan** | Pilihan default untuk setiap agen AI | Saat Anda memerlukan otomatisasi tingkat shell atau tidak menggunakan alat yang kompatibel dengan MCP |
**Mulailah dengan MCP.** Jika alat AI Anda mendukung MCP (Claude Code, Cursor, Claude Desktop, dan sebagainya), gunakan [server MCP](/docs/id/agents/mcp) atau [Plugin Claude Code](/docs/id/agents/claude-code-plugin). CLI berguna untuk pembuatan skrip shell dan CI/CD, tetapi MCP memberikan pengalaman yang lebih mulus untuk alur kerja berbasis AI — AI memanggil alat secara langsung, bukan menjalankan perintah shell dan mengurai output.
## Mulai Cepat: Pendaftaran Agen
Agen dapat membuat akun Helius dan memperoleh kunci API dengan [Helius CLI](/docs/id/agents/cli):
```bash theme={"system"}
npm install -g helius-cli # Install CLI
helius keygen # Generate keypair
# Default: prints a hosted payment link — pay with any wallet in the browser
helius signup --email you@example.com --first-name Jane --last-name Doe --json
# After paying via the link, finalize the account
helius signup --resume --json
# Or autopay: fund the keypair with 1 USDC + ~0.001 SOL, then
helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe --json
```
Jika berhasil (`--resume` atau `--pay`), agen Anda menerima kunci API, endpoint RPC, dan 1.000.000 kredit. Lihat [panduan CLI lengkap](/docs/id/agents/cli) untuk detailnya.
## Autentikasi
Semua permintaan API Helius memerlukan kunci API yang diteruskan sebagai parameter kueri:
```
?api-key=YOUR_API_KEY
```
Tambahkan ini ke endpoint RPC atau API apa pun. Contoh: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
Dapatkan kunci API dari [Dasbor Helius](https://dashboard.helius.dev) atau secara terprogram melalui [Helius CLI](/docs/id/agents/cli).
**Gunakan Gatekeeper untuk latensi yang lebih rendah** — [Gatekeeper (Beta)](/docs/id/gatekeeper/overview) menghapus Cloudflare dari jalur kritis sehingga mengurangi waktu respons hingga puluhan sampai ratusan milidetik. Kunci API dan metodenya tetap sama — cukup ganti endpoint:
```
https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
```
Mendukung semua metode RPC, DAS, WebSocket, ZK Compression, Priority Fee, dan Enhanced Transaction. Lihat [panduan migrasi](/docs/id/gatekeeper/migration-guide) untuk detailnya.
## Panduan API Khusus Helius
Gunakan API yang dioptimalkan untuk Helius berikut, alih-alih merangkai metode RPC Solana standar:
| Jika Anda memerlukan... | Gunakan ini | Alasan |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Riwayat terfilter, pengisian data historis, atau aktivitas akun token | [`getTransactionsForAddress`](/docs/id/rpc/gettransactionsforaddress) | Filter dan paginasi; gunakan `transactionDetails: "full"` hanya saat objek transaksi mentah dan metadata diperlukan (`filters.tokenAccounts` secara default bernilai `none`) |
| Aktivitas yang berpusat pada dompet dengan perubahan saldo per transaksi | [Riwayat Wallet API](/docs/id/wallet-api/history) (beta) | Respons REST yang berorientasi pada dompet — tidak setara dengan pengisian data historis terfilter GTFA atau objek transaksi lengkap mentah |
| Catatan SOL/token pada tingkat transfer | [`getTransfersByAddress`](/docs/id/rpc/gettransfersbyaddress) | Transfer yang dinormalisasi — bukan objek transaksi lengkap |
| Riwayat baru yang telah diurai dan mudah dibaca manusia | [Parsed Events](/docs/id/parsed-events) | Lebih disarankan daripada [Enhanced Transactions](/docs/id/enhanced-transactions/overview) lama; GTFA tidak menggunakan format respons Enhanced |
| Metadata aset dompet yang lengkap | [`getAssetsByOwner`](/docs/id/api-reference/das/getassetsbyowner) (DAS API) | Mengembalikan metadata lengkap, bukan sekadar akun token mentah; kepemilikan SPL/Token-2022 yang dapat dipertukarkan memerlukan opsi `showFungible` khusus metode |
| Estimasi biaya prioritas | [`getPriorityFeeEstimate`](/docs/id/api-reference/priority-fee/getpriorityfeeestimate) | Biaya optimal yang telah dihitung sebelumnya, tanpa perhitungan manual |
| Riwayat transaksi NFT terkompresi | [`getSignaturesForAsset`](/docs/id/api-reference/das/getsignaturesforasset) (DAS API) | RPC berbasis alamat standar tidak menyertakan riwayat NFT terkompresi |
| Pencarian NFT | [`searchAssets`](/docs/id/api-reference/das/searchassets) atau [`getAssetsByGroup`](/docs/id/api-reference/das/getassetsbygroup) | Data terindeks yang lebih cepat dan lebih murah |
| Data waktu nyata | [LaserStream WebSocket](/docs/id/rpc/websocket), [LaserStream gRPC](/docs/id/laserstream), atau [Webhook](/docs/id/webhooks) | Streaming persisten atau callback HTTP tanpa polling |
| Streaming backend berthroughput tinggi dengan pemutaran ulang | [LaserStream gRPC Subscribe](/docs/id/api-reference/laserstream/grpc/subscribe) (SDK `subscribe`) | WSS browser/UI menggunakan LaserStream WebSocket; MCP `laserstreamSubscribe` hanya menghasilkan konfigurasi/contoh — tidak membuka streaming langsung |
| Pengiriman transaksi berlatensi rendah | [Helius Sender](/docs/id/sending-transactions/sender) | Perutean multijalur (Helius, Jito, Harmonic, Rakurai, dan sebagainya), tingkat keberhasilan masuk yang lebih tinggi |
## Alur Kerja yang Direkomendasikan
| Yang sedang dibuat... | Produk Helius yang Digunakan |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Bot perdagangan | [Gatekeeper](/docs/id/gatekeeper/overview) (RPC berlatensi terendah) + [Sender](/docs/id/sending-transactions/sender) (pengiriman transaksi cepat) + [Priority Fee API](/docs/id/priority-fee-api) + [LaserStream](/docs/id/laserstream) (harga waktu nyata) |
| Aplikasi dompet | [DAS API](/docs/id/das-api) untuk kepemilikan aset dan metadata + [Riwayat Wallet API](/docs/id/wallet-api/history) (aktivitas beta dengan perubahan saldo) atau [`getTransactionsForAddress`](/docs/id/rpc/gettransactionsforaddress) untuk riwayat terfilter, pengisian data historis, aktivitas akun token, atau objek transaksi lengkap mentah |
| Marketplace NFT | [DAS API](/docs/id/das-api) (`searchAssets`, `getAssetsByGroup`) + [Webhook](/docs/id/webhooks) (melacak penjualan/daftar penawaran) |
| Token sniper | [Gatekeeper](/docs/id/gatekeeper/overview) (RPC dengan perutean edge) + [LaserStream gRPC](/docs/id/laserstream) (latensi terendah) + [Sender](/docs/id/sending-transactions/sender) (koneksi dengan staking) |
| Pelacak portofolio | [Saldo Wallet API](/docs/id/wallet-api/balances) (ringkasan portofolio beta) + [DAS API](/docs/id/das-api) (`getAssetsByOwner` dengan `showFungible` khusus metode) untuk inventaris NFT/metadata |
| Pemantau dompet | [LaserStream WebSocket](/docs/id/rpc/websocket) atau [Webhook](/docs/id/webhooks) untuk notifikasi waktu nyata |
| Dasbor analitik | [`getTransactionsForAddress`](/docs/id/rpc/gettransactionsforaddress) untuk pengisian data historis terfilter; [Parsed Events](/docs/id/parsed-events) untuk integrasi terurai yang baru; [Enhanced Transactions](/docs/id/enhanced-transactions/overview) hanya untuk integrasi terurai yang sudah ada |
| Alat airdrop | [AirShip](https://airship.helius.dev) (95% lebih murah dengan kompresi ZK) |
Saat menggunakan [Saldo Wallet API](/docs/id/wallet-api/balances) untuk ringkasan portofolio: API ini masih beta; token dibatasi hingga 100 per halaman; NFT tidak disertakan kecuali `showNfts=true` (maksimal 100 NFT dan hanya pada halaman pertama); `pricePerToken` dan `usdValue` dapat bernilai null; harga merupakan estimasi per jam, bukan harga pasar waktu nyata; `totalUsdValue` mencakup halaman saat ini, bukan seluruh portofolio yang dipaginasi; setiap permintaan dikenai biaya 100 kredit. Gunakan DAS dengan paginasi untuk inventaris dan metadata NFT yang lengkap — jangan perlakukan Balances sebagai inventaris NFT lengkap.
## Referensi Cepat Batas Laju
Batas laju bergantung pada [paket](/docs/id/billing/plans) Anda. Agen memulai dengan tingkat Agent yang memiliki 1.000.000 kredit. Tingkat Agent memerlukan pembayaran \$1 untuk mencegah penyalahgunaan.
| Paket | Harga | Kredit Bulanan | Batas Laju RPC | DAS & Enhanced API |
| ------------ | --------------- | -------------- | ------------------ | ------------------ |
| Agent | Pendaftaran \$1 | 1 jt | 10 permintaan/dtk | 2 permintaan/dtk |
| Developer | \$49/bln | 10 jt | 50 permintaan/dtk | 10 permintaan/dtk |
| Business | \$499/bln | 100 jt | 200 permintaan/dtk | 50 permintaan/dtk |
| Professional | \$999/bln | 200 jt | 500 permintaan/dtk | 100 permintaan/dtk |
Untuk batas laju terperinci per API, lihat [Batas Laju](/docs/id/billing/rate-limits).
## Kredit Per Panggilan API
| API | Kredit | Catatan |
| --------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| Panggilan RPC standar | 1 | Sebagian besar metode RPC Solana |
| `getProgramAccounts` | 10 | Gunakan DAS API sebagai gantinya jika memungkinkan |
| DAS API | 10 | Semua endpoint DAS |
| Enhanced Transactions | 100 | Data transaksi yang telah diurai |
| `getTransactionsForAddress` | 10+ | Transaksi lengkap dikenai biaya 10 kredit per 100 hasil; respons yang hanya berisi tanda tangan dikenai biaya tetap 10 kredit. |
| `getTransfersByAddress` | 10 | Hanya paket Developer+ |
| Wallet API | 100 | Semua endpoint Wallet API |
| Priority Fee API | 1 | Estimasi biaya |
| Sender | 0 | Gratis di semua paket |
| Peristiwa webhook | 1 | Per peristiwa yang dikirimkan |
| Pengelolaan webhook | 100 | Membuat, mengedit, menghapus |
Untuk perincian lengkap, lihat [Kredit](/docs/id/billing/credits).
## Percobaan Ulang dan Penanganan Kesalahan
### Kode Status HTTP
| Kode | Arti | Tindakan |
| ---- | ------------------------ | ------------------------------------- |
| 200 | Berhasil | Proses respons |
| 400 | Permintaan tidak valid | Perbaiki parameter permintaan |
| 401 | Tidak terotorisasi | Periksa kunci API |
| 429 | Dibatasi oleh batas laju | Tunggu dan coba lagi |
| 5xx | Kesalahan server | Coba lagi dengan backoff eksponensial |
### Pola Percobaan Ulang
```typescript theme={"system"}
async function heliusRequest(url: string, data: object, maxRetries = 3) {
for (let attempt = 0; attempt < maxRetries; attempt++) {
const response = await fetch(url, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(data),
});
if (response.ok) return response.json();
if (response.status === 429) {
const retryAfter = response.headers.get('Retry-After');
const delay = retryAfter ? parseInt(retryAfter) * 1000 : Math.pow(2, attempt) * 1000;
await new Promise(resolve => setTimeout(resolve, delay));
continue;
}
if (response.status >= 500) {
await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
continue;
}
throw new Error(`Request failed: ${response.status} ${await response.text()}`);
}
throw new Error('Max retries exceeded');
}
```
### Pantau Penggunaan Kredit
```bash theme={"system"}
helius usage --json
```
## Referensi Cepat
* **RPC Mainnet**: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **RPC Mainnet (Gatekeeper Beta)**: `https://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **RPC Devnet**: `https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **WSS Mainnet**: `wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **WSS Mainnet (Gatekeeper Beta)**: `wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **WSS Devnet**: `wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Endpoint Sender**: `https://sender.helius-rpc.com/fast`
* **Server MCP**: `https://www.helius.dev/docs/mcp`
* **Dasbor**: [dashboard.helius.dev](https://dashboard.helius.dev)
* **Status**: [helius.statuspage.io](https://helius.statuspage.io)