Ethers.js 中签名交易与广播交易的正确使用方式

理解交易签名与广播的区别

在区块链开发中，ethers.js 是一个广泛使用的 JavaScript 库，它提供了与区块链网络交互的简洁接口。其中，交易签名和广播是两个关键但经常被混淆的操作。

常见错误场景

许多开发者会遇到这样的错误："TypeError: Cannot use 'in' operator to search for 'chainId' in..."。这通常发生在尝试将已签名的交易直接传递给 sendTransaction 方法时。

正确使用方式

ethers.js 提供了两种处理交易的方式：

1. 签名交易：使用 wallet.signTransaction() 方法会返回一个序列化的已签名交易（十六进制字符串）。这个结果可以直接用于 provider.broadcastTransaction() 方法。

2. 发送交易：wallet.sendTransaction() 方法期望接收的是与 signTransaction 相同的 TransactionRequest 对象（包含 from、to、data 等字段的对象），而不是已签名的交易。这个方法会在内部自动完成签名和广播两个步骤。

代码示例

// 正确方式1：使用sendTransaction直接发送交易
const tx = await wallet.sendTransaction({
    from: wallet.address,
    to: address,
    data: hex,
    chainId: 4200,
    nonce: nonce
});

// 正确方式2：先签名再广播
const signedTx = await wallet.signTransaction({
    from: wallet.address,
    to: address,
    data: hex,
    chainId: 4200,
    nonce: nonce
});
const txHash = await provider.broadcastTransaction(signedTx);

为什么会出现错误

当开发者将 signTransaction 返回的已签名交易直接传递给 sendTransaction 时，后者会尝试解析这个十六进制字符串，期望找到一个 TransactionRequest 对象（包含 chainId 等字段），但实际得到的是序列化数据，因此抛出 "Cannot use 'in' operator to search for 'chainId'" 错误。

最佳实践建议

1. 大多数情况下，直接使用 sendTransaction 更为简便，因为它封装了签名和广播两个步骤。
2. 只有在需要将签名与广播分离的特殊场景下（如离线签名），才需要使用 signTransaction 和 broadcastTransaction 的组合。
3. 确保理解每个方法的输入输出类型，避免混淆序列化交易和交易请求对象。

通过正确理解这些概念和方法，开发者可以更高效地使用 ethers.js 进行区块链交易处理。