Resources
The verifiable AI-decision glossary
Plain-language definitions of the cryptography and compliance concepts behind a decision record your auditors can actually defend. Use it as a reference while evaluating Decision Keep or writing your automated-decision policy.
Glossary
- Append-only ledger
- A record that can only be added to, never edited or deleted. In Decision Keep each decision is one line; erasure appends a new, signed line. Tampering with any prior line breaks the cryptographic chain for every entry after it, so alteration is detectable by your auditors.
- Tamper-evident (hash chain)
- Each entry is bound to the one before it by a SHA-256 hash. Changing an earlier entry changes its hash, which breaks the link to every later entry. The chain is 'evident' because any modification is immediately and permanently visible.
- Content hash (SHA-256)
- A fixed-length fingerprint of a decision's canonical content (system, agent, version, time, payload and AI-governance fields). What Decision Keep stores and verifies is this hash plus the signature - never the decision content itself. Minimisation is enforced by the customer: send references, not raw personal data, and the ledger stays PII-free. With client-side signing the hash is computed and signed in your own environment before anything leaves it.
- Chain hash
- A SHA-256 over the previous entry's hash, the content hash, the receipt id and the organisation id. It is what cryptographically binds one decision to its predecessor and to its signer.
- Ed25519
- A modern, fast elliptic-curve signature algorithm. Each organisation holds its own Ed25519 root of trust; decisions are signed with the org's private key and verified against its published public key. Verification needs only the public key - never trust in Decision Keep.
- RFC 3161 trusted timestamp
- A signature from an independent timestamp authority (TSA) that proves exactly when a decision was signed, anchored outside your control. It removes self-asserted timestamps as the only proof of 'when', adding forensic, admissible evidence of time.
- Cryptographic erasure
- Lawful deletion that redacts the content of an expired decision and stores a signed erasure proof, while preserving the chain anchor. Storage-limitation and right-to-erasure (GDPR Art.17 / CCPA) are satisfied without losing auditability.
- Root of trust
- The cryptographic anchor an organisation controls. In Decision Keep it is the org's own Ed25519 key pair: signing happens with your key, and auditors verify with your published public key at /.well-known/record-public-key.
- Verifiable / trustless verification
- Checking a receipt with no account, no access request and no trust in the platform. An auditor recomputes the content hash, the chain hash and the signature, and (if used) the RFC 3161 token - entirely offline against the exported ledger.
- Payload minimisation
- The rule that you send references, not raw personal data. What Decision Keep persists and verifies is the hash and signature, not the decision content - keeping the ledger clean, portable and privacy-safe while still proving what was decided. The strongest guarantee comes from client-side hashing and signing: the content hash and signature are produced in your environment, so raw decision content never has to leave it.
- Gold Standard (audit readiness)
- Decision Keep's in-dashboard posture view. It exposes what is present (signed records, active hash chain, published key, retention policy, audit trail) and what is still missing (independent timestamping, external auditor, live activity, AI-governance metadata) for an evidence-ready posture.
Process
How a decision is recorded
- Your system sends the decision (references, not raw PII). What is persisted and verified is the hash and signature, not the decision content.
- The payload is canonicalised and hashed (SHA-256 content hash).
- The entry is bound to the previous one (SHA-256 chain hash).
- Your organisation's Ed25519 key signs the chain hash - in your environment (client-side signing) so the content never leaves it, or server-side on your key with the payload minimised.
- Optionally, an independent RFC 3161 authority timestamps the signing moment.
- The signed, chained record is appended to your sovereign ledger - and your auditors can verify it offline.
Sovereignty
Why sovereign and verifiable
The only persistent state is your DATA_DIR. No Supabase, no Vercel, no cloud account. Your keys never leave infrastructure you control, verification needs only your published public key, and the entire system can be evidenced offline. That is what makes the record defensible to an auditor, a regulator, or in court.
Glossary FAQ
Questions about the cryptography and compliance
What is the difference between a content hash and a chain hash?+
The content hash is a SHA-256 fingerprint of the decision itself (system, agent, version, payload and AI-governance fields). The chain hash is a SHA-256 over the previous entry's chain hash, the content hash, the receipt id and the org id. The content hash proves the decision hasn't changed; the chain hash proves it hasn't been inserted, deleted, or reordered.
Do I need to trust Decision Keep to verify a receipt?+
No. Verification is fully trustless. An auditor recomputes the content hash, the chain hash and the Ed25519 signature against your published public key - entirely offline, with no account and no access to Decision Keep. The public /verify tool and the offline
npm run verify:ledger script both do this independently.What happens if a recorded decision is altered?+
Any alteration changes the decision's content hash, which breaks the chain hash for that entry and every entry after it. The chain is tamper-evident by construction: auditors detect modification immediately and permanently. This is why the record is admissible as evidence - not because we assert it, but because the mathematics guarantee it.
Can I use Decision Keep with my existing compliance framework?+
Yes. The ledger maps directly to the controls auditors ask for: signed evidence (SOC 2 CC6.1, ISO 27001 A.5.15), tamper-evident logging (SOC 2 CC7.2, ISO 27001 A.8.15), retention and erasure (GDPR Art.17, CCPA §1798.105) and automatic logging (EU AI Act Art.12). The compliance page has the full mapping.