第四节 DApp 中的事件
1. 事件简介
在传统的 Web 或 App 开发中，我们对“事件”的理解通常是 用户操作触发的交互，例如点击按钮、输入文本、提交表单等。而在 区块链和智能合约 中，事件的概念有所不同。
以太坊并没有内置“消息推送”机制，合约无法直接通知外部世界。为了让 DApp 或区块链浏览器获知链上行为，事件（Event） 被设计为一种 轻量级日志记录方式。
特点：
- 事件本质上是交易执行过程中在 EVM 上产生的日志（log）。
- 日志数据不会影响链上状态，因此比修改存储更便宜。
- 每次事件触发，都会记录在交易的 receipt 中，外部应用可以通过 RPC 接口读取。
📌 成本对比
- 事件（log）写入：约 2000 gas
- 存储一个状态变量：至少 20000 gas
因此在智能合约中，事件通常被用来记录重要信息，而不是直接修改合约存储。
2. Solidity 合约中的事件
在 Solidity 中，事件通过 event 关键字声明，并在合约运行时通过 emit 触发。
2.1 定义事件
语法：
event EventName(type parameter1, type parameter2, ...);
你可以在合约里定义多个事件，常用于：
- 记录代币转账（Transfer）
- 记录授权（Approval）
- 记录自定义操作（如 NFT 的 mint、拍卖出价等）
2.2 触发事件
使用 emit：
emit EventName(param1, param2, ...);
事件被触发后，会记录在交易日志（logs）中，DApp 可以通过 RPC 调用获取。
2.3 示例：NFT 合约添加事件
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
contract MyToken is ERC721, Ownable {
uint256 private _nextTokenId = 0;
// 声明事件
event Minted(address minter, uint256 amount);
constructor() ERC721("MyToken", "MTK") Ownable(msg.sender) {}
function mint(uint256 quantity) public payable {
require(quantity == 1, "quantity must be 1");
require(msg.value == 0.01 ether, "must pay 0.01 ether");
uint256 tokenId = _nextTokenId++;
_mint(msg.sender, tokenId);
// 触发事件
emit Minted(msg.sender, quantity);
}
}
这里定义了 Minted 事件，在用户成功 mint NFT 后触发。这样前端 DApp 就能监听并更新界面。
3. DApp 中监听合约事件
在前端 DApp 中，我们无法直接从区块链获得“通知”，只能 通过 RPC 节点轮询或订阅合约日志 来获知事件发生。
借助 wagmi 这样的开发框架，我们可以用更简洁的方式来监听合约事件。
3.1 引入 Hook
在 React + wagmi 项目中，可以使用 useWatchContractEvent Hook：
import {
createConfig,
http,
useReadContract,
useWriteContract,
useWatchContractEvent,
} from "wagmi";
3.2 监听合约事件
useWatchContractEvent({
address: "0xEcd0D12E21805803f70de03B72B1C162dB0898d9", // 合约地址
abi: [
{
anonymous: false,
inputs: [
{ indexed: false, internalType: "address", name: "minter", type: "address" },
{ indexed: false, internalType: "uint256", name: "amount", type: "uint256" },
],
name: "Minted",
type: "event",
},
],
eventName: "Minted",
onLogs(logs) {
console.log("Event logs:", logs);
message.success("New NFT minted!");
},
});
这样，当链上出现 Minted 事件时，DApp 就会收到回调。
4. 应用场景
监听事件在 DApp 中非常常见，典型的应用包括：
-
实时更新 UI
例如 NFT mint 成功后，前端界面自动显示最新的 Token ID。
-
交易状态反馈
用户发起交易 → 等待确认 → 收到事件 → 页面弹窗提示成功/失败。
-
构建通知系统
后端服务器也可以监听事件，并给用户推送通知（如邮件、Websocket、Telegram 机器人）。
-
索引与数据服务
像 The Graph 这类区块链索引服务，就是通过事件来同步链上数据。
5. 最佳实践与注意事项
-
不要把事件当成合约逻辑的一部分
- 事件不能被合约内读取，它们只对外部应用有用。
- 不要在逻辑上依赖事件，否则合约本身不安全。
-
合理使用 indexed
- 事件的参数可以加上
indexed，最多 3 个。
- 这样可以在链上高效检索特定用户的事件（例如某个地址的 Transfer 记录）。
-
统一管理 ABI
- 在实际项目中，事件 ABI 不要散落在各个组件中，应该集中维护，保证和合约编译结果一致。
-
兼顾前后端
- 前端 DApp 可以监听事件更新 UI；
- 后端服务可以同时监听事件，用于数据分析、备份、风控。
6. 总结
- 事件是 EVM 的日志机制，成本低于存储，用于记录链上行为。
- 在 智能合约中通过
event 定义，用 emit 触发。
- 在 DApp 前端通过 RPC 或 SDK（如 wagmi）监听事件，实现实时更新。
- 应用场景包括 UI 实时刷新、交易通知、后端索引等。
- 事件是 DApp 开发的“桥梁”，既提高了效率，也增强了交互体验。
