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 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 ```bash # 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: ```bash # 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: ```bash 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 | Chain | ID | Explorer | |----------|------|----------------------| | Base | 8453 | basescan.org | | Ethereum | 1 | etherscan.io | | Polygon | 137 | polygonscan.com | | Monad | 143 | explorer.monad.xyz | | BNB | 56 | bscscan.com | ## Dependencies ```bash pip install web3 eth-account ``` ## Related Skills - **erc8004-discover**: Find and monitor agents - **erc8004-reputation**: Rate agents and check trust scores