Struct HashChainAuditor 

pub struct HashChainAuditor { /* private fields */ }

带哈希链的审计器：所有日志通过 SHA-256 链式哈希串联，支持篡改检测。

防篡改机制

1. 每条记录的 current_hash = SHA256(prev_hash || sql || user || timestamp)
2. 下一条记录的 prev_hash 等于上一条的 current_hash
3. 任何对历史记录的修改会导致 current_hash 变化， 进而与下一条的 prev_hash 不匹配
4. 删除中间记录会断开链；插入记录会改变后续所有哈希

示例

use sz_orm_audit::{HashChainAuditor, SqlAuditContext};

let mut auditor = HashChainAuditor::new();
auditor.log(&SqlAuditContext {
    sql: "SELECT * FROM users".to_string(),
    user: "admin".to_string(),
    timestamp: 1000,
});
// 验证链完整性
assert!(auditor.verify().is_ok());

Implementations

impl HashChainAuditor

pub fn new() -> Self

创建空的哈希链审计器

pub fn log(&self, ctx: &SqlAuditContext)

追加一条审计日志到哈希链末尾。

• 若链为空，使用 GENESIS_HASH 作为 prev_hash
• 否则使用上一条记录的 current_hash 作为 prev_hash

SQL 会先经过 mask_sensitive 脱敏再写入链中， 确保存储的审计日志不含敏感信息。

pub fn get_entries(&self) -> Vec<HashChainEntry>

返回所有日志条目的快照（克隆）

pub fn len(&self) -> usize

返回日志条目数量

pub fn is_empty(&self) -> bool

是否为空

pub fn verify(&self) -> Result<(), String>

验证哈希链完整性。

检查内容：

1. 首条记录的 prev_hash 等于 GENESIS_HASH
2. 每条记录的 current_hash 等于 compute_hash(prev_hash, entry)
3. 相邻记录的 prev_hash 等于前一条的 current_hash

返回值

• Ok(())：链完整，未被篡改
• Err(reason)：链被篡改，reason 描述首个异常的位置与类型

pub fn flush(&self, path: &str) -> Result<usize, String>

将哈希链持久化到 JSONL 文件（每行一条 JSON）。

返回写入的条目数。

Trait Implementations

impl Default for HashChainAuditor

fn default() -> Self

Returns the “default value” for a type.