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

Override with --network <network_key>:

/chaoschain verify 450 --network base_mainnet
/chaoschain register --network ethereum_mainnet

Setup

After Installation (Required Once)

Run the setup script to install Python dependencies:

cd ~/.openclaw/skills/chaoschain
./scripts/setup.sh

This creates a virtual environment with web3 and other dependencies.

Read-Only Mode (Default)

No setup required after running setup.sh! 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 keys (same official ERC-8004 registries):

• ethereum_mainnet

• base_mainnet

• polygon_mainnet

• arbitrum_mainnet

• celo_mainnet

• gnosis_mainnet

• scroll_mainnet

• taiko_mainnet

• monad_mainnet

• bsc_mainnet

Testnet keys (same official ERC-8004 registries):

• ethereum_sepolia

• base_sepolia

• polygon_amoy

• arbitrum_testnet

• celo_testnet

• scroll_testnet

• monad_testnet

• bsc_testnet

• optimism_sepolia

• linea_sepolia

• mode_testnet

Backward-compatible aliases:

• mainnet -> ethereum_mainnet

• sepolia -> ethereum_sepolia

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

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/