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

# Tài liệu tham chiếu Parsed Streams

> Tài liệu tham chiếu API cho các phương thức JSON-RPC của Parsed Streams qua WebSocket. Đăng ký nhận các giao dịch Solana đã giải mã với khả năng lọc phía máy chủ.

Parsed Streams được cung cấp trên tất cả các gói. Xác thực bằng khóa API của dự án. Mỗi sự kiện được gửi tốn 1 credit; xem [Credit](/docs/vi/billing/credits#tín-dụng-truyền-phát-dữ-liệu).

Parsed Streams sử dụng **JSON-RPC 2.0** qua một kết nối WebSocket duy nhất. Mỗi yêu cầu nhận được một phản hồi có cùng `id`. Sau đó, một đăng ký sẽ đẩy các thông báo `parsedTransactionNotification` cho đến khi bạn hủy đăng ký hoặc ngắt kết nối.

| Phương thức                    | Mục đích                                                               |
| ------------------------------ | ---------------------------------------------------------------------- |
| `parsedTransactionSubscribe`   | Bắt đầu đăng ký với một bộ lọc                                         |
| `parsedTransactionUnsubscribe` | Dừng đăng ký                                                           |
| `describeProgram`              | Liệt kê các chỉ thị, sự kiện và vai trò tài khoản của một chương trình |

<CardGroup cols={2}>
  <Card title="parsedTransactionSubscribe" href="/docs/vi/api-reference/parsed-streams/parsedtransactionsubscribe">
    Đăng ký nhận các giao dịch đã giải mã khớp với bộ lọc chương trình, tài khoản và chỉ thị.
  </Card>

  <Card title="parsedTransactionUnsubscribe" href="/docs/vi/api-reference/parsed-streams/parsedtransactionunsubscribe">
    Dừng đăng ký theo ID.
  </Card>

  <Card title="describeProgram" href="/docs/vi/api-reference/parsed-streams/describeprogram">
    Xác định chính xác tên chỉ thị và vai trò mà bộ so khớp dùng để so sánh.
  </Card>
</CardGroup>

## Kết nối

Parsed Streams được cung cấp trên endpoint [Gatekeeper](/docs/vi/gatekeeper/overview) tại `wss://beta.helius-rpc.com`, cùng máy chủ với lưu lượng RPC và WebSocket của Helius. Lấy khóa API từ [Bảng điều khiển Helius](https://dashboard.helius.dev) rồi truyền khóa dưới dạng tham số truy vấn `api-key` (hoặc header `x-api-key`):

```bash wscat theme={"system"}
wscat -c "wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY"
```

[`describeProgram`](/docs/vi/api-reference/parsed-streams/describeprogram) là trường hợp ngoại lệ: phương thức này hiện chỉ có trên `wss://fs-beta.helius-rpc.com/?api-key=YOUR_API_KEY`.

Khóa bị thiếu hoặc không hợp lệ sẽ bị từ chối với HTTP 401. Dự án đã đạt giới hạn kết nối sẽ nhận HTTP 429.

## Giới hạn

| Giới hạn                            | Giá trị                                                 |
| ----------------------------------- | ------------------------------------------------------- |
| Số kết nối đồng thời trên mỗi dự án | 5 (Free), 10 (Developer), 50 (Business và Professional) |
| Số đăng ký trên mỗi kết nối         | 25                                                      |
| Tin nhắn từ máy khách               | 10 mỗi giây, tối đa 20 khi tăng đột biến                |
| Kích thước tin nhắn từ máy khách    | 64 KiB                                                  |
| `programs` trên mỗi bộ lọc          | 10                                                      |
| `instructionNames` trên mỗi bộ lọc  | 50, mỗi mục tối đa 64 ký tự                             |
| `accounts.include` trên mỗi bộ lọc  | 100                                                     |
| `accounts.roles` trên mỗi bộ lọc    | 20, mỗi tên tối đa 64 ký tự                             |
| Bộ đệm đầu ra trên mỗi kết nối      | 2048 thông báo, sau đó kết nối sẽ bị đóng               |

## Lỗi

Lỗi tuân theo JSON-RPC 2.0: `{ "error": { "code": <int>, "message": "<text>" }, "id": <id> }`. Thông báo cho biết chính xác lỗi là gì và xảy ra ở đâu.

| Mã       | Ý nghĩa                                                                                                                 |
| -------- | ----------------------------------------------------------------------------------------------------------------------- |
| `-32700` | Lỗi phân tích cú pháp (JSON không hợp lệ)                                                                               |
| `-32600` | Yêu cầu không hợp lệ                                                                                                    |
| `-32601` | Không tìm thấy phương thức                                                                                              |
| `-32602` | Tham số không hợp lệ: pubkey không hợp lệ, trường không xác định, hoặc giá trị commitment hay details không được hỗ trợ |
| `-32000` | Đã vượt quá giới hạn bộ lọc                                                                                             |
| `-32001` | Máy chủ chưa sẵn sàng; thử lại với khoảng chờ tăng dần                                                                  |
| `-32002` | Bị giới hạn tốc độ (10 tin nhắn mỗi giây)                                                                               |
| `-32006` | Quá nhiều đăng ký (25 trên mỗi kết nối)                                                                                 |

Kết nối cũng có thể đóng với mã đóng WebSocket — xem [Xử lý kết nối lại](/docs/vi/parsed-streams/guides/handling-reconnects) để biết ý nghĩa của từng mã và cách khôi phục.

## Tìm hiểu thêm

<CardGroup cols={2}>
  <Card title="Parsed Streams Overview" href="/docs/vi/parsed-streams">
    Tìm hiểu Parsed Streams là gì và mô hình tư duy đằng sau các bộ lọc.
  </Card>

  <Card title="Quickstart" href="/docs/vi/parsed-streams/quickstart">
    Kết nối, gửi bộ lọc đầu tiên và đọc một thông báo đã giải mã.
  </Card>

  <Card title="Parsed Events Reference" href="/docs/vi/api-reference/parsed-events/overview">
    Truy vấn các giao dịch đã giải mã tương tự theo yêu cầu thông qua REST.
  </Card>

  <Card title="Handling Reconnects" href="/docs/vi/parsed-streams/guides/handling-reconnects">
    Duy trì hoạt động qua thời gian chờ khi không hoạt động và các đợt triển khai, sau đó truy xuất bù chính xác dữ liệu đã bỏ lỡ.
  </Card>
</CardGroup>