@agentlayer.tech/wallet 0.1.16 → 0.1.17

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

@@ -1448,7 +1448,7 @@ const solanaToolDefinitions = [
   },
   {
     name: "flash_trade_open_position",
-    description: "Preview, prepare, or execute a Flash Trade same-collateral perpetual open on Solana mainnet.",
+    description: "Preview, prepare, or execute a Flash Trade perpetual open on Solana mainnet using a supported Flash collateral.",
     optional: true,
     parameters: {
       type: "object",
@@ -1463,7 +1463,7 @@ const solanaToolDefinitions = [
         },
         collateral_symbol: {
           type: "string",
-          description: "Collateral symbol. Current integration requires the same symbol as market_symbol.",
+          description: "Flash collateral symbol, for example SOL for SOL longs or USDC for SOL shorts.",
         },
         collateral_amount_raw: {
           type: "string",
@@ -1498,7 +1498,7 @@ const solanaToolDefinitions = [
   },
   {
     name: "flash_trade_close_position",
-    description: "Preview, prepare, or execute a Flash Trade same-collateral perpetual close on Solana mainnet.",
+    description: "Preview, prepare, or execute a Flash Trade perpetual close on Solana mainnet.",
     optional: true,
     parameters: {
       type: "object",

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

@@ -1448,7 +1448,7 @@ const solanaToolDefinitions = [
   },
   {
     name: "flash_trade_open_position",
-    description: "Preview, prepare, or execute a Flash Trade same-collateral perpetual open on Solana mainnet.",
+    description: "Preview, prepare, or execute a Flash Trade perpetual open on Solana mainnet using a supported Flash collateral.",
     optional: true,
     parameters: {
       type: "object",
@@ -1463,7 +1463,7 @@ const solanaToolDefinitions = [
         },
         collateral_symbol: {
           type: "string",
-          description: "Collateral symbol. Current integration requires the same symbol as market_symbol.",
+          description: "Flash collateral symbol, for example SOL for SOL longs or USDC for SOL shorts.",
         },
         collateral_amount_raw: {
           type: "string",
@@ -1498,7 +1498,7 @@ const solanaToolDefinitions = [
   },
   {
     name: "flash_trade_close_position",
-    description: "Preview, prepare, or execute a Flash Trade same-collateral perpetual close on Solana mainnet.",
+    description: "Preview, prepare, or execute a Flash Trade perpetual close on Solana mainnet.",
     optional: true,
     parameters: {
       type: "object",

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

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

package/.openclaw/extensions/pay-bridge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayertech/pay-bridge-plugin",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "OpenClaw plugin bridge for the local pay.sh CLI.",
   "type": "module",
   "license": "SEE LICENSE IN ../../../LICENSE",

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## Unreleased
 
+## v0.1.17 - 2026-05-17
+
+- Added Flash Trade collateral-aware perp opens so the Solana wallet flow can
+  use the collateral supported by the selected Flash market instead of forcing
+  `collateral_symbol == market_symbol`.
+- Unblocked docs-aligned short-position previews, prepares, and execution for
+  markets such as `SOL short / USDC collateral`.
+- Tightened Flash market selection to match on `market_symbol + side +
+  collateral_symbol`, preventing incorrect market resolution when the same
+  asset has multiple collateral paths.
+- Updated the OpenClaw tool descriptions and Flash SDK bridge docs to reflect
+  supported Flash collateral paths instead of the earlier same-symbol-only
+  limitation.
+
 ## v0.1.16 - 2026-05-16
 
 - Added Flash Trade perpetuals support to the Solana wallet flow, including

package/agent-wallet/README.md

@@ -546,7 +546,7 @@ Operational notes:
 - `FLASH_SDK_BRIDGE_MODE=mock` provides deterministic smoke behavior without SDK dependencies
 - `FLASH_SDK_BRIDGE_MODE=real` now produces real Flash SDK quotes for preview and real versioned transaction builds for prepare/execute
 - the backend locally verifies the provider-built Flash transaction, applies only the wallet signature, and requires a host-issued approval token before broadcast; tool-level `prepare` still strips signed transaction bytes before returning to the agent
-- current real-mode constraints are intentionally narrow: mainnet only, same-collateral `market_symbol == collateral_symbol`, and whole-number leverage strings for opens
+- current real-mode constraints are intentionally narrow: mainnet only, Flash-supported market collateral only, and whole-number raw collateral strings for opens
 
 ## Native staking coverage
 

package/agent-wallet/agent_wallet/openclaw_adapter.py

@@ -1956,7 +1956,7 @@ class OpenClawWalletAdapter:
             AgentToolSpec(
                 name="flash_trade_open_position",
                 description=(
-                    "Preview, prepare, or execute a Flash Trade same-collateral perpetual open on Solana mainnet."
+                    "Preview, prepare, or execute a Flash Trade perpetual open on Solana mainnet using a supported Flash collateral."
                 ),
                 input_schema={
                     "type": "object",
@@ -1971,7 +1971,7 @@ class OpenClawWalletAdapter:
                         },
                         "collateral_symbol": {
                             "type": "string",
-                            "description": "Collateral symbol. Phase 2 requires the same symbol as market_symbol.",
+                            "description": "Flash collateral symbol, for example SOL for SOL longs or USDC for SOL shorts.",
                         },
                         "collateral_amount_raw": {
                             "type": "string",
@@ -2023,7 +2023,7 @@ class OpenClawWalletAdapter:
             AgentToolSpec(
                 name="flash_trade_close_position",
                 description=(
-                    "Preview, prepare, or execute a Flash Trade same-collateral perpetual close on Solana mainnet."
+                    "Preview, prepare, or execute a Flash Trade perpetual close on Solana mainnet."
                 ),
                 input_schema={
                     "type": "object",

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

@@ -127,7 +127,7 @@ async def _call_bridge(payload: dict[str, Any]) -> dict[str, Any]:
     return decoded
 
 
-async def preview_open_position_same_collateral(
+async def preview_open_position(
     *,
     owner: str,
     pool_name: str,
@@ -139,7 +139,7 @@ async def preview_open_position_same_collateral(
     network: str,
 ) -> dict[str, Any]:
     payload = {
-        "action": "preview_open_position_same_collateral",
+        "action": "preview_open_position",
         "owner": owner,
         "pool_name": pool_name,
         "market_symbol": market_symbol,
@@ -153,6 +153,29 @@ async def preview_open_position_same_collateral(
     return _unwrap_bridge_payload(response, operation="Flash open-position preview")
 
 
+async def preview_open_position_same_collateral(
+    *,
+    owner: str,
+    pool_name: str,
+    market_symbol: str,
+    collateral_symbol: str,
+    collateral_amount_raw: str,
+    leverage: str,
+    side: str,
+    network: str,
+) -> dict[str, Any]:
+    return await preview_open_position(
+        owner=owner,
+        pool_name=pool_name,
+        market_symbol=market_symbol,
+        collateral_symbol=collateral_symbol,
+        collateral_amount_raw=collateral_amount_raw,
+        leverage=leverage,
+        side=side,
+        network=network,
+    )
+
+
 async def get_markets(
     *,
     pool_name: str | None,
@@ -205,7 +228,7 @@ async def preview_close_position_same_collateral(
     return _unwrap_bridge_payload(response, operation="Flash close-position preview")
 
 
-async def prepare_open_position_same_collateral(
+async def prepare_open_position(
     *,
     owner: str,
     pool_name: str,
@@ -217,7 +240,7 @@ async def prepare_open_position_same_collateral(
     network: str,
 ) -> dict[str, Any]:
     payload = {
-        "action": "prepare_open_position_same_collateral",
+        "action": "prepare_open_position",
         "owner": owner,
         "pool_name": pool_name,
         "market_symbol": market_symbol,
@@ -231,6 +254,29 @@ async def prepare_open_position_same_collateral(
     return _unwrap_bridge_payload(response, operation="Flash open-position prepare")
 
 
+async def prepare_open_position_same_collateral(
+    *,
+    owner: str,
+    pool_name: str,
+    market_symbol: str,
+    collateral_symbol: str,
+    collateral_amount_raw: str,
+    leverage: str,
+    side: str,
+    network: str,
+) -> dict[str, Any]:
+    return await prepare_open_position(
+        owner=owner,
+        pool_name=pool_name,
+        market_symbol=market_symbol,
+        collateral_symbol=collateral_symbol,
+        collateral_amount_raw=collateral_amount_raw,
+        leverage=leverage,
+        side=side,
+        network=network,
+    )
+
+
 async def prepare_close_position_same_collateral(
     *,
     owner: str,

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

@@ -2600,10 +2600,6 @@ class SolanaWalletBackend(AgentWalletBackend):
             collateral_symbol,
             field_name="collateral_symbol",
         )
-        if normalized_collateral_symbol != normalized_market_symbol:
-            raise WalletBackendError(
-                "Phase 2 Flash preview currently supports only same-collateral opens where collateral_symbol matches market_symbol."
-            )
         normalized_collateral_amount_raw = _require_positive_integer_string(
             collateral_amount_raw,
             field_name="collateral_amount_raw",
@@ -2616,15 +2612,19 @@ class SolanaWalletBackend(AgentWalletBackend):
                 item
                 for item in market_snapshot["markets"]
                 if isinstance(item, dict)
-                and str(item.get("symbol") or "").strip().upper() == normalized_market_symbol
+                and str(item.get("market_symbol") or item.get("symbol") or "").strip().upper()
+                == normalized_market_symbol
+                and str(item.get("side") or "").strip().lower() == normalized_side
+                and str(item.get("collateral_symbol") or "").strip().upper()
+                == normalized_collateral_symbol
             ),
             None,
         )
         if matching_market is None:
             raise WalletBackendError(
-                "Requested Flash market is not available in the selected pool."
+                "Requested Flash market is not available in the selected pool for the requested collateral and side."
             )
-        bridge_preview = await flash_sdk_bridge.preview_open_position_same_collateral(
+        bridge_preview = await flash_sdk_bridge.preview_open_position(
             owner=owner,
             pool_name=normalized_pool_name,
             market_symbol=normalized_market_symbol,
@@ -2927,7 +2927,7 @@ class SolanaWalletBackend(AgentWalletBackend):
             leverage=leverage,
             side=side,
         )
-        bridge_prepared = await flash_sdk_bridge.prepare_open_position_same_collateral(
+        bridge_prepared = await flash_sdk_bridge.prepare_open_position(
             owner=str(preview["owner"]),
             pool_name=str(preview["pool_name"]),
             market_symbol=str(preview["market_symbol"]),
@@ -2948,7 +2948,7 @@ class SolanaWalletBackend(AgentWalletBackend):
         self,
         preview: dict[str, Any],
     ) -> dict[str, Any]:
-        bridge_prepared = await flash_sdk_bridge.prepare_open_position_same_collateral(
+        bridge_prepared = await flash_sdk_bridge.prepare_open_position(
             owner=str(preview["owner"]),
             pool_name=str(preview["pool_name"]),
             market_symbol=str(preview["market_symbol"]),

package/agent-wallet/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "openclaw-agent-wallet"
-version = "0.1.16"
+version = "0.1.17"
 description = "Plugin-friendly wallet backend for OpenClaw agents"
 requires-python = ">=3.10"
 dependencies = [

package/agent-wallet/scripts/flash-sdk-bridge/README.md

@@ -13,7 +13,7 @@ Current goals:
 - `FLASH_SDK_BRIDGE_MODE=mock`
   Returns deterministic payloads for local smoke checks without installing SDK dependencies.
 - `FLASH_SDK_BRIDGE_MODE=real`
-  Loads `flash-sdk` and validates runtime config. This mode now supports market discovery, user-position discovery, open/close previews, and unsigned transaction preparation for the current same-collateral Flash perps MVP.
+  Loads `flash-sdk` and validates runtime config. This mode now supports market discovery, user-position discovery, open/close previews, and unsigned transaction preparation for Flash perps using the collateral supported by the selected Flash market.
 
 ## Command
 
@@ -28,6 +28,6 @@ For local smoke:
 ```bash
 FLASH_SDK_BRIDGE_MODE=mock \
 node agent-wallet/scripts/flash-sdk-bridge/bridge.mjs <<'EOF'
-{"action":"preview_open_position_same_collateral","owner":"Fake11111111111111111111111111111111111111111","pool_name":"Crypto.1","market_symbol":"SOL","collateral_symbol":"SOL","collateral_amount_raw":"100000000","leverage":"5","side":"long","network":"mainnet"}
+{"action":"preview_open_position","owner":"Fake11111111111111111111111111111111111111111","pool_name":"Crypto.1","market_symbol":"SOL","collateral_symbol":"USDC","collateral_amount_raw":"5000000","leverage":"2","side":"short","network":"mainnet"}
 EOF
 ```

package/agent-wallet/scripts/flash-sdk-bridge/bridge.mjs

@@ -110,7 +110,7 @@ function mockResponse(normalized) {
             pool_name: normalized.poolName ?? "Crypto.1",
             symbol: "SOL",
             market_symbol: "SOL",
-            collateral_symbol: "SOL",
+            collateral_symbol: "USDC",
             side: "short",
             market_address: "MockFlashMarketShort1111111111111111111111111",
           },
@@ -145,7 +145,10 @@ function mockResponse(normalized) {
     };
   }
 
-  if (normalized.action === "preview_open_position_same_collateral") {
+  if (
+    normalized.action === "preview_open_position" ||
+    normalized.action === "preview_open_position_same_collateral"
+  ) {
     return {
       ok: true,
       preview: {
@@ -177,7 +180,10 @@ function mockResponse(normalized) {
     };
   }
 
-  if (normalized.action === "prepare_open_position_same_collateral") {
+  if (
+    normalized.action === "prepare_open_position" ||
+    normalized.action === "prepare_open_position_same_collateral"
+  ) {
     return {
       ok: true,
       prepared: {
@@ -608,12 +614,6 @@ async function getOpenPositionPreview(runtime, normalized) {
       "collateral_symbol, collateral_amount_raw, and leverage are required for open preview",
     );
   }
-  if (normalized.collateralSymbol !== normalized.marketSymbol) {
-    throw new Error(
-      "Current bridge MVP supports only same-collateral opens where collateral_symbol matches market_symbol",
-    );
-  }
-
   const { BN } = runtime;
   const privilege = runtime.flashSdk.Privilege.None;
   const ownerPublicKey = runtime.provider.wallet.publicKey;
@@ -810,12 +810,6 @@ async function prepareOpenPosition(runtime, normalized) {
       "collateral_symbol, collateral_amount_raw, and leverage are required for open prepare",
     );
   }
-  if (normalized.collateralSymbol !== normalized.marketSymbol) {
-    throw new Error(
-      "Current bridge MVP supports only same-collateral opens where collateral_symbol matches market_symbol",
-    );
-  }
-
   const { BN } = runtime;
   const privilege = runtime.flashSdk.Privilege.None;
   const ownerPublicKey = runtime.provider.wallet.publicKey;
@@ -1113,13 +1107,19 @@ async function realResponse(normalized) {
     return getPositionsReal(normalized);
   }
   const runtime = await buildRuntimeContext(normalized);
-  if (normalized.action === "preview_open_position_same_collateral") {
+  if (
+    normalized.action === "preview_open_position" ||
+    normalized.action === "preview_open_position_same_collateral"
+  ) {
     return getOpenPositionPreview(runtime, normalized);
   }
   if (normalized.action === "preview_close_position_same_collateral") {
     return getClosePositionPreview(runtime, normalized);
   }
-  if (normalized.action === "prepare_open_position_same_collateral") {
+  if (
+    normalized.action === "prepare_open_position" ||
+    normalized.action === "prepare_open_position_same_collateral"
+  ) {
     return prepareOpenPosition(runtime, normalized);
   }
   if (normalized.action === "prepare_close_position_same_collateral") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayer.tech/wallet",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "NPM installer for the OpenClaw Agent Wallet local runtime.",
   "type": "module",
   "repository": {