Diem区块链中的事件机制详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00317/article/details/148375584

Diem区块链中的事件机制详解

diem Diem’s mission is to build a trusted and innovative financial network that empowers people and businesses around the world. 项目地址: https://gitcode.com/gh_mirrors/di/diem

概述

在Diem区块链中，事件(Events)是Move语言定义的一种特殊数据结构，用于记录交易执行过程中产生的关键信息。这些事件数据会被永久存储在区块链的EventStore中，成为账本状态的一部分。通过查询事件，用户可以获取链上交易执行的证明。

事件类型与用途

Diem区块链中的事件主要分为三大类：

1. 支付交易事件

当发生支付交易时，系统会自动生成两类事件：

SentPaymentEvent：记录在发送方的事件流中
ReceivedPaymentEvent：记录在接收方的事件流中

这两种事件结构相同，包含以下字段：

| 字段名 | 类型 | 描述 | |----------|----------|----------------------------------------------------------------------| | amount | Amount | 交易金额 | | sender | string | 发送方地址(16进制编码)，如果是铸币交易则为0x0...0 | | receiver | string | 接收方地址(16进制编码) | | metadata | string | 可选字段，可用于存储额外元数据，如实现子地址方案等 |

2. 铸币与销毁事件

每种注册的货币类型都会在链上维护一个CurrencyInfo<CoinType>资源，其中包含四个相关事件流：

BurnEvent：记录货币销毁事件
PreburnEvent：记录预销毁事件
CancelBurnEvent：记录取消销毁事件
MintEvent：记录货币铸造事件

3. 系统操作事件

系统级操作也会产生相应事件，例如：

UpgradeEvent：系统升级维护时触发
NewEpochEvent：链上配置修改时触发
NewBlockEvent：新区块添加时触发

事件机制核心概念

事件流(Event Stream)

事件流是ContractEvent负载的仅追加向量(append-only vector)。每个事件流都有：

唯一的40字节事件键(Event Key)
从0开始的序列号(Sequence Number)

事件句柄(EventHandle)

EventHandle是Move资源，包含：

事件键
当前事件流中的事件计数

EventHandle通常嵌入在其他Move资源中。例如，每个DiemAccount资源都包含：

sent_events：发送支付事件句柄
received_events：接收支付事件句柄

ContractEvent结构

ContractEvent负载包含：

事件键
序列号
序列化的Move值
标识值类型的标签

事件查询实践

查询账户的SentPaymentEvent

以下示例展示如何查询账户的SentPaymentEvent：

获取事件键：通过查询账户状态获取sent_events_key和received_events_key。

示例响应：

{
  "received_events_key": "00000000000000001668f6be25668c1a17cd8caf6b8d2f25",
  "sent_events_key": "01000000000000001668f6be25668c1a17cd8caf6b8d2f25",
  ...
}

查询具体事件：使用获取的事件键查询特定序列号的事件。

示例响应：

{
  "data": {
    "amount": {
      "amount": 200,
      "currency": "XUS"
    },
    "metadata": "",
    "receiver": "280081f",
    "sender": "996b67d",
    "type": "sentpayment"
  },
  "key": "01000000000000001668f6be25668c1a17cd8caf6b8d2f25",
  "sequence_number": 2,
  "transaction_version": 106495
}