⚡ SDK 快速入门

我们的官方 SDK 开箱即用地处理 UDP 接收、shred 解析和交易解码。只需安装一个命令、编写几行代码，即可开始接收 Solana shreds。

📦 可用 SDK

📋 前提条件

1. 在 ShredStream.com 创建账户
2. 创建 Shred Stream 并选择区域
3. 输入服务器 IP 地址和接收 shreds 的 UDP 端口
4. 开放 firewall 的入站 UDP 流量——详见 网络配置

💻 快速入门示例

每个示例监听 ShredStream.com 分配的端口上的原始 shreds。

// First, install our SDK with: npm install shredstream
const { ShredListener } = require('shredstream');

const listener = new ShredListener(8001);

// Decoded transactions — ready-to-use Solana transactions
listener.on('transactions', (slot, txs) => {
  txs.forEach(tx => console.log(`slot ${slot}: ${tx.signature}`));
});

listener.start();

将 8001 替换为 ShredStream.com 仪表盘中分配给您数据流的端口。

⚙️ 操作系统 Buffer 调优

SDK 会自动配置 socket 接收 buffer（默认 25 MB）。但您仍需在操作系统层面允许此 buffer 大小：

# Linux
sudo sysctl -w net.core.rmem_max=33554432

# macOS
sudo sysctl -w kern.ipc.maxsockbuf=33554432

完整的 firewall 和 buffer 配置详见 网络配置。

➡️ 下一步

• 网络配置——firewall 和操作系统级配置
• 最佳实践——监控、冗余和性能优化
• 故障排查——常见问题与解决方案
• 高级：数据包格式——需要完全控制二进制格式的用户可参考