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

# 解析済みストリームリファレンス

> 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`メッセージをプッシュします。

| メソッド                           | 目的                            |
| ------------------------------ | ----------------------------- |
| `parsedTransactionSubscribe`   | フィルタ付きでサブスクリプションを開始           |
| `parsedTransactionUnsubscribe` | サブスクリプションを停止                  |
| `ping`                         | リバイブネスチェック; 現在のスロットを返します      |
| `describeProgram`              | プログラムの命令、イベント、アカウントロールをリストします |

<CardGroup cols={2}>
  <Card title="parsedTransactionSubscribe" href="/docs/ja/api-reference/parsed-streams/parsedtransactionsubscribe">
    プログラム、アカウント、命令フィルタに一致するデコードされたトランザクションを購読します。
  </Card>

  <Card title="parsedTransactionUnsubscribe" href="/docs/ja/api-reference/parsed-streams/parsedtransactionunsubscribe">
    IDでサブスクリプションを停止します。
  </Card>

  <Card title="ping" href="/docs/ja/api-reference/parsed-streams/ping">
    リバイブネスをチェックし、静かな接続を維持します。
  </Card>

  <Card title="describeProgram" href="/docs/ja/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になります。

## 制限

| 制限                        | 値                 |
| ------------------------- | ----------------- |
| プロジェクトごとの同時接続数            | 100               |
| 接続ごとのサブスクリプション数           | 25                |
| クライアントメッセージ               | 1秒あたり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> }`。メッセージは何が間違っていたのか、どこで間違っていたのかを正確に伝えます。

| コード      | 意味                                                |
| -------- | ------------------------------------------------- |
| `-32700` | パースエラー（無効なJSON）                                   |
| `-32600` | 無効なリクエスト                                          |
| `-32601` | メソッドが見つかりません                                      |
| `-32602` | 無効なパラメータ：不正なパブキー、不明なフィールド、サポートされていないコミットメントまたは詳細値 |
| `-32000` | フィルタ制限を超えました                                      |
| `-32001` | サーバー準備未完了；バックオフでリトライ                              |
| `-32002` | レート制限（1秒あたり10メッセージ）                               |
| `-32006` | サブスクリプションが多すぎる（接続ごとに25件）                          |

接続はWebSocketのクローズコードで閉じることもあります—各コードの意味と回復方法については、[リコネクトの処理](/docs/ja/parsed-streams/guides/handling-reconnects)を参照してください。

## 詳細を学ぶ

<CardGroup cols={2}>
  <Card title="Parsed Streams Overview" href="/docs/ja/parsed-streams">
    Parsed Streamsとは何か、フィルタの背後にあるメンタルモデル。
  </Card>

  <Card title="Quickstart" href="/docs/ja/parsed-streams/quickstart">
    接続し、最初のフィルタを送信し、デコードされた通知を読みます。
  </Card>

  <Card title="Parsed Events Reference" href="/docs/ja/api-reference/parsed-events/overview">
    同じデコードされたトランザクションをRESTまたはGraphQLでオンデマンドでクエリします。
  </Card>

  <Card title="Handling Reconnects" href="/docs/ja/parsed-streams/guides/handling-reconnects">
    アイドルタイムアウトやデプロイを乗り越え、見逃したものを正確にバックフィルします。
  </Card>
</CardGroup>
