Skip to content

Commit 7edfb8e

Browse files
Add Materios partner chain integration and expand hotwords
Support two anchoring paths: direct Cardano L1 via managed API and Materios partner chain with committee certification and batched L1 anchoring. User selects path via voice at runtime. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent e4e2043 commit 7edfb8e

2 files changed

Lines changed: 287 additions & 66 deletions

File tree

community/orynq-ai-auditability/README.md

Lines changed: 54 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,10 @@
66

77
## What It Does
88

9-
Creates tamper-proof, blockchain-anchored audit trails for AI conversations using Orynq Proof-of-Inference protocol. Each message is hashed into a rolling SHA-256 chain and anchored to Cardano L1 (metadata label 2222) for independent verification.
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
1013

1114
## Suggested Trigger Words
1215

@@ -17,34 +20,67 @@ Creates tamper-proof, blockchain-anchored audit trails for AI conversations usin
1720
- "verify AI"
1821
- "AI accountability"
1922
- "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"
2030

2131
## Setup
2232

2333
1. Get an Orynq API key at [orynq.com](https://orynq.com)
24-
2. Replace YOUR_ORYNQ_API_KEY_HERE in main.py with your key
25-
3. Upload the ability to your OpenHome dashboard
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
2637

2738
## How It Works
2839

29-
1. You trigger the ability with a phrase like "audit my AI"
30-
2. Speak the messages you want included in the audit trail
31-
3. Say "done" when finished
32-
4. The ability builds a SHA-256 rolling hash chain where each entry links to the previous one
33-
5. The chain is submitted to Orynq API for anchoring to Cardano L1
34-
6. You receive a transaction hash for independent verification
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
3558

3659
The hash chain is tamper-proof: changing any single entry invalidates all subsequent hashes, making unauthorized modifications detectable.
3760

3861
## Example Conversation
3962

40-
> **User:** "Audit my AI"
41-
> **AI:** "I will create a blockchain audit trail for this conversation. Each message gets hashed into a tamper-proof chain anchored to Cardano."
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."
4269
> **User:** "Log that the model recommended treatment plan A for patient 42"
43-
> **AI:** "Got it. I will include your messages in the audit trail. Say more to add entries, or say done when finished."
44-
> **User:** "The confidence score was 0.94 with no flagged biases"
45-
> **AI:** "Added. 2 messages in the trail so far. Say done to finalize."
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."
4682
> **User:** "Done"
47-
> **AI:** "Your 2-entry audit trail has been anchored to Cardano. It is now tamper-proof and independently verifiable."
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."
4884
4985
## Why Auditability Matters
5086

@@ -58,7 +94,8 @@ As AI systems make increasingly consequential decisions, organizations need prov
5894
## Technical Details
5995

6096
- **Hash algorithm**: SHA-256 rolling chain
61-
- **Blockchain**: Cardano L1
97+
- **Blockchain**: Cardano L1 (direct or via Materios batching)
6298
- **Metadata label**: 2222 (Orynq Proof-of-Inference standard)
63-
- **Protocol**: Orynq Flux (402 Payment Required for anchoring fees)
99+
- **Materios**: Substrate partner chain with OrinqReceipts pallet, committee certification, and checkpoint anchoring
100+
- **Protocols**: Orynq Flux (Cardano payments), MOTRA fee tokens (Materios)
64101
- **SDK**: [orynq-sdk](https://github.com/flux-point-studios/orynq-sdk)

0 commit comments

Comments
 (0)