Polkadot-js/apps 开发者工具中 transactionPaymentApi Runtime API 的查询问题分析

问题概述

在 Polkadot-js/apps 项目的开发者工具中，当使用 transactionPaymentApi Runtime API 的 queryInfo 和 queryFeeDetails 方法时，会出现执行失败的问题。具体表现为调用这些方法时会返回一个 wasm trap 错误，提示执行了 unreachable 指令。

技术背景

transactionPaymentApi 是 Substrate 框架中的一个重要 Runtime API，主要用于查询交易费用相关信息。queryInfo 方法用于获取交易的基本信息，包括费用计算所需的各项参数；queryFeeDetails 则提供更详细的费用明细。这两个 API 的正确运作对于开发者估算交易成本至关重要。

问题根源

经过技术分析，这个问题源于 Polkadot-js API 版本升级带来的类型兼容性变化。具体表现为：

1. 在 API v12.4.2 版本中，方法可以接受十六进制字符串格式的交易数据
2. 从 v13.0.1 版本开始，这些方法要求输入必须是 Uint8Array 格式的原始字节数据
3. 开发者工具中的调用方式没有随 API 升级而相应调整，导致类型不匹配

解决方案

要解决这个问题，需要对交易数据进行适当的类型转换：

1. 首先使用 registry.createType 将原始交易数据创建为 Extrinsic 类型
2. 然后调用 toU8a() 方法将其转换为 Uint8Array 格式
3. 最后将转换后的数据传递给 queryInfo 或 queryFeeDetails 方法

技术实现细节

正确的调用方式应该如下所示：

// 创建 Extrinsic 类型实例
const ext = api.registry.createType('Extrinsic', extrinsic);
// 转换为 Uint8Array
const u8a = ext.toU8a();
// 调用 API 方法
const feeInfo = await apiAt.call.transactionPaymentApi.queryInfo(u8a, u8a.length);

影响范围

这个问题主要影响以下场景：

1. 在开发者工具中手动调用 transactionPaymentApi 的场景
2. 依赖这些 API 进行费用估算的第三方工具
3. 需要精确计算交易费用的高级用户

最佳实践建议

对于开发者，建议：

1. 始终检查使用的 Polkadot-js API 版本
2. 对于涉及交易数据的操作，明确进行类型转换
3. 在升级 API 版本时，特别注意交易数据处理相关的变更

总结

这个问题的出现展示了 Substrate 生态系统中类型安全的重要性。随着框架的不断演进，类型系统的严格性也在提高，这虽然短期内可能带来兼容性问题，但长期来看有利于构建更健壮的应用。开发者应当关注这类变更，及时调整代码以适应新的类型要求。