@elizaos/plugin-wallet 2.0.0-beta.1

package/package.json

@@ -0,0 +1,152 @@
+{
+  "name": "@elizaos/plugin-wallet",
+  "version": "2.0.0-beta.1",
+  "description": "Unified non-custodial wallet for elizaOS agents — EVM + Solana, ERC-6551 token-bound accounts, on-chain spend policies, x402 micropayments, CCTP bridge, Li.Fi swap routing, Jupiter routing, multi-DEX LP management (Raydium/Orca/Meteora on Solana, Uniswap/Aerodrome on EVM), Hyperliquid perps, Polymarket, Aave/Morpho lending, and Clanker token launches. Replaces plugin-evm + plugin-solana + plugin-raydium + plugin-orca + plugin-meteora + plugin-jupiter + plugin-lp-manager + plugin-clanker behind one canonical action+provider surface.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://github.com/eliza-ai/eliza/tree/main/eliza/plugins/plugin-wallet",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eliza-ai/eliza.git",
+    "directory": "eliza/plugins/plugin-wallet"
+  },
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "auto-enable.ts",
+    "SDK-LICENSE"
+  ],
+  "elizaos": {
+    "plugin": {
+      "autoEnableModule": "./auto-enable.ts",
+      "capabilities": [
+        "wallet",
+        "evm",
+        "solana"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsdown --no-config src/index.ts --format esm --dts --clean -d dist && tsdown --no-config src/sdk/index.ts --format esm --dts --no-clean -d dist/sdk && tsdown --no-config src/wallet-action.ts --format esm --dts --no-clean -d dist && tsdown --no-config src/lib/server-wallet-trade.ts --format esm --dts --no-clean -d dist/lib && mv dist/index-*.d.ts dist/index.d.ts 2>/dev/null || true && mv dist/sdk/index-*.d.ts dist/sdk/index.d.ts 2>/dev/null || true && mv dist/wallet-action-*.d.ts dist/wallet-action.d.ts 2>/dev/null || true && mv dist/lib/server-wallet-trade-*.d.ts dist/lib/server-wallet-trade.d.ts 2>/dev/null || true",
+    "check": "tsc --noEmit",
+    "lint": "bunx @biomejs/biome check --write --unsafe .",
+    "test": "vitest run --config ./vitest.config.ts",
+    "test:watch": "vitest --config ./vitest.config.ts",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "@elizaos/core": "2.0.0-beta.1",
+    "@elizaos/plugin-elizacloud": "2.0.0-beta.1"
+  },
+  "dependencies": {
+    "@coral-xyz/anchor": "^0.32.1",
+    "@elizaos/cloud-routing": "2.0.0-beta.1",
+    "@lifi/data-types": "^6.0.0",
+    "@lifi/sdk": "^3.7.9",
+    "@lifi/types": "^17.18.0",
+    "@noble/hashes": "^1.8.0",
+    "@orca-so/whirlpools": "^2.2.0",
+    "@orca-so/whirlpools-client": "^6.2.1",
+    "@orca-so/whirlpools-core": "^3.1.0",
+    "@orca-so/whirlpools-sdk": "^0.20.0",
+    "@raydium-io/raydium-sdk": "^1.3.1-beta.58",
+    "@solana/spl-token": "0.4.14",
+    "@solana/spl-token-metadata": "^0.1.6",
+    "@solana/web3.js": "1.98.4",
+    "@steerprotocol/sdk": "^3.0.7",
+    "bignumber.js": "^11.0.0",
+    "bs58": "^6.0.0",
+    "tweetnacl": "^1.0.3",
+    "viem": "^2.48.8",
+    "zod": "^4.4.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@elizaos/core": "2.0.0-beta.1",
+    "@types/node": "^24.0.0",
+    "tsdown": "^0.21.10",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.18"
+  },
+  "agentConfig": {
+    "pluginType": "elizaos:plugin:1.0.0",
+    "pluginParameters": {
+      "ELIZA_WALLET_BACKEND": {
+        "type": "string",
+        "required": false,
+        "description": "Wallet backend selection: 'local' | 'steward' | 'auto'. Default: auto (desktop=local, cloud/mobile=steward).",
+        "default": "auto"
+      },
+      "EVM_PRIVATE_KEY": {
+        "type": "string",
+        "required": false,
+        "sensitive": true,
+        "description": "EVM private key (32-byte hex, 0x-prefixed). Local backend only. Hydrated from OS keychain when available."
+      },
+      "SOLANA_PRIVATE_KEY": {
+        "type": "string",
+        "required": false,
+        "sensitive": true,
+        "description": "Solana private key, base58-encoded. Local backend only. Hydrated from OS keychain when available."
+      },
+      "STEWARD_API_URL": {
+        "type": "string",
+        "required": false,
+        "description": "Steward API base URL. Required when ELIZA_WALLET_BACKEND=steward."
+      },
+      "STEWARD_AGENT_ID": {
+        "type": "string",
+        "required": false,
+        "description": "Steward agent identifier. Required when ELIZA_WALLET_BACKEND=steward."
+      },
+      "STEWARD_AGENT_TOKEN": {
+        "type": "string",
+        "required": false,
+        "sensitive": true,
+        "description": "Steward agent bearer token. Required when ELIZA_WALLET_BACKEND=steward."
+      },
+      "STEWARD_TENANT_ID": {
+        "type": "string",
+        "required": false,
+        "description": "Steward tenant identifier (typically the user ID)."
+      }
+    }
+  },
+  "keywords": [
+    "plugin",
+    "elizaos",
+    "wallet",
+    "non-custodial",
+    "evm",
+    "solana",
+    "erc-6551",
+    "x402",
+    "cctp",
+    "lifi",
+    "jupiter",
+    "raydium",
+    "orca",
+    "meteora",
+    "hyperliquid",
+    "polymarket",
+    "aave",
+    "morpho",
+    "clanker",
+    "lp-management",
+    "trading",
+    "automation"
+  ],
+  "packageType": "plugin"
+}

package/src/actions/failure-codes.ts

@@ -0,0 +1,79 @@
+/**
+ * Single source of truth for action failure modes. Every error returned to the
+ * planner carries a code from one of these unions; the `detail` string is for
+ * humans, the code is for the planner to react on.
+ *
+ * See docs/architecture/wallet-and-trading.md §E.
+ */
+
+export type ValidateFailureCode =
+  | "INVALID_PARAMS"
+  | "PLUGIN_DISABLED"
+  | "PROVIDER_UNAVAILABLE"
+  | "PROVIDER_AUTH_MISSING"
+  | "WALLET_NOT_AVAILABLE"
+  | "VENUE_NOT_SUPPORTED_ON_BACKEND"
+  | "VENUE_NOT_SUPPORTED_FOR_KIND"
+  | "POLICY_REQUIRES_APPROVAL"
+  | "POLICY_BLOCKED"
+  | "INSUFFICIENT_BALANCE"
+  | "MARKET_CLOSED"
+  | "INSTRUMENT_NOT_FOUND"
+  | "LEVERAGE_OUT_OF_RANGE"
+  | "SLIPPAGE_EXCEEDED"
+  | "WITHDRAWAL_NOT_ALLOWLISTED"
+  | "VENUE_GEO_RESTRICTED"
+  | "INVALID_ADDRESS"
+  | "TOKEN_NOT_SUPPORTED"
+  | "POOL_NOT_FOUND"
+  | "RANGE_OUT_OF_BOUNDS";
+
+export type ActionFailureCode =
+  | "PROVIDER_REJECTED"
+  | "SIGNATURE_REJECTED"
+  | "STEWARD_UNAVAILABLE"
+  | "ROUTE_NOT_FOUND"
+  | "TRANSACTION_REVERTED"
+  | "TIMEOUT";
+
+export type FailureCode = ValidateFailureCode | ActionFailureCode;
+
+export const isValidateFailureCode = (
+  code: string,
+): code is ValidateFailureCode =>
+  (
+    [
+      "INVALID_PARAMS",
+      "PLUGIN_DISABLED",
+      "PROVIDER_UNAVAILABLE",
+      "PROVIDER_AUTH_MISSING",
+      "WALLET_NOT_AVAILABLE",
+      "VENUE_NOT_SUPPORTED_ON_BACKEND",
+      "VENUE_NOT_SUPPORTED_FOR_KIND",
+      "POLICY_REQUIRES_APPROVAL",
+      "POLICY_BLOCKED",
+      "INSUFFICIENT_BALANCE",
+      "MARKET_CLOSED",
+      "INSTRUMENT_NOT_FOUND",
+      "LEVERAGE_OUT_OF_RANGE",
+      "SLIPPAGE_EXCEEDED",
+      "WITHDRAWAL_NOT_ALLOWLISTED",
+      "VENUE_GEO_RESTRICTED",
+      "INVALID_ADDRESS",
+      "TOKEN_NOT_SUPPORTED",
+      "POOL_NOT_FOUND",
+      "RANGE_OUT_OF_BOUNDS",
+    ] satisfies ReadonlyArray<ValidateFailureCode>
+  ).includes(code as ValidateFailureCode);
+
+export const isActionFailureCode = (code: string): code is ActionFailureCode =>
+  (
+    [
+      "PROVIDER_REJECTED",
+      "SIGNATURE_REJECTED",
+      "STEWARD_UNAVAILABLE",
+      "ROUTE_NOT_FOUND",
+      "TRANSACTION_REVERTED",
+      "TIMEOUT",
+    ] satisfies ReadonlyArray<ActionFailureCode>
+  ).includes(code as ActionFailureCode);

package/src/actions/index.ts

@@ -0,0 +1 @@
+export * from "./failure-codes.js";

package/src/analytics/birdeye/actions/wallet-search-address.ts

@@ -0,0 +1,9 @@
+import { tokenInfoAction } from "../../token-info/action";
+
+/**
+ * Compatibility export for the old BIRDEYE_LOOKUP action module.
+ * Birdeye lookup is now TOKEN_INFO with target="birdeye".
+ */
+export const walletSearchAddressAction = tokenInfoAction;
+
+export default tokenInfoAction;

package/src/analytics/birdeye/birdeye-task.ts

@@ -0,0 +1,175 @@
+// @ts-nocheck -- legacy wallet sync task from absorbed Birdeye plugin; strict types pending cleanup
+import {
+  type Content,
+  createUniqueUuid,
+  type IAgentRuntime,
+  type ServiceTypeName,
+  type UUID,
+} from "@elizaos/core";
+import { BIRDEYE_SERVICE_NAME } from "./constants";
+import type { BirdeyeService } from "./service";
+import type {
+  BirdeyeSupportedChain,
+  Portfolio,
+  TransactionHistory,
+} from "./types/shared";
+import { extractChain } from "./utils";
+
+export interface SentimentContent extends Content {
+  text: string;
+  source: "sentiment-analysis";
+  metadata: {
+    timeslot: string;
+    processed: boolean;
+    occuringTokens?: Array<{
+      token: string;
+      sentiment: number;
+      reason: string;
+    }>;
+  };
+}
+
+export default class Birdeye {
+  apiKey: string;
+  sentimentRoomId: UUID;
+  twitterFeedRoomId: UUID;
+  runtime: IAgentRuntime;
+
+  pSrvBirdeye: Promise<unknown>;
+  beService!: BirdeyeService;
+
+  constructor(runtime: IAgentRuntime) {
+    this.apiKey = runtime.getSetting("BIRDEYE_API_KEY");
+    this.sentimentRoomId = createUniqueUuid(runtime, "sentiment-analysis");
+    this.twitterFeedRoomId = createUniqueUuid(runtime, "twitter-feed");
+    this.runtime = runtime;
+
+    this.pSrvBirdeye = runtime
+      .getServiceLoadPromise(BIRDEYE_SERVICE_NAME as ServiceTypeName)
+      .then(() => {
+        this.beService = this.runtime.getService(
+          BIRDEYE_SERVICE_NAME,
+        ) as BirdeyeService;
+      });
+  }
+
+  private async syncWalletHistory(
+    chain: BirdeyeSupportedChain,
+    publicKey: string,
+  ) {
+    try {
+      await this.pSrvBirdeye;
+
+      if (!this.beService) {
+        throw new Error("BirdeyeService not initialized");
+      }
+
+      const birdeyeData = await this.beService.fetchWalletTxList(
+        chain,
+        publicKey,
+      );
+
+      const transactions: TransactionHistory[] = birdeyeData.map(
+        (tx: { txHash: string; blockTime: number | string }) => ({
+          txHash: tx.txHash,
+          blockTime: new Date(tx.blockTime),
+          data: tx,
+        }),
+      );
+
+      try {
+        const cachedTxs = await this.runtime.getCache<TransactionHistory[]>(
+          "transaction_history",
+        );
+        if (cachedTxs && Array.isArray(cachedTxs)) {
+          for (const cachedTx of cachedTxs) {
+            if (!transactions.some((tx) => tx.txHash === cachedTx.txHash)) {
+              transactions.push(cachedTx);
+            }
+          }
+        }
+      } catch (_error) {
+        this.runtime.logger.debug(
+          "Failed to get cached transactions, continuing with Birdeye data only",
+        );
+      }
+
+      for (const tx of transactions) {
+        if (typeof tx.blockTime === "string") {
+          tx.blockTime = new Date(tx.blockTime);
+        }
+      }
+
+      transactions.sort(
+        (a, b) => b.blockTime.getTime() - a.blockTime.getTime(),
+      );
+
+      try {
+        await this.runtime.setCache<TransactionHistory[]>(
+          "transaction_history",
+          transactions,
+        );
+        this.runtime.logger.debug(
+          `Birdeye Task - Updated transaction history with ${transactions.length} transactions for ${publicKey}`,
+        );
+      } catch (error) {
+        this.runtime.logger.debug(
+          `Failed to set transaction cache, continuing without caching: ${
+            error instanceof Error ? error.message : String(error)
+          }`,
+        );
+      }
+
+      return transactions;
+    } catch (error) {
+      this.runtime.logger.error(
+        `Failed to sync wallet history from Birdeye: ${
+          error instanceof Error ? error.message : String(error)
+        }`,
+      );
+      return [];
+    }
+  }
+
+  private async syncWalletPortfolio(
+    chain: BirdeyeSupportedChain,
+    publicKey: string,
+  ) {
+    await this.pSrvBirdeye;
+
+    if (!this.beService) {
+      throw new Error("BirdeyeService not initialized");
+    }
+
+    const data = await this.beService.fetchWalletTokenList(chain, publicKey);
+
+    await this.runtime.setCache<Portfolio>("portfolio", {
+      key: "PORTFOLIO",
+      data,
+    });
+  }
+
+  async syncWallet() {
+    const walletAddr = this.runtime.getSetting("BIRDEYE_WALLET_ADDR");
+    if (!walletAddr) {
+      return;
+    }
+
+    const explicitChain = this.runtime.getSetting("BIRDEYE_CHAIN");
+
+    try {
+      const chain = extractChain(walletAddr, explicitChain);
+      await this.syncWalletHistory(chain, walletAddr);
+      await this.syncWalletPortfolio(chain, walletAddr);
+
+      return true;
+    } catch (error) {
+      this.runtime.logger?.error(
+        `Failed to sync wallet: ${
+          error instanceof Error ? error.message : String(error)
+        }`,
+      );
+      return false;
+    }
+  }
+}