Provider 服务商
Provider 是一条连接 RPC 服务商账户的配置。它使用服务商提供的 API Key 或 Secret 发现可用网络，并把发现结果同步成当前账户下的 Endpoint。
Provider 负责维护 Endpoint 清单，但不会自动把 Endpoint 加入 Gateway Route。同步完成后，仍需在目标 Gateway 中选择这些 Endpoint，配置优先级故障切换或负载均衡。
当前支持范围
| 服务商 | 同步方式 |
|---|---|
| Alchemy | 为 Gateway 当前目录中的全部网络生成 Endpoint |
| QuickNode | 展开账户下的单链与多链清单，并同步 Gateway 当前目录中的全部网络 |
| Chainstack | 从账户清单导入 EVM、Solana、Bitcoin、TRON 和 Litecoin Mainnet 节点 |
| dRPC | 生成 EVM、Solana Mainnet/Devnet、Bitcoin Mainnet 和 TRON Mainnet Endpoint |
| Tenderly | 只为 Tenderly 提供 Node RPC 的 EVM 网络生成 Endpoint；不包含 BNB Mainnet/Testnet |
每个集成都只同步“服务商实际支持网络”与支持的网络的交集。Alchemy、QuickNode 和 Chainstack 会为 TRON 同时生成 JSON-RPC 与原生 HTTP API Endpoint；dRPC 只生成 TRON JSON-RPC Endpoint。dRPC 的 Solana 网络需要服务商 Premium 套餐。
服务商凭据用于访问服务商账户，或按服务商要求写入同步生成的 Endpoint 鉴权配置。请使用服务商控制台提供的有效凭据，不要把凭据写入源码、日志或公开链接。
创建并同步 Provider
1. 创建连接
在控制台进入 Providers，选择 新建服务商，然后填写：
- 名称：用于在控制台识别这条连接；
- 服务商：Alchemy、QuickNode、Chainstack、dRPC 或 Tenderly，创建后不能更换；
- API Key / Secret：服务商控制台提供的凭据；
- 自动同步：是否按计划刷新 Endpoint 清单；
- 同步间隔：可选择每小时、每 6 小时、每 12 小时、每天、每 3 天或每周；
- 网络过滤：控制该服务商支持的哪些网络参与同步。
自动同步默认关闭。创建后可以选择 立即同步，也可以启用自动同步并等待计划任务执行。
2. 设置网络范围
网络过滤有三种互斥模式：
| 模式 | 行为 |
|---|---|
| 全部网络 | 接受服务商发现且该 Provider 集成支持的全部网络 |
| 仅这些 | 只同步选中的链和网络 |
| 排除这些 | 同步除所选链和网络之外的发现结果 |
过滤只会缩小服务商发现结果，不会让平台支持新的链或网络。修改过滤条件后再次同步，清单才会按新范围更新。
3. 检查同步结果
同步结果会报告以下 Endpoint 变化：
| 结果 | 含义 |
|---|---|
| 新建 | 新发现的 Endpoint 已创建 |
| 更新 | URL 或鉴权等服务商管理的连接信息已更新 |
| 恢复 | 之前归档的 Endpoint 再次出现并恢复可用 |
| 归档 | 完整同步确认 Endpoint 已不在服务商清单中 |
| 跳过 | 某个 Endpoint 无法识别、验证或安全更新 |
Provider 页面同时显示上次同步状态：
- 从未同步：尚未执行过同步；
- 成功：发现和更新全部完成；
- 部分成功：可用结果已发布，但部分 Endpoint 或服务商目录未能完整处理；
- 失败：本次发现失败，没有发布破坏性的清单变更。
不完整的发现结果不会批量归档未返回的 Endpoint。单个 Endpoint 缺少服务商元数据时，系统也会保留其现有记录，避免临时服务商故障造成破坏性更新。
4. 加入 Gateway Route
打开 Endpoints 的 Provider 页签，检查同步生成的 Endpoint。Provider 管理其链、网络、URL 和鉴权等连接信息，因此这些字段不能像手工 Endpoint 一样直接修改。
确认 Endpoint 后，打开对应链和网络的 Gateway，把它加入默认 JSON-RPC Route。只有被 Route 引用的 Endpoint 才会参与路由、负载均衡和故障切换。
停用、更新与删除
- 停用 Provider：停止手动和自动同步，已同步的 Endpoint 保留；重新启用后可以继续同步。
- 替换凭据：保存新值会立即替换旧凭据；再次同步后，受 Provider 管理的 Endpoint 鉴权会按发现结果更新。
- 删除 Provider：停止管理并解除其与 Endpoint 的同步关系。默认保留 Endpoint 的 URL、鉴权和配置。
- 同时删除未被引用的 Endpoint：只删除未被 Gateway Route 使用的 Endpoint；被引用的 Endpoint 始终保留并解除 Provider 关系。
完整同步发现某个 Endpoint 已消失时，系统会尝试归档它。正在被 Route 引用的 Endpoint 不会被归档，而会在同步结果中标记为跳过。
常见问题
同步失败
确认 Provider 已启用，凭据仍有效，并且服务商的管理 API 可以访问。服务商目录或账户接口暂时不可用时，同步可能显示失败或部分成功；现有 Endpoint 不会因为一次不完整发现而被批量删除。
没有发现 Endpoint
检查网络过滤是否排除了目标网络，以及目标网络是否列在支持的网络中。QuickNode 需要可读取 账户 Endpoint 及各网络 URL 的 Admin API Key；Chainstack 需要能读取 v1 节点连接信息和 v2 节点网络元数据的 Platform API Key；dRPC 的 Solana 网络需要 Premium 套餐。
同步成功但 Gateway 仍无可用 Endpoint
Provider 同步只创建或更新 Endpoint，不会修改 Gateway Route。打开目标 Gateway，把同步生成且链、网络匹配的 Endpoint 加入 Route，并检查 Endpoint 是否已启用。
Endpoint 被归档或跳过
归档表示一次完整同步确认该 Endpoint 已不在服务商清单中；如果它以后重新出现，会在后续同步中恢复。跳过通常表示服务商元数据缺失、URL 校验或 Route 引用保护阻止了更新，请展开同步明细查看具体错误。