Skip to content

Add orynq-ai-auditability community ability#246

Closed
realdecimalist wants to merge 3 commits intoopenhome-dev:devfrom
realdecimalist:add-orynq-ai-auditability
Closed

Add orynq-ai-auditability community ability#246
realdecimalist wants to merge 3 commits intoopenhome-dev:devfrom
realdecimalist:add-orynq-ai-auditability

Conversation

@realdecimalist
Copy link
Copy Markdown

@realdecimalist realdecimalist commented Apr 10, 2026

Summary

  • Adds a community ability that creates tamper-proof, blockchain-anchored audit trails for AI conversations using Orynq's Proof-of-Inference protocol
  • Builds SHA-256 rolling hash chains where each entry links to the previous one, making any tampering detectable
  • Supports two anchoring paths:
    • Materios partner chain (default) - receipts submitted to the Materios Substrate chain, certified by the committee, then batched into Cardano L1 anchors automatically
    • Direct Cardano L1 - managed API anchoring to metadata label 2222 (user must explicitly request)

Files

File Purpose
main.py Python ability extending MatchingCapability - builds hash chain, submits via Materios gateway or Orynq managed API
config.json Ability registration with 16 trigger hotwords
README.md Full docs with setup, both anchoring paths, example conversations
__init__.py Required package init

Checklist

  • PR targets dev branch
  • Files in community/orynq-ai-auditability/
  • main.py extends MatchingCapability with register_capability + call
  • README.md with description, trigger words, and setup
  • resume_normal_flow() called on every exit path (in finally block)
  • No print() statements (uses editor_logging_handler)
  • No blocked imports
  • No hardcoded API keys (uses placeholder constants)
  • Error handling on all API calls
  • validate_ability.py passes all checks

Test plan

  • Upload zipped ability to OpenHome Live Editor
  • Test trigger phrases ("audit my AI", "run orynq", "anchor this session", etc.)
  • Verify Materios path: blob upload, receipt submission, result reporting
  • Verify direct Cardano path when user says "direct" or "cardano"
  • Confirm Materios is the default when user gives no clear preference
  • Verify hash chain builds correctly with multiple messages
  • Test exit/stop/cancel handling at each stage
  • Verify graceful fallback when APIs are unreachable

@realdecimalist realdecimalist requested a review from a team as a code owner April 10, 2026 21:48
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 10, 2026

🔀 Branch Merge Check

PR direction: add-orynq-ai-auditabilitydev

Passedadd-orynq-ai-auditabilitydev is a valid merge direction

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 10, 2026

✅ Community PR Path Check — Passed

All changed files are inside the community/ folder. Looks good!

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 10, 2026

✅ Ability Validation Passed

📋 Validating: community/orynq-ai-auditability
  ✅ All checks passed!

@github-actions github-actions bot added the community-ability Community-contributed ability label Apr 10, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 10, 2026

🔍 Lint Results

__init__.py — Empty as expected

Files linted: community/orynq-ai-auditability/main.py

✅ Flake8 — Passed

✅ All checks passed!

@realdecimalist realdecimalist force-pushed the add-orynq-ai-auditability branch from 6c7736e to 9db4d8a Compare April 10, 2026 22:03
Adds a community ability that creates tamper-proof, blockchain-anchored
audit trails for AI conversations using Orynq Proof-of-Inference protocol.
Builds SHA-256 rolling hash chains with two anchoring paths:

- Materios partner chain (default): committee-certified receipts batched
  into Cardano L1 anchors automatically
- Direct Cardano L1: managed API anchoring to metadata label 2222

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@realdecimalist realdecimalist force-pushed the add-orynq-ai-auditability branch from 9db4d8a to 9954dc9 Compare April 10, 2026 22:21
@uzair401
Copy link
Copy Markdown
Contributor

Hi @realdecimalist ,

Great work on this, After reviewing the code, we are putting this PR on hold for now as the Orynq API endpoint is currently unreachable. Once it is back up and we can verify the anchoring flow works end to end, we will pick this back up for a full review and move forward with approval and merging.

In the meanwhile, if you find the API functional on your end, please submit a working loom demo along with the PR and we will review it then.

Thanks!

@uzair401 uzair401 closed this Apr 13, 2026
@realdecimalist
Copy link
Copy Markdown
Author

hi @uzair401 we are actually wanting to go in a slightly different direction with this so there is no need for the API. please see fresh PR #249

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community-ability Community-contributed ability

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants