Skip to content

docs(audit): document hash-chain tamper evidence#1808

Closed
maxw06 wants to merge 4 commits into
QuickLendX:mainfrom
maxw06:codex/audit-hash-chain-doc-1703-ready
Closed

docs(audit): document hash-chain tamper evidence#1808
maxw06 wants to merge 4 commits into
QuickLendX:mainfrom
maxw06:codex/audit-hash-chain-doc-1703-ready

Conversation

@maxw06

@maxw06 maxw06 commented Jul 8, 2026

Copy link
Copy Markdown

Closes #1703.

Summary

  • Add quicklendx-contracts/docs/AUDIT_HASH_CHAIN.md documenting the audit hash-chain design.
  • Cover genesis hash semantics, per-entry linking, hash preimage serialization order, and operation tag mapping.
  • Document verifier/divergence usage, edge cases, and detected versus out-of-scope tampering.
  • Link the guide from the contract README.

Validation

git diff --check origin/main..HEAD
rg -n "fn (entry_hash|last_entry_hash|verify_audit_chain|first_audit_chain_divergence|genesis_prev_hash)|operation_tag|append_" quicklendx-contracts/src/audit.rs quicklendx-contracts/docs/AUDIT_HASH_CHAIN.md quicklendx-contracts/README.md

@Baskarayelu

Copy link
Copy Markdown
Contributor

thanks for the contribution! our workflow only merges a PR when its author is assigned to the linked issue — please get assigned to an open issue first, then raise the PR. closing as invalid for now 🙏

@Baskarayelu Baskarayelu closed this Jul 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document the audit hash-chain design and tamper-evidence model in docs/AUDIT_HASH_CHAIN.md

2 participants