@elizaos/agent 0.25.8 → 2.0.0-alpha.83

package/packages/agent/src/api/registry-service.js

@@ -0,0 +1,190 @@
+/**
+ * ERC-8004 Agent Identity Registry service.
+ *
+ * Handles all interactions with the ElizaAgentRegistry contract:
+ * - Registration (self and delegated)
+ * - Profile updates
+ * - Metadata (tokenURI) management
+ * - Status queries
+ */
+import { logger } from "@elizaos/core";
+import { ethers } from "ethers";
+// ── ABI ──────────────────────────────────────────────────────────────────
+// Matches ElizaAgentRegistry.sol. Babylon-compatible core interface plus
+// registerAgentFor() and ERC721URIStorage tokenURI.
+const REGISTRY_ABI = [
+    // Registration
+    "function registerAgent(string,string,bytes32,string) external returns (uint256)",
+    "function registerAgentFor(address,string,string,bytes32,string) external returns (uint256)",
+    // Updates
+    "function updateAgent(string,bytes32) external",
+    "function updateAgentProfile(string,string,bytes32,string) external",
+    "function updateTokenURI(uint256,string) external",
+    // Activation
+    "function deactivateAgent() external",
+    "function reactivateAgent() external",
+    // Views
+    "function getAgentInfo(uint256) view returns (string,string,bytes32,bool)",
+    "function addressToTokenId(address) view returns (uint256)",
+    "function isRegistered(address) view returns (bool)",
+    "function getTokenId(address) view returns (uint256)",
+    "function totalAgents() view returns (uint256)",
+    "function isEndpointTaken(string) view returns (bool)",
+    // ERC-721
+    "function balanceOf(address) view returns (uint256)",
+    "function ownerOf(uint256) view returns (address)",
+    "function tokenURI(uint256) view returns (string)",
+    // Events
+    "event AgentRegistered(uint256 indexed tokenId, address indexed owner, string name, string endpoint)",
+    "event AgentUpdated(uint256 indexed tokenId, string endpoint, bytes32 capabilitiesHash)",
+];
+// ── Default capabilities hash ────────────────────────────────────────────
+const DEFAULT_CAPABILITIES_HASH = ethers.id("eliza-agent");
+// ── Service ──────────────────────────────────────────────────────────────
+export class RegistryService {
+    contract;
+    txService;
+    registryAddress;
+    constructor(txService, registryAddress) {
+        this.txService = txService;
+        this.registryAddress = registryAddress;
+        this.contract = txService.getContract(registryAddress, REGISTRY_ABI);
+    }
+    get address() {
+        return this.txService.address;
+    }
+    get contractAddress() {
+        return this.registryAddress;
+    }
+    async getChainId() {
+        return this.txService.getChainId();
+    }
+    /**
+     * Get the full registration status for the current wallet.
+     */
+    async getStatus() {
+        const addr = this.txService.address;
+        const [registered, totalAgentsBN] = await Promise.all([
+            this.contract.isRegistered(addr),
+            this.contract.totalAgents(),
+        ]);
+        if (!registered) {
+            return {
+                registered: false,
+                tokenId: 0,
+                agentName: "",
+                agentEndpoint: "",
+                capabilitiesHash: "",
+                isActive: false,
+                tokenURI: "",
+                walletAddress: addr,
+                totalAgents: Number(totalAgentsBN),
+            };
+        }
+        const tokenId = Number(await this.contract.getTokenId(addr));
+        const [[name, endpoint, capHash, isActive], uri] = await Promise.all([
+            this.contract.getAgentInfo(tokenId),
+            this.contract.tokenURI(tokenId),
+        ]);
+        return {
+            registered: true,
+            tokenId,
+            agentName: name,
+            agentEndpoint: endpoint,
+            capabilitiesHash: capHash,
+            isActive,
+            tokenURI: uri,
+            walletAddress: addr,
+            totalAgents: Number(totalAgentsBN),
+        };
+    }
+    /**
+     * Register the current wallet as an agent.
+     * The NFT is minted to the wallet address stored in EVM_PRIVATE_KEY.
+     */
+    async register(params) {
+        const capHash = params.capabilitiesHash || DEFAULT_CAPABILITIES_HASH;
+        logger.info(`[registry] Registering agent "${params.name}" from ${this.txService.address}`);
+        // Get fresh nonce before each transaction
+        const nonce = await this.txService.getFreshNonce();
+        const tx = await this.contract.registerAgent(params.name, params.endpoint, capHash, params.tokenURI, { nonce });
+        logger.info(`[registry] Registration tx submitted: ${tx.hash}`);
+        const receipt = await tx.wait();
+        // Parse the AgentRegistered event to get the tokenId
+        const iface = new ethers.Interface(REGISTRY_ABI);
+        let tokenId = 0;
+        for (const log of receipt.logs) {
+            const parsed = iface.parseLog({
+                topics: log.topics,
+                data: log.data,
+            });
+            if (parsed && parsed.name === "AgentRegistered") {
+                tokenId = Number(parsed.args[0]);
+                break;
+            }
+        }
+        // Fallback: read from contract
+        if (tokenId === 0) {
+            tokenId = Number(await this.contract.getTokenId(this.txService.address));
+        }
+        logger.info(`[registry] Agent registered: tokenId=${tokenId} txHash=${receipt.hash}`);
+        return { tokenId, txHash: receipt.hash };
+    }
+    /**
+     * Update the tokenURI (metadata pointer) for the current wallet's agent.
+     * Called when the character is edited.
+     */
+    async updateTokenURI(newURI) {
+        const tokenId = Number(await this.contract.getTokenId(this.txService.address));
+        if (tokenId === 0) {
+            throw new Error("Agent not registered, cannot update token URI");
+        }
+        logger.info(`[registry] Updating tokenURI for token ${tokenId}: ${newURI}`);
+        // Get fresh nonce before transaction
+        const nonce = await this.txService.getFreshNonce();
+        const tx = await this.contract.updateTokenURI(tokenId, newURI, { nonce });
+        const receipt = await tx.wait();
+        logger.info(`[registry] TokenURI updated: txHash=${receipt.hash}`);
+        return receipt.hash;
+    }
+    /**
+     * Update the agent's endpoint and capabilities hash.
+     */
+    async updateAgent(endpoint, capabilitiesHash) {
+        const capHash = capabilitiesHash || DEFAULT_CAPABILITIES_HASH;
+        logger.info(`[registry] Updating agent profile: endpoint=${endpoint}`);
+        // Get fresh nonce before transaction
+        const nonce = await this.txService.getFreshNonce();
+        const tx = await this.contract.updateAgent(endpoint, capHash, { nonce });
+        const receipt = await tx.wait();
+        logger.info(`[registry] Agent updated: txHash=${receipt.hash}`);
+        return receipt.hash;
+    }
+    /**
+     * Check if a specific address is registered.
+     */
+    /**
+     * Sync the full agent profile on-chain: name, endpoint, capabilities, and tokenURI.
+     * Called when the character is edited and user wants to push changes to chain.
+     */
+    async syncProfile(params) {
+        const capHash = params.capabilitiesHash || DEFAULT_CAPABILITIES_HASH;
+        logger.info(`[registry] Syncing profile: name="${params.name}" endpoint="${params.endpoint}"`);
+        // Get fresh nonce before transaction
+        const nonce = await this.txService.getFreshNonce();
+        const tx = await this.contract.updateAgentProfile(params.name, params.endpoint, capHash, params.tokenURI, { nonce });
+        logger.info(`[registry] Sync tx submitted: ${tx.hash}`);
+        const receipt = await tx.wait();
+        logger.info(`[registry] Profile synced: txHash=${receipt.hash}`);
+        return receipt.hash;
+    }
+    async isRegistered(address) {
+        return this.contract.isRegistered(address);
+    }
+    /**
+     * Build the default capabilities hash used for Eliza agents.
+     */
+    static defaultCapabilitiesHash() {
+        return DEFAULT_CAPABILITIES_HASH;
+    }
+}

package/packages/agent/src/api/route-helpers.d.ts

@@ -0,0 +1,16 @@
+import type http from "node:http";
+import type { ReadJsonBodyOptions } from "./http-helpers";
+export interface RouteRequestMeta {
+    req: http.IncomingMessage;
+    res: http.ServerResponse;
+    method: string;
+    pathname: string;
+}
+export interface RouteHelpers {
+    json: (res: http.ServerResponse, data: object, status?: number) => void;
+    error: (res: http.ServerResponse, message: string, status?: number) => void;
+    readJsonBody: <T extends object>(req: http.IncomingMessage, res: http.ServerResponse, options?: ReadJsonBodyOptions) => Promise<T | null>;
+}
+export interface RouteRequestContext extends RouteRequestMeta, RouteHelpers {
+}
+//# sourceMappingURL=route-helpers.d.ts.map

package/packages/agent/src/api/route-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/api/route-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC;IAC1B,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,YAAY,EAAE,CAAC,CAAC,SAAS,MAAM,EAC7B,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,OAAO,CAAC,EAAE,mBAAmB,KAC1B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB,EAAE,YAAY;CAAG"}

package/packages/agent/src/api/route-helpers.js

@@ -0,0 +1 @@
+export {};

package/packages/agent/src/api/sandbox-routes.d.ts

@@ -0,0 +1,12 @@
+/** Sandbox capability API routes: status, exec, browser, screen, audio, computer use. */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { RemoteSigningService } from "../services/remote-signing-service";
+import type { SandboxManager } from "../services/sandbox-manager";
+interface SandboxRouteState {
+    sandboxManager: SandboxManager | null;
+    signingService?: RemoteSigningService | null;
+}
+/** Returns `true` if handled, `false` to fall through. */
+export declare function handleSandboxRoute(req: IncomingMessage, res: ServerResponse, pathname: string, method: string, state: SandboxRouteState): Promise<boolean>;
+export {};
+//# sourceMappingURL=sandbox-routes.d.ts.map

package/packages/agent/src/api/sandbox-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/sandbox-routes.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAIzF,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAQlE,UAAU,iBAAiB;IACzB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,cAAc,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC9C;AAWD,0DAA0D;AAC1D,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,OAAO,CAAC,CAsdlB"}