@agentlayer.tech/wallet 0.1.68 → 0.1.70

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

@@ -984,6 +984,54 @@ const solanaToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "get_kamino_portfolio",
+    description:
+      "Get the unified Kamino portfolio view for a Solana wallet on mainnet across lending, multiply, leverage, liquidity, earn, and staking.",
+    parameters: {
+      type: "object",
+      properties: {
+        user: {
+          type: "string",
+          description: "Optional Solana wallet address override.",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "get_kamino_vaults",
+    description: "List Kamino Earn vaults currently available on Solana mainnet.",
+    parameters: { type: "object", properties: {}, additionalProperties: false },
+  },
+  {
+    name: "get_kamino_earn_positions",
+    description: "Get Kamino Earn vault positions for a Solana wallet on mainnet.",
+    parameters: {
+      type: "object",
+      properties: {
+        user: {
+          type: "string",
+          description: "Optional Solana wallet address override.",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "get_kamino_liquidity_positions",
+    description: "Get Kamino Liquidity strategy positions for a Solana wallet on mainnet.",
+    parameters: {
+      type: "object",
+      properties: {
+        user: {
+          type: "string",
+          description: "Optional Solana wallet address override.",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
   {
     name: "get_kamino_lend_markets",
     description: "List Kamino lending markets currently available on Solana mainnet.",
@@ -1277,6 +1325,40 @@ const solanaToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "kamino_earn_deposit",
+    description: "Preview, prepare, or execute a Kamino Earn vault deposit using a decimal token amount. 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.",
+    optional: true,
+    parameters: {
+      type: "object",
+      properties: {
+        kvault: { type: "string" },
+        amount_ui: { type: "string" },
+        mode: { type: "string", enum: ["preview", "prepare", "execute"] },
+        purpose: { type: "string" },
+        user_intent: { type: "boolean" },
+      },
+      required: ["kvault", "amount_ui", "mode", "purpose"],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "kamino_earn_withdraw",
+    description: "Preview, prepare, or execute a Kamino Earn vault withdraw using a decimal token amount. 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.",
+    optional: true,
+    parameters: {
+      type: "object",
+      properties: {
+        kvault: { type: "string" },
+        amount_ui: { type: "string" },
+        mode: { type: "string", enum: ["preview", "prepare", "execute"] },
+        purpose: { type: "string" },
+        user_intent: { type: "boolean" },
+      },
+      required: ["kvault", "amount_ui", "mode", "purpose"],
+      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.",

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.68",
+  "version": "0.1.70",
   "contracts": {
     "tools": [
       "agentlayer_autonomous_approve",

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

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

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 ## Unreleased
 
+- Fixed the npm `files` allowlist dropping `.env.example` for `wdk-evm-wallet`
+  and `wdk-btc-wallet`. Both templates are tracked in git and correctly
+  un-ignored (`!.env.example` in `.gitignore`), but the root `package.json`
+  `files` list enumerated each wdk package's shipped files individually and
+  omitted `.env.example` (unlike the `agent-wallet/.env.example` entry, which
+  was listed correctly). On a machine with no pre-existing `.env`,
+  `run-local.sh`'s self-heal (`cp .env.example .env`) failed under `set -eu`,
+  and the Python bridge surfaced this as an opaque "wdk-evm-wallet exited
+  before becoming healthy" with no indication that the template file itself
+  was missing from the installed package.
+  - `package.json`
+
+- Fixed local EVM autostart incorrectly trusting any healthy same-version
+  `wdk-evm-wallet` already listening on the shared localhost port. If a temp or
+  alternate `OPENCLAW_HOME` had left a daemon running, host runtimes could hit
+  `Unauthorized` because the daemon served a different `dataDir` and bearer
+  token than the current install expected. Local EVM startup now also validates
+  the reported `dataDir` from `/health` and restarts mismatched daemons before
+  issuing authenticated requests.
+  - `agent-wallet/agent_wallet/evm_user_wallets.py`
+  - `agent-wallet/scripts/bootstrap_openclaw_evm.py`
+  - `agent-wallet/tests/smoke_openclaw_evm_runtime_restart_wrong_home.py`
+
 ## v0.1.62 - 2026-07-04
 
 - Made default boot-key storage prompt-free on macOS. The automatic keystore

package/VERSION

@@ -1 +1 @@
-0.1.68
+0.1.70

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.68"
+__version__ = "0.1.70"
 
 __all__ = [
     "config",

package/agent-wallet/agent_wallet/evm_user_wallets.py

@@ -86,6 +86,43 @@ def _read_on_disk_service_version(wallet_root: Path) -> str | None:
     return version or None
 
 
+def _expected_local_service_data_dir() -> Path:
+    configured = os.getenv("WDK_EVM_DATA_DIR", "").strip()
+    if configured:
+        return Path(configured).expanduser().resolve()
+    return (resolve_openclaw_home() / "wdk-evm-wallet").resolve()
+
+
+def _same_path(left: str | Path | None, right: str | Path | None) -> bool:
+    if left is None or right is None:
+        return False
+    try:
+        left_path = Path(str(left)).expanduser().resolve()
+        right_path = Path(str(right)).expanduser().resolve()
+    except OSError:
+        return False
+    return left_path == right_path
+
+
+def _should_restart_local_service(
+    health: dict[str, Any] | None,
+    *,
+    wallet_root: Path | None,
+) -> bool:
+    if health is None:
+        return False
+    expected_version = _read_on_disk_service_version(wallet_root) if wallet_root is not None else None
+    running_version = str(health.get("version") or "").strip()
+    if expected_version and running_version and running_version != expected_version:
+        return True
+
+    reported_data_dir = str(health.get("dataDir") or "").strip()
+    if reported_data_dir and not _same_path(reported_data_dir, _expected_local_service_data_dir()):
+        return True
+
+    return False
+
+
 def _listening_pids(port: int) -> list[int]:
     """PIDs LISTENing on a local TCP port (via lsof), excluding our own."""
     lsof = shutil.which("lsof")
@@ -177,18 +214,14 @@ def _auto_start_local_service(service_url: str, network: str) -> None:
     health = _service_health(service_url)
     if health is not None:
         # Already running. The daemon loads code once at boot (no hot-reload), so a
-        # long-running process keeps serving stale code after a release. Restart it
-        # only when its reported version differs from the on-disk launcher version —
-        # comparing against the version the restarted daemon will itself report keeps
-        # this idempotent (steady state = no-op) and free of restart loops. Remote
+        # long-running process keeps serving stale code after a release. It can also
+        # keep serving the wrong local vault after a temp/smoke install left another
+        # daemon on the shared localhost port. Restart only when the local daemon no
+        # longer matches the expected launcher version or expected dataDir. Remote
         # (non-local) healthy services we don't manage are left untouched.
         if not _is_local_service_url(service_url):
             return
-        expected_version = (
-            _read_on_disk_service_version(wallet_root) if wallet_root is not None else None
-        )
-        running_version = str(health.get("version") or "").strip()
-        if expected_version is None or running_version == expected_version:
+        if not _should_restart_local_service(health, wallet_root=wallet_root):
             return
         _stop_local_service(service_url)
     if not _is_local_service_url(service_url):

package/agent-wallet/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "agent-wallet",
   "name": "Agent Wallet",
   "description": "Plugin-friendly wallet backend for OpenClaw agents with safe wallet tools and runtime instructions across Solana, local BTC, and local EVM.",
-  "version": "0.1.68",
+  "version": "0.1.70",
   "skills": ["skills/wallet-operator"],
   "configSchema": {
     "type": "object",

package/agent-wallet/pyproject.toml

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

package/agent-wallet/scripts/bootstrap_openclaw_evm.py

@@ -142,17 +142,15 @@ def _auto_start_local_service(
     # steady state is a no-op. See agent_wallet.evm_user_wallets for the shared
     # health/version/stop helpers.
     from agent_wallet.evm_user_wallets import (
-        _read_on_disk_service_version,
         _service_health,
+        _should_restart_local_service,
         _stop_local_service,
     )
 
     restarted = False
     health = _service_health(service_url)
     if health is not None:
-        expected_version = _read_on_disk_service_version(wdk_wallet_root)
-        running_version = str(health.get("version") or "").strip()
-        if expected_version is None or running_version == expected_version:
+        if not _should_restart_local_service(health, wallet_root=wdk_wallet_root):
             return {"started": False, "already_healthy": True}
         _stop_local_service(service_url)
         restarted = True

package/claude-code/plugins/agent-wallet/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-wallet",
   "displayName": "Agent Wallet",
-  "version": "0.1.68",
+  "version": "0.1.70",
   "description": "Claude Code bridge for the existing AgentLayer wallet runtime. Connects to Solana, Bitcoin, and EVM wallets without creating a new one.",
   "author": {
     "name": "AgentLayer"

package/codex/plugins/agent-wallet/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-wallet",
-  "version": "0.1.68",
+  "version": "0.1.70",
   "description": "Codex plugin bridge for the AgentLayer wallet runtime.",
   "author": {
     "name": "AgentLayer"

package/hermes/plugins/agent_wallet/plugin.yaml

@@ -1,5 +1,5 @@
 name: agent-wallet
-version: 0.1.68
+version: 0.1.70
 description: Thin Hermes Agent bridge to the existing AgentLayer/OpenClaw wallet backend
 provides_tools:
   - agent_wallet_tools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayer.tech/wallet",
-  "version": "0.1.68",
+  "version": "0.1.70",
   "description": "NPM installer for the OpenClaw Agent Wallet local runtime.",
   "type": "module",
   "repository": {
@@ -56,12 +56,14 @@
     "wdk-btc-wallet/README.md",
     "wdk-btc-wallet/package.json",
     "wdk-btc-wallet/package-lock.json",
+    "wdk-btc-wallet/.env.example",
     "wdk-evm-wallet/src/",
     "wdk-evm-wallet/bootstrap.sh",
     "wdk-evm-wallet/run-local.sh",
     "wdk-evm-wallet/README.md",
     "wdk-evm-wallet/package.json",
     "wdk-evm-wallet/package-lock.json",
+    "wdk-evm-wallet/.env.example",
     "!agent-wallet/**/__pycache__/**",
     "!agent-wallet/**/*.pyc",
     "!hermes/**/__pycache__/**",

package/wdk-btc-wallet/.env.example

@@ -0,0 +1,41 @@
+HOST=127.0.0.1
+PORT=8080
+
+# Bitcoin network configuration from WDK docs:
+# - bitcoin
+# - testnet
+# - regtest
+# This is the initial active network. It can also be changed later via HTTP.
+WDK_BTC_NETWORK=bitcoin
+
+# Address derivation standard:
+# - 84 for Native SegWit (default in current WDK BTC docs)
+# - 44 for legacy compatibility
+WDK_BTC_BIP=84
+
+# Per-network Electrum profiles.
+# Docs recommend your own Fulcrum/Electrum server for production.
+WDK_BTC_BITCOIN_ELECTRUM_PROTOCOL=tcp
+WDK_BTC_BITCOIN_ELECTRUM_HOST=electrum.blockstream.info
+WDK_BTC_BITCOIN_ELECTRUM_PORT=50001
+
+WDK_BTC_TESTNET_ELECTRUM_PROTOCOL=tcp
+WDK_BTC_TESTNET_ELECTRUM_HOST=blockstream.info
+WDK_BTC_TESTNET_ELECTRUM_PORT=143
+
+WDK_BTC_REGTEST_ELECTRUM_PROTOCOL=tcp
+WDK_BTC_REGTEST_ELECTRUM_HOST=127.0.0.1
+WDK_BTC_REGTEST_ELECTRUM_PORT=60401
+
+# Local encrypted vault directory for wallet registry + encrypted seed files.
+WDK_BTC_DATA_DIR=
+
+# Optional local auth token override.
+# If unset, the service creates and reuses a token file under:
+# ~/.openclaw/wdk-btc-wallet/local-auth-token
+WDK_BTC_LOCAL_TOKEN=
+WDK_BTC_LOCAL_TOKEN_PATH=
+
+# How long unlocked wallets stay in memory.
+# 0 means "stay unlocked until explicit lock or process restart".
+WDK_BTC_UNLOCK_TIMEOUT_SECONDS=0

package/wdk-btc-wallet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wdk-btc-wallet",
-  "version": "0.1.68",
+  "version": "0.1.70",
   "private": true,
   "type": "module",
   "description": "Separate BTC-only wallet service built on Tether WDK.",

package/wdk-evm-wallet/.env.example

@@ -0,0 +1,29 @@
+HOST=127.0.0.1
+PORT=8081
+WDK_EVM_NETWORK=sepolia
+WDK_EVM_DATA_DIR=
+WDK_EVM_LOCAL_TOKEN=
+WDK_EVM_LOCAL_TOKEN_PATH=
+WDK_EVM_UNLOCK_TIMEOUT_SECONDS=0
+WDK_EVM_TRANSFER_MAX_FEE_WEI=
+WDK_EVM_RPC_PROVIDER_MODE=gateway
+WDK_EVM_RPC_GATEWAY_PROVIDER=alchemy
+PROVIDER_GATEWAY_URL=https://agent-layer-production.up.railway.app
+PROVIDER_GATEWAY_BEARER_TOKEN=
+# Mainnet ethereum/base are forced through provider-gateway -> Alchemy.
+# Direct per-network URLs below are only relevant for testnet-style paths.
+WDK_EVM_ETHEREUM_RPC_URL=
+WDK_EVM_SEPOLIA_RPC_URL=https://sepolia.drpc.org
+WDK_EVM_BASE_RPC_URL=
+WDK_EVM_BASE_SEPOLIA_RPC_URL=https://sepolia.base.org
+MORPHO_API_BASE_URL=https://api.morpho.org/graphql
+# Uniswap Trading API swap provider (ethereum/base, CLASSIC routing).
+# Uniswap Trading API. By default the daemon routes quotes/swaps through the
+# provider gateway (PROVIDER_GATEWAY_URL/v1/evm/uniswap), which holds the Uniswap
+# key and authenticates via the gateway bearer — so no UNISWAP_API_KEY is needed
+# here. Only set UNISWAP_API_KEY + point UNISWAP_TRADING_API_BASE_URL at Uniswap
+# directly (https://trade-api.gateway.uniswap.org/v1) for legacy/offline direct mode.
+UNISWAP_API_KEY=
+# UNISWAP_TRADING_API_BASE_URL=   # defaults to PROVIDER_GATEWAY_URL/v1/evm/uniswap
+UNISWAP_ROUTER_VERSION=2.0
+UNISWAP_DEFAULT_SLIPPAGE_BPS=300

package/wdk-evm-wallet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wdk-evm-wallet",
-  "version": "0.1.68",
+  "version": "0.1.70",
   "private": true,
   "type": "module",
   "description": "Separate EVM wallet service built on Tether WDK.",