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

# Parsed Streams 참조

> WebSocket을 통한 Parsed Streams JSON-RPC 메서드의 API 참조. 서버 측 필터링으로 디코딩된 Solana 트랜잭션을 구독하세요.

<Note>
  Parsed Streams는 **폐쇄 베타** 상태입니다. 현재는 화이트리스트에 등록된 프로젝트 ID에만 접근이 허용되며, API는 일반 공개 전 변경될 수 있습니다. 폐쇄 베타에 참여하려면 [여기서 신청하세요](https://form.typeform.com/to/BlFWKbC9).
</Note>

Parsed Streams는 단일 WebSocket 연결을 통해 **JSON-RPC 2.0**을 사용합니다. 각 요청은 동일한 `id`로 응답을 받습니다. 구독을 하면 구독 취소하거나 연결을 끊을 때까지 `parsedTransactionNotification` 메시지가 푸시됩니다.

| Method                         | Purpose                 |
| ------------------------------ | ----------------------- |
| `parsedTransactionSubscribe`   | 필터로 구독 시작               |
| `parsedTransactionUnsubscribe` | 구독 중지                   |
| `ping`                         | 생존 확인; 현재 슬롯 반환         |
| `describeProgram`              | 프로그램의 지침, 이벤트, 계정 역할 나열 |

<CardGroup cols={2}>
  <Card title="parsedTransactionSubscribe" href="/docs/ko/api-reference/parsed-streams/parsedtransactionsubscribe">
    프로그램, 계정, 지침 필터와 일치하는 디코딩된 트랜잭션을 구독합니다.
  </Card>

  <Card title="parsedTransactionUnsubscribe" href="/docs/ko/api-reference/parsed-streams/parsedtransactionunsubscribe">
    ID로 구독을 중지합니다.
  </Card>

  <Card title="ping" href="/docs/ko/api-reference/parsed-streams/ping">
    생존성을 확인하고 조용한 연결을 유지합니다.
  </Card>

  <Card title="describeProgram" href="/docs/ko/api-reference/parsed-streams/describeprogram">
    비교되는 정확한 지침 및 역할 이름을 확인합니다.
  </Card>
</CardGroup>

## 연결

Helius 팀이 프로젝트 ID를 화이트리스트에 등록하고 연결 엔드포인트를 공유합니다. 프로젝트의 API 키로 인증하며, 해당 키는 `api-key` 쿼리 매개변수(또는 `x-api-key` 헤더)로 전달합니다:

```bash wscat theme={"system"}
wscat -c "wss://<ENDPOINT>/?api-key=YOUR_API_KEY"
```

누락되거나 잘못되었거나 화이트리스트에 등록되지 않은 키는 HTTP 401로 거부됩니다. 연결 한도에 도달한 프로젝트는 HTTP 429를 받습니다.

## 제한

| Limit                  | Value                   |
| ---------------------- | ----------------------- |
| 프로젝트당 동시 연결            | 100                     |
| 연결당 구독                 | 25                      |
| 클라이언트 메시지              | 초당 10개, 최대 20개 버스트      |
| 클라이언트 메시지 크기           | 64 KiB                  |
| `programs` 필터당         | 10                      |
| `instructionNames` 필터당 | 50, 각각 최대 64자           |
| `accounts.include` 필터당 | 100                     |
| `accounts.roles` 필터당   | 20, 각 이름 최대 64자         |
| 연결당 아웃바운드 버퍼           | 2048개의 알림, 이후 연결이 종료됩니다 |

## 오류

오류는 JSON-RPC 2.0을 따릅니다: `{ "error": { "code": <int>, "message": "<text>" }, "id": <id> }`. 메시지는 무엇이 잘못되었는지 정확히 알려줍니다.

| Code     | Meaning                                             |
| -------- | --------------------------------------------------- |
| `-32700` | 구문 분석 오류 (잘못된 JSON)                                 |
| `-32600` | 잘못된 요청                                              |
| `-32601` | 메서드를 찾을 수 없음                                        |
| `-32602` | 잘못된 매개변수: 잘못된 공개 키, 알 수 없는 필드, 지원되지 않는 커밋 또는 세부사항 값 |
| `-32000` | 필터 한도 초과                                            |
| `-32001` | 서버 준비 안 됨; 백오프와 함께 재시도                              |
| `-32002` | 속도 제한 (초당 10개 메시지)                                  |
| `-32006` | 너무 많은 구독 (연결당 25개)                                  |

연결은 WebSocket 닫기 코드와 함께 종료될 수도 있습니다. 각 코드의 의미와 복구 방법은 [재연결 처리하기](/docs/ko/parsed-streams/guides/handling-reconnects)를 참조하세요.

## 더 알아보기

<CardGroup cols={2}>
  <Card title="Parsed Streams 개요" href="/docs/ko/parsed-streams">
    Parsed Streams란 무엇이며 필터 뒤에 있는 정신 모델.
  </Card>

  <Card title="퀵스타트" href="/docs/ko/parsed-streams/quickstart">
    연결하고, 첫 번째 필터를 보내고, 디코딩된 알림을 읽습니다.
  </Card>

  <Card title="파싱된 이벤트 참조" href="/docs/ko/api-reference/parsed-events/overview">
    REST 또는 GraphQL을 통해 요구 시 동일한 디코딩된 트랜잭션을 쿼리하십시오.
  </Card>

  <Card title="재연결 처리하기" href="/docs/ko/parsed-streams/guides/handling-reconnects">
    유휴 시간 초과 및 배포를 견디고, 놓친 부분을 정확히 백필하세요.
  </Card>
</CardGroup>