Erc8004 Reputation

ERC-8004 Reputation Skill

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

Use This When...

Commands

lookup

python scripts/reputation.py lookup  [--chain CHAIN]

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

give

python scripts/reputation.py give   [--decimals N] [--tag1 TAG] [--tag2 TAG] [--chain CHAIN]

Examples:

# 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

python scripts/reputation.py my-rep  [--chains base,ethereum,polygon]

clients

python scripts/reputation.py clients  [--chain CHAIN]

feedback

python scripts/reputation.py feedback    [--chain CHAIN]

revoke

python scripts/reputation.py revoke   [--chain CHAIN]

leaderboard

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

# 1. Register your agent (from erc8004-register skill)
python scripts/register.py register --name "MyBot" --description "..."
2. Validate the registration
python scripts/register.py validate 42
3. Check initial reputation (should be empty)
python scripts/reputation.py lookup 42
4. After interacting with clients, check reputation growth
python scripts/reputation.py my-rep 42

Before Interacting with an Agent

# 1. Find the agent (from erc8004-discover skill)
python scripts/discover.py search "oracle"
2. Get detailed info
python scripts/discover.py info 0x1234...
3. Check their reputation
python scripts/reputation.py lookup 42 --chain base
4. If satisfied, interact and then give feedback
python scripts/reputation.py give 42 85 --tag1 reliable --tag2 accurate

Reputation Monitoring

# Check your reputation regularly
python scripts/reputation.py my-rep 42
See who's giving feedback
python scripts/reputation.py clients 42 --chain base
Read specific feedback
python scripts/reputation.py feedback 42 0xABC... 1 --chain base

Heartbeat Integration

Monitor reputation changes in automated pipelines:

# Cron: check reputation daily
0 9 * * * python scripts/reputation.py my-rep 42 >> /var/log/rep-monitor.log 2>&1
In a monitoring script:
#!/bin/bash
Get current feedback count
count=$(python scripts/reputation.py lookup 42 2>&1 | grep "Feedback count:" | awk '{print $3}')
last_count=$(cat /tmp/rep-count-42.txt 2>/dev/null || echo 0)
if [ "$count" != "$last_count" ]; then
    echo "New feedback received! Count: $count" | notify-send
    echo "$count" > /tmp/rep-count-42.txt
fi

Configuration

Wallet (required for write operations)

export ERC8004_MNEMONIC="your twelve word mnemonic phrase here"
OR
export ERC8004_PRIVATE_KEY="0xabc123..."

Read operations (lookup, my-rep, clients, feedback, leaderboard) don't need a wallet.

Supported Chains

| Chain | ID | Default | Gas Cost | |----------|------|---------|----------| | Base | 8453 | Yes | ~$0.001 | | Ethereum | 1 | | ~$1-10 | | Polygon | 137 | | ~$0.01 | | Monad | 143 | | ~$0.001 | | BNB | 56 | | ~$0.05 |

Base is recommended — cheapest gas by far.

Contract Addresses

Same on all chains:

Dependencies

pip install web3 eth-account

Related Skills

Wallet (required for write operations)

export ERC8004_MNEMONIC="your twelve word mnemonic phrase here"
OR
export ERC8004_PRIVATE_KEY="0xabc123..."

Read operations (lookup, my-rep, clients, feedback, leaderboard) don't need a wallet.

Supported Chains

| Chain | ID | Default | Gas Cost | |----------|------|---------|----------| | Base | 8453 | Yes | ~$0.001 | | Ethereum | 1 | | ~$1-10 | | Polygon | 137 | | ~$0.01 | | Monad | 143 | | ~$0.001 | | BNB | 56 | | ~$0.05 |

Base is recommended — cheapest gas by far.