⚡ 为什么使用 SDK

我们的 SDK 是接收 ShredStream.com shreds 的最快、最可靠方式 — 只需几行代码,适配所有语言。本页面说明 SDK 为您做了什么以及为什么它是推荐的集成方式。

一句话总结 — ShredStream.com 通过 UDP 交付定制的 Solana shreds。SDK 负责网络格式,让您专注于策略,而不是底层管道。


🧩 SDK 为您处理的事项

我们的 SDK 是网络和您应用之间的薄层。它承担了您本来需要自己构建的一切:

事项没有 SDK使用 SDK
UDP 套接字 + OS 缓冲区您自己打开、绑定、调优 rmem_max/maxsockbuf、监控丢包listener.start() 时自动处理
Shred 格式解析您自己解析 1203 字节的二进制包(变体 0xA5、偏移量、大小、零填充)解析为类型化结构
交易解码您自己从 payload 解码 Solana 交易交易已解码,可直接迭代
Slot 组装您自己按索引重排每个 slot 中的 shreds按 slot 自动组装
优雅关闭您自己排空套接字、刷新缓冲区由 listener 生命周期管理

🌐 适配所有语言

SDK 为 Solana 交易员、机器人、MEV searcher 和 DeFi 开发者最常用的四种语言提供支持 — 每种语言都使用相同的 API:

JavaScript / TypeScriptnpm install shredstream
Pythonpip install shredstream
Rustcargo add shredstream
Go
Gogo get github.com/shredstream/shredstream-sdk-go

安装一个包,绑定分配的端口,迭代交易。每种语言都是相同的 5 到 6 行代码。


🚀 零延迟损失

一个常见疑虑:"解码会拖慢速度吗?" 简短回答 — 不会

  • SDK 在我们的交付之上增加亚毫秒级开销
  • 即使开启解码,您仍然领先于 Geyser gRPC。
  • 解码后的交易随着 shreds 到达就立即发出,而不是在 slot 结束时。

"raw wire" 与"解码"之间的权衡是理论上的微延迟。实际上,我们的 SDK 基准测试显示,原始 UDP listener 和 SDK 解码输出之间的 P50 延迟相同


🛠️ 我能自己构建接收器吗?

可以。我们完整地记录了包格式 — 参见数据包格式。但请自问:这真的是您想投入工程时间的地方吗?

我们的 shred 格式是定制的,可能与您现有的 Solana 工具链所期望的不匹配。如果把标准 shred 解码器接到我们的 UDP 流上,开箱即用是不行的。SDK 的存在,正是为了让您不必自己重新实现解析、套接字调优和解码。

如果您仍想走 raw 路线:

  • 阅读数据包格式了解二进制结构。
  • 查看网络配置调优您的套接字缓冲区。
  • 规划自己的 slot 组装和交易解码。

🎯 何时使用 SDK

请使用 SDK,如果您:

  • 想在 5 分钟内开始流式处理交易。
  • 构建机器人、HFT、MEV、Snipers、DeFi 或分析应用 — 需要解码后的交易。
  • 不想为专有二进制格式维护定制解析器。

仅在以下情况走 raw 路线:

  • 有非常特殊的理由做定制解析(性能剖析、嵌入式系统、学术研究)。
  • 乐意维护一个与我们规范对齐的 shred 解码器。

无论哪种情况,SDK 都是最短路径。我们强烈建议从它开始 — 如有需要,您随时可以降到原始 UDP。


➡️ 下一步

为什么使用 SDK — Documentations | ShredStream.com