使用Python Web3扫描区块事件后，如何解码返回的data字段？

一、data字段的含义 #

区块链事件的data字段存储的是事件中未使用indexed修饰的参数值，这些参数按照以太坊ABI编码规则被打包成十六进制字符串。而用indexed标记的参数（最多3个）会被放入topics数组中（topics[0]是事件的签名哈希）。

二、解码data字段的方法（Web3.py 5.22.0） #

方法1：通过合约ABI直接解码完整日志（推荐） #

这是最便捷的方式，能直接把整个事件日志转成结构化的参数：

1. 准备你的合约ABI（编译合约时生成，或从开源平台获取）
2. 创建合约实例：

contract = w3.eth.contract(address=contract_address, abi=your_contract_abi)

3. 遍历事件日志时，用合约的事件方法解码：

event_filter = w3.eth.filter({
    'address': contract_address,
    'fromBlock':4916476,
    'toBlock':4916576
})
for log in event_filter.get_all_entries():
    # 替换成你的事件名称，比如合约中的事件叫UserAdded
    decoded_event = contract.events.UserAdded().processLog(log)
    # decoded_event['args']里就是结构化的参数
    print(decoded_event['args'])

方法2：手动解码data字段（无ABI时） #

如果你没有合约ABI，但知道事件参数的类型列表，可以用w3.codec.decode_abi直接解码data：

# 假设事件未索引的参数类型是(string, uint256)，根据实际情况修改
param_types = ['string', 'uint256']
decoded_data = w3.codec.decode_abi(param_types, log['data'])
print(decoded_data)  # 输出：('adam', 1)，对应你提供的示例data

你的示例data解码结果 #

你给出的data字符串解码后为：

• 字符串参数：adam
• uint256参数：1

解码逻辑：

• 前32字节是字符串的偏移量0x40，表示字符串数据从第64字节（两个32字节参数后）开始
• 第二个32字节是uint256数值1
• 从第64字节开始，前32字节是字符串长度4，后续的6164616d转ASCII就是adam

内容的提问来源于stack exchange，提问作者Adam d3t