BBVA QED项目快速入门指南

概述

BBVA QED是一个基于密码学技术的可验证事件日志系统，它能够为事件提供不可篡改的证明。本文将带您快速了解QED的核心功能和使用方法。

环境准备

系统要求

在开始之前，请确保您的系统满足以下要求：

1. Docker环境已安装并运行
2. Docker Compose工具已安装

快速部署

使用以下命令可以快速搭建QED测试环境：

$ git clone <qed仓库地址>
$ git checkout v1.0.0-rc2
$ cd qed/deploy/docker
$ docker-compose up -d

这个环境包含三个核心服务：

1. QED日志服务器：负责事件存储和证明生成
2. QED发布代理：处理事件发布流程
3. 快照存储服务：保存系统状态快照

基础操作

1. 添加事件

使用QED客户端可以轻松添加事件：

$ qed_client add --event "event 0"

添加成功后会返回包含以下信息的快照：

• EventDigest：事件内容的哈希值
• HyperDigest：超树结构的哈希值
• HistoryDigest：历史记录的哈希值
• Version：事件版本号

2. 查询事件插入证明

2.1 基本查询

要验证某个事件是否已被插入：

$ qed_client membership --event "event 0"

返回结果包含：

• 事件存在性证明
• 审计路径信息
• 相关版本号

2.2 获取快照

验证证明需要从快照存储获取相关快照：

$ qed_client get --version 3

2.3 手动验证

交互式验证过程：

$ qed_client membership --event "event 0" --verify

系统会提示输入必要的哈希值进行验证。

2.4 自动验证

简化验证流程：

$ qed_client membership --event "event 0" --auto-verify

3. 增量证明

3.1 查询增量证明

验证两个事件版本间的一致性：

$ qed_client incremental --start 0 --end 3

3.2 获取相关快照

$ qed_client get --version 0
$ qed_client get --version 3

3.3 手动验证增量证明

$ qed_client incremental --start 0 --end 3 --verify

3.4 自动验证增量证明

$ qed_client incremental --start 0 --end 3 --auto-verify

技术要点解析

1. 密码学证明：QED使用Merkle树结构生成密码学证明，确保事件不可篡改。

2. 版本控制：每个事件都有唯一版本号，系统维护完整的历史记录。

3. 双重验证：

   • 事件存在性验证
   • 事件间一致性验证

4. 分布式架构：

   • 日志服务器处理核心逻辑
   • 快照存储确保状态持久化

最佳实践建议

1. 生产环境中应配置正确的终端点和快照存储URL
2. 定期备份重要快照
3. 对于关键业务事件，建议同时使用手动和自动验证
4. 保持QED客户端与服务端版本一致

环境清理

完成测试后，使用以下命令清理环境：

$ docker-compose down
$ unalias qed_client

通过本指南，您应该已经掌握了QED系统的基本操作流程。这个强大的工具可以为您的业务事件提供可靠的密码学证明，确保数据的完整性和可验证性。