Kusama 迁移：发生了什么变化以及如何更新您的 RPC 端点

快速迁移检查点

如果您是 Kusama 上的开发者或基础设施运营商，迁移到 Asset Hub 改变了您发送某些 RPC 调用的位置。以下是一个快速检查清单，帮助您更新端点：

• 确定您的 dApp 依赖哪条链。 如果您使用中继链 RPC 进行余额转账、质押或治理，您可能需要切换到 Asset Hub Kusama。
• 更新您的网络配置。 将 RPC 端点和链 ID 更改为 Asset Hub Kusama。请参阅 Asset Hub Kusama 网络页面 获取官方端点。
• 用小额交易进行测试。 在上线之前，发送一笔测试转账以确认您的钱包和后端使用的是正确的链。
• 监控错误。 注意 InvalidTransaction 或 UnknownConnection 错误，这些错误表明您仍指向旧链。

如果您不确定您的用例需要哪条链，下一节将详细说明迁移及其影响。

Kusama 迁移实际改变了什么

Kusama 迁移于 2025 年 10 月 7 日执行，将核心功能从 Kusama 中继链转移到 Asset Hub Kusama。这是更广泛路线图的一部分，旨在使网络更具可扩展性和可访问性。迁移在约 3 小时 13 分钟内完成，移动了所有资产、pallet、账户和代理。

对于开发者来说，关键变化是 Asset Hub Kusama 现在是资产转移和管理的主要链。中继链仍然存在，但不再是发送 KSM 转账或与资产交互的地方。这意味着您的 RPC 端点必须更新为指向 Asset Hub Kusama 以进行这些操作。

为什么这对您的 dApp 很重要

如果您的 dApp 处理 KSM 转账、查询余额或与资产交互，它现在必须与 Asset Hub Kusama 通信。使用旧的中继链端点将导致错误或过时数据。迁移还带来了几项改进：

• 更低的最低余额：从 0.00003 KSM 降至 0.000003 KSM。
• 更低的交易费用：从 0.00053 KSM 降至 0.00009 KSM。
• 更多代币支持：USDT、USDC、DOT 和其他生态系统代币。
• 统一访问：KSM、资产、质押和治理集中在一个地方。
• 任意代币支付费用：使用任何支持的资产支付交易费用。

这些变化是有益的，但您需要更新基础设施以利用它们。

链设置一览

以下是 Asset Hub Kusama 的关键设置。使用这些设置更新您的网络配置。

注意：此处未硬编码 RPC 端点，因为它可能因提供商而异。请使用网络页面上列出的官方 OnFinality 公共端点。

更新您的 RPC 端点

要更新您的 dApp，您需要在配置中更改 RPC 端点。以下是使用常见 JavaScript 库（如 polkadot-js）的示例：

const { ApiPromise, WsProvider } = require('@polkadot/api');

// 替换为官方 Asset Hub Kusama 端点
const wsProvider = new WsProvider('wss://assethub-kusama-rpc.polkadot.io');

async function main() {
  const api = await ApiPromise.create({ provider: wsProvider });
  console.log(`Connected to chain: ${await api.rpc.system.chain()}`);
}

main().catch(console.error);

如果您使用 REST API 或其他库，同样的原则适用：更新端点 URL 并确保您的链 ID 匹配。

常见陷阱及如何避免

以下是迁移后开发者面临的最常见问题以及如何避免：

生产应用迁移检查清单

在部署之前，请运行此检查清单以确保顺利过渡：

• 将所有 RPC 端点更新为 Asset Hub Kusama。
• 更新所有配置中的链 ID。
• 在新链上测试小额转账。
• 验证余额查询返回正确数据。
• 部署后监控日志中的错误。
• 如果您的用户使用您的应用进行 KSM 转账，请告知他们更改。

选择合适的 RPC 提供商

在更新端点时，您可能还想评估您的 RPC 提供商。迁移是确保您的提供商支持 Asset Hub Kusama 并提供您所需可靠性的好时机。请考虑以下因素：

• 网络覆盖：提供商是否支持 Asset Hub Kusama 和其他 Kusama 平行链？
• 传输选项：您需要 WebSocket、HTTPS 还是两者都需要？
• 速率限制：是否存在可能影响您流量的限制？
• 支持：是否有专门的支持渠道来处理问题？

OnFinality 为 Asset Hub Kusama 和许多其他网络提供 RPC 服务。您可以查看 支持的 RPC 网络 和 RPC 定价 以了解其是否适合您的需求。OnFinality 还为高流量应用提供 专用节点。

关键要点

• Kusama 迁移将核心功能移至 Asset Hub Kusama。
• 将您的 RPC 端点更新为 Asset Hub Kusama 以进行资产转移和余额查询。
• 使用正确的链 ID (1000) 并在上线前进行测试。
• 监控常见错误，如 InvalidTransaction。
• 评估您的 RPC 提供商以确保其支持新链。

常见问题解答

我需要迁移我的 KSM 代币吗？

不需要。迁移是自动的。您的 KSM 代币已移至 Asset Hub Kusama，无需您采取任何操作。

我的旧交易历史会怎样？

旧交易历史仍保留在 Kusama 中继链上。您仍然可以查询它，但新交易将在 Asset Hub Kusama 上进行。

我还能使用中继链进行质押吗？

质押功能已移至 Asset Hub Kusama。您应该更新您的质押 dApp 或钱包以使用新链。

如何找到官方 RPC 端点？

请查看 Asset Hub Kusama 网络页面 获取官方 OnFinality 公共端点。

如果我使用的钱包不支持 Asset Hub Kusama 怎么办？

您可能需要切换到支持迁移的钱包。许多钱包已更新，但有些钱包（如 Trust Wallet）存在问题。请查看您的钱包文档以了解迁移支持。