@aixyz/cli 0.7.0 → 0.9.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,8 @@
 import { program } from "commander";
 import { build } from "./build";
 import { dev } from "./dev";
+import { register } from "./register/register";
+import { update } from "./register/update";
 import pkg from "./package.json";
 
 function handleAction(
@@ -11,6 +13,9 @@ function handleAction(
     try {
       await action(options);
     } catch (error) {
+      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 +65,136 @@ Examples:
   )
   .action(handleAction(build));
 
+const erc8004 = program.command("erc-8004").description("ERC-8004 IdentityRegistry operations");
+
+erc8004
+  .command("register")
+  .description("Register a new agent to the ERC-8004 IdentityRegistry")
+  .option("--url <url>", "Agent deployment URL (e.g., https://my-agent.example.com)")
+  .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:
+  --url <url>
+      Agent deployment URL (e.g., https://my-agent.example.com).
+      The registration URI will be derived as <url>/_aixyz/erc-8004.json.
+      If omitted, you will be prompted to enter the URL interactively.
+
+  --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.
+
+  --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.
+
+  --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.).
+
+  --broadcast
+      Sign and broadcast the transaction on-chain. Without this flag the
+      command performs a dry-run.
+
+  --out-dir <path>
+      Directory to write the deployment result as a JSON file.
+
+Behavior:
+  If app/erc-8004.ts does not exist, you will be prompted to create it
+  (selecting supported trust mechanisms). After a successful on-chain
+  registration, the new registration entry is written back to app/erc-8004.ts.
+
+Environment Variables:
+  PRIVATE_KEY    Private key (hex, with or without 0x prefix) used for signing.
+
+Examples:
+  # Dry-run (default)
+  $ aixyz erc-8004 register --url "https://my-agent.example.com" --chain sepolia
+
+  # Sign and broadcast
+  $ aixyz erc-8004 register --url "https://my-agent.example.com" --chain sepolia --keystore ~/.foundry/keystores/default --broadcast
+  $ aixyz erc-8004 register --url "https://my-agent.example.com" --chain sepolia --browser --broadcast`,
+  )
+  .action(handleAction(register));
+
+erc8004
+  .command("update")
+  .description("Update the metadata URI of a registered agent")
+  .option("--url <url>", "New agent deployment URL (e.g., https://my-agent.example.com)")
+  .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:
+  --url <url>
+      New agent deployment URL (e.g., https://my-agent.example.com).
+      The URI will be derived as <url>/_aixyz/erc-8004.json.
+      If omitted, you will be prompted to enter the URL interactively.
+
+  --rpc-url <url>
+      Custom RPC endpoint URL. Overrides the default RPC for the selected
+      chain. Cannot be used with --browser.
+
+  --registry <address>
+      Contract address of the ERC-8004 IdentityRegistry. Only required for
+      localhost, where there is no default deployment.
+
+  --keystore <path>
+      Path to an Ethereum keystore (V3) JSON file.
+
+  --browser
+      Opens a local page in your default browser for signing with any
+      EIP-6963 compatible wallet extension (MetaMask, Rabby, etc.).
+
+  --broadcast
+      Sign and broadcast the transaction on-chain. Without this flag the
+      command performs a dry-run.
+
+  --out-dir <path>
+      Directory to write the result as a JSON file.
+
+Behavior:
+  Reads existing registrations from app/erc-8004.ts. If there is one
+  registration, confirms it. If multiple, prompts you to select which
+  one to update. The chain and registry address are derived from the
+  selected registration's agentRegistry field.
+
+Environment Variables:
+  PRIVATE_KEY    Private key (hex, with or without 0x prefix) used for signing.
+
+Examples:
+  # Dry-run (default)
+  $ aixyz erc-8004 update --url "https://new-domain.example.com"
+
+  # Sign and broadcast
+  $ aixyz erc-8004 update --url "https://new-domain.example.com" --keystore ~/.foundry/keystores/default --broadcast
+  $ aixyz erc-8004 update --url "https://new-domain.example.com" --browser --broadcast`,
+  )
+  .action(handleAction(update));
+
 program.parse();

package/build/AixyzConfigPlugin.ts

@@ -37,7 +37,7 @@ export function AixyzConfigPlugin(): BunPlugin {
   return {
     name: "aixyz-config",
     setup(build) {
-      build.onLoad({ filter: /aixyz\/config\.ts$/ }, () => ({
+      build.onLoad({ filter: /aixyz[-/]config\/index\.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,12 +122,35 @@ 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();");
   }
 
+  // If app/erc-8004.ts exists, auto-register ERC-8004 endpoint
+  const hasErc8004 = existsSync(resolve(appDir, "erc-8004.ts"));
+  if (hasErc8004) {
+    imports.push('import { useERC8004 } from "aixyz/server/adapters/erc-8004";');
+    imports.push(`import * as erc8004 from "${importPrefix}/erc-8004";`);
+    body.push(
+      `useERC8004(server, { default: erc8004.default, options: { mcp: ${tools.length > 0}, a2a: ${hasAgent} } });`,
+    );
+  }
+
   body.push("export default server;");
 
   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/index.ts

@@ -77,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("");

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.7.0",
+  "version": "0.9.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,15 +23,20 @@
   "files": [
     "build",
     "dev",
+    "register",
     "bin.ts"
   ],
   "dependencies": {
-    "@aixyz/config": "0.7.0",
+    "@aixyz/config": "0.9.0",
+    "@aixyz/erc-8004": "0.9.0",
+    "@inquirer/prompts": "^8.3.0",
     "@next/env": "^16.1.6",
-    "boxen": "^8.0.0",
-    "chalk": "^5.0.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
     "commander": "^14.0.3",
-    "sharp": "^0.34.5"
+    "ethers": "^6.16.0",
+    "sharp": "^0.34.5",
+    "viem": "^2.46.3"
   },
   "engines": {
     "bun": ">=1.3.0"

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,66 @@
+import { describe, expect, test } from "bun:test";
+import { CHAIN_ID, getIdentityRegistryAddress } from "@aixyz/erc-8004";
+
+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();
+  });
+});

package/register/register.ts

@@ -0,0 +1,204 @@
+import { encodeFunctionData, formatEther, parseEventLogs, type Chain, type Log } from "viem";
+import { IdentityRegistryAbi } from "@aixyz/erc-8004";
+import { selectWalletMethod, type WalletOptions } from "./wallet";
+import { signTransaction } from "./wallet/sign";
+import {
+  resolveChainConfig,
+  selectChain,
+  resolveRegistryAddress,
+  validateBrowserRpcConflict,
+  getExplorerUrl,
+} from "./utils/chain";
+import { writeResultJson } from "./utils/result";
+import { label, truncateUri, broadcastAndConfirm, logSignResult } from "./utils/transaction";
+import { promptAgentUrl, promptSupportedTrust, deriveAgentUri } from "./utils/prompt";
+import { hasErc8004File, createErc8004File, writeRegistrationEntry } from "./utils/erc8004-file";
+import { confirm } from "@inquirer/prompts";
+import chalk from "chalk";
+import boxen from "boxen";
+import type { BaseOptions } from "./index";
+
+export interface RegisterOptions extends BaseOptions {
+  url?: string;
+  chain?: string;
+}
+
+export async function register(options: RegisterOptions): Promise<void> {
+  // Step 1: Ensure app/erc-8004.ts exists
+  if (!hasErc8004File()) {
+    console.log(chalk.yellow("No app/erc-8004.ts found. Let's create one."));
+    console.log("");
+    const supportedTrust = await promptSupportedTrust();
+    createErc8004File(supportedTrust);
+    console.log(chalk.green("Created app/erc-8004.ts"));
+    console.log("");
+  }
+
+  // Step 2: Get agent URL and derive URI
+  const agentUrl = options.url ?? (await promptAgentUrl());
+  const resolvedUri = deriveAgentUri(agentUrl);
+
+  const yes = await confirm({
+    message: `Will register URI as: ${chalk.cyan(resolvedUri)} — confirm?`,
+    default: true,
+  });
+  if (!yes) {
+    throw new Error("Aborted.");
+  }
+
+  // Step 3: Select chain
+  const chainName = options.chain ?? (await selectChain());
+  const chainConfig = resolveChainConfig(chainName);
+  const registryAddress = resolveRegistryAddress(chainName, chainConfig.chainId, options.registry);
+
+  // Step 4: Encode transaction
+  const data = encodeFunctionData({
+    abi: IdentityRegistryAbi,
+    functionName: "register",
+    args: [resolvedUri],
+  });
+
+  const printTxDetails = (header: string) => {
+    console.log("");
+    console.log(chalk.dim(header));
+    console.log(`  ${label("To")}${registryAddress}`);
+    console.log(`  ${label("Data")}${data.slice(0, 10)}${chalk.dim("\u2026" + (data.length - 2) / 2 + " bytes")}`);
+    console.log(`  ${label("Chain")}${chainName}`);
+    console.log(`  ${label("Function")}register(string memory agentURI)`);
+    console.log(`  ${label("URI")}${truncateUri(resolvedUri)}`);
+    console.log("");
+  };
+
+  validateBrowserRpcConflict(options.browser, options.rpcUrl);
+
+  if (!options.broadcast) {
+    if (options.browser || options.keystore || process.env.PRIVATE_KEY) {
+      console.warn("Note: --browser/--keystore/PRIVATE_KEY ignored in dry-run mode. Pass --broadcast to use a wallet.");
+    }
+    printTxDetails("Transaction details (dry-run)");
+    console.log("Dry-run complete. To sign and broadcast, re-run with --broadcast.");
+    return;
+  }
+
+  const walletMethod = await selectWalletMethod(options);
+  validateBrowserRpcConflict(walletMethod.type === "browser" || undefined, options.rpcUrl);
+
+  printTxDetails("Signing transaction...");
+
+  const result = await signTransaction({
+    walletMethod,
+    tx: { to: registryAddress, data },
+    chain: chainConfig.chain,
+    rpcUrl: options.rpcUrl,
+    options: {
+      browser: { chainId: chainConfig.chainId, chainName, uri: resolvedUri, mode: "register" },
+    },
+  });
+  logSignResult(walletMethod.type, result);
+
+  const { hash, receipt, timestamp } = await broadcastAndConfirm({
+    result,
+    chain: chainConfig.chain,
+    rpcUrl: options.rpcUrl,
+  });
+
+  const resultData = printResult(receipt, timestamp, chainConfig.chain, chainConfig.chainId, hash);
+
+  // Step 5: Write registration entry back to app/erc-8004.ts
+  if (resultData.agentId !== undefined) {
+    const agentRegistry = `eip155:${chainConfig.chainId}:${registryAddress}`;
+    writeRegistrationEntry({ agentId: Number(resultData.agentId), agentRegistry });
+    console.log("");
+    console.log(chalk.green(`Updated app/erc-8004.ts with registration (agentId: ${resultData.agentId})`));
+  }
+
+  if (options.outDir) {
+    writeResultJson(options.outDir, "registration", resultData);
+  }
+}
+
+interface RegistrationResult {
+  agentId?: string;
+  owner?: string;
+  uri?: string;
+  chainId: number;
+  block: string;
+  timestamp: string;
+  gasPaid: string;
+  nativeCurrency: string;
+  txHash: string;
+  explorer?: string;
+  metadata?: Record<string, string>;
+}
+
+function printResult(
+  receipt: { blockNumber: bigint; gasUsed: bigint; effectiveGasPrice: bigint; logs: Log[] },
+  timestamp: bigint,
+  chain: Chain,
+  chainId: number,
+  hash: `0x${string}`,
+): RegistrationResult {
+  const events = parseEventLogs({ abi: IdentityRegistryAbi, logs: receipt.logs });
+  const registered = events.find((e) => e.eventName === "Registered");
+  const metadataEvents = events.filter((e) => e.eventName === "MetadataSet");
+
+  const lines: string[] = [];
+  const result: RegistrationResult = {
+    chainId,
+    block: receipt.blockNumber.toString(),
+    timestamp: new Date(Number(timestamp) * 1000).toUTCString(),
+    gasPaid: formatEther(receipt.gasUsed * receipt.effectiveGasPrice),
+    nativeCurrency: chain.nativeCurrency?.symbol ?? "ETH",
+    txHash: hash,
+  };
+
+  if (registered) {
+    const { agentId, agentURI, owner } = registered.args as { agentId: bigint; agentURI: string; owner: string };
+    result.agentId = agentId.toString();
+    result.owner = owner;
+    if (agentURI) result.uri = agentURI;
+
+    lines.push(`${label("Agent ID")}${chalk.bold(result.agentId)}`);
+    lines.push(`${label("Owner")}${owner}`);
+    if (agentURI) {
+      lines.push(`${label("URI")}${truncateUri(agentURI)}`);
+    }
+    lines.push(`${label("Block")}${receipt.blockNumber}`);
+  } else {
+    lines.push(`${label("Block")}${receipt.blockNumber}`);
+  }
+
+  lines.push(`${label("Timestamp")}${result.timestamp}`);
+  lines.push(`${label("Gas Paid")}${result.gasPaid} ${result.nativeCurrency}`);
+  lines.push(`${label("Tx Hash")}${hash}`);
+
+  const explorerUrl = getExplorerUrl(chain, hash);
+  if (explorerUrl) {
+    result.explorer = explorerUrl;
+    lines.push(`${label("Explorer")}${chalk.cyan(explorerUrl)}`);
+  }
+
+  if (metadataEvents.length > 0) {
+    result.metadata = {};
+    lines.push("");
+    lines.push(chalk.dim("Metadata"));
+    for (const event of metadataEvents) {
+      const { metadataKey, metadataValue } = event.args as { metadataKey: string; metadataValue: string };
+      result.metadata[metadataKey] = metadataValue;
+      lines.push(`${label(metadataKey)}${metadataValue}`);
+    }
+  }
+
+  console.log("");
+  console.log(
+    boxen(lines.join("\n"), {
+      padding: { left: 1, right: 1, top: 0, bottom: 0 },
+      borderStyle: "round",
+      borderColor: "green",
+      title: "Agent registered successfully",
+      titleAlignment: "left",
+    }),
+  );
+
+  return result;
+}

package/register/update.test.ts

@@ -0,0 +1,47 @@
+import { describe, expect, test } from "bun:test";
+import { CHAIN_ID, getIdentityRegistryAddress } from "@aixyz/erc-8004";
+import { deriveAgentUri } from "./utils/prompt";
+
+describe("update 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("deriveAgentUri", () => {
+  test("appends /_aixyz/erc-8004.json to base URL", () => {
+    expect(deriveAgentUri("https://my-agent.example.com")).toBe("https://my-agent.example.com/_aixyz/erc-8004.json");
+  });
+
+  test("strips trailing slash before appending", () => {
+    expect(deriveAgentUri("https://my-agent.example.com/")).toBe("https://my-agent.example.com/_aixyz/erc-8004.json");
+  });
+
+  test("strips multiple trailing slashes", () => {
+    expect(deriveAgentUri("https://my-agent.example.com///")).toBe("https://my-agent.example.com/_aixyz/erc-8004.json");
+  });
+
+  test("preserves path segments", () => {
+    expect(deriveAgentUri("https://example.com/agents/my-agent")).toBe(
+      "https://example.com/agents/my-agent/_aixyz/erc-8004.json",
+    );
+  });
+});