@elizaos/plugin-wallet 2.0.0-beta.1

package/src/chains/evm/dex/uniswap/types.ts

@@ -0,0 +1,390 @@
+// @ts-nocheck — legacy code from absorbed plugins (lp-manager, lpinfo, dexscreener, defi-news, birdeye); strict types pending cleanup
+import type { Address } from "viem";
+
+/**
+ * Uniswap V3 specific types
+ */
+
+export const UNISWAP_V3_FEE_TIERS = {
+  LOWEST: 100, // 0.01%
+  LOW: 500, // 0.05%
+  MEDIUM: 3000, // 0.3%
+  HIGH: 10000, // 1%
+} as const;
+
+export type UniswapV3FeeTier = (typeof UNISWAP_V3_FEE_TIERS)[keyof typeof UNISWAP_V3_FEE_TIERS];
+
+export interface UniswapV3Pool {
+  address: Address;
+  token0: Address;
+  token1: Address;
+  fee: UniswapV3FeeTier;
+  tickSpacing: number;
+  liquidity: bigint;
+  sqrtPriceX96: bigint;
+  tick: number;
+}
+
+export interface UniswapV3Position {
+  tokenId: bigint;
+  nonce: bigint;
+  operator: Address;
+  token0: Address;
+  token1: Address;
+  fee: UniswapV3FeeTier;
+  tickLower: number;
+  tickUpper: number;
+  liquidity: bigint;
+  feeGrowthInside0LastX128: bigint;
+  feeGrowthInside1LastX128: bigint;
+  tokensOwed0: bigint;
+  tokensOwed1: bigint;
+}
+
+export interface UniswapV3MintParams {
+  token0: Address;
+  token1: Address;
+  fee: UniswapV3FeeTier;
+  tickLower: number;
+  tickUpper: number;
+  amount0Desired: bigint;
+  amount1Desired: bigint;
+  amount0Min: bigint;
+  amount1Min: bigint;
+  recipient: Address;
+  deadline: bigint;
+}
+
+export interface UniswapV3IncreaseLiquidityParams {
+  tokenId: bigint;
+  amount0Desired: bigint;
+  amount1Desired: bigint;
+  amount0Min: bigint;
+  amount1Min: bigint;
+  deadline: bigint;
+}
+
+export interface UniswapV3DecreaseLiquidityParams {
+  tokenId: bigint;
+  liquidity: bigint;
+  amount0Min: bigint;
+  amount1Min: bigint;
+  deadline: bigint;
+}
+
+export interface UniswapV3CollectParams {
+  tokenId: bigint;
+  recipient: Address;
+  amount0Max: bigint;
+  amount1Max: bigint;
+}
+
+// Contract addresses by chain
+export const UNISWAP_V3_ADDRESSES: Record<
+  number,
+  {
+    factory: Address;
+    nonfungiblePositionManager: Address;
+    swapRouter: Address;
+    quoter: Address;
+  }
+> = {
+  // Ethereum Mainnet
+  1: {
+    factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+    nonfungiblePositionManager: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+    swapRouter: "0xE592427A0AEce92De3Edee1F18E0157C05861564",
+    quoter: "0xb27308f9F90D607463bb33eA1BeBb41C27CE5AB6",
+  },
+  // Base
+  8453: {
+    factory: "0x33128a8fC17869897dcE68Ed026d694621f6FDfD",
+    nonfungiblePositionManager: "0x03a520b32C04BF3bEEf7BEb72E919cf822Ed34f1",
+    swapRouter: "0x2626664c2603336E57B271c5C0b26F421741e481",
+    quoter: "0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a",
+  },
+  // Arbitrum One
+  42161: {
+    factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+    nonfungiblePositionManager: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+    swapRouter: "0xE592427A0AEce92De3Edee1F18E0157C05861564",
+    quoter: "0xb27308f9F90D607463bb33eA1BeBb41C27CE5AB6",
+  },
+  // Polygon
+  137: {
+    factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+    nonfungiblePositionManager: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+    swapRouter: "0xE592427A0AEce92De3Edee1F18E0157C05861564",
+    quoter: "0xb27308f9F90D607463bb33eA1BeBb41C27CE5AB6",
+  },
+  // Optimism
+  10: {
+    factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+    nonfungiblePositionManager: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+    swapRouter: "0xE592427A0AEce92De3Edee1F18E0157C05861564",
+    quoter: "0xb27308f9F90D607463bb33eA1BeBb41C27CE5AB6",
+  },
+};
+
+// ABI fragments for Uniswap V3 contracts
+export const UNISWAP_V3_FACTORY_ABI = [
+  {
+    inputs: [
+      { name: "tokenA", type: "address" },
+      { name: "tokenB", type: "address" },
+      { name: "fee", type: "uint24" },
+    ],
+    name: "getPool",
+    outputs: [{ name: "pool", type: "address" }],
+    stateMutability: "view",
+    type: "function",
+  },
+] as const;
+
+export const UNISWAP_V3_POOL_ABI = [
+  {
+    inputs: [],
+    name: "token0",
+    outputs: [{ type: "address" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "token1",
+    outputs: [{ type: "address" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "fee",
+    outputs: [{ type: "uint24" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "tickSpacing",
+    outputs: [{ type: "int24" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "liquidity",
+    outputs: [{ type: "uint128" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "slot0",
+    outputs: [
+      { name: "sqrtPriceX96", type: "uint160" },
+      { name: "tick", type: "int24" },
+      { name: "observationIndex", type: "uint16" },
+      { name: "observationCardinality", type: "uint16" },
+      { name: "observationCardinalityNext", type: "uint16" },
+      { name: "feeProtocol", type: "uint8" },
+      { name: "unlocked", type: "bool" },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+] as const;
+
+export const UNISWAP_V3_POSITION_MANAGER_ABI = [
+  {
+    inputs: [{ name: "tokenId", type: "uint256" }],
+    name: "positions",
+    outputs: [
+      { name: "nonce", type: "uint96" },
+      { name: "operator", type: "address" },
+      { name: "token0", type: "address" },
+      { name: "token1", type: "address" },
+      { name: "fee", type: "uint24" },
+      { name: "tickLower", type: "int24" },
+      { name: "tickUpper", type: "int24" },
+      { name: "liquidity", type: "uint128" },
+      { name: "feeGrowthInside0LastX128", type: "uint256" },
+      { name: "feeGrowthInside1LastX128", type: "uint256" },
+      { name: "tokensOwed0", type: "uint128" },
+      { name: "tokensOwed1", type: "uint128" },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [{ name: "owner", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "index", type: "uint256" },
+    ],
+    name: "tokenOfOwnerByIndex",
+    outputs: [{ type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        components: [
+          { name: "token0", type: "address" },
+          { name: "token1", type: "address" },
+          { name: "fee", type: "uint24" },
+          { name: "tickLower", type: "int24" },
+          { name: "tickUpper", type: "int24" },
+          { name: "amount0Desired", type: "uint256" },
+          { name: "amount1Desired", type: "uint256" },
+          { name: "amount0Min", type: "uint256" },
+          { name: "amount1Min", type: "uint256" },
+          { name: "recipient", type: "address" },
+          { name: "deadline", type: "uint256" },
+        ],
+        name: "params",
+        type: "tuple",
+      },
+    ],
+    name: "mint",
+    outputs: [
+      { name: "tokenId", type: "uint256" },
+      { name: "liquidity", type: "uint128" },
+      { name: "amount0", type: "uint256" },
+      { name: "amount1", type: "uint256" },
+    ],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        components: [
+          { name: "tokenId", type: "uint256" },
+          { name: "amount0Desired", type: "uint256" },
+          { name: "amount1Desired", type: "uint256" },
+          { name: "amount0Min", type: "uint256" },
+          { name: "amount1Min", type: "uint256" },
+          { name: "deadline", type: "uint256" },
+        ],
+        name: "params",
+        type: "tuple",
+      },
+    ],
+    name: "increaseLiquidity",
+    outputs: [
+      { name: "liquidity", type: "uint128" },
+      { name: "amount0", type: "uint256" },
+      { name: "amount1", type: "uint256" },
+    ],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        components: [
+          { name: "tokenId", type: "uint256" },
+          { name: "liquidity", type: "uint128" },
+          { name: "amount0Min", type: "uint256" },
+          { name: "amount1Min", type: "uint256" },
+          { name: "deadline", type: "uint256" },
+        ],
+        name: "params",
+        type: "tuple",
+      },
+    ],
+    name: "decreaseLiquidity",
+    outputs: [
+      { name: "amount0", type: "uint256" },
+      { name: "amount1", type: "uint256" },
+    ],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        components: [
+          { name: "tokenId", type: "uint256" },
+          { name: "recipient", type: "address" },
+          { name: "amount0Max", type: "uint128" },
+          { name: "amount1Max", type: "uint128" },
+        ],
+        name: "params",
+        type: "tuple",
+      },
+    ],
+    name: "collect",
+    outputs: [
+      { name: "amount0", type: "uint256" },
+      { name: "amount1", type: "uint256" },
+    ],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [{ name: "tokenId", type: "uint256" }],
+    name: "burn",
+    outputs: [],
+    stateMutability: "payable",
+    type: "function",
+  },
+] as const;
+
+export const ERC20_ABI = [
+  {
+    inputs: [],
+    name: "symbol",
+    outputs: [{ type: "string" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "decimals",
+    outputs: [{ type: "uint8" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "name",
+    outputs: [{ type: "string" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [{ name: "account", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { name: "spender", type: "address" },
+      { name: "amount", type: "uint256" },
+    ],
+    name: "approve",
+    outputs: [{ type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" },
+    ],
+    name: "allowance",
+    outputs: [{ type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+] as const;

package/src/chains/evm/generated/specs/spec-helpers.ts

@@ -0,0 +1,73 @@
+/**
+ * Helper functions to lookup action/provider specs by name.
+ * These allow language-specific implementations to import their text content
+ * (description, similes, examples) from the centralized specs.
+ *
+ * DO NOT EDIT the spec data - update prompts/actions.json, prompts/providers.json and regenerate.
+ */
+
+import {
+  type ActionDoc,
+  allActionDocs,
+  allProviderDocs,
+  coreActionDocs,
+  coreProviderDocs,
+  type ProviderDoc,
+} from "./specs";
+
+// Build lookup maps for O(1) access
+const coreActionMap = new Map<string, ActionDoc>(coreActionDocs.map((doc) => [doc.name, doc]));
+const allActionMap = new Map<string, ActionDoc>(allActionDocs.map((doc) => [doc.name, doc]));
+const coreProviderMap = new Map<string, ProviderDoc>(
+  coreProviderDocs.map((doc) => [doc.name, doc])
+);
+const allProviderMap = new Map<string, ProviderDoc>(allProviderDocs.map((doc) => [doc.name, doc]));
+
+/**
+ * Get an action spec by name from the core specs.
+ * @param name - The action name
+ * @returns The action spec or undefined if not found
+ */
+export function getActionSpec(name: string): ActionDoc | undefined {
+  return coreActionMap.get(name) ?? allActionMap.get(name);
+}
+
+/**
+ * Get an action spec by name, throwing if not found.
+ * @param name - The action name
+ * @returns The action spec
+ * @throws Error if the action is not found
+ */
+export function requireActionSpec(name: string): ActionDoc {
+  const spec = getActionSpec(name);
+  if (!spec) {
+    throw new Error(`Action spec not found: ${name}`);
+  }
+  return spec;
+}
+
+/**
+ * Get a provider spec by name from the core specs.
+ * @param name - The provider name
+ * @returns The provider spec or undefined if not found
+ */
+export function getProviderSpec(name: string): ProviderDoc | undefined {
+  return coreProviderMap.get(name) ?? allProviderMap.get(name);
+}
+
+/**
+ * Get a provider spec by name, throwing if not found.
+ * @param name - The provider name
+ * @returns The provider spec
+ * @throws Error if the provider is not found
+ */
+export function requireProviderSpec(name: string): ProviderDoc {
+  const spec = getProviderSpec(name);
+  if (!spec) {
+    throw new Error(`Provider spec not found: ${name}`);
+  }
+  return spec;
+}
+
+// Re-export types for convenience
+export type { ActionDoc, ProviderDoc };

package/src/chains/evm/generated/specs/specs.ts

@@ -0,0 +1,151 @@
+/**
+ * Auto-generated canonical action/provider docs for plugin-wallet evm chain.
+ * DO NOT EDIT - Generated from prompts/specs/**.
+ */
+
+export type ActionDoc = {
+  name: string;
+  description: string;
+  descriptionCompressed?: string;
+  similes?: readonly string[];
+  parameters?: readonly unknown[];
+  examples?: readonly (readonly unknown[])[];
+};
+
+export type ProviderDoc = {
+  name: string;
+  description: string;
+  descriptionCompressed?: string;
+  position?: number;
+  dynamic?: boolean;
+};
+
+export const coreActionsSpec = {
+  version: "1.0.0",
+  actions: [
+    {
+      name: "EVM_TRANSFER",
+      description: "Transfer tokens from the agent's EVM wallet to another address",
+      descriptionCompressed: "EVM transfer: send native or ERC-20 tokens to another address.",
+      similes: [
+        "TRANSFER",
+        "SEND_TOKENS",
+        "SEND_TOKEN",
+        "TRANSFER_TOKEN",
+        "TRANSFER_TOKENS",
+        "EVM_SEND_TOKENS",
+      ],
+    },
+    {
+      name: "EVM_SWAP",
+      description: "Swap tokens on a decentralized exchange",
+      descriptionCompressed: "EVM token swap on a DEX (Lifi/Bebop routing).",
+      similes: ["SWAP_TOKENS", "SWAP_TOKEN"],
+    },
+    {
+      name: "CROSS_CHAIN_TRANSFER",
+      description: "Bridge tokens to another chain",
+      descriptionCompressed: "Bridge ERC-20 tokens between EVM chains via Lifi.",
+      similes: ["BRIDGE", "BRIDGE_TOKENS"],
+    },
+    {
+      name: "WALLET_GOV",
+      description: "OZ-Governor governance op: { op: 'propose' | 'vote' | 'queue' | 'execute' }",
+      descriptionCompressed: "OZ-Governor op: propose, vote, queue, or execute (op switch).",
+      similes: [
+        "GOV_PROPOSE",
+        "GOV_VOTE",
+        "GOV_QUEUE",
+        "GOV_EXECUTE",
+        "GOVERNANCE_VOTE",
+        "QUEUE_PROPOSAL",
+        "EXECUTE_PROPOSAL",
+        "PROPOSE",
+      ],
+    },
+  ],
+} as const;
+export const allActionsSpec = {
+  version: "1.0.0",
+  actions: [
+    {
+      name: "EVM_TRANSFER",
+      description: "Transfer tokens from the agent's EVM wallet to another address",
+      descriptionCompressed: "EVM transfer: send native or ERC-20 tokens to another address.",
+      similes: [
+        "TRANSFER",
+        "SEND_TOKENS",
+        "SEND_TOKEN",
+        "TRANSFER_TOKEN",
+        "TRANSFER_TOKENS",
+        "EVM_SEND_TOKENS",
+      ],
+    },
+    {
+      name: "EVM_SWAP",
+      description: "Swap tokens on a decentralized exchange",
+      descriptionCompressed: "EVM token swap on a DEX (Lifi/Bebop routing).",
+      similes: ["SWAP_TOKENS", "SWAP_TOKEN"],
+    },
+    {
+      name: "CROSS_CHAIN_TRANSFER",
+      description: "Bridge tokens to another chain",
+      descriptionCompressed: "Bridge ERC-20 tokens between EVM chains via Lifi.",
+      similes: ["BRIDGE", "BRIDGE_TOKENS"],
+    },
+    {
+      name: "WALLET_GOV",
+      description: "OZ-Governor governance op: { op: 'propose' | 'vote' | 'queue' | 'execute' }",
+      descriptionCompressed: "OZ-Governor op: propose, vote, queue, or execute (op switch).",
+      similes: [
+        "GOV_PROPOSE",
+        "GOV_VOTE",
+        "GOV_QUEUE",
+        "GOV_EXECUTE",
+        "GOVERNANCE_VOTE",
+        "QUEUE_PROPOSAL",
+        "EXECUTE_PROPOSAL",
+        "PROPOSE",
+      ],
+    },
+  ],
+} as const;
+export const coreProvidersSpec = {
+  version: "1.0.0",
+  providers: [
+    {
+      name: "wallet",
+      description: "EVM wallet address and balances",
+      descriptionCompressed: "EVM wallet address and balances.",
+      dynamic: true,
+    },
+    {
+      name: "get-balance",
+      description: "Token balance for ERC20 tokens when onchain actions are requested",
+      descriptionCompressed: "ERC20 token balance for onchain actions.",
+      dynamic: true,
+    },
+  ],
+} as const;
+export const allProvidersSpec = {
+  version: "1.0.0",
+  providers: [
+    {
+      name: "wallet",
+      description: "EVM wallet address and balances",
+      descriptionCompressed: "EVM wallet address and balances.",
+      dynamic: true,
+    },
+    {
+      name: "get-balance",
+      description: "Token balance for ERC20 tokens when onchain actions are requested",
+      descriptionCompressed: "ERC20 token balance for onchain actions.",
+      dynamic: true,
+    },
+  ],
+} as const;
+
+export const coreActionDocs: readonly ActionDoc[] = coreActionsSpec.actions;
+export const allActionDocs: readonly ActionDoc[] = allActionsSpec.actions;
+export const coreProviderDocs: readonly ProviderDoc[] = coreProvidersSpec.providers;
+export const allProviderDocs: readonly ProviderDoc[] = allProvidersSpec.providers;