Skip to content

tutorials: add audit trail tutorial (04)#212

Open
ygd58 wants to merge 1 commit intoOpenGradient:mainfrom
ygd58:tutorials/04-audit-trail
Open

tutorials: add audit trail tutorial (04)#212
ygd58 wants to merge 1 commit intoOpenGradient:mainfrom
ygd58:tutorials/04-audit-trail

Conversation

@ygd58
Copy link
Copy Markdown
Contributor

@ygd58 ygd58 commented Mar 27, 2026

Summary

Adds tutorials/04-audit-trail.md — the fourth tutorial in the series,
complementing the existing three.

What it covers

  • Why INDIVIDUAL_FULL settlement is best for audit use cases
  • Building a structured AuditEntry dataclass with all TEE fields
  • Computing SHA-256 content hashes for local tamper detection
  • Persisting and verifying the audit log as JSON
  • On-chain verification via the block explorer
  • Settlement mode comparison table (PRIVATE / BATCH_HASHED / INDIVIDUAL_FULL)

Why it's useful

The three existing tutorials cover agents, streaming, and tool-calling.
None of them explain how to operationalize OpenGradient's core value
proposition — verifiable AI. This tutorial fills that gap directly and
references examples/llm_audit_trail.py (PR #211) as the runnable companion.

Related

Explains how to build a tamper-proof audit log from TEE-verified
inferences. Covers INDIVIDUAL_FULL settlement mode, content hashing
for local tamper detection, and on-chain verification via the
OpenGradient block explorer. References examples/llm_audit_trail.py.
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.

1 participant