@agentlayer.tech/wallet 0.1.15 → 0.1.17

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

@@ -14,7 +14,12 @@ let selectedEvmNetwork = null;
 let selectedBtcNetwork = null;
 const PREVIEW_CACHE_TTL_MS = 15 * 60 * 1000;
 const PRIVATE_SWAP_CACHE_TTL_MS = 35 * 60 * 1000;
-const PREVIEW_BOUND_SWAP_TOOLS = new Set(["swap_solana_tokens", "swap_solana_privately"]);
+const PREVIEW_BOUND_SWAP_TOOLS = new Set([
+  "swap_solana_tokens",
+  "swap_solana_privately",
+  "flash_trade_open_position",
+  "flash_trade_close_position",
+]);
 const PRIVATE_SWAP_APPROVAL_TOOL_NAME = "swap_solana_privately";
 const approvalPreviewCache = new Map();
 const privateSwapOrderCache = new Map();
@@ -1026,6 +1031,38 @@ const solanaToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "get_flash_trade_markets",
+    description: "List Flash Trade perpetual markets currently available on Solana mainnet.",
+    parameters: {
+      type: "object",
+      properties: {
+        pool_name: {
+          type: "string",
+          description: "Optional Flash pool identifier such as Crypto.1.",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "get_flash_trade_positions",
+    description: "Get Flash Trade perpetual positions for a Solana wallet on mainnet.",
+    parameters: {
+      type: "object",
+      properties: {
+        owner: {
+          type: "string",
+          description: "Optional Solana wallet address override. If omitted, use the configured wallet.",
+        },
+        pool_name: {
+          type: "string",
+          description: "Optional Flash pool identifier such as Crypto.1.",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
   {
     name: "get_kamino_lend_markets",
     description: "List Kamino lending markets currently available on Solana mainnet.",
@@ -1409,6 +1446,85 @@ const solanaToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "flash_trade_open_position",
+    description: "Preview, prepare, or execute a Flash Trade perpetual open on Solana mainnet using a supported Flash collateral.",
+    optional: true,
+    parameters: {
+      type: "object",
+      properties: {
+        pool_name: {
+          type: "string",
+          description: "Flash pool identifier such as Crypto.1.",
+        },
+        market_symbol: {
+          type: "string",
+          description: "Flash market symbol such as SOL or BTC.",
+        },
+        collateral_symbol: {
+          type: "string",
+          description: "Flash collateral symbol, for example SOL for SOL longs or USDC for SOL shorts.",
+        },
+        collateral_amount_raw: {
+          type: "string",
+          description: "Collateral amount in raw token units.",
+        },
+        leverage: {
+          type: "string",
+          description: "Requested leverage as a decimal string such as 5 or 7.5.",
+        },
+        side: {
+          type: "string",
+          enum: ["long", "short"],
+          description: "Position direction.",
+        },
+        mode: { type: "string", enum: ["preview", "prepare", "execute"] },
+        purpose: { type: "string" },
+        user_intent: { type: "boolean" },
+        approval_token: { type: "string" },
+      },
+      required: [
+        "pool_name",
+        "market_symbol",
+        "collateral_symbol",
+        "collateral_amount_raw",
+        "leverage",
+        "side",
+        "mode",
+        "purpose",
+      ],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "flash_trade_close_position",
+    description: "Preview, prepare, or execute a Flash Trade perpetual close on Solana mainnet.",
+    optional: true,
+    parameters: {
+      type: "object",
+      properties: {
+        pool_name: {
+          type: "string",
+          description: "Flash pool identifier such as Crypto.1.",
+        },
+        market_symbol: {
+          type: "string",
+          description: "Flash market symbol such as SOL or BTC.",
+        },
+        side: {
+          type: "string",
+          enum: ["long", "short"],
+          description: "Position direction to close.",
+        },
+        mode: { type: "string", enum: ["preview", "prepare", "execute"] },
+        purpose: { type: "string" },
+        user_intent: { type: "boolean" },
+        approval_token: { type: "string" },
+      },
+      required: ["pool_name", "market_symbol", "side", "mode", "purpose"],
+      additionalProperties: false,
+    },
+  },
   {
     name: "close_empty_token_accounts",
     description: "Preview or execute closing zero-balance token accounts. Execute requires a host-issued approval token bound to the previewed operation.",

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

@@ -14,7 +14,12 @@ let selectedEvmNetwork = null;
 let selectedBtcNetwork = null;
 const PREVIEW_CACHE_TTL_MS = 15 * 60 * 1000;
 const PRIVATE_SWAP_CACHE_TTL_MS = 35 * 60 * 1000;
-const PREVIEW_BOUND_SWAP_TOOLS = new Set(["swap_solana_tokens", "swap_solana_privately"]);
+const PREVIEW_BOUND_SWAP_TOOLS = new Set([
+  "swap_solana_tokens",
+  "swap_solana_privately",
+  "flash_trade_open_position",
+  "flash_trade_close_position",
+]);
 const PRIVATE_SWAP_APPROVAL_TOOL_NAME = "swap_solana_privately";
 const approvalPreviewCache = new Map();
 const privateSwapOrderCache = new Map();
@@ -1026,6 +1031,38 @@ const solanaToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "get_flash_trade_markets",
+    description: "List Flash Trade perpetual markets currently available on Solana mainnet.",
+    parameters: {
+      type: "object",
+      properties: {
+        pool_name: {
+          type: "string",
+          description: "Optional Flash pool identifier such as Crypto.1.",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "get_flash_trade_positions",
+    description: "Get Flash Trade perpetual positions for a Solana wallet on mainnet.",
+    parameters: {
+      type: "object",
+      properties: {
+        owner: {
+          type: "string",
+          description: "Optional Solana wallet address override. If omitted, use the configured wallet.",
+        },
+        pool_name: {
+          type: "string",
+          description: "Optional Flash pool identifier such as Crypto.1.",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
   {
     name: "get_kamino_lend_markets",
     description: "List Kamino lending markets currently available on Solana mainnet.",
@@ -1409,6 +1446,85 @@ const solanaToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "flash_trade_open_position",
+    description: "Preview, prepare, or execute a Flash Trade perpetual open on Solana mainnet using a supported Flash collateral.",
+    optional: true,
+    parameters: {
+      type: "object",
+      properties: {
+        pool_name: {
+          type: "string",
+          description: "Flash pool identifier such as Crypto.1.",
+        },
+        market_symbol: {
+          type: "string",
+          description: "Flash market symbol such as SOL or BTC.",
+        },
+        collateral_symbol: {
+          type: "string",
+          description: "Flash collateral symbol, for example SOL for SOL longs or USDC for SOL shorts.",
+        },
+        collateral_amount_raw: {
+          type: "string",
+          description: "Collateral amount in raw token units.",
+        },
+        leverage: {
+          type: "string",
+          description: "Requested leverage as a decimal string such as 5 or 7.5.",
+        },
+        side: {
+          type: "string",
+          enum: ["long", "short"],
+          description: "Position direction.",
+        },
+        mode: { type: "string", enum: ["preview", "prepare", "execute"] },
+        purpose: { type: "string" },
+        user_intent: { type: "boolean" },
+        approval_token: { type: "string" },
+      },
+      required: [
+        "pool_name",
+        "market_symbol",
+        "collateral_symbol",
+        "collateral_amount_raw",
+        "leverage",
+        "side",
+        "mode",
+        "purpose",
+      ],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "flash_trade_close_position",
+    description: "Preview, prepare, or execute a Flash Trade perpetual close on Solana mainnet.",
+    optional: true,
+    parameters: {
+      type: "object",
+      properties: {
+        pool_name: {
+          type: "string",
+          description: "Flash pool identifier such as Crypto.1.",
+        },
+        market_symbol: {
+          type: "string",
+          description: "Flash market symbol such as SOL or BTC.",
+        },
+        side: {
+          type: "string",
+          enum: ["long", "short"],
+          description: "Position direction to close.",
+        },
+        mode: { type: "string", enum: ["preview", "prepare", "execute"] },
+        purpose: { type: "string" },
+        user_intent: { type: "boolean" },
+        approval_token: { type: "string" },
+      },
+      required: ["pool_name", "market_symbol", "side", "mode", "purpose"],
+      additionalProperties: false,
+    },
+  },
   {
     name: "close_empty_token_accounts",
     description: "Preview or execute closing zero-balance token accounts. Execute requires a host-issued approval token bound to the previewed operation.",

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

@@ -8,6 +8,8 @@
       "claim_bags_fees",
       "close_empty_token_accounts",
       "continue_solana_private_swap",
+      "flash_trade_close_position",
+      "flash_trade_open_position",
       "get_active_wallet_backend",
       "get_bags_claimable_positions",
       "get_bags_fee_analytics",
@@ -26,6 +28,8 @@
       "get_evm_token_balance",
       "get_evm_token_metadata",
       "get_evm_transaction_receipt",
+      "get_flash_trade_markets",
+      "get_flash_trade_positions",
       "get_jupiter_earn_earnings",
       "get_jupiter_earn_positions",
       "get_jupiter_earn_tokens",

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

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayertech/agent-wallet-plugin",
-  "version": "0.1.15",
+  "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.15",
+  "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,34 @@
 
 ## 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
+  market discovery, position lookup, preview, prepare, open, and close tools.
+- Kept Flash perps wallet-native inside the existing Solana backend instead of
+  introducing a separate custodial trading account flow.
+- Added a repo-owned Flash SDK bridge for real quote, prepare, and execution
+  planning against Flash Trade from the local runtime.
+- Fixed OpenClaw runtime packaging and plugin contract sync so Flash Trade
+  tools are exposed correctly from the installed runtime.
+- Bound Flash execute approvals to the exact approved preview payload, so
+  host-issued approvals remain valid across small quote drift between preview
+  and execution.
+
 - Added ClawHub-publishable OpenClaw plugin package metadata for
   `.openclaw/extensions/agent-wallet` and `.openclaw/extensions/pay-bridge`,
   including required `openclaw.compat`, `openclaw.build`, and

package/RELEASING.md

@@ -284,3 +284,100 @@ https://github.com/lopushok9/Agent-Layer.git
 
 Do not use `NPM_TOKEN` unless Trusted Publishing is unavailable. Token-based
 publishes can fail with `EOTP` when npm requires two-factor authentication.
+
+## ClawHub Release Workflow
+
+This repo also includes a separate GitHub Actions workflow for the OpenClaw
+plugin packages:
+
+```text
+.github/workflows/clawhub-plugins.yml
+```
+
+It publishes these ClawHub packages:
+
+```text
+@agentlayertech/agent-wallet-plugin
+@agentlayertech/pay-bridge-plugin
+```
+
+### Triggers
+
+- `pull_request`
+  - runs ClawHub publish in `--dry-run` mode for both plugin packages
+- `workflow_dispatch`
+  - supports manual runs with a `dry_run` boolean input
+- `push` on git tags matching `v*`
+  - publishes both plugin packages to ClawHub
+
+### Required secret
+
+The workflow requires this repository Actions secret:
+
+```text
+CLAWHUB_TOKEN
+```
+
+That token is created in the ClawHub web UI and must belong to an account with
+publisher access to:
+
+```text
+@agentlayertech
+```
+
+### Family mapping
+
+The workflow currently publishes:
+
+- `.openclaw/extensions/agent-wallet` as `bundle-plugin`
+- `.openclaw/extensions/pay-bridge` as `code-plugin`
+
+`agent-wallet` remains on `bundle-plugin` because the package
+`@agentlayertech/agent-wallet-plugin` was first created in ClawHub with that
+family, and ClawHub does not allow family changes for an existing package name.
+
+### Release flow with tags
+
+If you want one git tag to publish both npm and ClawHub surfaces together:
+
+1. Keep these versions aligned:
+
+```text
+package.json
+agent-wallet/pyproject.toml
+.openclaw/extensions/agent-wallet/package.json
+.openclaw/extensions/pay-bridge/package.json
+```
+
+2. Commit the release version bump.
+
+3. Push `main`.
+
+4. Create and push the tag:
+
+```bash
+git tag -a v0.1.16 -m "v0.1.16"
+git push origin v0.1.16
+```
+
+That tag will trigger:
+
+- `.github/workflows/npm-installer.yml`
+- `.github/workflows/clawhub-plugins.yml`
+
+### Manual verification without publishing
+
+To verify the ClawHub workflow and token without creating a new release:
+
+1. Open GitHub Actions
+2. Select `ClawHub plugins`
+3. Click `Run workflow`
+4. Choose branch `main`
+5. Set `dry_run=true`
+6. Run it
+
+Expected result:
+
+- both matrix jobs succeed
+- ClawHub login succeeds
+- both package publishes resolve in dry-run mode without uploading

package/agent-wallet/.env.example

@@ -65,6 +65,11 @@ HOUDINI_USER_IP=
 HOUDINI_USER_AGENT=AgentLayer/0.1.12
 HOUDINI_USER_TIMEZONE=UTC
 
+# Flash Trade perps
+FLASH_API_BASE_URL=
+FLASH_SDK_BRIDGE_COMMAND=
+FLASH_SDK_BRIDGE_MODE=real
+
 # Kamino REST lending
 KAMINO_API_BASE_URL=https://api.kamino.finance
 KAMINO_PROGRAM_ID=KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD

package/agent-wallet/README.md

@@ -524,6 +524,30 @@ Operational notes:
 - Jupiter `Portfolio` implementation remains in the backend, but the agent-facing tools are temporarily disabled.
 - The Jupiter config fields and provider code are intentionally kept so these surfaces can be restored later without rebuilding the integration from scratch.
 
+## Flash Trade coverage
+
+Current Flash Trade integration is intentionally phase-scoped:
+
+- read-only `markets` and `positions` hooks are now wired through the Solana backend and OpenClaw adapter
+- the transport is provider-driven, so Flash can be added through `provider-gateway` without introducing a new wallet runtime
+
+Operational notes:
+
+- current agent-facing tools are `get_flash_trade_markets` and `get_flash_trade_positions`
+- these reads are mainnet-only
+- Flash perpetual opens/closes now follow the existing `preview -> prepare -> execute` approval model instead of a separate trading wallet flow
+- Flash reads expect either hosted/self-hosted gateway routes on `PROVIDER_GATEWAY_URL` or a direct `FLASH_API_BASE_URL`
+- if those HTTP routes are unavailable, the Solana backend now falls back to the local `flash-sdk-bridge` for market discovery and user-position discovery
+- Phase 2 now also adds `flash_trade_open_position` and `flash_trade_close_position` in `preview` / `prepare` / `execute`
+- those preview/prepare/execute flows are produced by a local bridge command configured via `FLASH_SDK_BRIDGE_COMMAND`
+- the bridge is expected to return machine JSON on stdout; `agent-wallet/tests/smoke_flash_sdk_bridge.py` documents the minimal contract shape
+- a repo-owned Node bridge now lives at `agent-wallet/scripts/flash-sdk-bridge/bridge.mjs`
+- install its pinned SDK dependencies with `cd agent-wallet/scripts/flash-sdk-bridge && npm install`
+- `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, Flash-supported market collateral only, and whole-number raw collateral strings for opens
+
 ## Native staking coverage
 
 Current native Solana staking integration now includes:

package/agent-wallet/agent_wallet/config.py

@@ -60,6 +60,10 @@ class Settings(BaseSettings):
     houdini_user_ip: str = ""
     houdini_user_agent: str = "AgentLayer/0.1.12"
     houdini_user_timezone: str = "UTC"
+    flash_api_base_url: str = ""
+    flash_sdk_bridge_command: str = ""
+    flash_sdk_bridge_mode: str = "mock"
+    flash_sdk_bridge_timeout_seconds: float = 20.0
     kamino_api_base_url: str = "https://api.kamino.finance"
     kamino_program_id: str = "KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD"
     alchemy_api_key: str = ""