OnFinality

Google Cloud 关停日期

将 Google Cloud Blockchain Node Engine 和 Blockchain RPC 迁移到 OnFinality

创建可用于生产环境的 OnFinality RPC 端点,验证链和数据一致后,再分批切换流量。

迁移流程
  1. 盘点 Google Cloud 工作负载共享 RPC 或托管节点
  2. 验证新端点HTTPS、WebSocket 和归档读取
  3. 切换生产流量小流量试运行、监控和备用端点

选择迁移路径

Google Cloud 将于 2026 年 12 月 15 日关停这两项服务。关停后,依赖原端点的工作负载将受影响。Quicknode 是 Google Cloud 推荐的迁移合作伙伴。

Google Cloud Blockchain RPC

为同一网络创建带鉴权的 OnFinality 端点,更新各客户端的 URL 和凭证。迁移生产流量前,先验证应用实际调用的 RPC 方法。

创建共享 RPC 端点

Google Cloud Blockchain Node Engine

按现有全节点或归档节点的能力逐项核对历史状态、追踪方法及其参数。如使用独立的 Beacon 或共识层端点,或需要特定客户端设置和资源隔离,请一并纳入迁移计划。

查看专属节点方案

映射 Google Cloud 网络

更换服务商时请保持工作负载所在网络一致。从 OnFinality 控制台复制 HTTPS 和 WSS URL。Goerli、Holesky 等旧测试网如需切换,先选择仍受维护的测试网,再重新部署测试合约并准备测试数据。

网络验证项目OnFinality 端点
Ethereum Mainnet链 ID 1、已最终确认的区块、日志和应用的合约读取。创建端点
Ethereum Sepolia链 ID 11155111、测试合约和预发布环境的订阅。创建端点
Polygon PoS Mainnet链 ID 137、索引任务的日志区间及追踪或归档调用。创建端点
Polygon Amoy链 ID 80002、预发布合约及事件消费者。创建端点
Solana Mainnet创世哈希、确认级别和订阅恢复。创建端点

替换 URL 和认证凭证

从控制台复制 OnFinality URL,并从新客户端配置移除 X-goog-api-key 等 Google 专用鉴权。验证期间在旧路由中保留原凭证。

RPC 方法文档 · Ethereum · Polygon · Solana

Ethereum 主网端点示例
ETH_RPC_URL=https://eth.api.onfinality.io/YOUR_ONFINALITY_API_KEY
ETH_WSS_URL=wss://eth.api.onfinality.io/YOUR_ONFINALITY_API_KEY
切换前需要检查的方法差异
  • Ethereum 和 Polygon。用相同参数重跑 eth_call 和 eth_getLogs;在 WSS 上检查过滤器与订阅,并确认可以使用 debug_traceTransaction 及应用需要的 tracer 参数。
  • Solana。使用相同的确认级别,比较 getGenesisHash 和常用读取结果。在 WebSocket 端点测试 logsSubscribe 或应用使用的其他订阅方法。
  • 归档和自定义节点。测试应用读取的最早历史状态,并单独验证所用的共识 API 或客户端专属命名空间。

RPC 套餐

浏览全部 135 个支持的网络

OnFinality 覆盖多个生态的主网和测试网。按网络搜索,即可查看支持 RPC API、专属节点或两种服务。

显示 12 / 135 个网络

验证两个 Ethereum 端点

切流前用 Node.js 22 或更新版本运行只读脚本。脚本检查链 ID,并在双方都确认的同一高度比对区块哈希。验证失败时返回非零退出码。

下载验证脚本

将配置保存为 .env.migration,与脚本放在同一目录,并排除在版本控制之外。请填写完整端点 URL。如端点使用查询参数鉴权,也要保留对应参数。然后运行:

node --env-file=.env.migration verify-google-cloud-ethereum-rpc.mjs

.env.migration
GOOGLE_RPC_URL=https://YOUR_GOOGLE_RPC_ENDPOINT
ONFINALITY_RPC_URL=https://eth.api.onfinality.io/YOUR_ONFINALITY_API_KEY
# GOOGLE_API_KEY=YOUR_GOOGLE_KEY
可选的归档和 WebSocket 验证
  • 设置 ARCHIVE_ADDRESS 和 ARCHIVE_BLOCK 比对历史余额。区块号使用十六进制,且不得超过双方共同确认的高度。
  • 设置 GOOGLE_WSS_URL 和 ONFINALITY_WSS_URL,验证两个端点都能收到 eth_subscribe 的 newHeads 事件。脚本使用 URL 鉴权。如旧端点需要自定义请求头,请用应用客户端单独验证。
  • 验证 Sepolia 时设置 EXPECTED_CHAIN_ID=11155111。默认使用 Ethereum 主网(1)。

若 Google 端点已经离线,请用同一条链上的另一个可信端点做对照。切流前重跑应用的日志、追踪、写入和断线重连检查。

生产切流清单

首次切流前确定验收和回滚阈值。HTTPS 请求与长连接 WebSocket 应分别切换和监控。

  1. 盘点生产负载

    记录网络、HTTPS/WSS 客户端、鉴权、请求峰值、所用方法和节点设置。把后台任务、索引器、监控和备用 URL 纳入清单。

  2. 创建并测试替换端点

    为预发布环境使用独立的 OnFinality 密钥。运行一致性脚本,复现高频和高开销读取,并演练订阅重连及从检查点补录。

  3. 先切换少量流量

    保留配置开关或加权路由。先切一小部分只读流量,确认错误率、429、p95 延迟、链头滞后和订阅缺口低于阈值后再扩量。

  4. 分别切换写入和订阅

    保持单一活跃写入方。重试交易提交前先核实是否已被接受。从上次处理的区块或 slot 恢复订阅,补齐缺失事件并去重。

  5. 演练回滚

    指定回滚负责人和触发阈值。Google 资源仍可用时保留已测试的旧路由。临近或超过关停日时,使用同一网络上已独立验证的备用端点。

  6. 清理旧资源

    观察期结束后,从客户端和备用配置移除 Google URL。按 Google 指引删除旧 Blockchain Node Engine 节点。Blockchain RPC 端点由 Google 在关停时移除。

迁移常见问题

Google Cloud Blockchain Node Engine 和 Blockchain RPC 什么时候关停?

Google Cloud 公布的关停日期是 2026 年 12 月 15 日。剩余节点和端点计划于当天删除。

Google Cloud 关停公告

可以用 OnFinality 替代 Quicknode 吗?

可以。Quicknode 是 Google Cloud 推荐的合作伙伴。评估 OnFinality 时,先创建目标网络端点,验证实际工作负载所需的方法和访问权限。

对比 OnFinality 和 Quicknode

需要改应用代码吗?

标准 JSON-RPC 调用通常保持原有请求格式。更新 URL 和凭证后,验证方法限制、tracer 参数、重试和订阅恢复。供应商专用方法或节点设置可能需要调整。

如何选择生产 RPC 套餐?

根据实际调用的方法估算峰值吞吐量和月度 Response Units,再核对归档与追踪权限、WebSocket 用量和资源隔离需求。

RPC 套餐

如果 Google Cloud 端点已经下线怎么办?

切换到同一网络上已验证的端点,从最后一次保存的检查点恢复任务和订阅,并补齐错过的事件。

准备替换端点

如果业务需要专属节点,请在联系时提供目标网络、流量峰值、归档和追踪需求,以及计划切换日期。

永远不用担心基础设施

OnFinality 消除了 DevOps 的繁重工作,让您能够更聪明、更快地构建。

开始