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

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/