@elizaos/plugin-wallet 2.0.0-beta.1

package/src/analytics/dexscreener/errors.ts

@@ -0,0 +1,28 @@
+interface DexScreenerFetchErr {
+  readonly response?: { readonly data?: { readonly message?: string } };
+  readonly message?: string;
+}
+
+function isDexScreenerFetchErr(value: object): value is DexScreenerFetchErr {
+  return "response" in value || "message" in value;
+}
+
+/** Best-effort message extraction for DexScreener HTTP / fetch failures. */
+export function dexScreenerErrorMessage(caught: unknown): string {
+  if (typeof caught === "string") return caught;
+  if (caught instanceof Error) return caught.message;
+  if (
+    typeof caught === "object" &&
+    caught !== null &&
+    isDexScreenerFetchErr(caught)
+  ) {
+    const fromResponse = caught.response?.data?.message;
+    const fromMsg = caught.message;
+    return (
+      (typeof fromResponse === "string" ? fromResponse : undefined) ??
+      (typeof fromMsg === "string" ? fromMsg : undefined) ??
+      "Request failed"
+    );
+  }
+  return "Request failed";
+}

package/src/analytics/dexscreener/index.ts

@@ -0,0 +1,3 @@
+export { registerDexScreenerSearchCategory } from "./search-category";
+export { DexScreenerService } from "./service";
+export * from "./types";

package/src/analytics/dexscreener/search-category.test.ts

@@ -0,0 +1,49 @@
+import type { IAgentRuntime, SearchCategoryRegistration } from "@elizaos/core";
+import { describe, expect, it, vi } from "vitest";
+import {
+  DEXSCREENER_SEARCH_CATEGORY,
+  registerDexScreenerSearchCategory,
+} from "./search-category";
+
+function createRuntime() {
+  const categories = new Map<string, SearchCategoryRegistration>();
+  const registerSearchCategory = vi.fn(
+    (registration: SearchCategoryRegistration) => {
+      categories.set(registration.category, registration);
+    },
+  );
+  const getSearchCategory = vi.fn((category: string) => {
+    const registration = categories.get(category);
+    if (!registration) throw new Error(`Missing category ${category}`);
+    return registration;
+  });
+
+  return {
+    categories,
+    registerSearchCategory,
+    runtime: {
+      getSearchCategory,
+      registerSearchCategory,
+    } as IAgentRuntime,
+  };
+}
+
+describe("DexScreener search category", () => {
+  it("registers token and pair search metadata", () => {
+    const { categories, registerSearchCategory, runtime } = createRuntime();
+
+    registerDexScreenerSearchCategory(runtime);
+    registerDexScreenerSearchCategory(runtime);
+
+    expect(registerSearchCategory).toHaveBeenCalledTimes(1);
+    expect(categories.get("dexscreener")).toMatchObject({
+      category: "dexscreener",
+      serviceType: "dexscreener",
+      source: "plugin:wallet:dexscreener",
+    });
+    expect(DEXSCREENER_SEARCH_CATEGORY.filters?.map((f) => f.name)).toEqual([
+      "query",
+      "limit",
+    ]);
+  });
+});

package/src/analytics/dexscreener/search-category.ts

@@ -0,0 +1,42 @@
+// @ts-nocheck — legacy code from absorbed plugins (lp-manager, lpinfo, dexscreener, defi-news, birdeye); strict types pending cleanup
+import type { IAgentRuntime, SearchCategoryRegistration } from "@elizaos/core";
+
+export const DEXSCREENER_SEARCH_CATEGORY: SearchCategoryRegistration = {
+  category: "dexscreener",
+  label: "DexScreener token search",
+  description:
+    "Search DexScreener for tokens and trading pairs by name, symbol, or contract address.",
+  contexts: ["wallet", "knowledge"],
+  filters: [
+    { name: "query", label: "Query", type: "string", required: true },
+    {
+      name: "limit",
+      label: "Limit",
+      description: "Maximum pairs to return.",
+      type: "number",
+      default: 5,
+    },
+  ],
+  resultSchemaSummary:
+    "DexScreenerPair[] with chainId, dexId, url, baseToken, quoteToken, price, priceChange, volume, liquidity, marketCap, and fdv.",
+  capabilities: ["tokens", "pairs", "dex-liquidity", "market-data"],
+  source: "plugin:wallet:dexscreener",
+  serviceType: "dexscreener",
+};
+
+function hasSearchCategory(runtime: IAgentRuntime, category: string): boolean {
+  try {
+    runtime.getSearchCategory(category, { includeDisabled: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function registerDexScreenerSearchCategory(
+  runtime: IAgentRuntime,
+): void {
+  if (!hasSearchCategory(runtime, DEXSCREENER_SEARCH_CATEGORY.category)) {
+    runtime.registerSearchCategory(DEXSCREENER_SEARCH_CATEGORY);
+  }
+}