跳转到主要内容
OrbitFlare Jetstream Architecture

概述

OrbitFlare Jetstream 是一个高性能 gRPC 服务,支持实时流式传输 Solana 交易。它为开发者提供了一种可靠且高效的方式来监控和处理 Solana 区块链交易,具有极低的延迟。

功能特性

  • 通过 gRPC 实时交易流
  • 灵活的交易过滤能力
  • 基于账户的过滤(包含、排除、必需)
  • 高吞吐量和低延迟
  • 强大的错误处理和重连机制
  • 与现有 Solana 应用轻松集成

快速开始

安装

要开始使用 OrbitFlare Jetstream,请选择一个示例克隆: 克隆基本客户端示例:
git clone https://github.com/orbitflare/jetstream-client-example
cd jetstream-client-example
构建客户端:
cargo build --release

基本用法

使用默认设置运行客户端:
./target/release/jetstream-client-example
连接到自定义 Jetstream gRPC 端点:
./target/release/jetstream-client-example -j http://fra.jetstream.orbitflare.com

交易过滤

OrbitFlare Jetstream 支持多种过滤选项,帮助您专注于相关交易:
  1. 命令行过滤
# 包含特定账户
./target/release/jetstream-client-example -i <pubkey1>,<pubkey2>

# 排除账户
./target/release/jetstream-client-example -e <pubkey1>,<pubkey2>

# 必需账户
./target/release/jetstream-client-example -r <pubkey1>,<pubkey2>
  1. JSON 配置: 创建 filters.json 文件:
{
  "filters": {
    "my-filter": {
      "account_include": ["pubkey1", "pubkey2"],
      "account_exclude": ["pubkey3"],
      "account_required": ["pubkey4"]
    }
  }
}
应用 JSON 配置:
./target/release/jetstream-client-example -f filters.json

配置选项

选项描述示例
--jetstream-grpc-urlJetstream gRPC 端点 URLhttp://fra.jetstream.orbitflare.com
--filter-config-pathJSON 过滤配置文件路径None
--include-accounts要包含的账户(逗号分隔)None
--exclude-accounts要排除的账户(逗号分隔)None
--required-accounts必需的账户(逗号分隔)None

日志

使用 RUST_LOG 环境变量控制日志级别:
RUST_LOG=debug ./target/release/jetstream-client-example

最佳实践

  1. 错误处理:为连接问题和交易处理实现适当的错误处理
  2. 过滤:使用账户过滤器减少不必要的数据处理
  3. 监控:设置适当的日志级别用于监控和调试
  4. 资源管理:正确管理 gRPC 连接和资源

另请参阅

支持

如需有关 OrbitFlare Jetstream 的技术支持或问题咨询,请联系我们的支持团队或访问我们的 GitHub 仓库获取更多信息。