安装
--features "ws grpc"。
包含内容
环境变量
若未显式传入端点,SDK 从环境读取。这是智能体生成代码的推荐模式:智能体无需硬编码 URL 或密钥,同一二进制可在不同区域与网络运行。简短示例
从环境读取端点并查询余额的最小 RPC 智能体,重试/故障转移自动处理:使用 Yellowstone gRPC 流式传输
subscribe_yaml 从 YAML 读取过滤器;编程式过滤器请改用 client.subscribe(SubscribeRequest { .. })。Jetstream 客户端模式相同。将 GeyserClientBuilder 换为 JetstreamClientBuilder 即可。
为何使用 SDK 而非原始 HTTP
对智能体编写的生产代码,SDK 处理容易出错的横切关注点:- 指数退避重试,可按客户端配置
- 多区域故障转移:主端点失败后按顺序尝试备用
- 认证注入:许可证密钥加入每个请求,不存储在端点字符串中
- WebSocket 重连:断开后订阅自动恢复
- gRPC 通道管理:keepalive、重连、退避
- 类型化响应:常用方法反序列化为 Rust 结构体,其余仍可用原始出口