|
| 1 | +# Orynq AI Auditability |
| 2 | + |
| 3 | + |
| 4 | + |
| 5 | + |
| 6 | + |
| 7 | +## What It Does |
| 8 | + |
| 9 | +Creates tamper-proof, blockchain-anchored audit trails for AI conversations using Orynq's Proof-of-Inference protocol. Each message is hashed into a rolling SHA-256 chain with two anchoring paths: |
| 10 | + |
| 11 | +1. **Direct Cardano L1** - Managed API anchoring to Cardano metadata label 2222 |
| 12 | +2. **Materios Partner Chain** - High-throughput receipts with committee certification, automatically batched into Cardano L1 anchors |
| 13 | + |
| 14 | +## Suggested Trigger Words |
| 15 | + |
| 16 | +- "audit my AI" |
| 17 | +- "create audit trail" |
| 18 | +- "blockchain audit" |
| 19 | +- "proof of inference" |
| 20 | +- "verify AI" |
| 21 | +- "AI accountability" |
| 22 | +- "audit this conversation" |
| 23 | +- "run orynq" |
| 24 | +- "anchor this session" |
| 25 | +- "anchor this conversation" |
| 26 | +- "record AI decision" |
| 27 | +- "log this to blockchain" |
| 28 | +- "start audit" |
| 29 | +- "chain of custody" |
| 30 | + |
| 31 | +## Setup |
| 32 | + |
| 33 | +1. Get an Orynq API key at [orynq.com](https://orynq.com) |
| 34 | +2. Replace `YOUR_ORYNQ_API_KEY_HERE` in `main.py` with your key |
| 35 | +3. For Materios support: get a gateway API key and replace `YOUR_MATERIOS_GATEWAY_API_KEY_HERE` |
| 36 | +4. Upload the ability to your OpenHome dashboard |
| 37 | + |
| 38 | +## How It Works |
| 39 | + |
| 40 | +1. You trigger the ability with a phrase like "audit my AI" or "run orynq" |
| 41 | +2. Choose your anchoring path: say "direct" for Cardano L1, or "Materios" for the partner chain |
| 42 | +3. Speak the messages you want included in the audit trail |
| 43 | +4. Say "done" when finished |
| 44 | +5. The ability builds a SHA-256 rolling hash chain where each entry links to the previous one |
| 45 | +6. The chain is submitted via your chosen path |
| 46 | + |
| 47 | +### Direct Cardano Path |
| 48 | +- Hash chain is submitted to the Orynq managed API |
| 49 | +- Anchored directly to Cardano L1 under metadata label 2222 |
| 50 | +- You receive a transaction hash for on-chain verification |
| 51 | + |
| 52 | +### Materios Partner Chain Path |
| 53 | +- Trace data is uploaded as blobs to the Materios gateway |
| 54 | +- A receipt is submitted on-chain to the Materios Substrate chain |
| 55 | +- The cert daemon committee attests data availability |
| 56 | +- Certified receipts are batched into Cardano L1 anchors automatically |
| 57 | +- You receive a receipt ID for tracking through the full lifecycle |
| 58 | + |
| 59 | +The hash chain is tamper-proof: changing any single entry invalidates all subsequent hashes, making unauthorized modifications detectable. |
| 60 | + |
| 61 | +## Example Conversation |
| 62 | + |
| 63 | +### Direct Cardano |
| 64 | + |
| 65 | +> **User:** "Anchor this session" |
| 66 | +> **AI:** "I will create a blockchain audit trail. Would you like to anchor directly to Cardano, or use the Materios partner chain for high-throughput certified receipts?" |
| 67 | +> **User:** "Direct to Cardano" |
| 68 | +> **AI:** "Using direct Cardano anchoring via the managed API. Tell me what to include in the audit trail." |
| 69 | +> **User:** "Log that the model recommended treatment plan A for patient 42" |
| 70 | +> **AI:** "Got it. Say more to add entries, or say done when finished." |
| 71 | +> **User:** "Done" |
| 72 | +> **AI:** "Your 1-entry audit trail has been anchored to Cardano and is now tamper-proof and independently verifiable." |
| 73 | +
|
| 74 | +### Materios Partner Chain |
| 75 | + |
| 76 | +> **User:** "Run orynq" |
| 77 | +> **AI:** "I will create a blockchain audit trail. Would you like to anchor directly to Cardano, or use the Materios partner chain?" |
| 78 | +> **User:** "Use Materios" |
| 79 | +> **AI:** "Using Materios partner chain. Your receipt will be certified by the committee and then batched into a Cardano L1 anchor. Tell me what to include." |
| 80 | +> **User:** "The agent processed 500 claims with a 98.2% accuracy rate" |
| 81 | +> **AI:** "Got it. Say more to add entries, or say done when finished." |
| 82 | +> **User:** "Done" |
| 83 | +> **AI:** "Your audit trail was submitted to Materios. The cert daemon committee will verify, then it gets batched into a Cardano L1 anchor automatically." |
| 84 | +
|
| 85 | +## Why Auditability Matters |
| 86 | + |
| 87 | +As AI systems make increasingly consequential decisions, organizations need provable records of what AI said and when. Traditional logging can be altered. Blockchain anchoring provides: |
| 88 | + |
| 89 | +- **Tamper evidence** - Any modification breaks the hash chain |
| 90 | +- **Independent verification** - Anyone can verify the trail on-chain |
| 91 | +- **Regulatory compliance** - Immutable records for audit requirements |
| 92 | +- **Accountability** - Provable AI decision history |
| 93 | + |
| 94 | +## Technical Details |
| 95 | + |
| 96 | +- **Hash algorithm**: SHA-256 rolling chain |
| 97 | +- **Blockchain**: Cardano L1 (direct or via Materios batching) |
| 98 | +- **Metadata label**: 2222 (Orynq Proof-of-Inference standard) |
| 99 | +- **Materios**: Substrate partner chain with OrinqReceipts pallet, committee certification, and checkpoint anchoring |
| 100 | +- **Protocols**: Orynq Flux (Cardano payments), MOTRA fee tokens (Materios) |
| 101 | +- **SDK**: [orynq-sdk](https://github.com/flux-point-studios/orynq-sdk) |
0 commit comments