这一讲，我们用转账ERC20代币为例来先容Solidity中的变乱（event）。
一、变乱
在 Solidity 中，变乱（event）是智能合约的一种关照机制，用于向外部步调或别的合约关照某个变乱的发生。
触发一个变乱后，相干数据就会存储到区块链的收据中，并与买卖业务关联，纪录在区块链上，以便外部应用监听和处置处罚。
变乱经常用于调试合约、追踪买卖业务和数据统计等场景。比如：区块欣赏器会使用 ERC20 代币合约的变乱，对买卖业务数据举行统计。
Solidity中的变乱（event）是EVM上日记的抽象，它具有两个特点：
- 相应：应用步调（ethers.js）可以通过RPC接口订阅和监听这些变乱，并在前端做相应。
- 经济：变乱是EVM上比力经济的存储数据的方式，每个大概斲丧2,000 gas；相比之下，链上存储一个新变量至少须要20,000 gas。
1.1 声明变乱
变乱的声明由event关键字开头，接着是变乱名称，括号内里写好变乱须要纪录的变量范例和变量名。
在 Solidity 代码中，使用 event 关键字来界说一个变乱，语法如下：
- event event-name(<parameter list>);
- event Transfer(address indexed from, address indexed to, uint256 value);
1.2 触发变乱
我们可以在函数里开释变乱。在下面的例子中，每次用_transfer()函数举行转账利用的时间，都会开释Transfer变乱，并纪录相应的变量。
在 Solidity 代码中，使用 emit 关键字来触发变乱，语法如下：
- emit event-name(<parameter list>);
- emit Transfer(0xAb...b2, 0x4B...db, 1000);
- // SPDX-License-Identifier: MITpragma solidity ^0.8.0;contract Event { // balances是一个mapping，将address映射到一个uint256（无符号整数）。这个映射存储每个地点的余额。详细来说，左券会纪录每个地点的代币数目。 mapping (address => uint256) balances; // constructor()是合约的构造函数，当合约摆设时会主动调用。 // 表现约定摆设时，摆设者（msg.sender）的余额被设置为uint256范例的顶点（type(uint256).max）。这个顶点为2^256 - 1，代表了一个险些无穷的余额。 constructor() { balances[msg.sender] = type(uint256).max; } // 界说Transfer转账变乱 event Transfer(address indexed from, address indexed to, uint256 value);
- // 由指定的from地点转账到to地点 function transfer(address from,address to, uint256 value) external { // 转账利用 balances[from] -= value; // from地点减去转账数目 balances[to] += value; // 触发转账变乱 // 调用emit Transfer(...)触发Transfer变乱，纪录近期信息。这个变乱会被链上日记纪录下来，以后查询和监听。 emit Transfer(from, to, value); }}
我们输入参数from和 to 的地点，比如 0x5B38Da6a701c568545dCfcB03FcB875f56beddC4和0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97，再输入转账数目 666，点击 transact 按钮，就会在右下方输出实行结果。
实行结果表现，产生了 1 条变乱日记，我们可以继续检察详情。
1.3 indexed
在 Solidity 中，使用 emit 触发的变乱中，有一种特殊情势称为索引变乱，语法如下：
- event event-name(type-name indexed parameter-name,...);
- event Transfer(address indexed from, address indexed to, uint256 value);
通过索引参数，外部应用步调可以过滤感爱好的变乱。比方，根据发送者或吸收者地点过滤特定用户的买卖业务变乱。
通过索引参数，外部应用步调可以快速搜刮具有特定属性或条件的变乱。比方，按照特定金额范围搜刮买卖业务变乱。
留意：
- 没有使用 indexed 标记过的参数，不能作为过滤大概搜刮的字段。
- 一个变乱中 indexed 标记的参数最多有 3 个。
- 纪录区块链的日记，也可以使用状态变量，但变乱淹灭的 gas 要低。
二、 EVM日记 Log
以太坊假造机（EVM）用日记Log来存储Solidity变乱，每条日记纪录都包罗主题topics和数据data两部门。
2.1 主题 topics
日记的第一部门是主题数组，用于形貌变乱，长度不能高出4。它的第一个元素是变乱的署名（哈希）。对于上面的Transfer变乱，它的变乱哈希就是：
- keccak256("Transfer(address,address,uint256)")
- //0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
indexed标记的参数可以明确为检索变乱的索引“键”，方便之后搜刮。每个 indexed 参数的巨细为固定的256比特，如果参数太大了（比如字符串），就会主动盘算哈希存储在主题中。
这里实在会引入一个新的标题，根据Solidity的官方文档, 对于非值范例的参数（如arrays, bytes, strings）, Solidity不会直接存储，而是会将Keccak-256哈希存储在主题中，从而导致数据信息的丢失。这对于某些依靠于链上变乱的DAPP（跨链，用户注册等等）来说，大概会导致变乱检索困难，须要剖析哈希值。
2.2 数据 data
变乱中不带 indexed的参数会被存储在 data 部门中，可以明确为变乱的“值”。data 部门的变量不能被直接检索，但可以存储恣意巨细的数据。因此一样平常 data 部门可以用来存储复杂的数据结构，比方数组和字符串等等，由于这些数据高出了256比特，纵然存储在变乱的 topics 部门中，也是以哈希的方式存储。别的，data 部门的变量在存储上斲丧的gas相比于 topics 更少。
三、演示
3.1 代码示例
- // SPDX-License-Identifier: MITpragma solidity ^0.8.21;contract Events { // 界说_balances映射变量，纪录每个地点的持币数目 mapping(address => uint256) public _balances; // 界说Transfer event，纪录transfer买卖业务的转账地点，吸收地点和转账数目 event Transfer(address indexed from, address indexed to, uint256 value);
- // 界说_transfer函数，实行转账逻辑 function _transfer( address from, address to, uint256 amount ) external { _balances[from] = 10000000; // 给转账地点一些初始代币 _balances[from] -= amount; // from地点减去转账数目 _balances[to] += amount; // to地点加上转账数目 // 开释变乱 emit Transfer(from, to, amount); }}
以 Event.sol 合约为例，编译摆设。
然后调用 _transfer 函数。
点击右侧的买卖业务检察详情，可以看到日记的详细内容。
3.3 在Etherscan上查询变乱
我们实验用_transfer()函数在Sepolia测试网络上转账100代币，可以在Etherscan上查询到相应的tx：网址。
点击Logs按钮，就能看到变乱明细：
Topics内里有三个元素，[0]是这个变乱的哈希，[1]和[2]是我们界说的两个indexed变量的信息，即转账的转出地点和吸收地点。Data内里是剩下的不带indexed的变量，也就是转账数目。
四、总结
这一讲，我们先容了怎样使用和查询Solidity中的变乱。许多链上分析工具包罗Nansen和Dune Analysis都是基于变乱工作的。
|
|手机版|qidao123.com IT社区;IT企服评测▪应用市场
( 浙ICP备20004199|
浙ICP备20004199号 )|网站地图
发表于 2025-10-11 23:10:38