ERC-8004 Register

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

```bash
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.

```bash
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.

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

### validate
Check registration for common issues.

```bash
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.

```bash
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.

```bash
python scripts/register.py self-check
```

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

## Cross-Skill Workflows

### Post-Registration Flow
```bash
# 1. Register new agent
pytho...

# ERC-8004 Registration Tool

CLI tool for registering and managing agents on the ERC-8004 Identity Registry.

## Quick Start

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

# Set wallet (pick one)
export ERC8004_MNEMONIC="your twelve word mnemonic phrase here"
# OR
export ERC8004_PRIVATE_KEY="0x..."

# Register an agent
python scripts/register.py register --name "MyAgent" --description "AI assistant"

# View agent info
python scripts/register.py info 123

# Update metadata
python scripts/register.py update 123 --name "NewName" --image "https://example.com/avatar.png"

# Validate registration
python scripts/register.py validate 123
```

## Commands

| Command | Description |
|---------|-------------|
| `register` | Register a new agent (mints NFT + sets URI) |
| `update` | Update existing agent metadata |
| `info` | Display agent information |
| `validate` | Check registration for common issues |

## Registration Process

The `register` command performs two transactions:

1. **register()** - Mints the agent NFT and returns the agentId
2. **setAgentURI()** - Sets the full metadata including the agentId in the registrations array

This ensures the on-chain metadata correctly references itself.

## Supported Chains

- **Base** (default) - Cheapest gas fees
- **Ethereum** - Mainnet
- **Polygon** - Low fees
- **Monad** - Fast finality
- **BNB** - BSC

Use `--chain` flag to select: `--chain ethereum`

## Contract

Identity Registry: `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432`

Same address on all supported chains.

## Metadata Schema

Follows ERC-8004 registration-v1 specification:

```json
{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "AgentName",
  "description": "What the agent does",
  "image": "https://example.com/image.jpg",
  "services": [
    {"name": "api", "endpoint": "https://api.example.com"}
  ],
  "x402Support": false,
  "active": true,
  "registrations": [
    {"agentId": 123, "agentRegistry": "eip155:8453:0...