basecred-8004-registration

# Basecred ERC-8004 Registration

Register AI agents on the [ERC-8004](https://8004.org) on-chain registry through a guided chat experience.

## Registration Flow

### Step 1: Auto-Prefill

When the user triggers registration, **auto-fill every field you can** from:
- Agent identity files (IDENTITY.md, SOUL.md, USER.md)
- Environment (`.env` — wallet address derived from private key)
- Previous context (A2A endpoint, description, image, etc.)
- Sensible defaults (version: 1.0.0, license: MIT, chain: Base, storage: onchain)

**Do NOT ask questions one by one.** Prefill first, ask later.

### Step 1.5: Explain Config Defaults

Before showing the draft, briefly explain the config so users understand what's pre-selected and what alternatives exist:

```
⚙️ Config defaults (you can change these later):

Chain:    Base (8453) — where your agent lives on-chain
          Others: Ethereum, Polygon, BNB, Arbitrum, Celo, Gnosis, Scroll

Storage:  Fully onchain — agent data stored directly on-chain
          Alternative: IPFS — data pinned to IPFS, hash stored on-chain

Trust:    Reputation — other agents/users rate your agent on-chain
          Others: Crypto-Economic (staking/slashing guarantees)
                  TEE Attestation (hardware-level trust proof)

x402:     Off — no payment protocol
          On: agent can charge for services via x402 payment protocol

Active:   On — agent is discoverable and accepting requests
          Off: registered but hidden from discovery

Wallet:   Your agent's on-chain identity address
          Two ways to set it:

          Option A: Paste your wallet address
          → Just paste your 0x... address
          → Agent will be linked to this address on-chain

          Option B: Add private key to .env (for signing)
          → Set PRIVATE_KEY=0x... in your .env file
          → Wallet auto-detected + can sign transactions
          → Enables setWallet() via EIP-712 after registration

          💡 Option A is easier. Option B is needed...

# basecred-8004-registration

Interactive ERC-8004 agent registration for [OpenClaw](https://openclaw.ai) agents. Register your AI agent on the [ERC-8004](https://8004.org) on-chain identity registry through a guided chat experience.

## Features

- 🗂️ **Auto-prefill** — fills from agent identity files, `.env`, and context
- 📋 **Full draft preview** — all fields with ✅/⚠️ status before submitting
- ✏️ **Inline section editing** — tap buttons to edit Basic Info, Endpoints, Skills, or Config
- 💬 **Instant button feedback** — immediate acknowledgment on every tap
- 🔘 **Multi-select toggles** — skills, domains, and trust models as toggleable buttons
- ⛓️ **Multi-chain** — Base (default), Ethereum, Polygon, BNB, Arbitrum, Celo, Gnosis, Scroll
- 💾 **Fully onchain** — default storage on-chain, no IPFS dependency
- 🔑 **Wallet flexibility** — paste an address or auto-detect from private key
- 🔐 **EIP-712 wallet linking** — sets agent wallet after registration
- 📄 **8004.org compatible** — imports/exports the standard 8004.org JSON template
- ⏳ **Progress updates** — step-by-step feedback during on-chain registration

## How It Works

1. **Auto-prefill** — agent fills every field it can from identity files and `.env`
2. **Config explainer** — explains defaults (chain, storage, trust, x402, wallet) with alternatives
3. **Draft + buttons** — shows full draft as single message with inline edit/register buttons
4. **Edit sections** — tap to edit any section, with back-to-draft navigation
5. **Register** — on confirmation, mints agent NFT, sets endpoints, links wallet
6. **Result** — shows Agent ID, TX hash, and link to 8004.org

## Quick Start

### 1. Install

```bash
bash scripts/setup.sh
```

### 2. Set Environment

Add to your `.env`:

```bash
# Required (one of these):
PRIVATE_KEY=0x...
# or
AGENT_PRIVATE_KEY=0x...
# or
MAIN_WALLET_PRIVATE_KEY=0x...

# Optional:
RPC_URL=https://mainnet.base.org
CHAIN_ID=8453
PINATA_JWT=...  # only needed for IPFS storage
```

### 3....