@elizaos/agent 2.0.0-alpha.98 → 2.0.0-beta.2

package/packages/agent/src/api/trade-safety.js

@@ -0,0 +1,62 @@
+/**
+ * Pure trade safety utilities — no heavy dependencies.
+ * Extracted so they can be unit-tested without pulling in the full server.
+ */
+/** Maximum number of autonomous agent trades allowed per calendar day. */
+export const AGENT_AUTO_MAX_DAILY_TRADES = 25;
+/** Maximum age of a trade quote before it is considered stale. */
+export const QUOTE_MAX_AGE_MS = 60_000; // 60 seconds
+/** Tracks autonomous trade count for rate-limiting in agent-auto mode. */
+export const agentAutoDailyTrades = { count: 0, resetDate: "" };
+export function getAgentAutoTradeDate() {
+    return new Date().toISOString().slice(0, 10);
+}
+/**
+ * Record an autonomous agent trade. Returns true if allowed, false if
+ * the daily limit has been reached. Resets the counter on a new calendar day.
+ */
+export function recordAgentAutoTrade(log) {
+    const today = getAgentAutoTradeDate();
+    if (agentAutoDailyTrades.resetDate !== today) {
+        agentAutoDailyTrades.count = 0;
+        agentAutoDailyTrades.resetDate = today;
+    }
+    if (agentAutoDailyTrades.count >= AGENT_AUTO_MAX_DAILY_TRADES) {
+        log?.(`[trade] Agent-auto daily trade limit reached (${AGENT_AUTO_MAX_DAILY_TRADES}). Rejecting autonomous trade.`);
+        return false;
+    }
+    agentAutoDailyTrades.count += 1;
+    log?.(`[trade] Agent-auto autonomous trade ${agentAutoDailyTrades.count}/${AGENT_AUTO_MAX_DAILY_TRADES} for ${today}`);
+    return true;
+}
+/**
+ * Returns true if local-key execution is permitted for the given actor.
+ */
+export function canUseLocalTradeExecution(mode, isAgent, log, options = {}) {
+    if (mode === "agent-auto") {
+        if (isAgent) {
+            if (options.consumeAgentQuota === false) {
+                const today = getAgentAutoTradeDate();
+                if (agentAutoDailyTrades.resetDate !== today) {
+                    return true;
+                }
+                return agentAutoDailyTrades.count < AGENT_AUTO_MAX_DAILY_TRADES;
+            }
+            return recordAgentAutoTrade(log);
+        }
+        return true;
+    }
+    if (mode === "manual-local-key")
+        return !isAgent;
+    return false;
+}
+/**
+ * Assert that a trade quote is still fresh. Throws if the quote is older
+ * than QUOTE_MAX_AGE_MS. Silently passes if `quotedAt` is undefined
+ * (backwards compatibility with quotes that lack the field).
+ */
+export function assertQuoteFresh(quotedAt, now = Date.now()) {
+    if (quotedAt && now - quotedAt > QUOTE_MAX_AGE_MS) {
+        throw new Error("Quote expired — please request a fresh quote");
+    }
+}

package/packages/agent/src/api/training-service-like.d.ts

@@ -1,10 +1,11 @@
+import type { Trajectory, TrajectoryListResult } from "../types/trajectory.ts";
 export interface TrainingServiceLike {
     getStatus(): Record<string, unknown>;
     listTrajectories(options: {
         limit?: number;
         offset?: number;
-    }): Promise<Record<string, unknown>>;
-    getTrajectoryById(trajectoryId: string): Promise<Record<string, unknown> | null>;
+    }): Promise<TrajectoryListResult>;
+    getTrajectoryById(trajectoryId: string): Promise<Trajectory | null>;
     listDatasets(): Record<string, unknown>[];
     buildDataset(options: {
         limit?: number;

package/packages/agent/src/api/training-service-like.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"training-service-like.d.ts","sourceRoot":"","sources":["../../../../../src/api/training-service-like.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,gBAAgB,CAAC,OAAO,EAAE;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,iBAAiB,CACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1C,YAAY,CAAC,OAAO,EAAE;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,gBAAgB,CAAC,OAAO,EAAE;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACxC,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,aAAa,CACX,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3D"}
+{"version":3,"file":"training-service-like.d.ts","sourceRoot":"","sources":["../../../../../src/api/training-service-like.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,gBAAgB,CAAC,OAAO,EAAE;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClC,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACpE,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1C,YAAY,CAAC,OAAO,EAAE;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,gBAAgB,CAAC,OAAO,EAAE;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACxC,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,aAAa,CACX,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3D"}

package/packages/agent/src/api/travel-provider-relay-routes.d.ts

@@ -0,0 +1,9 @@
+import type http from "node:http";
+import { type IAgentRuntime } from "@elizaos/core";
+import type { CloudProxyConfigLike } from "../types/config-like.ts";
+export interface TravelProviderRelayRouteState {
+    config: CloudProxyConfigLike;
+    runtime?: IAgentRuntime | null;
+}
+export declare function handleTravelProviderRelayRoute(req: http.IncomingMessage, res: http.ServerResponse, pathname: string, method: string, state: TravelProviderRelayRouteState): Promise<boolean>;
+//# sourceMappingURL=travel-provider-relay-routes.d.ts.map

package/packages/agent/src/api/travel-provider-relay-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"travel-provider-relay-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/travel-provider-relay-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,KAAK,aAAa,EAA+B,MAAM,eAAe,CAAC;AAOhF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC;AA+HD,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,OAAO,CAAC,CAwDlB"}

package/packages/agent/src/api/travel-provider-relay-routes.js

@@ -0,0 +1,143 @@
+import { sendJsonError } from "@elizaos/core";
+import { normalizeCloudSiteUrl, resolveCloudApiKey, validateCloudBaseUrl, } from "@elizaos/plugin-elizacloud";
+import { sendJson } from "@elizaos/shared";
+const PROXY_TIMEOUT_MS = 30_000;
+const MAX_BODY_BYTES = 1_048_576;
+const TRAVEL_PROVIDER_PATH_RE = /^\/api\/cloud\/travel-providers\/([a-z0-9][a-z0-9-]*)(\/.*)$/;
+function normalizeCloudApiKey(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.toUpperCase() === "[REDACTED]")
+        return null;
+    return trimmed;
+}
+function resolveProxyApiKey(state) {
+    const cloudAuth = state.runtime
+        ? state.runtime.getService("CLOUD_AUTH")
+        : null;
+    const runtimeApiKey = cloudAuth?.isAuthenticated() === true
+        ? normalizeCloudApiKey(cloudAuth.getApiKey?.())
+        : null;
+    return runtimeApiKey ?? resolveCloudApiKey(state.config, state.runtime);
+}
+function buildAuthHeaders(config, apiKey) {
+    const serviceKey = config.cloud?.serviceKey?.trim();
+    const headers = {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`,
+    };
+    if (serviceKey)
+        headers["X-Service-Key"] = serviceKey;
+    return headers;
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on("data", (chunk) => {
+            size += chunk.length;
+            if (size > MAX_BODY_BYTES) {
+                reject(new Error("Request body too large"));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => resolve(chunks.length > 0 ? Buffer.concat(chunks).toString("utf-8") : undefined));
+        req.on("error", reject);
+    });
+}
+async function readJsonResponse(response) {
+    return response.json().catch(async () => ({
+        success: response.ok,
+        error: await response
+            .text()
+            .catch(() => "Travel-provider relay request failed"),
+    }));
+}
+function parseTravelProviderPath(pathname) {
+    const match = TRAVEL_PROVIDER_PATH_RE.exec(pathname);
+    if (!match)
+        return null;
+    const [, provider, providerPath] = match;
+    return provider ? { provider, providerPath } : null;
+}
+function buildUpstreamPath(localPath) {
+    const parsed = parseTravelProviderPath(localPath);
+    if (!parsed) {
+        throw new Error("Invalid travel-provider relay path");
+    }
+    return `/api/v1/${parsed.provider}${parsed.providerPath}`;
+}
+const TRAVEL_PROVIDER_RELAY_ROUTES = [
+    { method: "POST", pattern: /^\/offer-requests$/ },
+    { method: "GET", pattern: /^\/offers\/[^/]+$/ },
+    { method: "POST", pattern: /^\/orders$/ },
+    { method: "GET", pattern: /^\/orders\/[^/]+$/ },
+    { method: "POST", pattern: /^\/payments$/ },
+];
+function matchRoute(method, pathname) {
+    const parsed = parseTravelProviderPath(pathname);
+    if (!parsed)
+        return false;
+    return TRAVEL_PROVIDER_RELAY_ROUTES.some((route) => route.method === method && route.pattern.test(parsed.providerPath));
+}
+async function forward402(res, upstream) {
+    const wwwAuth = upstream.headers.get("www-authenticate");
+    const contentType = upstream.headers.get("content-type") ?? "application/json";
+    const bodyText = await upstream.text();
+    res.statusCode = 402;
+    res.setHeader("Content-Type", contentType);
+    if (wwwAuth)
+        res.setHeader("WWW-Authenticate", wwwAuth);
+    res.end(bodyText);
+}
+export async function handleTravelProviderRelayRoute(req, res, pathname, method, state) {
+    const parsed = parseTravelProviderPath(pathname);
+    if (!parsed)
+        return false;
+    if (!matchRoute(method, pathname)) {
+        sendJsonError(res, "Unknown travel-provider relay route", 404);
+        return true;
+    }
+    const apiKey = resolveProxyApiKey(state);
+    if (!apiKey) {
+        sendJsonError(res, "Not connected to Eliza Cloud. Sign in to use travel search.", 401);
+        return true;
+    }
+    const baseUrl = normalizeCloudSiteUrl(state.config.cloud?.baseUrl);
+    const urlError = await validateCloudBaseUrl(baseUrl);
+    if (urlError) {
+        sendJsonError(res, urlError, 502);
+        return true;
+    }
+    const headers = buildAuthHeaders(state.config, apiKey);
+    let body;
+    if (method === "POST") {
+        try {
+            body = await readBody(req);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : "Failed to read body";
+            sendJsonError(res, msg, 413);
+            return true;
+        }
+    }
+    const fullUrl = new URL(req.url ?? pathname, "http://localhost");
+    const upstreamUrl = `${baseUrl}${buildUpstreamPath(pathname)}${fullUrl.search}`;
+    const upstreamResponse = await fetch(upstreamUrl, {
+        method,
+        headers,
+        body,
+        redirect: "manual",
+        signal: AbortSignal.timeout(PROXY_TIMEOUT_MS),
+    });
+    if (upstreamResponse.status === 402) {
+        await forward402(res, upstreamResponse);
+        return true;
+    }
+    const payload = await readJsonResponse(upstreamResponse);
+    sendJson(res, payload, upstreamResponse.status);
+    return true;
+}

package/packages/agent/src/api/tx-service.d.ts

@@ -6,6 +6,12 @@
  * Used by the registry and drop services for on-chain operations.
  */
 import { ethers } from "ethers";
+export interface JsonRpcEndpointProbeResult {
+    ok: boolean;
+    reason?: string;
+}
+export declare function normalizeJsonRpcUrl(rpcUrl: string): string;
+export declare function probeJsonRpcEndpoint(rpcUrl: string, timeoutMs?: number): Promise<JsonRpcEndpointProbeResult>;
 export declare class TxService {
     private readonly provider;
     private readonly wallet;

package/packages/agent/src/api/tx-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tx-service.d.ts","sourceRoot":"","sources":["../../../../../src/api/tx-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAchC,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAwB9C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAsBtC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAEK,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAKnC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,QAAQ;IAIvE,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,YAAY,GACvB,MAAM,CAAC,QAAQ;IAIZ,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IAI3C;;;OAGG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,aAAa,GAAE,MAAU,EACzB,SAAS,GAAE,MAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAiCrC;;;OAGG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxE;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5E;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CASjC"}
+{"version":3,"file":"tx-service.d.ts","sourceRoot":"","sources":["../../../../../src/api/tx-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAsB1D;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,SAAQ,GAChB,OAAO,CAAC,0BAA0B,CAAC,CAoDrC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAwB9C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAsBtC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAEK,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAKnC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,QAAQ;IAIvE,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,YAAY,GACvB,MAAM,CAAC,QAAQ;IAIZ,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IAI3C;;;OAGG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,aAAa,GAAE,MAAU,EACzB,SAAS,GAAE,MAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAiCrC;;;OAGG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxE;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5E;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CASjC"}

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

@@ -7,7 +7,7 @@
  */
 import { logger } from "@elizaos/core";
 import { ethers } from "ethers";
-import { createIntegrationTelemetrySpan } from "../diagnostics/integration-observability";
+import { createIntegrationTelemetrySpan } from "../diagnostics/integration-observability.js";
 /**
  * Validate that a private key is a valid 32-byte hex string.
  */
@@ -19,13 +19,72 @@ function isValidPrivateKey(key) {
     // 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) {
-        this.rpcUrl = rpcUrl;
-        this.provider = new ethers.JsonRpcProvider(rpcUrl);
         // Validate private key before attempting to create wallet
         if (!isValidPrivateKey(privateKey)) {
             const preview = privateKey.length > 10
@@ -34,6 +93,8 @@ export class TxService {
             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}`;

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

@@ -0,0 +1,19 @@
+import type http from "node:http";
+import type { ReadJsonBodyOptions } from "@elizaos/core";
+import type { ElizaConfig } from "../config/config.ts";
+export interface UpdateRouteContext {
+    req: http.IncomingMessage;
+    res: http.ServerResponse;
+    method: string;
+    pathname: string;
+    url: URL;
+    state: {
+        config: ElizaConfig;
+    };
+    json: (res: http.ServerResponse, data: unknown, 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>;
+    saveElizaConfig: (config: ElizaConfig) => void;
+}
+export declare function handleUpdateRoutes(ctx: UpdateRouteContext): Promise<boolean>;
+//# sourceMappingURL=update-routes.d.ts.map

package/packages/agent/src/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;AACzD,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,CA2DlB"}

package/packages/agent/src/api/update-routes.js

@@ -0,0 +1,54 @@
+// ---------------------------------------------------------------------------
+// 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 { detectInstallMethod } = await import("../services/self-updater.js");
+        const channel = resolveChannel(state.config.update);
+        const [check, versions] = await Promise.all([
+            checkForUpdate({ force: req.url?.includes("force=true") }),
+            fetchAllChannelVersions(),
+        ]);
+        json(res, {
+            currentVersion: VERSION,
+            channel,
+            installMethod: detectInstallMethod(),
+            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 body = (await readJsonBody(req, res));
+        if (!body)
+            return true;
+        const ch = body.channel;
+        if (ch !== "stable" && ch !== "beta" && ch !== "nightly") {
+            error(res, `Invalid channel "${ch}". Must be stable, beta, or nightly.`);
+            return true;
+        }
+        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/packages/agent/src/api/wallet-capability.d.ts

@@ -0,0 +1,33 @@
+import type { AgentRuntime } from "@elizaos/core";
+import type { ElizaConfig } from "../config/config.ts";
+import { type EvmSigningCapabilityKind, resolveEvmSigningCapability } from "../services/evm-signing-capability.ts";
+import { getWalletAddresses } from "./wallet.ts";
+/** Unified wallet package (bundles legacy EVM + Solana plugins). */
+export declare const EVM_PLUGIN_PACKAGE = "@elizaos/plugin-wallet";
+export interface WalletCapabilityStatus {
+    walletSource: "local" | "managed" | "none";
+    walletNetwork: "mainnet" | "testnet";
+    evmAddress: string | null;
+    solanaAddress: string | null;
+    hasWallet: boolean;
+    hasEvm: boolean;
+    localSignerAvailable: boolean;
+    rpcReady: boolean;
+    automationMode: "full" | "connectors-only";
+    pluginEvmLoaded: boolean;
+    pluginEvmRequired: boolean;
+    executionReady: boolean;
+    executionBlockedReason: string | null;
+    evmSigningCapability: EvmSigningCapabilityKind;
+    evmSigningReason: string;
+}
+export declare function isPluginLoadedByName(runtime: AgentRuntime | null, pluginName: string): boolean;
+export declare function resolveWalletAutomationMode(config: ElizaConfig): "full" | "connectors-only";
+export declare function resolvePluginEvmLoaded(runtime: AgentRuntime | null): boolean;
+export declare function resolveWalletCapabilityStatus(state: {
+    config: ElizaConfig;
+    runtime: AgentRuntime | null;
+    getWalletAddresses?: typeof getWalletAddresses;
+    resolveEvmSigningCapability?: typeof resolveEvmSigningCapability;
+}): WalletCapabilityStatus;
+//# sourceMappingURL=wallet-capability.d.ts.map

package/packages/agent/src/api/wallet-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-capability.d.ts","sourceRoot":"","sources":["../../../../../src/api/wallet-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAEL,KAAK,wBAAwB,EAC7B,2BAA2B,EAC5B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAG3D,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC3C,aAAa,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAC3C,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oBAAoB,EAAE,wBAAwB,CAAC;IAC/C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAqHD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,CAcT;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,WAAW,GAClB,MAAM,GAAG,iBAAiB,CAc5B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAM5E;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC/C,2BAA2B,CAAC,EAAE,OAAO,2BAA2B,CAAC;CAClE,GAAG,sBAAsB,CAmEzB"}