ERC-8004 Registration Skill

Register, update, validate, and fix agents on-chain via the ERC-8004 Identity Registry.

Use This When...

• "Register my agent on-chain"
• "I need to create a new ERC-8004 agent"
• "Update my agent's metadata"
• "Check if my agent registration is valid"
• "Fix my agent's registration issues"
• "Show my agent's on-chain info"
• "What agents do I own?"
• "Health check my agents"

Commands

register

Register a new agent on-chain.

python scripts/register.py register --name "AgentName" --description "Description" [--image URL] [--chain base]

Options:

• --name (required): Agent name
• --description (required): Agent description
• --image: Image URL (must be https://)
• --chain: Blockchain (base, ethereum, polygon, monad, bnb). Default: base

update

Update an existing agent's metadata.

python scripts/register.py update <agentId> [--name NAME] [--description DESC] [--image URL] [--add-service name=X,endpoint=Y] [--remove-service NAME] [--chain base]

info

Display agent information.

python scripts/register.py info <agentId> [--chain base]

validate

Check registration for common issues.

python scripts/register.py validate <agentId> [--chain base]

Checks:

• Missing type field
• Local-path images (/home/..., ./, file://)
• Empty name/description
• Missing registrations array
• Unreachable image URLs

fix

Auto-fix common registration issues.

python scripts/register.py fix <agentId> [--chain base] [--dry-run]

Auto-fixes:

• Missing type field
• Missing registrations array
• Local-path images (removes them)

Use --dry-run to preview changes without applying.

self-check

Check all agents owned by your wallet.

python scripts/register.py self-check

Queries Agentscan for your agents, validates each, and prints a health report.

Cross-Skill Workflows

Post-Registration Flow

# 1. Register new agent
python scripts/register.py register --name "MyBot" --description "Trading assistant"

# 2. Validate the registration
python scripts/register.py validate 42 --chain base

# 3. Check initial reputation (from erc8004-reputation skill)
python scripts/reputation.py lookup 42 --chain base

# 4. Monitor for discovery (from erc8004-discover skill)
python scripts/discover.py info 42

Periodic Health Check

# Run self-check to validate all your agents
python scripts/register.py self-check

# Fix any issues found
python scripts/register.py fix 42 --chain base

Heartbeat Integration

For automated monitoring, run self-check periodically:

# Cron: check health every hour
0 * * * * cd /path/to/skill && python scripts/register.py self-check >> /var/log/agent-health.log 2>&1

# Or in a script:
#!/bin/bash
python scripts/register.py self-check
if [ $? -ne 0 ]; then
    echo "Agent health check failed!" | notify-send
fi

Wallet Configuration

Set one of these environment variables:

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

Contract

Identity Registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (same on all chains)

Supported Chains

Dependencies

pip install web3 eth-account

Related Skills

• erc8004-discover: Find and monitor agents
• erc8004-reputation: Rate agents and check trust scores