@aixyz/cli 0.6.0 → 0.8.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm](https://img.shields.io/npm/v/aixyz-cli)](https://www.npmjs.com/package/aixyz-cli)
 
-CLI for building and deploying [aixyz](https://ai-xyz.dev) agents.
+CLI for building and deploying [aixyz](https://aixyz.sh) agents.
 
 ## Quick Start
 

package/bin.ts

@@ -2,6 +2,9 @@
 import { program } from "commander";
 import { build } from "./build";
 import { dev } from "./dev";
+import { register } from "./register/register";
+import { setAgentUri } from "./register/set-agent-uri";
+import { CliError } from "./register/utils";
 import pkg from "./package.json";
 
 function handleAction(
@@ -11,6 +14,13 @@ function handleAction(
     try {
       await action(options);
     } catch (error) {
+      if (error instanceof CliError) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+      }
+      if (error instanceof Error && error.name === "ExitPromptError") {
+        process.exit(130);
+      }
       console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
       process.exit(1);
     }
@@ -60,4 +70,169 @@ Examples:
   )
   .action(handleAction(build));
 
+const erc8004 = program.command("erc8004").description("ERC-8004 IdentityRegistry operations");
+
+erc8004
+  .command("register")
+  .description("Register a new agent to the ERC-8004 IdentityRegistry")
+  .option("--uri <uri>", "Agent metadata URI or path to .json file (converts to base64 data URI)")
+  .option("--chain <chain>", "Target chain (mainnet, sepolia, base-sepolia, localhost)")
+  .option("--rpc-url <url>", "Custom RPC URL (uses default if not provided)")
+  .option("--registry <address>", "Contract address of the IdentityRegistry (required for localhost)")
+  .option("--keystore <path>", "Path to Ethereum keystore (V3) JSON file for local signing")
+  .option("--browser", "Use browser extension wallet (any extension)")
+  .option("--broadcast", "Sign and broadcast the transaction (default: dry-run)")
+  .option("--out-dir <path>", "Write deployment result as JSON to the given directory")
+  .addHelpText(
+    "after",
+    `
+Option Details:
+  --uri <uri>
+      Agent metadata as a URI or local file path. Accepts http://, https://,
+      ipfs://, and data: URIs directly.
+      If a .json file path is given, it is read and converted to a base64 data URI automatically.
+      Otherwise, the URI is used as-is and the validity of the URI is not checked.
+      If omitted, the agent is registered without metadata.
+
+  --chain <chain>
+      Target chain for registration. Supported values:
+        mainnet       Ethereum mainnet (chain ID 1)
+        sepolia       Ethereum Sepolia testnet (chain ID 11155111)
+        base-sepolia  Base Sepolia testnet (chain ID 84532)
+        localhost     Local Foundry/Anvil node (chain ID 31337)
+      If omitted, you will be prompted to select a chain interactively.
+      Each chain has a default RPC endpoint unless overridden with --rpc-url.
+
+  --rpc-url <url>
+      Custom RPC endpoint URL. Overrides the default RPC for the selected
+      chain. Cannot be used with --browser since the browser wallet manages
+      its own RPC connection.
+
+  --registry <address>
+      Contract address of the ERC-8004 IdentityRegistry. Only required for
+      localhost, where there is no default deployment. For mainnet, sepolia,
+      and base-sepolia the canonical registry address is used automatically.
+
+  --keystore <path>
+      Path to an Ethereum keystore (V3) JSON file. You will be prompted for
+      the keystore password to decrypt the private key for signing.
+
+  --browser
+      Opens a local page in your default browser for signing with any
+      EIP-6963 compatible wallet extension (MetaMask, Rabby, etc.).
+      The wallet handles both signing and broadcasting the transaction.
+      Cannot be combined with --rpc-url.
+
+  --broadcast
+      Sign and broadcast the transaction on-chain. Without this flag the
+      command performs a dry-run: it encodes the transaction and prints
+      its details but does not interact with any wallet or send anything
+      to the network.
+
+  --out-dir <path>
+      Directory to write the deployment result as a JSON file. The file
+      is named registration-<chainId>-<timestamp>.json.
+
+Environment Variables:
+  PRIVATE_KEY    Private key (hex, with or without 0x prefix) used for
+                 signing. Detected automatically if set. Not recommended
+                 for interactive use as the key may appear in shell history.
+
+Examples:
+  # Dry-run (default) — shows encoded transaction, no wallet needed
+  $ aixyz erc8004 register --uri "./metadata.json" --chain sepolia
+
+  # Sign and broadcast
+  $ aixyz erc8004 register --uri "./metadata.json" --chain sepolia --keystore ~/.foundry/keystores/default --broadcast
+  $ PRIVATE_KEY=0x... aixyz erc8004 register --chain sepolia --broadcast
+  $ aixyz erc8004 register --chain localhost --registry 0x5FbDB2315678afecb367f032d93F642f64180aa3 --uri "./metadata.json" --broadcast
+  $ aixyz erc8004 register --uri "./metadata.json" --chain sepolia --browser --broadcast`,
+  )
+  .action(handleAction(register));
+
+erc8004
+  .command("set-agent-uri")
+  .description("Update the metadata URI of a registered agent")
+  .option("--agent-id <id>", "Agent ID (token ID) to update")
+  .option("--uri <uri>", "New agent metadata URI or path to .json file")
+  .option("--chain <chain>", "Target chain (mainnet, sepolia, base-sepolia, localhost)")
+  .option("--rpc-url <url>", "Custom RPC URL (uses default if not provided)")
+  .option("--registry <address>", "Contract address of the IdentityRegistry (required for localhost)")
+  .option("--keystore <path>", "Path to Ethereum keystore (V3) JSON file for local signing")
+  .option("--browser", "Use browser extension wallet (any extension)")
+  .option("--broadcast", "Sign and broadcast the transaction (default: dry-run)")
+  .option("--out-dir <path>", "Write result as JSON to the given directory")
+  .addHelpText(
+    "after",
+    `
+Option Details:
+  --agent-id <id>
+      The token ID of the agent whose URI you want to update.
+      Must be a non-negative integer. Only the agent owner, an approved
+      address, or an operator can update the URI.
+      If omitted, you will be prompted to enter the agent ID interactively.
+
+  --uri <uri>
+      New agent metadata as a URI or local file path. Accepts http://, https://,
+      ipfs://, and data: URIs directly.
+      If a .json file path is given, it is read and converted to a base64 data URI automatically.
+      Otherwise, the URI is used as-is and the validity of the URI is not checked.
+      If omitted, you will be prompted to enter the URI interactively.
+
+  --chain <chain>
+      Target chain. Supported values:
+        mainnet       Ethereum mainnet (chain ID 1)
+        sepolia       Ethereum Sepolia testnet (chain ID 11155111)
+        base-sepolia  Base Sepolia testnet (chain ID 84532)
+        localhost     Local Foundry/Anvil node (chain ID 31337)
+      If omitted, you will be prompted to select a chain interactively.
+      Each chain has a default RPC endpoint unless overridden with --rpc-url.
+
+  --rpc-url <url>
+      Custom RPC endpoint URL. Overrides the default RPC for the selected
+      chain. Cannot be used with --browser since the browser wallet manages
+      its own RPC connection.
+
+  --registry <address>
+      Contract address of the ERC-8004 IdentityRegistry. Only required for
+      localhost, where there is no default deployment. For mainnet, sepolia,
+      and base-sepolia the canonical registry address is used automatically.
+
+  --keystore <path>
+      Path to an Ethereum keystore (V3) JSON file. You will be prompted for
+      the keystore password to decrypt the private key for signing.
+
+  --browser
+      Opens a local page in your default browser for signing with any
+      EIP-6963 compatible wallet extension (MetaMask, Rabby, etc.).
+      The wallet handles both signing and broadcasting the transaction.
+      Cannot be combined with --rpc-url.
+
+  --broadcast
+      Sign and broadcast the transaction on-chain. Without this flag the
+      command performs a dry-run: it encodes the transaction and prints
+      its details but does not interact with any wallet or send anything
+      to the network.
+
+  --out-dir <path>
+      Directory to write the result as a JSON file. The file
+      is named set-agent-uri-<chainId>-<timestamp>.json.
+
+Environment Variables:
+  PRIVATE_KEY    Private key (hex, with or without 0x prefix) used for
+                 signing. Detected automatically if set. Not recommended
+                 for interactive use as the key may appear in shell history.
+
+Examples:
+  # Dry-run (default) — shows encoded transaction, no wallet needed
+  $ aixyz erc8004 set-agent-uri --agent-id 1 --uri "./metadata.json" --chain sepolia
+
+  # Sign and broadcast
+  $ aixyz erc8004 set-agent-uri --agent-id 1 --uri "./metadata.json" --chain sepolia --keystore ~/.foundry/keystores/default --broadcast
+  $ PRIVATE_KEY=0x... aixyz erc8004 set-agent-uri --agent-id 42 --uri "https://example.com/agent.json" --chain sepolia --broadcast
+  $ aixyz erc8004 set-agent-uri --agent-id 1 --uri "./metadata.json" --chain localhost --registry 0x5FbDB2315678afecb367f032d93F642f64180aa3 --broadcast
+  $ aixyz erc8004 set-agent-uri --agent-id 1 --uri "./metadata.json" --chain sepolia --browser --broadcast`,
+  )
+  .action(handleAction(setAgentUri));
+
 program.parse();

package/build/AixyzConfigPlugin.ts

@@ -37,7 +37,7 @@ export function AixyzConfigPlugin(): BunPlugin {
   return {
     name: "aixyz-config",
     setup(build) {
-      build.onLoad({ filter: /packages\/aixyz\/config\.ts$/ }, () => ({
+      build.onLoad({ filter: /aixyz\/config\.ts$/ }, () => ({
         contents: `
         const config = ${JSON.stringify(materialized)};
         export function getAixyzConfig() {

package/build/AixyzServerPlugin.ts

@@ -1,6 +1,7 @@
 import type { BunPlugin } from "bun";
 import { existsSync, mkdirSync, readdirSync, writeFileSync } from "fs";
 import { resolve, relative, basename, join } from "path";
+import { getAixyzConfig } from "@aixyz/config";
 
 export function AixyzServerPlugin(entrypoint: string, mode: "vercel" | "standalone"): BunPlugin {
   return {
@@ -51,6 +52,17 @@ export function getEntrypointMayGenerate(cwd: string, mode: "dev" | "build"): st
   return entrypoint;
 }
 
+class AixyzGlob {
+  constructor(readonly config = getAixyzConfig()) {}
+
+  includes(file: string): boolean {
+    const included = this.config.build.includes.some((pattern) => new Bun.Glob(pattern).match(file));
+    if (!included) return false;
+    const excluded = this.config.build.excludes.some((pattern) => new Bun.Glob(pattern).match(file));
+    return !excluded;
+  }
+}
+
 /**
  * Generate server.ts content by scanning the app directory for agent.ts and tools/.
  *
@@ -58,6 +70,7 @@ export function getEntrypointMayGenerate(cwd: string, mode: "dev" | "build"): st
  * @param entrypointDir - Directory where the generated file will live (for computing relative imports).
  */
 function generateServer(appDir: string, entrypointDir: string): string {
+  const glob = new AixyzGlob();
   const rel = relative(entrypointDir, appDir);
   const importPrefix = rel === "" ? "." : rel.startsWith(".") ? rel : `./${rel}`;
 
@@ -73,22 +86,20 @@ function generateServer(appDir: string, entrypointDir: string): string {
     imports.push('import { facilitator } from "aixyz/accepts";');
   }
 
-  const hasAgent = existsSync(resolve(appDir, "agent.ts"));
+  const hasAgent = existsSync(resolve(appDir, "agent.ts")) && glob.includes("agent.ts");
   if (hasAgent) {
     imports.push('import { useA2A } from "aixyz/server/adapters/a2a";');
     imports.push(`import * as agent from "${importPrefix}/agent";`);
   }
 
   const toolsDir = resolve(appDir, "tools");
-  const tools: { name: string }[] = [];
+  const tools: { name: string; identifier: string }[] = [];
   if (existsSync(toolsDir)) {
     for (const file of readdirSync(toolsDir)) {
-      if (file.endsWith(".ts")) {
+      if (glob.includes(`tools/${file}`)) {
         const name = basename(file, ".ts");
-        // Skip tools starting with underscore
-        if (!name.startsWith("_")) {
-          tools.push({ name });
-        }
+        const identifier = toIdentifier(name);
+        tools.push({ name, identifier });
       }
     }
   }
@@ -96,7 +107,7 @@ function generateServer(appDir: string, entrypointDir: string): string {
   if (tools.length > 0) {
     imports.push('import { AixyzMCP } from "aixyz/server/adapters/mcp";');
     for (const tool of tools) {
-      imports.push(`import * as ${tool.name} from "${importPrefix}/tools/${tool.name}";`);
+      imports.push(`import * as ${tool.identifier} from "${importPrefix}/tools/${tool.name}";`);
     }
   }
 
@@ -111,7 +122,7 @@ function generateServer(appDir: string, entrypointDir: string): string {
   if (tools.length > 0) {
     body.push("const mcp = new AixyzMCP(server);");
     for (const tool of tools) {
-      body.push(`await mcp.register("${tool.name}", ${tool.name});`);
+      body.push(`await mcp.register("${tool.name}", ${tool.identifier});`);
     }
     body.push("await mcp.connect();");
   }
@@ -120,3 +131,16 @@ function generateServer(appDir: string, entrypointDir: string): string {
 
   return [...imports, "", ...body].join("\n");
 }
+
+/**
+ * Convert a kebab-case filename into a valid JS identifier.
+ *
+ * Examples:
+ *  "lookup"                    → "lookup"
+ *  "get-aggregator-v3-address" → "getAggregatorV3Address"
+ *  "3d-model"                  → "_3dModel"
+ */
+function toIdentifier(name: string): string {
+  const camel = name.replace(/-(.)/g, (_, c: string) => c.toUpperCase()).replace(/[^a-zA-Z0-9_$]/g, "_");
+  return /^\d/.test(camel) ? `_${camel}` : camel;
+}

package/build/icons.ts

@@ -0,0 +1,64 @@
+import sharp from "sharp";
+import { cpSync, existsSync, mkdirSync, writeFileSync } from "fs";
+import { dirname, resolve } from "path";
+
+/** Icon source file extensions to look for, in priority order */
+const ICON_EXTENSIONS = ["svg", "png", "jpeg", "jpg"] as const;
+
+/** Returns the first matching icon file path, or null if none found. */
+export function findIconFile(appDir: string): string | null {
+  for (const ext of ICON_EXTENSIONS) {
+    const iconPath = resolve(appDir, `icon.${ext}`);
+    if (existsSync(iconPath)) return iconPath;
+  }
+  return null;
+}
+
+/**
+ * Copy the icon to destPath as icon.png.
+ * PNG sources are copied directly; other formats are converted via sharp.
+ */
+export async function copyAgentIcon(iconPath: string, destPath: string): Promise<void> {
+  if (iconPath.endsWith(".png")) {
+    cpSync(iconPath, destPath);
+  } else {
+    await sharp(iconPath).png().toFile(destPath);
+  }
+}
+
+/**
+ * Generate a favicon.ico at destPath from the given icon source.
+ * Uses sharp to produce a 32×32 PNG buffer, then wraps it in an ICO container.
+ * Modern browsers support ICO files with embedded PNG data.
+ */
+export async function generateFavicon(iconPath: string, destPath: string): Promise<void> {
+  const pngData = await sharp(iconPath)
+    .resize(32, 32, { fit: "contain", background: { r: 0, g: 0, b: 0, alpha: 0 } })
+    .png()
+    .toBuffer();
+
+  mkdirSync(dirname(destPath), { recursive: true });
+  writeFileSync(destPath, buildIco(pngData, 32, 32));
+}
+
+/** Build a single-image ICO buffer with embedded PNG data. */
+function buildIco(pngData: Buffer, width: number, height: number): Buffer {
+  // ICONDIR header (6 bytes)
+  const header = Buffer.alloc(6);
+  header.writeUInt16LE(0, 0); // reserved
+  header.writeUInt16LE(1, 2); // type: 1 = ICO
+  header.writeUInt16LE(1, 4); // image count
+
+  // ICONDIRENTRY (16 bytes); image data starts at offset 6 + 16 = 22
+  const entry = Buffer.alloc(16);
+  entry.writeUInt8(width === 256 ? 0 : width, 0); // width  (0 means 256)
+  entry.writeUInt8(height === 256 ? 0 : height, 1); // height (0 means 256)
+  entry.writeUInt8(0, 2); // color count (0 = true color)
+  entry.writeUInt8(0, 3); // reserved
+  entry.writeUInt16LE(1, 4); // planes
+  entry.writeUInt16LE(32, 6); // bits per pixel
+  entry.writeUInt32LE(pngData.length, 8); // size of image data
+  entry.writeUInt32LE(22, 12); // offset to image data
+
+  return Buffer.concat([header, entry, pngData]);
+}

package/build/index.ts

@@ -2,6 +2,7 @@ import { resolve } from "path";
 import { existsSync, mkdirSync, cpSync, rmSync } from "fs";
 import { AixyzConfigPlugin } from "./AixyzConfigPlugin";
 import { AixyzServerPlugin, getEntrypointMayGenerate } from "./AixyzServerPlugin";
+import { findIconFile, copyAgentIcon, generateFavicon } from "./icons";
 import { getAixyzConfig } from "@aixyz/config";
 import { loadEnvConfig } from "@next/env";
 import chalk from "chalk";
@@ -65,9 +66,10 @@ async function buildBun(entrypoint: string): Promise<void> {
     console.log("Copied public/ →", destPublicDir);
   }
 
-  const iconFile = resolve(cwd, "app/icon.png");
-  if (existsSync(iconFile)) {
-    cpSync(iconFile, resolve(outputDir, "icon.png"));
+  const iconFile = findIconFile(resolve(cwd, "app"));
+  if (iconFile) {
+    await copyAgentIcon(iconFile, resolve(outputDir, "icon.png"));
+    await generateFavicon(iconFile, resolve(outputDir, "public/favicon.ico"));
   }
 
   // Log summary
@@ -75,7 +77,7 @@ async function buildBun(entrypoint: string): Promise<void> {
   console.log("Build complete! Output:");
   console.log("  .aixyz/output/server.js");
   console.log("  .aixyz/output/package.json");
-  if (existsSync(publicDir) || existsSync(iconFile)) {
+  if (existsSync(publicDir) || iconFile) {
     console.log("  .aixyz/output/public/ and assets");
   }
   console.log("");
@@ -151,11 +153,12 @@ async function buildVercel(entrypoint: string): Promise<void> {
     console.log("Copied public/ →", staticDir);
   }
 
-  const iconFile = resolve(cwd, "app/icon.png");
-  if (existsSync(iconFile)) {
+  const iconFile = findIconFile(resolve(cwd, "app"));
+  if (iconFile) {
     mkdirSync(staticDir, { recursive: true });
-    cpSync(iconFile, resolve(staticDir, "icon.png"));
-    console.log("Copied app/icon.png →", staticDir);
+    await copyAgentIcon(iconFile, resolve(staticDir, "icon.png"));
+    await generateFavicon(iconFile, resolve(staticDir, "favicon.ico"));
+    console.log("Copied app/icon →", staticDir);
   }
 
   // Log summary

package/dev/index.ts

@@ -15,7 +15,7 @@ export async function dev(options: { port?: string }): Promise<void> {
   const baseUrl = `http://localhost:${port}`;
 
   console.log("");
-  console.log(`⟡ ai-xyz.dev v${pkg.version}`);
+  console.log(`⟡ aixyz.sh v${pkg.version}`);
   console.log("");
   console.log(`- A2A:          ${baseUrl}/.well-known/agent-card.json`);
   console.log(`- MCP:          ${baseUrl}/mcp`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aixyz/cli",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Payment-native SDK for AI Agent",
   "keywords": [
     "ai",
@@ -8,7 +8,7 @@
     "agent",
     "aixyz"
   ],
-  "homepage": "https://ai-xyz.dev",
+  "homepage": "https://aixyz.sh",
   "bugs": "https://github.com/AgentlyHQ/aixyz/issues",
   "repository": {
     "type": "git",
@@ -23,14 +23,20 @@
   "files": [
     "build",
     "dev",
+    "register",
     "bin.ts"
   ],
   "dependencies": {
-    "@aixyz/config": "0.6.0",
+    "@aixyz/config": "0.8.0",
+    "@aixyz/erc-8004": "0.8.0",
+    "@inquirer/prompts": "^8.3.0",
     "@next/env": "^16.1.6",
-    "boxen": "^8.0.0",
-    "chalk": "^5.0.0",
-    "commander": "^14.0.3"
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "ethers": "^6.16.0",
+    "sharp": "^0.34.5",
+    "viem": "^2.46.3"
   },
   "engines": {
     "bun": ">=1.3.0"

package/register/README.md

@@ -0,0 +1,101 @@
+# ERC-8004 Registry Commands
+
+CLI commands for registering agents to the [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) IdentityRegistry.
+
+These commands are part of the `aixyz` CLI under the `erc8004` subcommand.
+
+## Usage
+
+### Register an Agent
+
+Register a new agent to the IdentityRegistry with multiple wallet options:
+
+#### Using Keystore (Recommended)
+
+Sign with an Ethereum keystore (V3) JSON file:
+
+```bash
+aixyz erc8004 register --uri "./metadata.json" --chain sepolia --keystore ~/.foundry/keystores/default --broadcast
+```
+
+#### Using Browser Wallet
+
+Opens a localhost page to sign with any browser extension wallet (MetaMask, Rabby, etc.) that are `EIP-6963` compliant:
+
+```bash
+aixyz erc8004 register --uri "ipfs://Qm..." --chain sepolia --browser --broadcast
+```
+
+> **Note:** `--rpc-url` cannot be used with `--browser`. The browser wallet uses its own RPC endpoint.
+
+#### Using Private Key Env (Not Recommended)
+
+For scripting and CI:
+
+```bash
+# Not recommended for interactive use
+PRIVATE_KEY=0x... aixyz erc8004 register --uri "ipfs://Qm..." --chain sepolia --broadcast
+```
+
+#### Interactive Mode
+
+If no wallet option is provided, you'll be prompted to choose:
+
+```bash
+aixyz erc8004 register --uri "ipfs://Qm..." --chain sepolia --broadcast
+```
+
+#### Local Development
+
+Register against a local Foundry/Anvil node:
+
+```bash
+aixyz erc8004 register \
+  --chain localhost \
+  --registry 0x5FbDB2315678afecb367f032d93F642f64180aa3 \
+  --rpc-url http://localhost:8545 \
+  --uri "./metadata.json" \
+  --keystore ~/.foundry/keystores/default \
+  --broadcast
+```
+
+### Set Agent URI
+
+Update the metadata URI of a registered agent:
+
+```bash
+aixyz erc8004 set-agent-uri \
+  --agent-id 1 \
+  --uri "https://my-agent.vercel.app/.well-known/agent-card.json" \
+  --chain sepolia \
+  --keystore ~/.foundry/keystores/default \
+  --broadcast
+```
+
+### Options
+
+| Option                 | Description                                                                          |
+| ---------------------- | ------------------------------------------------------------------------------------ |
+| `--uri <uri>`          | Agent metadata URI or path to `.json` file (converts to base64 data URI)             |
+| `--chain <chain>`      | Target chain: `mainnet`, `sepolia`, `base-sepolia`, `localhost` (default: `sepolia`) |
+| `--rpc-url <url>`      | Custom RPC URL (cannot be used with `--browser`)                                     |
+| `--registry <address>` | IdentityRegistry contract address (required for `localhost`)                         |
+| `--keystore <path>`    | Path to Ethereum keystore (V3) JSON file                                             |
+| `--browser`            | Use browser extension wallet                                                         |
+| `--broadcast`          | Sign and broadcast the transaction (default: dry-run)                                |
+| `--out-dir <path>`     | Write deployment result as JSON to the given directory                               |
+
+### Environment Variables
+
+| Variable      | Description                           |
+| ------------- | ------------------------------------- |
+| `PRIVATE_KEY` | Private key for signing (use caution) |
+
+### Supported Chains
+
+| Chain          | Chain ID | Network                  |
+| -------------- | -------- | ------------------------ |
+| `mainnet`      | 1        | Ethereum mainnet         |
+| `sepolia`      | 11155111 | Ethereum Sepolia testnet |
+| `base-sepolia` | 84532    | Base Sepolia testnet     |
+| `localhost`    | 31337    | Local Foundry/Anvil node |

package/register/index.ts

@@ -0,0 +1,8 @@
+import type { WalletOptions } from "./wallet";
+
+export interface BaseOptions extends WalletOptions {
+  chain?: string;
+  rpcUrl?: string;
+  registry?: string;
+  outDir?: string;
+}

package/register/register.test.ts

@@ -0,0 +1,75 @@
+import { describe, expect, test } from "bun:test";
+import { CHAIN_ID, getIdentityRegistryAddress } from "@aixyz/erc-8004";
+import { register } from "./register";
+
+describe("register command chain configuration", () => {
+  test("sepolia chain ID is correct", () => {
+    expect(CHAIN_ID.SEPOLIA).toStrictEqual(11155111);
+  });
+
+  test("base-sepolia chain ID is correct", () => {
+    expect(CHAIN_ID.BASE_SEPOLIA).toStrictEqual(84532);
+  });
+
+  test("identity registry address is returned for sepolia", () => {
+    const address = getIdentityRegistryAddress(CHAIN_ID.SEPOLIA);
+    expect(address).toMatch(/^0x[a-fA-F0-9]{40}$/);
+  });
+
+  test("identity registry address is returned for base-sepolia", () => {
+    const address = getIdentityRegistryAddress(CHAIN_ID.BASE_SEPOLIA);
+    expect(address).toMatch(/^0x[a-fA-F0-9]{40}$/);
+  });
+
+  test("throws for unsupported chain ID", () => {
+    expect(() => getIdentityRegistryAddress(999999)).toThrow("Unsupported chain ID");
+  });
+});
+
+describe("register command validation", () => {
+  test("supported chains list includes sepolia", () => {
+    const CHAINS: Record<string, { chainId: number }> = {
+      sepolia: { chainId: CHAIN_ID.SEPOLIA },
+      "base-sepolia": { chainId: CHAIN_ID.BASE_SEPOLIA },
+    };
+    expect(CHAINS["sepolia"]).toBeDefined();
+    expect(CHAINS["sepolia"].chainId).toStrictEqual(CHAIN_ID.SEPOLIA);
+  });
+
+  test("supported chains list includes base-sepolia", () => {
+    const CHAINS: Record<string, { chainId: number }> = {
+      sepolia: { chainId: CHAIN_ID.SEPOLIA },
+      "base-sepolia": { chainId: CHAIN_ID.BASE_SEPOLIA },
+      localhost: { chainId: 31337 },
+    };
+    expect(CHAINS["base-sepolia"]).toBeDefined();
+    expect(CHAINS["base-sepolia"].chainId).toStrictEqual(CHAIN_ID.BASE_SEPOLIA);
+  });
+
+  test("supported chains list includes localhost with chainId 31337", () => {
+    const CHAINS: Record<string, { chainId: number }> = {
+      sepolia: { chainId: CHAIN_ID.SEPOLIA },
+      "base-sepolia": { chainId: CHAIN_ID.BASE_SEPOLIA },
+      localhost: { chainId: 31337 },
+    };
+    expect(CHAINS["localhost"]).toBeDefined();
+    expect(CHAINS["localhost"].chainId).toStrictEqual(31337);
+  });
+
+  test("unsupported chain is not in list", () => {
+    const CHAINS: Record<string, { chainId: number }> = {
+      sepolia: { chainId: CHAIN_ID.SEPOLIA },
+      "base-sepolia": { chainId: CHAIN_ID.BASE_SEPOLIA },
+      localhost: { chainId: 31337 },
+    };
+    expect(CHAINS["mainnet"]).toBeUndefined();
+  });
+
+  test("localhost requires --registry flag", async () => {
+    await expect(register({ chain: "localhost" })).rejects.toThrow("--registry is required for localhost");
+  });
+
+  test("dry-run completes without wallet interaction when --broadcast is not set", async () => {
+    await expect(register({ chain: "sepolia", uri: "https://example.com/agent.json" })).resolves.toBeUndefined();
+  });
+});