智能合约与以太坊 / 系统课时

构造并签名一笔 ETH 转账

构造并签名一笔 ETH 转账

一笔 ETH 转账需要明确收款地址、金额、交易序号和 Gas 费用,再由发送方私钥签名并提交给网络。本课使用 Anvil 本地 Ethereum 节点和 ethers.js v6,完成一笔 0.01 ETH 转账,检查签名、交易哈希、执行收据和余额变化,区分签名成功、广播成功与链上执行成功。

学习目标

  • 识别 ETH 转账的发送方、接收方、金额、nonce、Gas 参数和签名数据。
  • 使用 ethers.js v6 构造 EIP-1559 交易,在本地完成签名并广播。
  • 根据交易哈希、执行收据和余额变化验证转账结果及手续费。

认识 ETH 转账的交易字段

Ethereum 使用账户模型。普通 ETH 转账由外部账户(EOA)发起,交易的 to 指向收款地址,value 表示转账金额。发送方并不是随意填写的 from 字段,而是节点根据签名恢复并验证的账户地址。

以本地链上一笔 0.01 ETH 转账为例,采用 EIP-1559 Type 2 交易,主要字段如下。

字段 示例 作用
chainId 31337 指定目标链,参与签名以防止跨链重放
nonce 0 发送账户的交易序号,实际值按账户状态获取
to 0x70997970C51812dc3A010C7d01b50e0d17dc79C8 接收方地址
value 10000000000000000 wei 转账 0.01 ETH
gasLimit 21000 此次普通 EOA 转账的 Gas 上限
maxFeePerGas 3 gwei 每单位 Gas 愿意支付的最高总费用
maxPriorityFeePerGas 1 gwei 每单位 Gas 的最高优先费
type 2 EIP-1559 动态费用交易

1 ETH = 10^18 wei,而 1 gwei = 10^9 wei。金额应使用整数 wei 表示,避免 JavaScript 浮点数计算精度问题;ethers.js 的 parseEther('0.01') 会返回正确的 bigint 金额。

签名后,Type 2 交易还包含 yParity、r 和 s 签名数据。它们由私钥对交易签名摘要计算得到,用来验证发送方的授权。原始交易不会携带私钥。

对于接收方没有代码、交易没有附加数据和访问列表的普通 ETH 转账,Gas 消耗通常为 21000。如果接收方是合约,或交易包含额外数据,则不能直接沿用这一数值。

启动本地 Ethereum 节点

本例使用 Foundry 提供的 Anvil 节点和 Node.js 20 或更高版本。需要事先安装 Foundry、Node.js 和 npm,并确认 anvil --version 与 node --version 可以正常执行。

在第一个终端启动独立的本地开发链:

bash
anvil --chain-id 31337

预期结果:Anvil 显示 RPC 监听地址 127.0.0.1:8545、链 ID 31337,并列出预先充值的开发账户。默认配置通常提供 10 个账户,每个账户具有 10000 个测试 ETH。该终端需保持运行。

打开第二个终端,初始化项目并安装 ethers.js v6:

bash
mkdir eth-transfer-demo
cd eth-transfer-demo
npm init -y
npm install ethers@6

预期结果:目录内出现 package.json、package-lock.json 和 node_modules,package.json 的依赖包含 ethers。npm 输出的版本号、安装耗时和审计提示会随环境变化。

本例使用 Anvil 的默认测试助记词 test test test test test test test test test test test junk,对应第一个账户地址 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266。接收方使用第二个预置账户。

构造、签名并广播交易

整个转账过程涉及本地钱包、RPC 节点、交易池和区块执行。钱包先查询链 ID、nonce 与费用建议,再使用私钥签名;节点接收已签名的原始交易,校验后将其传播和纳入区块。私钥始终保留在签名端。

ETH 转账从本地构造签名到节点广播和区块确认的数据流

在项目目录中新建 transfer.mjs,填写下面的完整程序。示例手动构造 Type 2 交易,并调用 signTransaction 和 broadcastTransaction,以便分别观察签名与广播这两个动作。

js
import {
  JsonRpcProvider,
  Wallet,
  Transaction,
  parseEther,
  formatEther
} from 'ethers';

async function main() {
  const provider = new JsonRpcProvider('http://127.0.0.1:8545');
  const network = await provider.getNetwork();
  if (network.chainId !== 31337n) {
    throw new Error('链 ID 不匹配,拒绝签名');
  }

  // 公开测试助记词只能连接本地 Anvil,禁止用于真实资金。
  const sender = Wallet.fromPhrase(
    'test test test test test test test test test test test junk',
    provider
  );
  const recipient = '0x70997970C51812dc3A010C7d01b50e0d17dc79C8';
  const before = await provider.getBalance(recipient);
  const feeData = await provider.getFeeData();

  if (feeData.maxFeePerGas == null ||
      feeData.maxPriorityFeePerGas == null) {
    throw new Error('当前节点未提供 EIP-1559 费率');
  }

  // 手动签名不会自动补齐 nonce、Gas 和链 ID。
  const request = {
    type: 2,
    chainId: network.chainId,
    nonce: await provider.getTransactionCount(sender.address, 'pending'),
    to: recipient,
    value: parseEther('0.01'),
    gasLimit: 21000n,
    maxFeePerGas: feeData.maxFeePerGas,
    maxPriorityFeePerGas: feeData.maxPriorityFeePerGas
  };

  const signed = await sender.signTransaction(request);
  const decoded = Transaction.from(signed);

  // 广播前验证签名恢复出的发送方是否与预期一致。
  const signatureValid =
    decoded.from?.toLowerCase() === sender.address.toLowerCase();
  if (!signatureValid) throw new Error('签名发送方不匹配');

  const submitted = await provider.broadcastTransaction(signed);
  const receipt = await submitted.wait(1);
  if (!receipt) throw new Error('尚未获得交易收据');

  const after = await provider.getBalance(recipient);
  console.log('发送方:', sender.address);
  console.log('接收方:', recipient);
  console.log('签名校验:', signatureValid);
  console.log('交易哈希:', submitted.hash);
  console.log('收据状态:', receipt.status);
  console.log('Gas 已用:', receipt.gasUsed.toString());
  console.log('到账增量:', formatEther(after - before), 'ETH');
  console.log('手续费:', formatEther(receipt.fee), 'ETH');
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

在第二个终端执行:

bash
node transfer.mjs

预期输出示例:

text
发送方: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
接收方: 0x70997970C51812dc3A010C7d01b50e0d17dc79C8
签名校验: true
交易哈希: 0x<ID>
收据状态: 1
Gas 已用: 21000
到账增量: 0.01 ETH
手续费: <FEE> ETH

其中 <ID> 是随交易内容变化的哈希值,<FEE> 是实际手续费,具体取值由打包区块的费率决定。示例展示了典型的成功结果,不要求每次运行获得相同的交易哈希和手续费。

这段程序中,signTransaction 返回包含签名数据的序列化原始交易,但并不会自行广播。Transaction.from(signed) 解析签名交易,通过其 from 属性检查签名恢复的发送方。随后,broadcastTransaction 向节点提交原始交易,返回的哈希用于后续查询。

wait(1) 等待交易进入区块并获得至少一次确认。它返回的收据中,status 为 1 表示执行成功,0 表示执行失败。网络接纳交易并返回哈希时,交易还不一定已经入块,因此不能仅凭哈希判断转账完成。

核对余额、Gas 与常见失败

本例的转账金额为 0.01 ETH,接收方的余额应增加 0.01 ETH,而发送方余额减少的数量还包括手续费。Gas 上限与实际用量是两种不同的数据:gasLimit 决定可使用的最大 Gas,receipt.gasUsed 反映最终执行消耗。

对于 EIP-1559 交易,每单位 Gas 的实际价格由区块基础费、优先费和最高费用限制共同决定,计算方式为:

实际Gas单价=min⁡(maxFeePerGas,baseFeePerGas+maxPriorityFeePerGas)\text{实际Gas单价}=\min(\text{maxFeePerGas},\text{baseFeePerGas}+\text{maxPriorityFeePerGas})

假设交易所在区块的基础费为 1 gwei,最高优先费为 1 gwei,最高总费为 3 gwei,那么实际单价为 2 gwei。若消耗 21000 Gas,则手续费为 21000 × 2 gwei = 0.000042 ETH。发送方总计减少 0.010042 ETH,接收方增加 0.01 ETH。基础费按协议销毁,优先费归区块提议者对应的费用接收地址。

检查项 成功判断 失败时优先检查
链连接 链 ID 为 31337 Anvil 是否运行、RPC 地址是否正确
签名 恢复出的发送方与预期一致 私钥来源、交易字段、chainId
广播 获得交易哈希 nonce、账户余额、Gas 费率上限
收据 status = 1 是否入块、是否执行失败
金额 接收方余额增加 0.01 ETH value 的 wei 换算、查询的区块状态
Gas 普通 EOA 转账使用 21000 接收方是否为合约、交易是否带有数据

若遇到 nonce too low,说明所提交的 nonce 已过期,可能已经被其他交易占用。重新从 pending 状态获取交易计数并重新签名,而不是重复广播原始字节。

若遇到 insufficient funds,需要核对发送账户余额是否足以覆盖转账金额与最高可能费用。对于本例,至少应满足余额不低于 value + gasLimit × maxFeePerGas。如果提示费用上限低于基础费,则需要重新获取费率并构造新的交易。

完成验证时,应同时具备签名发送方匹配、交易哈希、成功收据和余额变化这四项证据。它们分别证明交易获得授权、被节点接收、在区块中成功执行,以及 ETH 确实转移到了目标账户。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构造并签名一笔 ETH 转账

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通