OpenClaw Audit Skill (FORAY Protocol)

Tamper-evident audit trails for AI-executed trades.

Create cryptographic proof of every trade your OpenClaw agent executes, anchored to the Kaspa blockchain.

---

Why This Matters

You're giving an AI agent control over real money. What happens when:

• A trade goes wrong and you need to prove what happened?
• Tax authorities ask for your trading history?
• You dispute a fill with an exchange?
• The agent makes a decision you don't understand?

FORAY captures every trade with:

• What was intended (arrangements, risk parameters)
• How values were calculated (fees, PnL, leverage)
• What was expected (stop loss, take profit)
• What actually happened (execution, fill price)
• Who authorized it (human approval, agent rationale)

All cryptographically anchored to Kaspa's ~1-second finality blockchain.

---

Quick Start

Install

openclaw skill install openclaw-audit

Or clone manually:

git clone https://github.com/DUNIN7/openclaw-audit-skill.git ~/.openclaw/skills/openclaw-audit

Configure

export KASPA_WALLET_ADDRESS="kaspa:qr..."
export KASPA_NETWORK="testnet-10"

Use

"Audit my last trade"
"Anchor my trading history to Kaspa"
"Show me proof of that BTC short"

---

Commands

Command	Description
audit this trade	Generate FORAY JSON for most recent trade
audit my last N trades	Batch audit
anchor to kaspa	Commit to blockchain
show audit history	Display anchored transactions
verify trade [id]	Verify against blockchain
export audit report	Generate compliance report

---

Documentation

• Full Skill Documentation
• FORAY v4.1 Specification
• FORAY Protocol Website

---

Files

openclaw-audit-skill/
├── SKILL.md                    # Main skill definition
├── README.md                   # This file
├── references/
│   └── foray-v41-spec.md       # Protocol quick reference
└── scripts/
    ├── anchor-trade.sh         # Kaspa anchoring script
    └── trade-to-foray.js       # Trade → FORAY JSON converter

---

Example Output

{
  "transaction_id": "TRADE_2026_Q1_BTC_SHORT_001",
  "schema_version": "4.1",
  "merkle_root": "sha256:e5f6789...",
  "blockchain_anchor": {
    "kaspa_tx_id": "kaspa:qr7x8y9z...",
    "block_height": 2851234,
    "confirmation_time_ms": 1100
  }
}

---

Security

• Private keys never touch FORAY
• Wallet addresses hashed by default
• Agent rationale optional
• Full details stored locally, only hash on-chain

---

License

Business Source License 1.1 (BSL-1.1)

Copyright (c) 2026 Marvin Percival. All rights reserved.

---

Contact

• Author: Marvin Percival
• Email: marvinp@dunin7.com
• GitHub: DUNIN7/foray-kaspathon
• Website: foray.dunin7.com