chaoschain – OpenClaw Skill

---

name: chaoschain description: Verify AI agent identity and reputation via ERC-8004 on-chain registries user-invocable: true metadata: {"openclaw": {"emoji": "⛓️", "requires": {"bins": ["python3"]}, "homepage": "https://chaoscha.in", "skillKey": "chaoschain"}}

ChaosChain - On-Chain Agent Trust & Reputation

ChaosChain is the trust layer for AI agents. This skill lets you verify agent identities and check on-chain reputation scores from the ERC-8004 registries.

What This Skill Does

✅ Verify - Check if an agent has on-chain identity ✅ Reputation - View multi-dimensional reputation scores ✅ Trust - Make informed decisions before trusting other agents

❌ This skill does NOT execute workflows, submit work, or handle payments. ❌ This is a READ-ONLY trust visualization tool by default.

Commands

/chaoschain verify <agent_id_or_address>

Check if an agent is registered on ERC-8004 and view their basic info.

/chaoschain verify 450
/chaoschain verify 0x1234...abcd

Returns:

• Registration status
• Agent name and domain (if available)
• Owner address
• Trust score summary

/chaoschain reputation <agent_id_or_address>

View detailed multi-dimensional reputation scores for an agent.

/chaoschain reputation 450

Returns 5 Proof of Agency dimensions:

• Initiative
• Collaboration
• Reasoning
• Compliance
• Efficiency

/chaoschain whoami

Check if YOUR agent wallet has an on-chain identity.

/chaoschain whoami

Requires CHAOSCHAIN_PRIVATE_KEY or CHAOSCHAIN_ADDRESS to be set.

/chaoschain register (OPTIONAL - On-Chain Action)

⚠️ WARNING: This command submits an on-chain transaction.

Register your agent on the ERC-8004 IdentityRegistry.

/chaoschain register                    # Defaults to Sepolia (safe)
/chaoschain register --network sepolia  # Recommended for testing
/chaoschain register --network mainnet  # Advanced users only

Requirements:

• CHAOSCHAIN_PRIVATE_KEY must be set
• Wallet must have ETH for gas (~0.001 ETH)
• This is a ONE-TIME action per wallet

Safety Default: Registration defaults to Sepolia testnet to prevent accidental mainnet transactions. Use --network mainnet explicitly for production.

Network Defaults

Command	Default Network	Reason
verify	Mainnet	Production reputation data
reputation	Mainnet	Production reputation data
whoami	Mainnet	Check production identity
register	Sepolia	Safety - avoid accidental mainnet txs

Override with --network mainnet or --network sepolia:

/chaoschain verify 450 --network sepolia
/chaoschain register --network mainnet

Setup

Read-Only Mode (Default)

No setup required! Just use /chaoschain verify and /chaoschain reputation.

With Your Own Wallet (Optional)

To use /chaoschain whoami or /chaoschain register, add to your OpenClaw config:

{
  "skills": {
    "entries": {
      "chaoschain": {
        "enabled": true,
        "env": {
          "CHAOSCHAIN_ADDRESS": "0xYourAddress...",
          "CHAOSCHAIN_NETWORK": "mainnet"
        }
      }
    }
  }
}

For registration (on-chain action):

{
  "skills": {
    "entries": {
      "chaoschain": {
        "enabled": true,
        "env": {
          "CHAOSCHAIN_PRIVATE_KEY": "0x...",
          "CHAOSCHAIN_NETWORK": "mainnet"
        }
      }
    }
  }
}

Network Options

• mainnet - Ethereum Mainnet (production ERC-8004)
• sepolia - Ethereum Sepolia (testnet)

Example Usage

Before trusting an agent to help with a task:

User: /chaoschain verify 550

Agent: ⛓️ Agent #550 Verification
       ━━━━━━━━━━━━━━━━━━━━━━━━━━
       ✅ REGISTERED on ERC-8004
       
       Name: DataAnalyzer
       Domain: analyzer.ai
       Owner: 0x2A47...8B8
       
       Trust Summary: 87/100 (HIGH)
       Total Feedback: 23 reviews
       
       This agent has verified on-chain identity.

Check detailed reputation:

User: /chaoschain reputation 550

Agent: ⛓️ Agent #550 Reputation
       ━━━━━━━━━━━━━━━━━━━━━━━━━━
       
       Initiative:    ████████░░ 81/100
       Collaboration: █████████░ 89/100
       Reasoning:     █████████░ 88/100
       Compliance:    ████████░░ 84/100
       Efficiency:    █████████░ 93/100
       
       Overall: 87/100 (HIGH TRUST)
       Based on 23 on-chain feedback entries.

What is ERC-8004?

ERC-8004 is the Ethereum standard for Trustless Agents. It provides:

• IdentityRegistry - On-chain agent registration (NFT-based)
• ReputationRegistry - Feedback and reputation scores
• ValidationRegistry - Independent validation records

ChaosChain is a reference implementation of ERC-8004.

Contract Addresses

Network	Registry	Address
Mainnet	Identity	0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
Mainnet	Reputation	0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
Sepolia	Identity	0x8004A818BFB912233c491871b3d84c89A494BD9e
Sepolia	Reputation	0x8004B663056A597Dffe9eCcC1965A193B7388713

Learn More

• ChaosChain Documentation
• ERC-8004 Specification
• 8004scan.io - Agent Explorer
• GitHub

Security Notes

• This skill is READ-ONLY by default
• /chaoschain register is the ONLY command that writes on-chain
• Private keys are only used for registration, never for viewing
• No funds are transferred, only gas for registration
• Source code: {baseDir}/scripts/

ChaosChain OpenClaw Skill

Trust & Reputation Verification for AI Agents

This OpenClaw skill provides READ-ONLY access to ERC-8004 on-chain registries, allowing you to verify agent identities and check reputation scores before trusting other agents.

What This Is

✅ Trust Visualization Tool - See on-chain reputation scores
✅ Agent Verification - Check if an agent is registered on ERC-8004
✅ READ-ONLY by Default - No transactions, no custody, no risk

What This Is NOT

❌ This is NOT a workflow execution tool
❌ This does NOT submit work or scores
❌ This does NOT handle payments
❌ This does NOT run background processes
❌ This does NOT interact with ChaosChain Gateway

Installation

From ClawHub (Recommended)

clawhub install chaoschain

Manual Installation

Copy the chaoschain/ folder to your OpenClaw skills directory:

cp -r chaoschain ~/.openclaw/skills/

Or to your workspace:

cp -r chaoschain ~/your-workspace/skills/

Commands

Command	Description	Requires Wallet?	Default Network
/chaoschain verify <id>	Check if agent is registered	No	Mainnet
/chaoschain reputation <id>	View reputation scores	No	Mainnet
/chaoschain whoami	Check your identity	Address only	Mainnet
/chaoschain register	Register on ERC-8004	Yes (on-chain tx)	Sepolia

Network Flag

All commands support --network mainnet or --network sepolia:

/chaoschain verify 450 --network sepolia
/chaoschain register --network mainnet  # Advanced users only

Safety Default: Registration defaults to Sepolia to prevent accidental mainnet transactions.

Usage Examples

Verify an Agent

/chaoschain verify 450

Output:

⛓️ Verifying agent: 450
   Network: MAINNET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ REGISTERED on ERC-8004

Agent ID: #450
Owner: 0x1234...abcd
Name: DataAnalyzer
Description: AI data analysis agent...

Trust Score: 87/100 (✅ HIGH TRUST)
Total Feedback: 23 reviews

🔗 https://8004scan.io/agents/mainnet/450

Check Reputation

/chaoschain reputation 450

Output:

⛓️ Agent #450 Reputation
   Network: MAINNET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Initiative     ████████░░  81/100
Collaboration  █████████░  89/100
Reasoning      █████████░  88/100
Compliance     ████████░░  84/100
Efficiency     █████████░  93/100

Overall: 87/100 (✅ HIGH TRUST)
Based on 23 on-chain feedback entries.

🔗 https://8004scan.io/agents/mainnet/450

Configuration

Read-Only Mode (Default)

No configuration needed. Just use the skill.

With Your Wallet (Optional)

Add to ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "chaoschain": {
        "enabled": true,
        "env": {
          "CHAOSCHAIN_ADDRESS": "0xYourAddress...",
          "CHAOSCHAIN_NETWORK": "mainnet"
        }
      }
    }
  }
}

For Registration (On-Chain Action)

⚠️ Warning: This enables on-chain transactions.

{
  "skills": {
    "entries": {
      "chaoschain": {
        "enabled": true,
        "env": {
          "CHAOSCHAIN_PRIVATE_KEY": "0x...",
          "CHAOSCHAIN_NETWORK": "mainnet"
        }
      }
    }
  }
}

Environment Variables

Variable	Description	Required
CHAOSCHAIN_NETWORK	mainnet or sepolia	No (default: mainnet)
CHAOSCHAIN_ADDRESS	Your wallet address	For /whoami
CHAOSCHAIN_PRIVATE_KEY	Your private key	For /register
CHAOSCHAIN_RPC_URL	Custom RPC endpoint	No

Network Support

Network	Identity Registry	Reputation Registry
Ethereum Mainnet	0x8004A169FB4a3325136EB29fA0ceB6D2e539a432	0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
Ethereum Sepolia	0x8004A818BFB912233c491871b3d84c89A494BD9e	0x8004B663056A597Dffe9eCcC1965A193B7388713

Security

• READ-ONLY by default - No transactions without explicit action
• No custody - Private keys are only used for /register
• No background processes - Only runs when you invoke a command
• Open source - Full source code in scripts/chaoschain_skill.py

Dependencies

• Python 3.8+
• web3.py (pip install web3)

What is ERC-8004?

ERC-8004 is the Ethereum standard for Trustless Agents:

• IdentityRegistry - On-chain agent registration (NFT-based)
• ReputationRegistry - Feedback and reputation scores
• ValidationRegistry - Independent validation records

What is ChaosChain?

ChaosChain is the accountability layer for AI agents. It provides:

• Multi-agent collaboration with fair attribution
• Consensus-based reputation from independent verifiers
• On-chain proof of work quality
• ERC-8004 compliant identity and reputation

Learn more: https://chaoscha.in

Links

• ChaosChain Documentation
• ERC-8004 Specification
• 8004scan.io - Agent Explorer
• GitHub

License

MIT License - See LICENSE