✓ Verified 💻 Development ✓ Enhanced Data

Chaoschain

Verify AI agent identity and reputation via ERC-8004 on-chain registries.

Rating: 4.9 (485 reviews)
Downloads: 7,451 downloads
Version: 1.0.0

Overview

Verify AI agent identity and reputation via ERC-8004 on-chain registries.

Complete Documentation

View Source →

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`

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

text

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

Returns:

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

`/chaoschain reputation`

View detailed multi-dimensional reputation scores for an agent.

text

/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.

text

/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.

text

/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 :

text

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

Setup

After Installation (Required Once)

Run the setup script to install Python dependencies:

bash

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:

json

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

For registration (on-chain action):

json

{
  "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:

text

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:

text

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 (all supported mainnet chains)	Identity	0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
Mainnet (all supported mainnet chains)	Reputation	0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
Testnet (all supported testnet chains)	Identity	0x8004A818BFB912233c491871b3d84c89A494BD9e
Testnet (all supported testnet chains)	Reputation	0x8004B663056A597Dffe9eCcC1965A193B7388713

Learn More

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/

Installation

Terminal bash


openclaw install chaoschain

Copied!

💻Code Examples

/chaoschain verify 0x1234...abcd

chaoschain-verify-0x1234abcd.txt

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

chaoschain-reputation-450.txt

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

chaoschain-whoami.txt

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 --network mainnet # Advanced users only

chaoschain-register---network-mainnet--advanced-users-only.txt

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 <network_key>`:

/chaoschain register --network ethereum_mainnet

chaoschain-register---network-ethereummainnet.txt

## Setup

### After Installation (Required Once)

Run the setup script to install Python dependencies:

./scripts/setup.sh

scriptssetupsh.txt

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:

}

.txt

### 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:**

example.txt

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

example.json

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

example.json

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