配置 Yellowstone gRPC 身份验证

配置 x-token 身份验证，选择欧洲或美国端点，并排查连接错误。

使用 RPC 控制台中的 gRPC token。gRPC 通过 x-token 认证，与 Data API 的 x-api-key 请求头不同。

​

检查凭据

按快速开始安装依赖并设置环境变量，然后将以下连接检查保存为 check-connection.mts。

check-connection.mts

import Yellowstone from "@triton-one/yellowstone-grpc";

const Client = typeof Yellowstone === "function" ? Yellowstone : Yellowstone.default;

const token = process.env.GRPC_API_TOKEN;
if (!token) throw new Error("Set GRPC_API_TOKEN");
const client = new Client(
  process.env.GRPC_ENDPOINT ?? "https://grpc.solanatracker.io",
  token,
  undefined,
);
console.log(await client.getVersion());

npx tsx check-connection.mts

版本响应可验证端点与 token。接着运行快速入门的订阅，验证数据流访问权限。

​

选择区域

• EU: https://grpc.solanatracker.io
• US: https://grpc-us.solanatracker.io

从部署服务器进行测量。网络距离、路由、处理时间和订阅负载都会影响交付延迟。

​

排查连接错误

• 未认证： 检查 GRPC_API_TOKEN 是否设置、是否有多余空格，以及订阅是否有效。
• 超时或不可用： 检查 URL 和出站 TLS/HTTP2 连接，再尝试另一区域。
• 资源耗尽： 阅读错误详情，分别检查连接额度与消息大小限制。提高消息大小限制无法解决额度问题。
• 已连接但无数据： 先使用 blocksMeta: { blocks: {} }，再逐项恢复筛选条件。

​

Guardar el token

从环境变量或密钥管理服务读取 token，不要写入日志、浏览器代码或提交的示例中。更换 token 后重启或重新连接客户端。

​

相关指南

快速入门

可靠性与性能