@elizaos/agent 2.0.0-beta.2 → 2.0.11-beta.5

package/api/tx-service.js

@@ -0,0 +1,217 @@
+/**
+ * Ethereum transaction signing and contract interaction layer.
+ *
+ * Provides the missing transaction capability to Eliza's wallet system,
+ * which currently only handles key generation and balance fetching.
+ * Used by the registry and drop services for on-chain operations.
+ */
+import { logger } from "@elizaos/core";
+import * as ethers from "ethers";
+import { createIntegrationTelemetrySpan } from "../diagnostics/integration-observability.js";
+/**
+ * Validate that a private key is a valid 32-byte hex string.
+ */
+function isValidPrivateKey(key) {
+    const normalized = key.startsWith("0x") ? key.slice(2) : key;
+    // Must be 64 hex characters (32 bytes)
+    if (normalized.length !== 64)
+        return false;
+    // Must be valid hex
+    return /^[0-9a-fA-F]+$/.test(normalized);
+}
+export function normalizeJsonRpcUrl(rpcUrl) {
+    const trimmed = rpcUrl.trim();
+    if (!trimmed) {
+        throw new Error("EVM JSON-RPC URL is required.");
+    }
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        throw new Error(`Invalid EVM JSON-RPC URL "${trimmed}": expected an http(s) URL.`);
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error(`Invalid EVM JSON-RPC URL "${trimmed}": expected http: or https:.`);
+    }
+    return parsed.toString();
+}
+export async function probeJsonRpcEndpoint(rpcUrl, timeoutMs = 2_000) {
+    const normalizedRpcUrl = normalizeJsonRpcUrl(rpcUrl);
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(normalizedRpcUrl, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: 1,
+                method: "eth_chainId",
+                params: [],
+            }),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            return {
+                ok: false,
+                reason: `HTTP ${response.status} ${response.statusText}`.trim(),
+            };
+        }
+        const body = (await response.json());
+        if (typeof body.result === "string" &&
+            /^0x[0-9a-fA-F]+$/.test(body.result)) {
+            return { ok: true };
+        }
+        const errorMessage = typeof body.error?.message === "string"
+            ? body.error.message
+            : "missing eth_chainId result";
+        return { ok: false, reason: errorMessage };
+    }
+    catch (err) {
+        const message = err instanceof Error && err.name === "AbortError"
+            ? `timed out after ${timeoutMs}ms`
+            : err instanceof Error
+                ? err.message
+                : String(err);
+        return { ok: false, reason: message };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export class TxService {
+    provider;
+    wallet;
+    rpcUrl;
+    constructor(rpcUrl, privateKey) {
+        // Validate private key before attempting to create wallet
+        if (!isValidPrivateKey(privateKey)) {
+            const preview = privateKey.length > 10
+                ? `${privateKey.slice(0, 6)}...${privateKey.slice(-4)}`
+                : "(empty or too short)";
+            throw new Error(`Invalid EVM_PRIVATE_KEY: expected 64-character hex string, got ${preview}. ` +
+                `Please set a valid private key in your environment or .env file.`);
+        }
+        this.rpcUrl = normalizeJsonRpcUrl(rpcUrl);
+        this.provider = new ethers.JsonRpcProvider(this.rpcUrl);
+        const normalizedKey = privateKey.startsWith("0x")
+            ? privateKey
+            : `0x${privateKey}`;
+        // Create wallet with provider
+        this.wallet = new ethers.Wallet(normalizedKey, this.provider);
+    }
+    /**
+     * Get fresh nonce for the wallet address.
+     * Always fetches from blockchain using a fresh provider to avoid caching issues.
+     * This ensures we always get the correct nonce even after failed transactions.
+     */
+    async getFreshNonce() {
+        const span = createIntegrationTelemetrySpan({
+            boundary: "wallet",
+            operation: "rpc_get_nonce",
+        });
+        // Use a fresh provider for each nonce lookup to avoid ethers.js v6 caching
+        const freshProvider = new ethers.JsonRpcProvider(this.rpcUrl);
+        try {
+            const nonce = await freshProvider.getTransactionCount(this.wallet.address, "pending");
+            span.success();
+            return nonce;
+        }
+        catch (err) {
+            span.failure({ error: err });
+            throw err;
+        }
+        finally {
+            freshProvider.destroy();
+        }
+    }
+    get address() {
+        return this.wallet.address;
+    }
+    async getBalance() {
+        return this.provider.getBalance(this.wallet.address);
+    }
+    async getBalanceFormatted() {
+        const balance = await this.getBalance();
+        return ethers.formatEther(balance);
+    }
+    async getChainId() {
+        const network = await this.provider.getNetwork();
+        return Number(network.chainId);
+    }
+    getContract(address, abi) {
+        return new ethers.Contract(address, abi, this.wallet);
+    }
+    getReadOnlyContract(address, abi) {
+        return new ethers.Contract(address, abi, this.provider);
+    }
+    async estimateGas(tx) {
+        return this.provider.estimateGas(tx);
+    }
+    async getFeeData() {
+        return this.provider.getFeeData();
+    }
+    /**
+     * Wait for a transaction to be mined and return the receipt.
+     * Throws if the transaction fails or times out.
+     */
+    async waitForTransaction(txHash, confirmations = 1, timeoutMs = 120_000) {
+        const span = createIntegrationTelemetrySpan({
+            boundary: "wallet",
+            operation: "rpc_wait_for_transaction",
+            timeoutMs,
+        });
+        let receipt;
+        try {
+            receipt = await this.provider.waitForTransaction(txHash, confirmations, timeoutMs);
+        }
+        catch (err) {
+            span.failure({ error: err });
+            throw err;
+        }
+        if (!receipt) {
+            const err = new Error(`Transaction ${txHash} timed out after ${timeoutMs}ms`);
+            span.failure({ error: err, errorKind: "timeout" });
+            throw err;
+        }
+        if (receipt.status === 0) {
+            const err = new Error(`Transaction ${txHash} reverted`);
+            span.failure({ error: err, errorKind: "tx_reverted" });
+            throw err;
+        }
+        span.success();
+        return receipt;
+    }
+    /**
+     * Estimate the gas cost in ETH for a contract call.
+     * Useful for showing users how much gas they'll need.
+     */
+    async estimateGasCostEth(tx) {
+        const gasLimit = await this.estimateGas(tx);
+        const feeData = await this.getFeeData();
+        const gasPrice = feeData.gasPrice ?? feeData.maxFeePerGas ?? 0n;
+        const costWei = gasLimit * gasPrice;
+        return ethers.formatEther(costWei);
+    }
+    /**
+     * Check whether the wallet has enough balance for a given value + estimated gas.
+     */
+    async hasEnoughBalance(value, gasEstimate) {
+        const balance = await this.getBalance();
+        const feeData = await this.getFeeData();
+        const gasPrice = feeData.gasPrice ?? feeData.maxFeePerGas ?? 0n;
+        const gasCost = gasEstimate * gasPrice;
+        return balance >= value + gasCost;
+    }
+    /**
+     * Log a summary of the tx service state for diagnostics.
+     */
+    async logStatus() {
+        const [balance, chainId] = await Promise.all([
+            this.getBalanceFormatted(),
+            this.getChainId(),
+        ]);
+        logger.info(`[tx-service] address=${this.address} chain=${chainId} balance=${balance} ETH`);
+    }
+}

package/api/update-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-routes.d.ts","sourceRoot":"","sources":["../../src/api/update-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC;IAC1B,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,KAAK,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC;IAC/B,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,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;IACvB,eAAe,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAChD;AAMD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,OAAO,CAAC,CA8ElB"}

package/api/update-routes.js

@@ -0,0 +1,69 @@
+import { PutUpdateChannelRequestSchema } from "@elizaos/shared";
+// ---------------------------------------------------------------------------
+// Route handler
+// ---------------------------------------------------------------------------
+export async function handleUpdateRoutes(ctx) {
+    const { req, res, method, pathname, state, json, error, readJsonBody } = ctx;
+    // ── GET /api/update/status ───────────────────────────────────────────
+    if (method === "GET" && pathname === "/api/update/status") {
+        const { VERSION } = await import("../runtime/version.js");
+        const { resolveChannel, checkForUpdate, fetchAllChannelVersions, CHANNEL_DIST_TAGS, } = await import("../services/update-checker.js");
+        const { isTrustedLocalRequest } = await import("./server-helpers-auth.js");
+        const { detectInstallMethod, getUpdateActionPlan } = await import("../services/self-updater.js");
+        const channel = resolveChannel(state.config.update);
+        const installMethod = detectInstallMethod();
+        const updatePlan = getUpdateActionPlan(installMethod, channel, {
+            remoteDisplay: !isTrustedLocalRequest(req),
+        });
+        const [check, versions] = await Promise.all([
+            checkForUpdate({ force: req.url?.includes("force=true") }),
+            fetchAllChannelVersions(),
+        ]);
+        json(res, {
+            currentVersion: VERSION,
+            channel,
+            installMethod,
+            updateAuthority: updatePlan.authority,
+            nextAction: updatePlan.nextAction,
+            canAutoUpdate: updatePlan.canAutoUpdate,
+            canExecuteUpdate: updatePlan.canExecuteFromContext,
+            remoteDisplay: updatePlan.remoteDisplay,
+            updateCommand: updatePlan.command,
+            updateInstructions: updatePlan.message,
+            updateAvailable: check.updateAvailable,
+            latestVersion: check.latestVersion,
+            channels: {
+                stable: versions.stable,
+                beta: versions.beta,
+                nightly: versions.nightly,
+            },
+            distTags: CHANNEL_DIST_TAGS,
+            lastCheckAt: state.config.update?.lastCheckAt ?? null,
+            error: check.error,
+        });
+        return true;
+    }
+    // ── PUT /api/update/channel ────────────────────────────────────────────
+    if (method === "PUT" && pathname === "/api/update/channel") {
+        const rawCh = await readJsonBody(req, res);
+        if (rawCh === null)
+            return true;
+        const parsedCh = PutUpdateChannelRequestSchema.safeParse(rawCh);
+        if (!parsedCh.success) {
+            error(res, parsedCh.error.issues[0]?.message ??
+                `Invalid channel. Must be stable, beta, or nightly.`);
+            return true;
+        }
+        const ch = parsedCh.data.channel;
+        state.config.update = {
+            ...state.config.update,
+            channel: ch,
+            lastCheckAt: undefined,
+            lastCheckVersion: undefined,
+        };
+        ctx.saveElizaConfig(state.config);
+        json(res, { channel: ch });
+        return true;
+    }
+    return false;
+}

package/api/view-registry-types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Shared types for the view registry.
+ *
+ * Extracted from views-registry.ts to break the views-registry ↔
+ * views-search-index circular dependency.
+ *
+ * @module api/view-registry-types
+ */
+import type { ViewDeclaration, ViewType } from "@elizaos/core";
+import type { AgentPlatform } from "./platform-detect.ts";
+export interface ViewRegistryEntry extends ViewDeclaration {
+    /** Concrete presentation type after applying the default (`gui`). */
+    viewType: ViewType;
+    /** Owning plugin name. */
+    pluginName: string;
+    /** Absolute path to the plugin's package root, if resolvable. */
+    pluginDir?: string;
+    /** Resolved URL served by the agent: `/api/views/<id>/bundle.js`. */
+    bundleUrl?: string;
+    /** Resolved URL served by the agent: `/api/views/<id>/hero`. */
+    heroImageUrl?: string;
+    /**
+     * True when a real hero image asset exists on disk for this view. When false,
+     * `heroImageUrl` still resolves (the route serves a generated fallback),
+     * but the client should render the view's icon instead of that fallback.
+     */
+    hasHeroImage: boolean;
+    /** True when the bundle file exists on disk. */
+    available: boolean;
+    /** Unix timestamp (ms) when this entry was registered. */
+    loadedAt: number;
+    /**
+     * Platform this view is available on. Populated from
+     * `ViewDeclaration.platforms` (first entry) or defaults to "web".
+     * Used by platform-aware route filtering to gate dynamic bundles on
+     * restricted platforms (iOS App Store, Google Play).
+     */
+    platform: AgentPlatform;
+    /** First 12 hex chars of the SHA-256 content hash of the bundle file. */
+    bundleHash?: string;
+    /** Bundle URL with `?v=<hash>` for immutable long-lived caching. */
+    bundleUrlVersioned?: string;
+    /** Bundle file size in bytes. */
+    bundleSize?: number;
+    /**
+     * True for entries registered by the built-in shell itself
+     * (pluginName === "@elizaos/builtin"). These views live in the main
+     * bundle and have no separate bundle file.
+     */
+    builtin?: boolean;
+}
+//# sourceMappingURL=view-registry-types.d.ts.map

package/api/view-registry-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-registry-types.d.ts","sourceRoot":"","sources":["../../src/api/view-registry-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,qEAAqE;IACrE,QAAQ,EAAE,QAAQ,CAAC;IACnB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,EAAE,aAAa,CAAC;IACxB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/api/view-registry-types.js

@@ -0,0 +1,9 @@
+/**
+ * Shared types for the view registry.
+ *
+ * Extracted from views-registry.ts to break the views-registry ↔
+ * views-search-index circular dependency.
+ *
+ * @module api/view-registry-types
+ */
+export {};

package/api/views-registry.d.ts

@@ -0,0 +1,90 @@
+/**
+ * View Registry — discovers, catalogs, and resolves view bundles from plugins.
+ *
+ * Views are declared by plugins via `Plugin.views`. Each declaration is
+ * registered here at plugin load time and assigned runtime URLs. The HTTP
+ * layer (`views-routes.ts`) delegates all path resolution back to this module.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import { type Plugin, type ViewType } from "@elizaos/core";
+export type { ViewRegistryEntry } from "./view-registry-types.ts";
+import type { ViewRegistryEntry } from "./view-registry-types.ts";
+/**
+ * Resolve the absolute on-disk path for a view bundle.
+ * Returns `null` when the entry has no `bundlePath` or no `pluginDir`.
+ */
+export declare function getBundleDiskPath(entry: ViewRegistryEntry): string | null;
+/**
+ * Resolve the absolute on-disk path for a hero image.
+ * Returns `null` when the entry has no `heroImagePath` or no `pluginDir`.
+ * This only handles declared paths; for extension-probing see `findHeroOnDisk`.
+ */
+type HeroLookup = Pick<ViewRegistryEntry, "pluginDir" | "heroImagePath">;
+export declare function getHeroDiskPath(entry: HeroLookup): string | null;
+/**
+ * Find the first existing hero image file for an entry, probing extensions
+ * in preference order. Returns the absolute path and its content type, or
+ * `null` when nothing is found.
+ */
+export declare function findHeroOnDisk(entry: HeroLookup): Promise<{
+    absolutePath: string;
+    contentType: string;
+} | null>;
+/**
+ * Build a branded generated SVG fallback when no hero image is on disk. Shares
+ * the exact art (frame, no-blue palette, line-icon glyph) used for the heroes
+ * committed into plugins, so a view without a packaged hero still renders a
+ * cohesive card instead of a placeholder. `icon` is the view's Lucide icon name,
+ * used as a hint to pick the matching glyph.
+ */
+export declare function generateViewHeroSvg(label: string, icon?: string): string;
+/**
+ * Register all views declared by `plugin`. Safe to call multiple times for the
+ * same plugin — subsequent calls update existing entries.
+ *
+ * @param plugin    - The Plugin object whose `views` array to register.
+ * @param pluginDir - Absolute path to the plugin's package root. When omitted,
+ *   the registry attempts to resolve it via `require.resolve`.
+ * @param runtime   - Optional agent runtime. When provided, embeddings for the
+ *   newly registered views are queued in the background search index.
+ */
+export declare function registerPluginViews(plugin: Plugin, pluginDir?: string, runtime?: IAgentRuntime): Promise<void>;
+/**
+ * Remove all views registered for `pluginName`. Called when a plugin is
+ * unloaded via `runtime.unloadPlugin`.
+ */
+export declare function unregisterPluginViews(pluginName: string): void;
+/**
+ * Register all built-in first-party shell views.
+ *
+ * These views are declared in `builtin-views.ts` and live in the main shell
+ * bundle — no separate bundle file is required. Called once at server startup
+ * before any plugin views are registered, so plugin views can override them
+ * by registering the same id only when a conflict is logged (built-in wins
+ * under the existing conflict resolution rule).
+ *
+ * Safe to call multiple times — subsequent calls have no additional effect
+ * because the conflict guard in `registerPluginViews` keeps the first
+ * registration.
+ *
+ * @param runtime - Optional agent runtime. When provided, embeddings for the
+ *   built-in views are queued in the background search index.
+ */
+export declare function registerBuiltinViews(runtime?: IAgentRuntime): void;
+/**
+ * List all registered views.
+ *
+ * @param filter.developerMode - When `false` (default) hidden developer-only
+ *   views are excluded. Pass `true` to include them.
+ */
+export declare function listViews(filter?: {
+    developerMode?: boolean;
+    viewType?: ViewType;
+}): ViewRegistryEntry[];
+/**
+ * Look up a single view by its stable id.
+ */
+export declare function getView(id: string, filter?: {
+    viewType?: ViewType;
+}): ViewRegistryEntry | undefined;
+//# sourceMappingURL=views-registry.d.ts.map

package/api/views-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views-registry.d.ts","sourceRoot":"","sources":["../../src/api/views-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAEL,KAAK,MAAM,EAEX,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AAIvB,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAgIlE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAOzE;AAED;;;;GAIG;AACH,KAAK,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,eAAe,CAAC,CAAC;AAEzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAMhE;AASD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA0B/D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAiDf;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAW9D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAuDlE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,iBAAiB,EAAE,CA+BtB;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,GAC/B,iBAAiB,GAAG,SAAS,CAM/B"}