> ## 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 dành cho tác nhân AI

> Mọi thứ tác nhân AI cần để xây dựng trên Solana bằng Helius: đăng ký theo chương trình, truy cập API, SDK, tích hợp MCP và các quy trình làm việc được đề xuất.

Helius cung cấp khả năng hỗ trợ hàng đầu cho các tác nhân AI xây dựng trên Solana. Từ việc tạo tài khoản theo chương trình đến truyền dữ liệu theo thời gian thực, tác nhân có thể khai thác toàn bộ sức mạnh của Helius mà không cần bất kỳ sự can thiệp thủ công nào.

* [Helius MCP](/docs/vi/agents/mcp) — 10 công cụ được định tuyến, hỗ trợ truy vấn blockchain, gửi giao dịch, truyền dữ liệu và nhiều chức năng khác
* [Plugin Claude Code](/docs/vi/agents/claude-code-plugin) — Plugin Claude Code chính thức đầu tiên và hiện là duy nhất từ một công ty tiền mã hóa. Chỉ cần cài đặt một lần: máy chủ MCP + kỹ năng + tệp tham chiếu
* [Kỹ năng](/docs/vi/agents/skills/overview) — Bộ hướng dẫn chuyên sâu cho Claude: [Xây dựng](/docs/vi/agents/skills/build), [Phantom](/docs/vi/agents/skills/phantom), [Jupiter](/docs/vi/agents/skills/jupiter), [DFlow](/docs/vi/agents/skills/dflow), [OKX](/docs/vi/agents/skills/okx), [SVM](/docs/vi/agents/skills/svm)
* [TypeScript SDK](/docs/vi/agents/typescript-sdk) — Các phương thức an toàn kiểu cho tất cả API của Helius
* [Rust SDK](/docs/vi/agents/rust-sdk) — Rust SDK hiệu năng cao cho API của Helius
* [Helius CLI](/docs/vi/agents/cli) — Quản lý tài khoản và viết tập lệnh shell

<Note>
  Phiên bản mà máy có thể đọc của phần này có tại [agents/llms.txt](https://www.helius.dev/docs/agents/llms.txt) để tác nhân AI sử dụng.
</Note>

## MCP so với CLI

[Máy chủ Helius MCP](/docs/vi/agents/mcp) là cách được đề xuất để tác nhân AI tương tác với Helius. Máy chủ này cung cấp 10 công cụ được định tuyến, cho phép AI truy cập trực tiếp và có cấu trúc vào Solana — không cần lệnh shell, không cần phân tích đầu ra và không cần gọi API thủ công.

|                         | [MCP](/docs/vi/agents/mcp)                                                                                                                                                                | [CLI](/docs/vi/agents/cli)                                                            |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- |
| **Phù hợp nhất cho**    | Tác nhân AI trong Claude Code, Cursor, Claude Desktop và mọi công cụ tương thích với MCP                                                                                             | Tập lệnh shell, quy trình CI/CD, quy trình làm việc trên terminal                |
| **Giao diện**           | Lệnh gọi công cụ có cấu trúc với đầu vào/đầu ra được định kiểu                                                                                                                       | Dòng lệnh với đầu ra `--json`                                                    |
| **Khả năng**            | 10 công cụ được định tuyến (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …) hỗ trợ truy vấn blockchain, giao dịch, webhook, truyền dữ liệu, phân tích ví, tài liệu và đăng ký | Hơn 95 lệnh: các khả năng tương tự, cùng với quản lý cấu hình và luồng tương tác |
| **Thiết lập tài khoản** | Tích hợp sẵn: các hành động `heliusAccount` `generateKeypair` → `signup` (liên kết hoặc thanh toán tự động) — không cần công cụ bên ngoài                                            | `helius keygen` → `helius signup`                                                |
| **Khi nào nên dùng**    | Lựa chọn mặc định cho mọi tác nhân AI                                                                                                                                                | Khi cần tự động hóa ở cấp shell hoặc không sử dụng công cụ tương thích với MCP   |

<Tip>
  **Bắt đầu với MCP.** Nếu công cụ AI của bạn hỗ trợ MCP (Claude Code, Cursor, Claude Desktop, v.v.), hãy sử dụng [máy chủ MCP](/docs/vi/agents/mcp) hoặc [Plugin Claude Code](/docs/vi/agents/claude-code-plugin). CLI hữu ích cho việc viết tập lệnh shell và CI/CD, nhưng MCP mang lại trải nghiệm liền mạch hơn cho các quy trình làm việc dựa trên AI — AI gọi trực tiếp các công cụ thay vì khởi chạy lệnh shell và phân tích đầu ra.
</Tip>

## Bắt đầu nhanh: Đăng ký tác nhân

Tác nhân có thể tạo tài khoản Helius và nhận khóa API bằng [Helius CLI](/docs/vi/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
```

Khi thành công (`--resume` hoặc `--pay`), tác nhân của bạn sẽ nhận được khóa API, các điểm cuối RPC và 1.000.000 tín dụng. Xem [hướng dẫn CLI đầy đủ](/docs/vi/agents/cli) để biết chi tiết.

## Xác thực

Mọi yêu cầu API của Helius đều yêu cầu khóa API được truyền dưới dạng tham số truy vấn:

```
?api-key=YOUR_API_KEY
```

Nối giá trị này vào bất kỳ điểm cuối RPC hoặc API nào. Ví dụ: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`

Lấy khóa API từ [Bảng điều khiển Helius](https://dashboard.helius.dev) hoặc theo chương trình thông qua [Helius CLI](/docs/vi/agents/cli).

<Tip>
  **Sử dụng Gatekeeper để giảm độ trễ** — [Gatekeeper (Beta)](/docs/vi/gatekeeper/overview) loại bỏ Cloudflare khỏi đường dẫn trọng yếu, giúp giảm thời gian phản hồi từ hàng chục đến hàng trăm mili giây. Vẫn cùng khóa API, cùng phương thức — chỉ cần thay đổi điểm cuối:

  ```
  https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  ```

  Hỗ trợ tất cả phương thức RPC, DAS, WebSocket, ZK Compression, Priority Fee và Enhanced Transaction. Xem [hướng dẫn di chuyển](/docs/vi/gatekeeper/migration-guide) để biết chi tiết.
</Tip>

## Hướng dẫn dành riêng cho API của Helius

Hãy sử dụng các API được Helius tối ưu hóa này thay vì nối chuỗi các phương thức RPC Solana tiêu chuẩn:

| Nếu bạn cần...                                                               | Hãy dùng                                                                                                               | Lý do                                                                                                                                                                    |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Lịch sử đã lọc, truy xuất dữ liệu quá khứ hoặc hoạt động của tài khoản token | [`getTransactionsForAddress`](/docs/vi/rpc/gettransactionsforaddress)                                                       | Có bộ lọc và phân trang; chỉ dùng `transactionDetails: "full"` khi cần các đối tượng giao dịch thô và siêu dữ liệu (`filters.tokenAccounts` mặc định là `none`)          |
| Hoạt động tập trung vào ví với thay đổi số dư theo từng giao dịch            | [Lịch sử Wallet API](/docs/vi/wallet-api/history) (beta)                                                                    | Phản hồi REST hướng đến ví — không tương đương với truy xuất dữ liệu quá khứ đã lọc bằng GTFA hoặc các đối tượng giao dịch thô đầy đủ                                    |
| Bản ghi SOL/token ở cấp độ chuyển khoản                                      | [`getTransfersByAddress`](/docs/vi/rpc/gettransfersbyaddress)                                                               | Các giao dịch chuyển khoản đã chuẩn hóa — không phải đối tượng giao dịch đầy đủ                                                                                          |
| Lịch sử mới đã phân tích cú pháp, con người có thể đọc                       | [Sự kiện đã phân tích cú pháp](/docs/vi/parsed-events)                                                                      | Ưu tiên hơn [Enhanced Transactions](/docs/vi/enhanced-transactions/overview) cũ; GTFA không sử dụng định dạng phản hồi Enhanced                                               |
| Siêu dữ liệu tài sản ví phong phú                                            | [`getAssetsByOwner`](/docs/vi/api-reference/das/getassetsbyowner) (DAS API)                                                 | Trả về siêu dữ liệu phong phú, không chỉ các tài khoản token thô; tài sản SPL/Token-2022 có thể thay thế được yêu cầu tùy chọn `showFungible` dành riêng cho phương thức |
| Ước tính phí ưu tiên                                                         | [`getPriorityFeeEstimate`](/docs/vi/api-reference/priority-fee/getpriorityfeeestimate)                                      | Phí tối ưu được tính trước, không cần tính toán thủ công                                                                                                                 |
| Lịch sử giao dịch NFT nén                                                    | [`getSignaturesForAsset`](/docs/vi/api-reference/das/getsignaturesforasset) (DAS API)                                       | RPC dựa trên địa chỉ tiêu chuẩn không bao gồm lịch sử NFT nén                                                                                                            |
| Tìm kiếm NFT                                                                 | [`searchAssets`](/docs/vi/api-reference/das/searchassets) hoặc [`getAssetsByGroup`](/docs/vi/api-reference/das/getassetsbygroup) | Dữ liệu được lập chỉ mục, nhanh hơn và rẻ hơn                                                                                                                            |
| Dữ liệu theo thời gian thực                                                  | [LaserStream WebSocket](/docs/vi/rpc/websocket), [LaserStream gRPC](/docs/vi/laserstream) hoặc [Webhook](/docs/vi/webhooks)           | Luồng liên tục hoặc lệnh gọi lại HTTP mà không cần thăm dò                                                                                                               |
| Truyền dữ liệu phụ trợ thông lượng cao có khả năng phát lại                  | [Đăng ký LaserStream gRPC](/docs/vi/api-reference/laserstream/grpc/subscribe) (SDK `subscribe`)                             | WSS trên trình duyệt/giao diện người dùng sử dụng LaserStream WebSocket; MCP `laserstreamSubscribe` chỉ tạo cấu hình/ví dụ — không mở luồng trực tiếp                    |
| Gửi giao dịch với độ trễ thấp                                                | [Helius Sender](/docs/vi/sending-transactions/sender)                                                                       | Định tuyến đa đường (Helius, Jito, Harmonic, Rakurai, v.v.), tỷ lệ giao dịch được ghi nhận cao hơn                                                                       |

## Quy trình làm việc được đề xuất

| Đang xây dựng...                 | Sản phẩm Helius nên dùng                                                                                                                                                                                                                                                                                                                      |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Bot giao dịch                    | [Gatekeeper](/docs/vi/gatekeeper/overview) (RPC có độ trễ thấp nhất) + [Sender](/docs/vi/sending-transactions/sender) (gửi giao dịch nhanh) + [Priority Fee API](/docs/vi/priority-fee-api) + [LaserStream](/docs/vi/laserstream) (giá theo thời gian thực)                                                                                                       |
| Ứng dụng ví                      | [DAS API](/docs/vi/das-api) cho quyền sở hữu tài sản và siêu dữ liệu + [Lịch sử Wallet API](/docs/vi/wallet-api/history) (hoạt động beta kèm thay đổi số dư) hoặc [`getTransactionsForAddress`](/docs/vi/rpc/gettransactionsforaddress) cho lịch sử đã lọc, truy xuất dữ liệu quá khứ, hoạt động của tài khoản token hoặc các đối tượng giao dịch thô đầy đủ |
| Sàn giao dịch NFT                | [DAS API](/docs/vi/das-api) (`searchAssets`, `getAssetsByGroup`) + [Webhook](/docs/vi/webhooks) (theo dõi giao dịch bán/niêm yết)                                                                                                                                                                                                                       |
| Công cụ săn token                | [Gatekeeper](/docs/vi/gatekeeper/overview) (RPC được định tuyến tại biên) + [LaserStream gRPC](/docs/vi/laserstream) (độ trễ thấp nhất) + [Sender](/docs/vi/sending-transactions/sender) (kết nối có stake)                                                                                                                                                  |
| Công cụ theo dõi danh mục đầu tư | [Số dư Wallet API](/docs/vi/wallet-api/balances) (bản tóm tắt danh mục đầu tư beta) + [DAS API](/docs/vi/das-api) (`getAssetsByOwner` với `showFungible` dành riêng cho phương thức) cho kho NFT/siêu dữ liệu                                                                                                                                           |
| Công cụ giám sát ví              | [LaserStream WebSocket](/docs/vi/rpc/websocket) hoặc [Webhook](/docs/vi/webhooks) để nhận thông báo theo thời gian thực                                                                                                                                                                                                                                 |
| Bảng điều khiển phân tích        | [`getTransactionsForAddress`](/docs/vi/rpc/gettransactionsforaddress) để truy xuất dữ liệu quá khứ đã lọc; [Sự kiện đã phân tích cú pháp](/docs/vi/parsed-events) cho các tích hợp phân tích cú pháp mới; chỉ dùng [Enhanced Transactions](/docs/vi/enhanced-transactions/overview) cho các tích hợp phân tích cú pháp hiện có                               |
| Công cụ airdrop                  | [AirShip](https://airship.helius.dev) (rẻ hơn 95% nhờ nén ZK)                                                                                                                                                                                                                                                                                 |

<Note>
  Khi sử dụng [Số dư Wallet API](/docs/vi/wallet-api/balances) để tóm tắt danh mục đầu tư: API đang ở giai đoạn beta; token bị giới hạn ở 100 token mỗi trang; NFT bị loại trừ trừ khi dùng `showNfts=true` (tối đa 100 NFT và chỉ trên trang đầu tiên); `pricePerToken` và `usdValue` có thể là null; giá là ước tính theo giờ, không phải giá thị trường theo thời gian thực; `totalUsdValue` áp dụng cho trang hiện tại, không phải toàn bộ danh mục đầu tư được phân trang; mỗi yêu cầu tốn 100 tín dụng. Hãy sử dụng DAS có phân trang để lấy đầy đủ kho NFT và siêu dữ liệu — không coi Balances là kho NFT đầy đủ.
</Note>

## Tham khảo nhanh về giới hạn tốc độ

Giới hạn tốc độ phụ thuộc vào [gói](/docs/vi/billing/plans) của bạn. Tác nhân bắt đầu ở cấp Agent với 1.000.000 tín dụng. Cấp Agent yêu cầu thanh toán \$1 để ngăn chặn hành vi lạm dụng.

| Gói          | Giá             | Tín dụng hằng tháng | Giới hạn tốc độ RPC | DAS và API Enhanced |
| ------------ | --------------- | ------------------- | ------------------- | ------------------- |
| Agent        | \$1 khi đăng ký | 1M                  | 10 yêu cầu/giây     | 2 yêu cầu/giây      |
| Developer    | \$49/tháng      | 10M                 | 50 yêu cầu/giây     | 10 yêu cầu/giây     |
| Business     | \$499/tháng     | 100M                | 200 yêu cầu/giây    | 50 yêu cầu/giây     |
| Professional | \$999/tháng     | 200M                | 500 yêu cầu/giây    | 100 yêu cầu/giây    |

Để biết giới hạn tốc độ chi tiết cho từng API, hãy xem [Giới hạn tốc độ](/docs/vi/billing/rate-limits).

## Tín dụng cho mỗi lệnh gọi API

| API                         | Tín dụng | Ghi chú                                                                                                                |
| --------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------- |
| Lệnh gọi RPC tiêu chuẩn     | 1        | Hầu hết phương thức RPC Solana                                                                                         |
| `getProgramAccounts`        | 10       | Sử dụng DAS API thay thế khi có thể                                                                                    |
| DAS API                     | 10       | Tất cả điểm cuối DAS                                                                                                   |
| Enhanced Transactions       | 100      | Dữ liệu giao dịch đã phân tích cú pháp                                                                                 |
| `getTransactionsForAddress` | 10+      | Giao dịch đầy đủ tốn 10 tín dụng cho mỗi 100 kết quả trả về; phản hồi chỉ có chữ ký có mức phí cố định là 10 tín dụng. |
| `getTransfersByAddress`     | 10       | Chỉ dành cho gói Developer trở lên                                                                                     |
| Wallet API                  | 100      | Tất cả điểm cuối Wallet API                                                                                            |
| Priority Fee API            | 1        | Ước tính phí                                                                                                           |
| Sender                      | 0        | Miễn phí trên tất cả các gói                                                                                           |
| Sự kiện webhook             | 1        | Cho mỗi sự kiện được gửi                                                                                               |
| Quản lý webhook             | 100      | Tạo, chỉnh sửa, xóa                                                                                                    |

Để xem thông tin phân tích đầy đủ, hãy xem [Tín dụng](/docs/vi/billing/credits).

## Thử lại và xử lý lỗi

### Mã trạng thái HTTP

| Mã  | Ý nghĩa              | Hành động                                       |
| --- | -------------------- | ----------------------------------------------- |
| 200 | Thành công           | Xử lý phản hồi                                  |
| 400 | Yêu cầu không hợp lệ | Sửa tham số yêu cầu                             |
| 401 | Chưa được cấp quyền  | Kiểm tra khóa API                               |
| 429 | Bị giới hạn tốc độ   | Tạm dừng rồi thử lại                            |
| 5xx | Lỗi máy chủ          | Thử lại với thời gian chờ tăng theo cấp số nhân |

### Mẫu thử lại

```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');
}
```

### Theo dõi mức sử dụng tín dụng

```bash theme={"system"}
helius usage --json
```

## Tham khảo nhanh

* **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`
* **Điểm cuối Sender**: `https://sender.helius-rpc.com/fast`
* **Máy chủ MCP**: `https://www.helius.dev/docs/mcp`
* **Bảng điều khiển**: [dashboard.helius.dev](https://dashboard.helius.dev)
* **Trạng thái**: [helius.statuspage.io](https://helius.statuspage.io)