> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt
> Use this file to discover all available pages before exploring further.
# OrbitFlare Jetstream
> 用于 Solana 交易流的高性能 gRPC 服务
Jetstream 旨在为您提供**可靠、低延迟的 Solana 交易流**——让您无需运行自己的索引管道即可构建实时应用（告警、交易、分析、监控）。
## 概述
OrbitFlare Jetstream 是一个高性能 gRPC 服务，支持实时流式传输 Solana 交易。它为开发者提供了一种可靠且高效的方式来监控和处理 Solana 区块链交易，具有极低的延迟。
## 功能特性
* 通过 gRPC 实时交易流
* 灵活的交易过滤能力
* 基于账户的过滤（包含、排除、必需）
* 高吞吐量和低延迟
* 强大的错误处理和重连机制
* 与现有 Solana 应用轻松集成
## 快速开始
### 安装
要开始使用 OrbitFlare Jetstream，请选择一个示例克隆：
最简 Rust 客户端，演示 gRPC 连接、过滤和交易流。
生产就绪的实时钱包追踪器，包含 PumpFun 解码、鲸鱼警报和 YAML 过滤配置。
克隆基本客户端示例：
```bash theme={null}
git clone https://github.com/orbitflare/jetstream-client-example
cd jetstream-client-example
```
构建客户端：
```bash theme={null}
cargo build --release
```
### 基本用法
使用默认设置运行客户端：
```bash theme={null}
./target/release/jetstream-client-example
```
连接到自定义 Jetstream gRPC 端点：
```bash theme={null}
./target/release/jetstream-client-example -j http://fra.jetstream.orbitflare.com
```
### 交易过滤
OrbitFlare Jetstream 支持多种过滤选项，帮助您专注于相关交易：
1. **命令行过滤**：
```bash theme={null}
# 包含特定账户
./target/release/jetstream-client-example -i ,
# 排除账户
./target/release/jetstream-client-example -e ,
# 必需账户
./target/release/jetstream-client-example -r ,
```
2. **JSON 配置**：
创建 `filters.json` 文件：
```json theme={null}
{
"filters": {
"my-filter": {
"account_include": ["pubkey1", "pubkey2"],
"account_exclude": ["pubkey3"],
"account_required": ["pubkey4"]
}
}
}
```
应用 JSON 配置：
```bash theme={null}
./target/release/jetstream-client-example -f filters.json
```
## 配置选项
| 选项 | 描述 | 示例 |
| ---------------------- | --------------------- | -------------------------------------------------------------------------- |
| `--jetstream-grpc-url` | Jetstream gRPC 端点 URL | [http://fra.jetstream.orbitflare.com](http://fra.jetstream.orbitflare.com) |
| `--filter-config-path` | JSON 过滤配置文件路径 | None |
| `--include-accounts` | 要包含的账户（逗号分隔） | None |
| `--exclude-accounts` | 要排除的账户（逗号分隔） | None |
| `--required-accounts` | 必需的账户（逗号分隔） | None |
## 日志
使用 `RUST_LOG` 环境变量控制日志级别：
```bash theme={null}
RUST_LOG=debug ./target/release/jetstream-client-example
```
## 最佳实践
1. **错误处理**：为连接问题和交易处理实现适当的错误处理
2. **过滤**：使用账户过滤器减少不必要的数据处理
3. **监控**：设置适当的日志级别用于监控和调试
4. **资源管理**：正确管理 gRPC 连接和资源
## 另请参阅
完整的 Protocol Buffer 规范、消息类型和代码生成指南。
版本历史、性能更新和协议变更。
支持内部指令和完整元数据的基于 Geyser 的全保真度流式传输。
## 支持
如需有关 OrbitFlare Jetstream 的技术支持或问题咨询，请联系我们的支持团队或访问我们的 [GitHub 仓库](https://github.com/orbitflare/jetstream-client-example)获取更多信息。