智能合约与以太坊 / 系统课时
发送写入交易并处理回执
发送写入交易并处理回执
把 DApp 中的“增加计数”按钮接到 Sepolia 上的合约:用户在钱包中确认交易,页面先显示交易哈希,再等待区块回执,并区分成功、拒签、链上回滚和交易替换。示例使用 ethers.js v6,不在前端保存私钥。
学习目标
- 使用
BrowserProvider、Signer和Contract发送状态修改交易。 - 依据交易哈希与回执的
status更新页面进度。 - 区分钱包拒绝、合约执行失败与替换交易,避免误报成功或重复提交。
准备可写入的测试合约
使用 Sepolia 测试网和有少量测试 ETH 的浏览器钱包。若没有已部署的计数器,可在 Remix 新建 Counter.sol,放入以下完整合约:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Counter {
uint256 public count;
// 写入 storage,必须由链上交易执行
function increment() external {
count += 1;
}
}预期结果:在 Remix 的 Solidity Compiler 中选择兼容 ^0.8.20 的编译器完成编译;在 Deploy & Run Transactions 中选择 Injected Provider - MetaMask(界面文案可能随 Remix 版本略有变化),确认钱包连接 Sepolia 后部署。部署成功会获得形如 0x... 的合约地址,首次调用只读函数 count() 返回 0。记下该地址,后续填入页面;不要使用主网账户资金做练习。
区分钱包确认、广播与执行成功
写入函数不能像只读函数一样立即返回最终状态。点击按钮后,浏览器通过钱包获取 Signer,调用 increment() 触发钱包签名或确认;钱包批准并提交后,await contract.increment() 返回交易响应,其中 hash 可用于查询进度。await tx.wait(1) 等待交易进入区块并取得至少一次确认。

**三个判定点不可混用:**钱包确认不代表已上链;拿到 tx.hash 只代表已有可追踪的交易;回执 status=1 才表示此次 EVM 执行成功,status=0 表示已上链但执行回滚。ethers v6 的 wait() 遇到回滚通常会抛出带 receipt 的 CALL_EXCEPTION,因此错误分支也必须检查回执。
将写入按钮接到 Signer
新建 index.html,保存以下完整页面。示例使用浏览器注入的 EIP-1193 钱包,并从 CDN 加载 ethers.js v6.15.0 的浏览器构建;它只调用当前输入地址上的 increment() 与 count()。合约地址必须来自上一节实际部署的 Sepolia 合约。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Sepolia 计数器</title>
</head>
<body>
<label>合约地址:<input id="address" size="44" placeholder="0x..."></label>
<button id="send">增加计数</button>
<p id="stage" role="status">等待操作</p>
<p id="hash"></p>
<script src="https://cdnjs.cloudflare.com/ajax/libs/ethers/6.15.0/ethers.umd.min.js"></script>
<script>
const { BrowserProvider, Contract, isAddress } = ethers;
const button = document.querySelector("#send");
const stage = document.querySelector("#stage");
const hashBox = document.querySelector("#hash");
const abi = [
"function increment()",
"function count() view returns (uint256)"
];
button.addEventListener("click", async () => {
const address = document.querySelector("#address").value.trim();
if (!isAddress(address)) {
stage.textContent = "请填写有效的合约地址";
return;
}
if (!window.ethereum) {
stage.textContent = "未检测到浏览器钱包";
return;
}
button.disabled = true; // 阻止等待期间重复点击
hashBox.textContent = "";
try {
const provider = new BrowserProvider(window.ethereum);
const network = await provider.getNetwork();
if (network.chainId !== 11155111n) {
throw new Error("请将钱包切换至 Sepolia(chainId 11155111)");
}
if ((await provider.getCode(address)) === "0x") {
throw new Error("该地址在 Sepolia 上没有部署合约");
}
stage.textContent = "等待钱包连接与交易确认";
await provider.send("eth_requestAccounts", []);
const signer = await provider.getSigner();
const counter = new Contract(address, abi, signer);
const tx = await counter.increment();
hashBox.textContent = `交易哈希:${tx.hash}`;
stage.textContent = "已广播,等待区块确认";
const receipt = await tx.wait(1);
if (!receipt || receipt.status !== 1) {
stage.textContent = "交易未成功执行";
return;
}
stage.textContent = `已确认:区块 ${receipt.blockNumber},status=1`;
// 读回链上状态失败,不应抹去已确认的结论
try {
const count = await counter.count();
stage.textContent += `,当前计数 ${count.toString()}`;
} catch {
stage.textContent += ";计数读取失败,请稍后重查";
}
} catch (error) {
if (error.code === "ACTION_REJECTED" ||
error.code === 4001 || error.info?.error?.code === 4001) {
stage.textContent = "用户拒绝钱包操作,本次未广播";
} else if (error.code === "CALL_EXCEPTION" &&
error.receipt?.status === 0) {
stage.textContent = "交易已上链但执行回滚(status=0)";
} else if (error.code === "TRANSACTION_REPLACED") {
stage.textContent = "原交易被替换或取消,请核查替换回执";
if (error.receipt?.hash) {
hashBox.textContent += `;替换哈希:${error.receipt.hash}`;
}
} else {
stage.textContent = `操作未完成:${error.shortMessage ?? error.message}`;
}
} finally {
button.disabled = false;
}
});
</script>
</body>
</html>预期结果:页面显示合约地址输入框、“增加计数”按钮与进度文字。输入正确地址并点击后,进度依次为“等待钱包连接与交易确认”“已广播,等待区块确认”“已确认:区块 <ID>,status=1,当前计数 1”。交易哈希显示为 0x<ID>;实际哈希和区块号均随交易改变。若已有写入,计数会在原值上加一,不固定为 1。
为避免钱包扩展对本地文件的限制,在 index.html 所在目录运行 Python 3 的静态文件服务:
python3 -m http.server 8000预期结果:终端显示 HTTP 服务监听端口 8000(具体提示随 Python 版本变化);浏览器打开 http://localhost:8000 即可操作页面。如果系统只提供 python 命令,可用 python -m http.server 8000 替换。钱包弹窗必须由用户点击触发,不能在页面加载时主动连续发起授权请求。
排查拒签、回滚与卡住的交易
| 页面现象 | 判断依据 | 应做的事 |
|---|---|---|
| 钱包拒签 | 错误码 4001 或 ethers ACTION_REJECTED;无本次 tx.hash |
显示“已拒绝”,允许用户重新主动点击 |
| 已广播但未确认 | 已拿到 tx.hash,wait(1) 尚未完成 |
保留哈希和等待态,不自动再发一笔 |
| 链上回滚 | 回执 status=0,或 CALL_EXCEPTION 附带失败回执 |
显示失败,检查权限、余额及合约的 require 条件 |
| 同 nonce 替换 | TRANSACTION_REPLACED,存在替换交易及回执 |
核查 reason、新哈希及新回执,不能把原交易直接判成功 |
| 已确认 | 回执 status=1,具有 blockNumber |
显示成功并重新读取 count() |
按三个场景验收:正常提交后 count() 增加 1;在钱包确认界面点击拒绝,页面回到可操作且计数不变;拿到哈希后刷新页面,使用钱包或区块浏览器按哈希查询回执,不要因等待时间长而直接再点一次。wait(1) 只是一次区块确认,不代表不可逆的最终确定;对高价值操作应提高确认数,并在钱包账户或网络变化后重新校验 Signer 与 chainId。测试始终使用 Sepolia 测试 ETH,不在页面中收集私钥。