@agentlayer.tech/wallet 0.1.93 → 0.1.95

package/.openclaw/extensions/agent-wallet/dist/index.js

@@ -29,6 +29,7 @@ const AUTONOMOUS_DEFI_TOOLS = new Set([
   "manage_evm_lido_withdrawal",
   "manage_evm_morpho_market_position",
   "manage_evm_morpho_vault_position",
+  "manage_evm_uniswap_liquidity",
 ]);
 const approvalPreviewCache = new Map();
 const WALLET_TOOL_ONLY_GUIDANCE =
@@ -1977,6 +1978,61 @@ const evmToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "search_uniswap_pairs",
+    description: "Search read-only onchain Uniswap-tradeable pairs by name, ticker, or ERC-20 address. Verify any returned token address independently before quoting or trading.",
+    parameters: {
+      type: "object",
+      properties: {
+        query: { type: "string" },
+        token_address: { type: "string" },
+        chain: { type: "string" },
+        dex_id: { type: "string" },
+        all_chains: { type: "boolean" },
+        limit: { type: "integer" },
+        network: { type: "string", enum: EVM_CORE_NETWORKS },
+      },
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "get_evm_uniswap_pools",
+    description: "Find existing Uniswap V3/V4 pools through the official Pool Info API on ethereum, base, or robinhood. Returns the canonical poolReferenceIdentifier needed for an LP create request. Read-only: it does not approve, sign, or execute anything.",
+    parameters: {
+      type: "object",
+      properties: {
+        protocol: { type: "string", enum: ["V3", "V4"] },
+        pool_parameters: {
+          type: "object",
+          description: "Official Pool Info API token-pair parameters, such as tokenAddressA, tokenAddressB and optional fee/tickSpacing/hooks.",
+          additionalProperties: true,
+        },
+        pool_references: {
+          type: "array",
+          maxItems: 20,
+          items: { type: "object", additionalProperties: true },
+        },
+        page_size: { type: "integer", minimum: 1, maximum: 20 },
+        current_page: { type: "integer", minimum: 1 },
+        network: { type: "string", enum: EVM_CORE_NETWORKS },
+      },
+      required: ["protocol"],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "get_evm_uniswap_positions",
+    description: "List the active wallet's Uniswap V3 LP NFTs on ethereum, base, or robinhood. Returns token ids, token pair, fee tier, ticks, liquidity, and owed fees. Read-only. V4 is excluded because its PositionManager is not enumerable without a verified indexed source.",
+    parameters: {
+      type: "object",
+      properties: {
+        protocol: { type: "string", enum: ["V3"] },
+        limit: { type: "integer", minimum: 1, maximum: 100 },
+        network: { type: "string", enum: EVM_CORE_NETWORKS },
+      },
+      additionalProperties: false,
+    },
+  },
   {
     name: "swap_evm_uniswap_tokens",
     description: "Preview, prepare, or execute a supported Uniswap path on ethereum, base, or robinhood: CLASSIC, UniswapX orders, or canonical ETH↔WETH wrap/unwrap. ERC-20 paths may use Permit2 EIP-712 or an UniswapX order signature. Preview or prepare first. After the user explicitly confirms the shown summary in chat, call execute; the OpenClaw plugin handles the internal execution authorization automatically.",
@@ -1997,6 +2053,29 @@ const evmToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "manage_evm_uniswap_liquidity",
+    description: "Preview, prepare, or execute a Uniswap V3/V4 liquidity action on ethereum, base, or robinhood. Supported actions are create, increase, decrease, and claim_fees. Create needs existingPool.poolReference and position actions need an NFT token id: use get_evm_uniswap_pools or the V3 get_evm_uniswap_positions scanner to obtain them, never guess. The official Liquidity API builds the transaction again immediately before signing, so confirmation is scoped to the LP intent rather than fragile ticks or calldata.",
+    optional: true,
+    parameters: {
+      type: "object",
+      properties: {
+        action: { type: "string", enum: ["create", "increase", "decrease", "claim_fees"] },
+        protocol: { type: "string", enum: ["V3", "V4"] },
+        request: {
+          type: "object",
+          description: "Official Uniswap Liquidity API fields. walletAddress, chainId, protocol, simulateTransaction, and permit/signature fields are controlled by the wallet.",
+          additionalProperties: true,
+        },
+        mode: { type: "string", enum: ["preview", "prepare", "execute"] },
+        purpose: { type: "string" },
+        user_intent: { type: "boolean" },
+        network: { type: "string", enum: EVM_CORE_NETWORKS },
+      },
+      required: ["action", "protocol", "request", "mode", "purpose"],
+      additionalProperties: false,
+    },
+  },
   {
     name: "swap_evm_lifi_cross_chain_tokens",
     description: "Preview, prepare, or execute an EVM-origin cross-chain swap through LI.FI. This currently supports ethereum/base as the source network and ethereum/base/solana as the destination chain. Preview or prepare first. After the user explicitly confirms the shown summary in chat, call execute; the OpenClaw plugin handles the internal execution authorization automatically.",

package/.openclaw/extensions/agent-wallet/index.ts

@@ -29,6 +29,7 @@ const AUTONOMOUS_DEFI_TOOLS = new Set([
   "manage_evm_lido_withdrawal",
   "manage_evm_morpho_market_position",
   "manage_evm_morpho_vault_position",
+  "manage_evm_uniswap_liquidity",
 ]);
 const approvalPreviewCache = new Map();
 const WALLET_TOOL_ONLY_GUIDANCE =
@@ -1977,6 +1978,61 @@ const evmToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "search_uniswap_pairs",
+    description: "Search read-only onchain Uniswap-tradeable pairs by name, ticker, or ERC-20 address. Verify any returned token address independently before quoting or trading.",
+    parameters: {
+      type: "object",
+      properties: {
+        query: { type: "string" },
+        token_address: { type: "string" },
+        chain: { type: "string" },
+        dex_id: { type: "string" },
+        all_chains: { type: "boolean" },
+        limit: { type: "integer" },
+        network: { type: "string", enum: EVM_CORE_NETWORKS },
+      },
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "get_evm_uniswap_pools",
+    description: "Find existing Uniswap V3/V4 pools through the official Pool Info API on ethereum, base, or robinhood. Returns the canonical poolReferenceIdentifier needed for an LP create request. Read-only: it does not approve, sign, or execute anything.",
+    parameters: {
+      type: "object",
+      properties: {
+        protocol: { type: "string", enum: ["V3", "V4"] },
+        pool_parameters: {
+          type: "object",
+          description: "Official Pool Info API token-pair parameters, such as tokenAddressA, tokenAddressB and optional fee/tickSpacing/hooks.",
+          additionalProperties: true,
+        },
+        pool_references: {
+          type: "array",
+          maxItems: 20,
+          items: { type: "object", additionalProperties: true },
+        },
+        page_size: { type: "integer", minimum: 1, maximum: 20 },
+        current_page: { type: "integer", minimum: 1 },
+        network: { type: "string", enum: EVM_CORE_NETWORKS },
+      },
+      required: ["protocol"],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "get_evm_uniswap_positions",
+    description: "List the active wallet's Uniswap V3 LP NFTs on ethereum, base, or robinhood. Returns token ids, token pair, fee tier, ticks, liquidity, and owed fees. Read-only. V4 is excluded because its PositionManager is not enumerable without a verified indexed source.",
+    parameters: {
+      type: "object",
+      properties: {
+        protocol: { type: "string", enum: ["V3"] },
+        limit: { type: "integer", minimum: 1, maximum: 100 },
+        network: { type: "string", enum: EVM_CORE_NETWORKS },
+      },
+      additionalProperties: false,
+    },
+  },
   {
     name: "swap_evm_uniswap_tokens",
     description: "Preview, prepare, or execute a supported Uniswap path on ethereum, base, or robinhood: CLASSIC, UniswapX orders, or canonical ETH↔WETH wrap/unwrap. ERC-20 paths may use Permit2 EIP-712 or an UniswapX order signature. Preview or prepare first. After the user explicitly confirms the shown summary in chat, call execute; the OpenClaw plugin handles the internal execution authorization automatically.",
@@ -1997,6 +2053,29 @@ const evmToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "manage_evm_uniswap_liquidity",
+    description: "Preview, prepare, or execute a Uniswap V3/V4 liquidity action on ethereum, base, or robinhood. Supported actions are create, increase, decrease, and claim_fees. Create needs existingPool.poolReference and position actions need an NFT token id: use get_evm_uniswap_pools or the V3 get_evm_uniswap_positions scanner to obtain them, never guess. The official Liquidity API builds the transaction again immediately before signing, so confirmation is scoped to the LP intent rather than fragile ticks or calldata.",
+    optional: true,
+    parameters: {
+      type: "object",
+      properties: {
+        action: { type: "string", enum: ["create", "increase", "decrease", "claim_fees"] },
+        protocol: { type: "string", enum: ["V3", "V4"] },
+        request: {
+          type: "object",
+          description: "Official Uniswap Liquidity API fields. walletAddress, chainId, protocol, simulateTransaction, and permit/signature fields are controlled by the wallet.",
+          additionalProperties: true,
+        },
+        mode: { type: "string", enum: ["preview", "prepare", "execute"] },
+        purpose: { type: "string" },
+        user_intent: { type: "boolean" },
+        network: { type: "string", enum: EVM_CORE_NETWORKS },
+      },
+      required: ["action", "protocol", "request", "mode", "purpose"],
+      additionalProperties: false,
+    },
+  },
   {
     name: "swap_evm_lifi_cross_chain_tokens",
     description: "Preview, prepare, or execute an EVM-origin cross-chain swap through LI.FI. This currently supports ethereum/base as the source network and ethereum/base/solana as the destination chain. Preview or prepare first. After the user explicitly confirms the shown summary in chat, call execute; the OpenClaw plugin handles the internal execution authorization automatically.",

package/.openclaw/extensions/agent-wallet/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "agent-wallet",
   "name": "Agent Wallet",
   "description": "Official OpenClaw plugin bridge for the agent-wallet backends, including Solana, local BTC, and local EVM.",
-  "version": "0.1.93",
+  "version": "0.1.95",
   "contracts": {
     "tools": [
       "agentlayer_autonomous_approve",
@@ -30,6 +30,7 @@
       "get_evm_token_balance",
       "get_evm_token_metadata",
       "get_evm_transaction_receipt",
+      "get_uniswap_swap_quote",
       "get_flash_trade_markets",
       "get_flash_trade_positions",
       "get_kamino_earn_positions",
@@ -61,11 +62,15 @@
       "manage_evm_morpho_vault_position",
       "manage_evm_lido_position",
       "manage_evm_lido_withdrawal",
+      "manage_evm_uniswap_liquidity",
       "search_uniswap_pairs",
+      "get_evm_uniswap_pools",
+      "get_evm_uniswap_positions",
       "set_evm_network",
       "set_wallet_backend",
       "sign_wallet_message",
       "swap_evm_lifi_cross_chain_tokens",
+      "swap_evm_uniswap_tokens",
       "swap_evm_tokens",
       "swap_solana_lifi_cross_chain_tokens",
       "swap_solana_tokens",

package/.openclaw/extensions/agent-wallet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayertech/agent-wallet-plugin",
-  "version": "0.1.93",
+  "version": "0.1.95",
   "description": "OpenClaw plugin bridge for the AgentLayer wallet runtime.",
   "type": "module",
   "license": "SEE LICENSE IN ../../../LICENSE",

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## Unreleased
 
+## v0.1.94 - 2026-08-13
+
+- **Added Uniswap V3/V4 liquidity provisioning for Ethereum, Base, and
+  Robinhood Chain.** The EVM wallet now previews, prepares, and executes
+  create, increase, decrease, and fee-claim actions through Uniswap's
+  Liquidity API. Final LP calldata is refreshed and simulated immediately
+  before signing; executable transactions are accepted only for pinned
+  PositionManager deployments and matching wallet/network fields.
+- **Added bounded LP approval handling and intent-safe confirmations.** Token
+  approvals are restricted to LP-request assets and approved spenders, while
+  confirmations bind the action, network, protocol, pool/position, and assets
+  rather than fast-expiring ticks or calldata. Single-sided concentrated
+  positions with a zero amount on one ERC-20 side no longer fail approval
+  discovery.
+- **Exposed LP actions through the provider gateway, OpenClaw, and Codex.**
+  The provider gateway forwards the existing shared Uniswap API key to the
+  Liquidity API; OpenClaw's pair-search contract was restored and registered.
+
 ## v0.1.93 - 2026-08-10
 
 - **Added `/cards` (Claude Code) and `cards` (Codex) for Laso Finance card

package/VERSION

@@ -1 +1 @@
-0.1.93
+0.1.95

package/agent-wallet/agent_wallet/__init__.py

@@ -2,7 +2,7 @@
 
 # Keep in sync with package.json, pyproject.toml, and the npm installer version.
 # scripts/check_release_version.mjs enforces this on release.
-__version__ = "0.1.93"
+__version__ = "0.1.95"
 
 __all__ = [
     "config",

package/agent-wallet/agent_wallet/autonomous_permissions.py

@@ -31,6 +31,7 @@ DEFI_TOOLS = frozenset(
         "manage_evm_lido_withdrawal",
         "manage_evm_morpho_market_position",
         "manage_evm_morpho_vault_position",
+        "manage_evm_uniswap_liquidity",
     }
 )
 DEFI_TOOLS_ISSUER = "autonomous-permission:defi-tools"

package/agent-wallet/agent_wallet/openclaw_adapter.py

@@ -751,6 +751,28 @@ class OpenClawWalletAdapter:
                 "quote_fingerprint": provided_fingerprint,
             }
 
+        if asset_type == "evm-uniswap-liquidity":
+            request = payload.get("request") if isinstance(payload.get("request"), dict) else {}
+            existing_pool = request.get("existingPool") if isinstance(request.get("existingPool"), dict) else {}
+            return {
+                "operation": action_label,
+                "network": str(payload.get("network") or getattr(self.backend, "network", "unknown")),
+                "from_address": payload.get("from_address"),
+                "protocol": payload.get("protocol"),
+                "liquidity_action": payload.get("liquidity_action"),
+                "liquidity_protocol": payload.get("liquidity_protocol"),
+                # Intent binds to the action and caller-provided LP scope, not a
+                # per-block transaction hash, adjusted ticks, or calculated amount.
+                "token0_address": request.get("token0Address") or existing_pool.get("token0Address"),
+                "token1_address": request.get("token1Address") or existing_pool.get("token1Address"),
+                "pool_reference": existing_pool.get("poolReference"),
+                "position_token_id": request.get("nftTokenId") or request.get("tokenId") or payload.get("position_token_id"),
+                "independent_token": request.get("independentToken"),
+                "liquidity_percentage_to_decrease": request.get("liquidityPercentageToDecrease"),
+                "slippage_tolerance": request.get("slippageTolerance"),
+                "position_manager": payload.get("position_manager"),
+            }
+
         if asset_type == "evm-morpho-vault":
             return {
                 "operation": action_label,
@@ -1722,6 +1744,85 @@ class OpenClawWalletAdapter:
                         risk_level="low",
                     ),
                 )
+                tools.insert(
+                    13,
+                    AgentToolSpec(
+                        name="get_evm_uniswap_pools",
+                        description=(
+                            "Find existing Uniswap V3/V4 pool metadata on ethereum, base, or robinhood using the official "
+                            "Uniswap Pool Info API. Returns the canonical poolReferenceIdentifier required to create liquidity; "
+                            "this is read-only and does not approve, sign, or execute anything."
+                        ),
+                        input_schema={
+                            "type": "object",
+                            "properties": {
+                                "protocol": {"type": "string", "enum": ["V3", "V4"]},
+                                "pool_parameters": {"type": "object", "description": "Official Pool Info API token-pair parameters, such as tokenAddressA, tokenAddressB and optional fee/tickSpacing/hooks.", "additionalProperties": True},
+                                "pool_references": {"type": "array", "maxItems": 20, "items": {"type": "object", "additionalProperties": True}, "description": "One to twenty official Pool Info API pool reference objects."},
+                                "page_size": {"type": "integer", "minimum": 1, "maximum": 20},
+                                "current_page": {"type": "integer", "minimum": 1},
+                                "network": {"type": "string", "enum": ["ethereum", "base", "robinhood"]},
+                            },
+                            "required": ["protocol"],
+                            "additionalProperties": False,
+                        },
+                        read_only=True,
+                        risk_level="low",
+                    ),
+                )
+                tools.insert(
+                    14,
+                    AgentToolSpec(
+                        name="get_evm_uniswap_positions",
+                        description=(
+                            "List read-only Uniswap V3 LP position NFTs owned by the active wallet on ethereum, base, or robinhood. "
+                            "Returns NFT token ids, tokens, fee tier, tick range, liquidity, and currently owed fees. V4 discovery is "
+                            "not exposed until a verified indexed source is configured because V4 PositionManager is not enumerable."
+                        ),
+                        input_schema={
+                            "type": "object",
+                            "properties": {
+                                "protocol": {"type": "string", "enum": ["V3"], "description": "V3 is the currently enumerable, on-chain-supported position scanner."},
+                                "limit": {"type": "integer", "minimum": 1, "maximum": 100},
+                                "network": {"type": "string", "enum": ["ethereum", "base", "robinhood"]},
+                            },
+                            "additionalProperties": False,
+                        },
+                        read_only=True,
+                        risk_level="low",
+                    ),
+                )
+                tools.insert(
+                    15,
+                    AgentToolSpec(
+                        name="manage_evm_uniswap_liquidity",
+                        description=(
+                            "Preview, prepare, or execute a Uniswap V3/V4 liquidity action on ethereum, base, or robinhood. "
+                            "Supported actions are create, increase, decrease, and claim_fees. The request is passed to the "
+                            "official Uniswap Liquidity API; execute refreshes the transaction immediately before signing. "
+                            "Create requires existingPool.poolReference; increase/decrease/claim_fees require a position NFT token id. "
+                            "Use get_evm_uniswap_pools or get_evm_uniswap_positions to obtain these identifiers; never guess them."
+                        ),
+                        input_schema={
+                            "type": "object",
+                            "properties": {
+                                "action": {"type": "string", "enum": ["create", "increase", "decrease", "claim_fees"]},
+                                "protocol": {"type": "string", "enum": ["V3", "V4"]},
+                                "request": {"type": "object", "description": "Uniswap LP API fields excluding walletAddress, chainId, protocol, and simulateTransaction; those are set from the active wallet.", "additionalProperties": True},
+                                "mode": {"type": "string", "enum": ["preview", "prepare", "execute"]},
+                                "purpose": {"type": "string"},
+                                "user_intent": {"type": "boolean"},
+                                "approval_token": {"type": "string"},
+                                "network": {"type": "string", "enum": ["ethereum", "base", "robinhood"]},
+                            },
+                            "required": ["action", "protocol", "request", "mode", "purpose"],
+                            "additionalProperties": False,
+                        },
+                        read_only=False,
+                        requires_explicit_user_intent=True,
+                        risk_level="high",
+                    ),
+                )
                 tools.insert(
                     14,
                     AgentToolSpec(
@@ -5631,6 +5732,46 @@ class OpenClawWalletAdapter:
                 )
                 return AgentToolResult(tool=tool_name, ok=True, data=data)
 
+            if tool_name == "get_evm_uniswap_pools":
+                protocol = args.get("protocol")
+                pool_parameters = args.get("pool_parameters")
+                pool_references = args.get("pool_references")
+                page_size = args.get("page_size", 20)
+                current_page = args.get("current_page", 1)
+                if protocol not in {"V3", "V4"}:
+                    raise WalletBackendError("protocol must be V3 or V4.")
+                if (pool_parameters is None) == (pool_references is None):
+                    raise WalletBackendError("Provide exactly one of pool_parameters or pool_references.")
+                if pool_parameters is not None and not isinstance(pool_parameters, dict):
+                    raise WalletBackendError("pool_parameters must be an object.")
+                if pool_references is not None:
+                    if not isinstance(pool_references, list) or not 1 <= len(pool_references) <= 20:
+                        raise WalletBackendError("pool_references must contain between 1 and 20 objects.")
+                    if any(not isinstance(reference, dict) for reference in pool_references):
+                        raise WalletBackendError("pool_references must contain only objects.")
+                if not isinstance(page_size, int) or not 1 <= page_size <= 20:
+                    raise WalletBackendError("page_size must be an integer between 1 and 20.")
+                if not isinstance(current_page, int) or current_page < 1:
+                    raise WalletBackendError("current_page must be a positive integer.")
+                data = await active_backend.get_uniswap_liquidity_pools(
+                    protocol=protocol,
+                    pool_parameters=pool_parameters,
+                    pool_references=pool_references,
+                    page_size=page_size,
+                    current_page=current_page,
+                )
+                return AgentToolResult(tool=tool_name, ok=True, data=data)
+
+            if tool_name == "get_evm_uniswap_positions":
+                protocol = args.get("protocol", "V3")
+                limit = args.get("limit", 20)
+                if protocol != "V3":
+                    raise WalletBackendError("Only V3 position discovery is currently available; V4 PositionManager is not enumerable.")
+                if not isinstance(limit, int) or not 1 <= limit <= 100:
+                    raise WalletBackendError("limit must be an integer between 1 and 100.")
+                data = await active_backend.get_uniswap_liquidity_positions(protocol=protocol, limit=limit)
+                return AgentToolResult(tool=tool_name, ok=True, data=data)
+
             if tool_name == "swap_evm_uniswap_tokens":
                 token_in = args.get("token_in")
                 token_out = args.get("token_out")
@@ -5757,6 +5898,127 @@ class OpenClawWalletAdapter:
                     ),
                 )
 
+            if tool_name == "manage_evm_uniswap_liquidity":
+                action = args.get("action")
+                protocol = args.get("protocol")
+                request = args.get("request")
+                mode = args.get("mode")
+                purpose = args.get("purpose")
+                user_intent = args.get("user_intent", False)
+                approval_token = args.get("approval_token")
+                if action not in {"create", "increase", "decrease", "claim_fees"}:
+                    raise WalletBackendError("action must be create, increase, decrease, or claim_fees.")
+                if protocol not in {"V3", "V4"}:
+                    raise WalletBackendError("protocol must be V3 or V4.")
+                if not isinstance(request, dict):
+                    raise WalletBackendError("request must be an object.")
+                if mode not in {"preview", "prepare", "execute"}:
+                    raise WalletBackendError("mode must be 'preview', 'prepare' or 'execute'.")
+                if not isinstance(purpose, str) or not purpose.strip():
+                    raise WalletBackendError("purpose is required.")
+                normalized_request = dict(request)
+                if action == "create":
+                    existing_pool = normalized_request.get("existingPool")
+                    if not isinstance(existing_pool, dict):
+                        raise WalletBackendError(
+                            "create requires existingPool with token0Address, token1Address, and poolReference. "
+                            "Use get_evm_uniswap_pools to obtain the exact existing pool; do not infer it from market search data."
+                        )
+                    missing_pool_fields = [
+                        field
+                        for field in ("token0Address", "token1Address", "poolReference")
+                        if not isinstance(existing_pool.get(field), str) or not existing_pool[field].strip()
+                    ]
+                    if missing_pool_fields:
+                        raise WalletBackendError(
+                            "create existingPool is missing "
+                            f"{', '.join(missing_pool_fields)}. Ask the user for the exact existing Uniswap pool; do not infer it from market search data."
+                        )
+                elif action in {"increase", "decrease"}:
+                    nft_token_id = normalized_request.get("nftTokenId")
+                    if not isinstance(nft_token_id, str) or not nft_token_id.strip().isdigit() or int(nft_token_id.strip()) <= 0:
+                        raise WalletBackendError(
+                            f"{action} requires a positive nftTokenId. Use get_evm_uniswap_positions for V3 or request a verified V4 token id; never infer it."
+                        )
+                    normalized_request["nftTokenId"] = nft_token_id.strip()
+                else:  # claim_fees
+                    token_id = normalized_request.get("tokenId", normalized_request.get("nftTokenId"))
+                    if not isinstance(token_id, str) or not token_id.strip().isdigit() or int(token_id.strip()) <= 0:
+                        raise WalletBackendError(
+                            "claim_fees requires the user's positive tokenId (the LP position NFT id). "
+                            "Use get_evm_uniswap_positions for V3 or request a verified V4 token id; never infer it."
+                        )
+                    # The Liquidity API names this field tokenId for fee claims;
+                    # accept nftTokenId as the user-facing alias used by other LP actions.
+                    normalized_request["tokenId"] = token_id.strip()
+                    normalized_request.pop("nftTokenId", None)
+                # The caller must not override values that are derived from the
+                # active wallet/network in the WDK layer.
+                forbidden = {"walletAddress", "chainId", "protocol", "simulateTransaction", "signature", "batchPermitData", "v4BatchPermitData", "v3NftPermitData"}
+                overlap = forbidden.intersection(request)
+                if overlap:
+                    raise WalletBackendError(f"request must not set wallet-controlled fields: {', '.join(sorted(overlap))}.")
+                preview_kwargs = {"action": action, "protocol": protocol, "request": normalized_request}
+                if mode == "preview":
+                    preview = await active_backend.preview_uniswap_liquidity(**preview_kwargs)
+                    return AgentToolResult(tool=tool_name, ok=True, data=self._annotate_sensitive_payload(preview, action_label="Uniswap liquidity", mode="preview"))
+                if mode == "prepare":
+                    self._require_prepare_intent(user_intent)
+                    preview = await active_backend.preview_uniswap_liquidity(**preview_kwargs)
+                    return AgentToolResult(tool=tool_name, ok=True, data=self._annotate_sensitive_payload(self._build_prepare_plan(preview_payload=preview, action_label="Uniswap liquidity"), action_label="Uniswap liquidity", mode="prepare"))
+                if isinstance(approval_token, str) and approval_token.strip():
+                    approval_payload = inspect_approval_token(
+                        approval_token,
+                        tool_name=tool_name,
+                        network=str(getattr(active_backend, "network", "unknown")),
+                        require_mainnet_confirmation=self._is_mainnet_for_backend(active_backend),
+                    )
+                    approval_summary = approval_payload.get("binding", {}).get("summary")
+                    if not isinstance(approval_summary, dict):
+                        raise WalletBackendError("approval_token does not match the requested LP operation. Generate a new approval after prepare.")
+                    approval_summary_copy = dict(approval_summary)
+                else:
+                    fresh_preview = await active_backend.preview_uniswap_liquidity(**preview_kwargs)
+                    approval_summary_copy = self._build_confirmation_summary(action_label="Uniswap liquidity", payload=fresh_preview)
+                expected = {
+                    "operation": "Uniswap liquidity",
+                    "network": str(getattr(active_backend, "network", "unknown")),
+                    "liquidity_action": action,
+                    "liquidity_protocol": protocol,
+                }
+                for key, value in expected.items():
+                    if approval_summary_copy.get(key) != value:
+                        raise WalletBackendError("approval_token does not match the requested LP operation. Generate a new approval after prepare.")
+                # An LP intent deliberately does not bind API-calculated ticks,
+                # price, calldata, or quote amounts: those are regenerated just
+                # before broadcast. It must still be scoped to the selected
+                # assets/pool/position so an approval cannot be reused for a
+                # different liquidity position.
+                requested_scope = self._build_confirmation_summary(
+                    action_label="Uniswap liquidity",
+                    payload={
+                        "asset_type": "evm-uniswap-liquidity",
+                        "network": str(getattr(active_backend, "network", "unknown")),
+                        "protocol": "uniswap",
+                        "liquidity_action": action,
+                        "liquidity_protocol": protocol,
+                        "request": preview_kwargs["request"],
+                    },
+                )
+                for key in ("token0_address", "token1_address", "pool_reference", "position_token_id", "independent_token"):
+                    requested_value = requested_scope.get(key)
+                    if requested_value is not None and approval_summary_copy.get(key) != requested_value:
+                        raise WalletBackendError("approval_token does not match the requested LP assets or position. Generate a new approval after prepare.")
+                self._require_execute_approval(
+                    approval_token=approval_token,
+                    tool_name=tool_name,
+                    summary=approval_summary_copy,
+                    action_label="Uniswap liquidity",
+                    backend=active_backend,
+                )
+                result = await active_backend.send_uniswap_liquidity(**preview_kwargs)
+                return AgentToolResult(tool=tool_name, ok=True, data=self._annotate_sensitive_payload(result, action_label="Uniswap liquidity", mode="execute"))
+
             if tool_name == "issue_wallet_approval":
                 from agent_wallet.approval import issue_approval_token
 

package/agent-wallet/agent_wallet/providers/wdk_evm_local.py

@@ -40,6 +40,8 @@ LONG_RUNNING_POST_PATHS = {
     "/v1/evm/swap/send",
     "/v1/evm/uniswap/swap/quote",
     "/v1/evm/uniswap/swap/send",
+    "/v1/evm/uniswap/liquidity/quote",
+    "/v1/evm/uniswap/liquidity/send",
     "/v1/evm/lifi/quote",
     "/v1/evm/lifi/send",
     "/v1/evm/transfer/send",

package/agent-wallet/agent_wallet/wallet_layer/base.py

@@ -337,6 +337,25 @@ class AgentWalletBackend(ABC):
     ) -> dict[str, Any]:
         raise WalletBackendError(f"{self.name} does not support Uniswap pair search.")
 
+    async def get_uniswap_liquidity_pools(
+        self,
+        *,
+        protocol: str,
+        pool_parameters: dict[str, Any] | None = None,
+        pool_references: list[dict[str, Any]] | None = None,
+        page_size: int = 20,
+        current_page: int = 1,
+    ) -> dict[str, Any]:
+        raise WalletBackendError(f"{self.name} does not support Uniswap liquidity pool discovery.")
+
+    async def get_uniswap_liquidity_positions(
+        self,
+        *,
+        protocol: str = "V3",
+        limit: int = 20,
+    ) -> dict[str, Any]:
+        raise WalletBackendError(f"{self.name} does not support Uniswap liquidity position discovery.")
+
     async def send_uniswap_swap(
         self,
         *,
@@ -349,6 +368,24 @@ class AgentWalletBackend(ABC):
     ) -> dict[str, Any]:
         raise WalletBackendError(f"{self.name} does not support Uniswap swaps.")
 
+    async def preview_uniswap_liquidity(
+        self,
+        *,
+        action: str,
+        protocol: str,
+        request: dict[str, Any],
+    ) -> dict[str, Any]:
+        raise WalletBackendError(f"{self.name} does not support Uniswap liquidity previews.")
+
+    async def send_uniswap_liquidity(
+        self,
+        *,
+        action: str,
+        protocol: str,
+        request: dict[str, Any],
+    ) -> dict[str, Any]:
+        raise WalletBackendError(f"{self.name} does not support Uniswap liquidity operations.")
+
     async def preview_evm_native_transfer(
         self,
         *,