智能合约与以太坊 / 系统课时
构造并签名一笔 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 可以正常执行。
在第一个终端启动独立的本地开发链:
anvil --chain-id 31337预期结果:Anvil 显示 RPC 监听地址 127.0.0.1:8545、链 ID 31337,并列出预先充值的开发账户。默认配置通常提供 10 个账户,每个账户具有 10000 个测试 ETH。该终端需保持运行。
打开第二个终端,初始化项目并安装 ethers.js v6:
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 与费用建议,再使用私钥签名;节点接收已签名的原始交易,校验后将其传播和纳入区块。私钥始终保留在签名端。

在项目目录中新建 transfer.mjs,填写下面的完整程序。示例手动构造 Type 2 交易,并调用 signTransaction 和 broadcastTransaction,以便分别观察签名与广播这两个动作。
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;
});在第二个终端执行:
node transfer.mjs预期输出示例:
发送方: 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 的实际价格由区块基础费、优先费和最高费用限制共同决定,计算方式为:
假设交易所在区块的基础费为 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 确实转移到了目标账户。