ERC-8004 Reputation

# ERC-8004 Reputation Skill

Interact with the ERC-8004 Reputation Registry — the decentralized reputation layer for AI agents.

## Use This When...

- "Check an agent's reputation"
- "Rate this agent"
- "Give feedback to agent X"
- "What's my agent's reputation?"
- "Who gave feedback to my agent?"
- "Show me the reputation leaderboard"
- "Top agents by reputation"
- "Revoke my feedback"

## Commands

### lookup
Look up an agent's reputation summary.

```bash
python scripts/reputation.py lookup <agentId> [--chain CHAIN]
```

Shows: reviewer count, feedback count, summary value, individual feedback.

### give
Give feedback to an agent.

```bash
python scripts/reputation.py give <agentId> <value> [--decimals N] [--tag1 TAG] [--tag2 TAG] [--chain CHAIN]
```

**Examples:**
```bash
# Simple score (0-100)
python scripts/reputation.py give 16700 85 --tag1 reliable

# Percentage with decimals (99.77%)
python scripts/reputation.py give 16700 9977 --decimals 2 --tag1 uptime
```

### my-rep
Check your agent's reputation across all chains.

```bash
python scripts/reputation.py my-rep <agentId> [--chains base,ethereum,polygon]
```

### clients
List all addresses that gave feedback.

```bash
python scripts/reputation.py clients <agentId> [--chain CHAIN]
```

### feedback
Read a specific feedback entry.

```bash
python scripts/reputation.py feedback <agentId> <clientAddress> <feedbackIndex> [--chain CHAIN]
```

### revoke
Revoke feedback you previously gave.

```bash
python scripts/reputation.py revoke <agentId> <feedbackIndex> [--chain CHAIN]
```

### leaderboard
Show top agents by reputation score.

```bash
python scripts/reputation.py leaderboard [--chain CHAIN] [--limit 20]
```

Fetches from Agentscan API and displays top agents with scores and star ratings.

## Cross-Skill Workflows

### Post-Registration Reputation Building
```bash
# 1. Register your agent (from erc8004-register skill)
python scripts/register.py register --name "MyBot" --description "..."

# 2. Validate the...

# ERC-8004 Reputation Skill

An [OpenClaw](https://github.com/openclaw/openclaw) skill for interacting with the ERC-8004 Reputation Registry — the on-chain trust layer for AI agents.

## The Problem

Over 43,000 agents are registered on-chain via ERC-8004, but almost none have reputation scores. The contracts are deployed, but there was no easy tooling. This fixes that.

## Install

```bash
# Clone into your OpenClaw workspace
git clone https://github.com/aetherstacey/erc8004-reputation-skill.git skills/erc8004-reputation

# Install dependencies
pip install web3 eth-account
```

## Usage

Agent IDs are integers (e.g. 16700), not addresses.

```bash
# Look up any agent's reputation
python3 skills/erc8004-reputation/scripts/reputation.py lookup 23983 --chain ethereum

# Give feedback (needs funded wallet)
export ERC8004_PRIVATE_KEY="0x..."
python3 skills/erc8004-reputation/scripts/reputation.py give 16700 85 --tag1 reliable --tag2 fast

# Check your reputation across all chains
python3 skills/erc8004-reputation/scripts/reputation.py my-rep 16700

# List who rated an agent
python3 skills/erc8004-reputation/scripts/reputation.py clients 23983 --chain ethereum

# Read specific feedback
python3 skills/erc8004-reputation/scripts/reputation.py feedback 23983 0xF653...807e 1 --chain ethereum

# Revoke your feedback
python3 skills/erc8004-reputation/scripts/reputation.py revoke 16700 1
```

## Chains

Works on Base (default, cheapest), Ethereum, Polygon, Monad, and BNB. Same contract addresses on all chains:

- **Identity Registry**: `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432`
- **Reputation Registry**: `0x8004BAa17C55a88189AE136b182e5fdA19dE9b63`

## Feedback Values

The ERC-8004 feedback system uses `value` + `valueDecimals`:

| Example | value | --decimals | Meaning |
|---------|-------|-----------|---------|
| Score 85/100 | 85 | 0 | Simple rating |
| Uptime 99.77% | 9977 | 2 | Percentage |
| Response 560ms | 560 | 0 | Latency |

## ABI

The ABI in this tool is verified...