> ## 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
> Giao diện dòng lệnh dành cho Helius với hơn 95 lệnh để quản lý tài khoản, truy vấn Solana, gửi giao dịch, quản lý webhook, truyền phát và tự động hóa staking.
[Helius CLI](https://www.npmjs.com/package/helius-cli) là giao diện dòng lệnh đầy đủ tính năng dành cho nền tảng Helius. Công cụ này cung cấp hơn 95 lệnh để quản lý tài khoản, truy vấn dữ liệu blockchain, gửi giao dịch, quản lý webhook, truyền phát theo thời gian thực, staking, ZK Compression và nhiều tác vụ khác — với đầu ra JSON có thể được máy đọc cho mọi lệnh.
**Bạn đang sử dụng công cụ AI tương thích với MCP?** [Máy chủ Helius MCP](/docs/vi/agents/mcp) là cách được khuyến nghị để các 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 với đầu vào/đầu ra có cấu trúc, bao gồm tính năng đăng ký tài khoản tích hợp sẵn. Sử dụng CLI cho tập lệnh shell, quy trình CI/CD hoặc khi không có MCP.
## Cài đặt
```bash theme={"system"}
npm install -g helius-cli
```
## Bắt đầu nhanh — Người dùng hiện tại
Nếu đã có khóa API Helius, bạn chỉ cần thiết lập khóa rồi bắt đầu:
```bash theme={"system"}
helius config set-api-key YOUR_API_KEY
```
Lấy khóa từ [dashboard.helius.dev](https://dashboard.helius.dev). Vậy là xong — bỏ qua các bước đăng ký bên dưới.
## Bắt đầu nhanh — Người dùng mới
Các lần gọi `helius signup` để tạo tài khoản yêu cầu `--email`, `--first-name` và `--last-name` — bao gồm cả gói Agent. `helius signup --resume`, dùng để hoàn tất một lượt đăng ký hiện có sau khi thanh toán qua liên kết được lưu trữ, không cần cờ nào khác.
```bash theme={"system"}
helius keygen
```
Đầu ra:
```
✓ 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
```
Gợi ý nạp tiền ở trên chỉ áp dụng nếu bạn sẽ sử dụng tính năng thanh toán tự động — bỏ qua việc nạp tiền nếu bạn định thanh toán qua liên kết được lưu trữ.
Có hai phương thức thanh toán: liên kết được lưu trữ (thanh toán từ bất kỳ ví nào, không cần nạp tiền) hoặc thanh toán tự động (thanh toán USDC từ cặp khóa cục bộ, cặp khóa này phải có khoảng 0.001 SOL cộng với số tiền của gói).
```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
```
Khóa API là thông tin nhạy cảm cấp quyền truy cập vào tài khoản Helius của bạn. Tuyệt đối không để lộ khóa trong mã phía máy khách, kho lưu trữ công khai hoặc các khu vực có thể truy cập từ trình duyệt.
## Gói dịch vụ và giá
Bạn có thể mua trực tiếp bất kỳ gói Helius dùng chung nào thông qua CLI. Truyền `--plan` khi đăng ký hoặc sử dụng `helius upgrade` sau đó:
| Gói | Giá | Tín dụng | Giá trị `--plan` |
| ------------ | ----------- | ----------- | ---------------- |
| Agent | \$1 một lần | 1,000,000 | `agent` |
| Developer | \$49/tháng | 10,000,000 | `developer` |
| Business | \$499/tháng | 100,000,000 | `business` |
| Professional | \$999/tháng | 200,000,000 | `professional` |
Gói **Agent** (`agent`) là gói mặc định. Gói này có giá \$1 (thanh toán bằng USDC) nhằm ngăn chặn hành vi lạm dụng và cung cấp cho bạn 1,000,000 tín dụng. Để có giới hạn tốc độ cao hơn và nhiều tín dụng hơn, hãy đăng ký gói trả phí hoặc nâng cấp sau.
### Đăng ký một gói cụ thể
```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
```
### Nâng cấp tài khoản hiện có
```bash theme={"system"}
helius upgrade --plan developer --email you@example.com --first-name Jane --last-name Doe
```
### Thanh toán gia hạn
Khi đến hạn gia hạn gói đăng ký (hằng tháng hoặc hằng năm), Helius sẽ tạo một **yêu cầu thanh toán** — khoản thanh toán đang chờ xử lý với ID, số tiền và thời hạn riêng. Bạn sẽ nhận được ID yêu cầu thanh toán qua email hoặc [bảng điều khiển](https://dashboard.helius.dev).
```bash theme={"system"}
helius pay
```
Lệnh này truy xuất thông tin chi tiết của yêu cầu, hiển thị số tiền và thời hạn, yêu cầu xác nhận, sau đó gửi khoản thanh toán USDC từ ví cặp khóa của bạn.
## Tham chiếu lệnh
CLI cung cấp hơn 95 lệnh thuộc 14 danh mục. Mọi lệnh đều hỗ trợ `--json` để tạo đầu ra có thể được máy đọc và các tùy chọn ghi đè toàn cục `--api-key ` / `--network `.
Toàn bộ hơn 95 lệnh — quản lý tài khoản, truy vấn blockchain, DAS API, ví, webhook, gửi giao dịch, WebSocket, staking, nén ZK và nhiều chức năng khác
## Chế độ đầu ra JSON
Thêm `--json` vào bất kỳ lệnh nào để nhận đầu ra có thể được máy đọc:
```bash theme={"system"}
helius projects --json
helius balance Gh9ZwEm... --json
helius asset owner 86xCnPe... --json
```
Ví dụ:
```json theme={"system"}
{
"projects": [
{
"id": "67b9d260-726b-4ba3-8bb0-dbbf794641bf",
"name": "My Project",
"plan": "free"
}
]
}
```
## Mã thoát
Các tác nhân nên kiểm tra mã thoát để đảm bảo quá trình tự động hóa đáng tin cậy:
| Mã | Ý nghĩa |
| -- | ------------------------ |
| 0 | Thành công |
| 1 | Lỗi chung |
| 10 | Chưa đăng nhập |
| 11 | Không tìm thấy cặp khóa |
| 20 | Không đủ SOL |
| 21 | Không đủ USDC |
| 30 | Không tìm thấy dự án nào |
| 31 | Không tìm thấy dự án |
| 40 | Lỗi API |
## Cấu hình
Cấu hình được lưu trong `~/.helius/`:
```
~/.helius/
├── config.json # JWT token, API key, network, default project
└── keypair.json # Solana keypair (if generated with keygen)
```
Quản lý cấu hình bằng:
```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
```
### Thứ tự phân giải khóa API
Khóa API được phân giải theo thứ tự sau:
1. Cờ `--api-key ` (ghi đè theo từng lệnh)
2. Biến môi trường `HELIUS_API_KEY`
3. `~/.helius/config.json` (được thiết lập qua `helius config set-api-key`)
## Tùy chọn toàn cục
Tất cả các lệnh đều chấp nhận các cờ sau:
| Cờ | Mô tả |
| ---------------------- | --------------------------------------------------------- |
| `--api-key ` | Ghi đè khóa API đã cấu hình |
| `--network ` | Ghi đè mạng (`mainnet` hoặc `devnet`) |
| `--json` | Xuất ở định dạng JSON |
| `-k, --keypair ` | Đường dẫn đến tệp cặp khóa (dành cho các lệnh yêu cầu ký) |
## Quy trình làm việc đầy đủ cho tác nhân
```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
```
## Bước tiếp theo
Hướng dẫn về API, quy trình làm việc và xử lý lỗi dành cho tác nhân
Kết nối trực tiếp các công cụ AI với API Helius
Tìm hiểu các gói Helius và tùy chọn nâng cấp
Theo dõi mức sử dụng API và quản lý khóa
## Hỗ trợ
Tham gia Discord của chúng tôi để nhận trợ giúp theo thời gian thực và hỗ trợ từ cộng đồng
Liên hệ trực tiếp với đội ngũ hỗ trợ của chúng tôi