跳转到主要内容

​
什么是 Yellowstone gRPC？

Yellowstone gRPC 是一个 Geyser 插件，可以以超低延迟将 Solana 区块链数据直接流式传输到您的后端。它使用双向 gRPC 流，允许您动态创建和取消订阅，无需重新连接。 通过 Yellowstone，您可以订阅：
  • 账户 — 实时余额和数据变化
  • 交易 — 交易处理时的执行结果
  • Slot — 跨承诺级别的网络共识进度
  • 区块 — 完整区块数据，可选择包含交易/账户信息
  • 条目 — 区块内的低级执行单元

高性能

二进制协议，高效序列化，最大化吞吐量，最小化带宽占用。

实时流式传输

双向流式传输，即时创建和取消订阅——无需重新连接。

高级过滤

通过账户、交易和程序过滤器精确控制接收的数据。

多种数据类型

在单一流中订阅账户、交易、Slot、区块和条目。

​
通过 OrbitFlare 访问

Yellowstone gRPC 可通过以下方式访问：
  • OrbitFlare Pass — 包含在有效的 NFT Pass 许可证中
  • gRPC 订阅 — 独立 gRPC 计划
  • 专用 gRPC 节点 — 完全隔离，无限吞吐量
请参阅 产品 页面了解定价和计划详情。

​
订阅请求结构

每个 gRPC 订阅都共享相同的基础请求结构： 
const subscriptionRequest: SubscribeRequest = {
  commitment: CommitmentLevel.CONFIRMED, // processed | confirmed | finalized
  accountsDataSlice: [],                 // 可选：请求特定字节范围
  ping: { id: 1 },                       // 可选：保持连接活跃
  accounts: {},
  transactions: {},
  slots: {},
  blocks: {},
  blocksMeta: {},
  entry: {},
};
参数必填描述
commitment是承诺级别：processed、confirmed 或 finalized
accountsDataSlice否{ offset, length } 数组，用于接收账户数据的特定字节范围
ping否发送 ping 以保持连接活跃。服务器每 15 秒响应一次 pong
云负载均衡器（如 Cloudflare）通常在 10 分钟不活动后关闭 gRPC 连接。始终每 30 秒发送一次 ping 以防止断开连接。

​
流类型

监控实时账户变化——余额更新、数据修改、所有权变更以及创建/删除事件。按特定账户地址、所有者程序、数据大小或字节模式进行过滤。账户监控指南 →

​
开始使用

快速入门

安装客户端，连接到您的端点，并在几分钟内发送第一个订阅。

账户监控

通过精确过滤流式传输实时账户更新。

交易监控

使用程序和账户过滤器监控交易。

Slot 与区块

实时追踪网络共识和区块生产。