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

发送写入交易并处理回执

发送写入交易并处理回执

把 DApp 中的“增加计数”按钮接到 Sepolia 上的合约:用户在钱包中确认交易,页面先显示交易哈希,再等待区块回执,并区分成功、拒签、链上回滚和交易替换。示例使用 ethers.js v6,不在前端保存私钥。

学习目标

  • 使用 BrowserProvider、Signer 和 Contract 发送状态修改交易。
  • 依据交易哈希与回执的 status 更新页面进度。
  • 区分钱包拒绝、合约执行失败与替换交易,避免误报成功或重复提交。

准备可写入的测试合约

使用 Sepolia 测试网和有少量测试 ETH 的浏览器钱包。若没有已部署的计数器,可在 Remix 新建 Counter.sol,放入以下完整合约:

solidity
// 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) 等待交易进入区块并取得至少一次确认。

DApp 写入交易的签名、广播、回执与失败分支时序

**三个判定点不可混用:**钱包确认不代表已上链;拿到 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 合约。

html
<!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 的静态文件服务:

bash
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,不在页面中收集私钥。

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

目录与阅读设置

阅读设置

17

记录一个想法

发送写入交易并处理回执

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

登录哪都通