Asset Hub Migration: What Developers Need to Know About the Polkadot Relay Chain Transition

Asset Hub 迁移决策清单

在迁移之前，请检查以下关键点，确保您的应用程序和基础架构准备就绪：

什么是 Asset Hub 迁移？

Asset Hub 迁移是一项分阶段升级，将三个核心模块——余额、质押和治理——从 Polkadot 中继链迁移至 Asset Hub 系统平行链。这一架构变更属于 Polkadot 向 JAM（Join-Accumulate Machine）协议路线图的一部分，旨在减少中继链状态膨胀、实现更快的升级并提高整体可扩展性。

对于开发者而言，这意味着迁移后，所有面向用户的操作（查询余额、质押、投票）必须指向 Asset Hub 的 RPC 端点，而非中继链。中继链将继续处理共识、平行链拍卖和跨链消息传递（XCM），但不再提供这些用户级模块。

为何进行迁移？

中继链最初承载了所有核心功能，但随着 Polkadot 的发展，这种单体设计成为了瓶颈：

• 状态膨胀：中继链状态变得庞大，导致升级更慢且更复杂。
• 升级摩擦：对质押或治理的更改需要影响整个网络的运行时升级。
• 可扩展性限制：中继链无法轻松独立扩展面向用户的功能。

通过将这些模块迁移至 Asset Hub，Polkadot 实现了：

• 模块化：每条系统链可以独立演进。
• 更低费用：Asset Hub 提供显著更低的交易费用和生存存款（0.01 DOT vs 1 DOT）。
• 更好用户体验：支持使用任何支持的资产支付费用、直接访问以太坊桥接以及扩展的资产支持。

时间线与阶段

迁移遵循测试网优先的方法：

1. Kusama：迁移于 2025 年 10 月 7 日执行。
2. Polkadot：迁移于 2025 年 11 月 4 日执行。
3. Westend（测试网）：2025 年全年进行早期测试阶段。

用户无需采取任何操作来保障资金安全——资产会自动迁移。但是，开发者必须更新其基础架构以指向正确的 RPC 端点。

对 RPC 端点的影响

迁移后，以下变更适用于 RPC 查询：

示例：迁移后查询余额

curl -H "Content-Type: application/json" -d '{
  "jsonrpc":"2.0",
  "id":1,
  "method":"chain_getBalance",
  "params":["YOUR_ACCOUNT_ADDRESS"]
}' https://rpc.asset-hub.polkadot.io

将 YOUR_ACCOUNT_ADDRESS 替换为实际的 Polkadot 地址。确保您的 RPC 提供商支持 Asset Hub 链。

更新您的基础架构

对于 dApp 和钱包

1. 更新 RPC URL：将您的网络配置更改为指向 Asset Hub RPC 端点。例如，如果使用 OnFinality，请从支持的网络列表中选择 "Polkadot Asset Hub" 网络。
2. 使用 Kusama 测试：由于 Kusama 首先迁移，请将其用作暂存环境来验证您的更改。
3. 处理旧查询：某些用户可能仍会查询中继链；请实现回退逻辑或重定向。

对于质押服务

质押操作（提名、验证、领取奖励）现在在 Asset Hub 上进行。更新您的质押 UI 或后端以使用 Asset Hub 的 staking 模块。RPC 方法保持不变，但端点发生了变化。

对于索引器和浏览器

重新配置您的索引器，以订阅 Asset Hub 的区块和事件，用于余额、质押和治理。中继链将不再发出这些事件。

常见陷阱与故障排除

• 使用旧中继链端点：查询将返回空响应或错误。请仔细检查您的网络配置。
• 硬编码端点 URL：将代码库中任何硬编码的中继链 URL 替换为 Asset Hub URL。
• 忽略测试网结果：在 Polkadot 迁移窗口关闭前，在 Kusama 或 Westend 上进行彻底测试。
• 认为无需操作：虽然最终用户无需转移资金，但开发者必须更新其基础架构。

为 Asset Hub 选择 RPC 提供商

迁移后，可靠的 RPC 提供商至关重要。评估提供商时，请考虑：

• 网络支持：提供商是否为 Polkadot Asset Hub 和 Kusama Asset Hub 提供专用端点？
• 速率限制：确保提供商的免费或付费层级与您的应用流量匹配。
• WebSocket 支持：对于实时订阅（例如质押事件），WebSocket 端点至关重要。
• 归档数据：如果您需要历史状态，请检查是否支持归档节点。

OnFinality 为 Polkadot Asset Hub 和 Kusama Asset Hub 提供 RPC 端点，并提供灵活的定价和适用于生产工作负载的专用节点选项。

关键要点

• Asset Hub 迁移将余额、质押和治理从中继链移至 Asset Hub 系统平行链。
• 用户无需采取任何操作来保障资金安全，但开发者必须更新 RPC 端点和基础架构。
• Kusama 于 2025 年 10 月 7 日迁移；Polkadot 于 2025 年 11 月 4 日迁移。
• 在依赖 Polkadot 主网之前，先在 Kusama 或 Westend 上测试您的集成。
• 选择支持 Asset Hub 端点且具有足够性能和可靠性的 RPC 提供商。