@agentlayer.tech/wallet 0.1.14 → 0.1.15

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

@@ -1,6 +1,7 @@
 import { execFile } from "node:child_process";
 import crypto from "node:crypto";
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
 import { promisify } from "node:util";
 
@@ -390,10 +391,16 @@ function resolvePythonBin(config) {
   return config.pythonBin || process.env.OPENCLAW_AGENT_WALLET_PYTHON || "python3";
 }
 
+function resolveOpenclawHome(config) {
+  return path.resolve(config.openclawHome || process.env.OPENCLAW_HOME || path.join(os.homedir(), ".openclaw"));
+}
+
 function resolvePackageRoot(config) {
+  const openclawHome = resolveOpenclawHome(config);
   const candidates = [
     config.packageRoot,
     process.env.OPENCLAW_AGENT_WALLET_PACKAGE_ROOT,
+    path.join(openclawHome, "agent-wallet-runtime/current/agent-wallet"),
     path.resolve(PLUGIN_ROOT, "../../../agent-wallet"),
     path.resolve(process.cwd(), "agent-wallet"),
   ].filter(Boolean);
@@ -405,7 +412,7 @@ function resolvePackageRoot(config) {
     }
   }
   throw new Error(
-    "Could not resolve agent-wallet package root. Set plugins.entries.agent-wallet.config.packageRoot."
+    `Could not resolve agent-wallet package root. Checked ${path.join(openclawHome, "agent-wallet-runtime/current/agent-wallet")} and local workspace fallbacks. Set plugins.entries.agent-wallet.config.packageRoot if your runtime lives elsewhere.`
   );
 }
 

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

@@ -1,11 +1,50 @@
 {
-  "name": "agent-wallet",
-  "version": "0.1.0",
-  "private": true,
+  "name": "@agentlayertech/agent-wallet-plugin",
+  "version": "0.1.15",
+  "description": "OpenClaw plugin bridge for the AgentLayer wallet runtime.",
   "type": "module",
+  "license": "SEE LICENSE IN ../../../LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lopushok9/Agent-Layer.git",
+    "directory": ".openclaw/extensions/agent-wallet"
+  },
+  "bugs": {
+    "url": "https://github.com/lopushok9/Agent-Layer/issues"
+  },
+  "homepage": "https://github.com/lopushok9/Agent-Layer/tree/main/.openclaw/extensions/agent-wallet#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "index.ts",
+    "dist/",
+    "openclaw.plugin.json",
+    "README.md",
+    "skills/"
+  ],
   "openclaw": {
     "extensions": [
       "./index.ts"
-    ]
-  }
+    ],
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.3.24-beta.2",
+      "minGatewayVersion": "2026.3.24-beta.2"
+    },
+    "build": {
+      "openclawVersion": "2026.3.24-beta.2",
+      "pluginSdkVersion": "2026.3.24-beta.2"
+    }
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "wallet",
+    "solana",
+    "bitcoin",
+    "evm"
+  ]
 }

package/.openclaw/extensions/pay-bridge/README.md

@@ -2,6 +2,12 @@
 
 Thin OpenClaw bridge to the locally installed `pay` CLI.
 
+External install path:
+
+```bash
+openclaw plugins install clawhub:@agentlayertech/pay-bridge-plugin
+```
+
 This plugin is intentionally separate from `agent-wallet`:
 
 - `agent-wallet` remains the execution wallet stack for Solana/EVM/BTC

package/.openclaw/extensions/pay-bridge/dist/core.mjs

@@ -0,0 +1,287 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
+const ANSI_RE = /\u001b\[[0-9;]*m/g;
+
+function stripAnsi(text) {
+  return String(text || "").replace(ANSI_RE, "");
+}
+
+function nonEmptyLines(text) {
+  return stripAnsi(text)
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+}
+
+function extractLastJsonValue(text) {
+  const lines = nonEmptyLines(text);
+  for (let i = lines.length - 1; i >= 0; i -= 1) {
+    const candidate = lines[i];
+    if (!candidate.startsWith("{") && !candidate.startsWith("[")) continue;
+    try {
+      return JSON.parse(candidate);
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+
+function collectStringLeaves(value, acc = new Set()) {
+  if (typeof value === "string") {
+    acc.add(value);
+    return acc;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) collectStringLeaves(item, acc);
+    return acc;
+  }
+  if (value && typeof value === "object") {
+    for (const item of Object.values(value)) collectStringLeaves(item, acc);
+  }
+  return acc;
+}
+
+function withAccountArgs(args, account) {
+  if (!account) return args;
+  return [...args, "--account", account];
+}
+
+export function resolvePayBinary(config = {}) {
+  return (
+    config.payBinary ||
+    process.env.OPENCLAW_PAY_BINARY ||
+    "pay"
+  );
+}
+
+export async function runPayCommand(payBinary, args, options = {}) {
+  const { cwd, input = null } = options;
+  let stdout = "";
+  let stderr = "";
+  try {
+    const result = await execFileAsync(payBinary, args, {
+      cwd,
+      env: { ...process.env },
+      input,
+      maxBuffer: 1024 * 1024 * 8,
+    });
+    stdout = result.stdout ?? "";
+    stderr = result.stderr ?? "";
+  } catch (error) {
+    stdout = typeof error?.stdout === "string" ? error.stdout : "";
+    stderr = typeof error?.stderr === "string" ? error.stderr : "";
+    const payload = extractLastJsonValue(stdout) || extractLastJsonValue(stderr);
+    const message =
+      payload?.error?.message ||
+      payload?.message ||
+      stripAnsi(stderr || stdout || error?.message || "pay command failed").trim() ||
+      "pay command failed";
+    const wrapped = new Error(message);
+    wrapped.stdout = stdout;
+    wrapped.stderr = stderr;
+    wrapped.details = payload && typeof payload === "object" ? payload : null;
+    throw wrapped;
+  }
+  return { stdout, stderr };
+}
+
+export function parseWhoamiOutput(stdout) {
+  const lines = nonEmptyLines(stdout);
+  const systemUser = lines[0] || null;
+  const noAccount = lines.some((line) => /no mainnet account/i.test(line));
+  return {
+    system_user: systemUser,
+    has_mainnet_account: !noAccount,
+    raw_lines: lines,
+  };
+}
+
+export function parseAccountListOutput(stdout) {
+  const lines = nonEmptyLines(stdout);
+  const noAccounts = lines.some((line) => /no accounts found/i.test(line));
+  return {
+    has_accounts: !noAccounts,
+    raw_lines: lines,
+  };
+}
+
+export async function getPayStatus(config = {}, options = {}) {
+  const payBinary = resolvePayBinary(config);
+  const versionResult = await runPayCommand(payBinary, ["--version"], options);
+  const whoamiResult = await runPayCommand(
+    payBinary,
+    withAccountArgs(["whoami"], config.defaultAccount),
+    options
+  );
+  const accountListResult = await runPayCommand(payBinary, ["account", "list"], options);
+  return {
+    installed: true,
+    pay_binary: payBinary,
+    version: stripAnsi(versionResult.stdout).trim() || null,
+    account_configured: parseWhoamiOutput(whoamiResult.stdout).has_mainnet_account,
+    has_any_accounts: parseAccountListOutput(accountListResult.stdout).has_accounts,
+    whoami: parseWhoamiOutput(whoamiResult.stdout),
+    accounts: parseAccountListOutput(accountListResult.stdout),
+  };
+}
+
+export async function getPayWalletInfo(config = {}, options = {}) {
+  const payBinary = resolvePayBinary(config);
+  const whoamiResult = await runPayCommand(
+    payBinary,
+    withAccountArgs(["whoami"], config.defaultAccount),
+    options
+  );
+  const accountListResult = await runPayCommand(payBinary, ["account", "list"], options);
+  return {
+    pay_binary: payBinary,
+    default_account: config.defaultAccount || null,
+    whoami: parseWhoamiOutput(whoamiResult.stdout),
+    accounts: parseAccountListOutput(accountListResult.stdout),
+    notes: [
+      "This wallet is managed by pay.sh and is separate from the AgentLayer execution wallet.",
+    ],
+  };
+}
+
+export async function searchPayServices(config = {}, params = {}, options = {}) {
+  const payBinary = resolvePayBinary(config);
+  const args = ["skills", "search"];
+  if (params.query) args.push(String(params.query));
+  if (params.category) args.push("--category", String(params.category));
+  args.push("--json");
+  const { stdout, stderr } = await runPayCommand(
+    payBinary,
+    withAccountArgs(args, params.account || config.defaultAccount),
+    options
+  );
+  const parsed = JSON.parse(stdout.trim() || "{}");
+  return {
+    query: params.query || "",
+    category: params.category || null,
+    results: parsed,
+    warnings: nonEmptyLines(stderr),
+  };
+}
+
+export async function getPayServiceEndpoints(config = {}, params = {}, options = {}) {
+  const payBinary = resolvePayBinary(config);
+  const args = [
+    "skills",
+    "endpoints",
+    String(params.service_fqn),
+    String(params.resource),
+    "--json",
+  ];
+  const { stdout, stderr } = await runPayCommand(
+    payBinary,
+    withAccountArgs(args, params.account || config.defaultAccount),
+    options
+  );
+  const parsed = JSON.parse(stdout.trim() || "{}");
+  return {
+    service_fqn: String(params.service_fqn),
+    resource: String(params.resource),
+    endpoints: parsed,
+    warnings: nonEmptyLines(stderr),
+  };
+}
+
+function ensureHttps(url, requireHttps = true) {
+  if (!requireHttps) return;
+  const parsed = new URL(url);
+  if (parsed.protocol !== "https:") {
+    throw new Error("pay_api_request only allows https URLs.");
+  }
+}
+
+function appendQuery(url, query) {
+  const parsed = new URL(url);
+  if (query && typeof query === "object") {
+    for (const [key, value] of Object.entries(query)) {
+      if (value === undefined || value === null) continue;
+      parsed.searchParams.set(key, String(value));
+    }
+  }
+  return parsed.toString();
+}
+
+export function endpointPayloadContainsUrl(endpointPayload, url) {
+  const strings = collectStringLeaves(endpointPayload);
+  return strings.has(url);
+}
+
+export async function executePayApiRequest(config = {}, params = {}, options = {}) {
+  if (params.user_confirmed !== true) {
+    throw new Error("pay_api_request requires user_confirmed=true.");
+  }
+  if (!params.purpose || !String(params.purpose).trim()) {
+    throw new Error("pay_api_request requires a non-empty purpose.");
+  }
+  if (!params.service_fqn || !params.resource || !params.url) {
+    throw new Error("pay_api_request requires service_fqn, resource, and url.");
+  }
+  if (params.json_body !== undefined && params.text_body !== undefined) {
+    throw new Error("Provide either json_body or text_body, not both.");
+  }
+
+  const endpointData = await getPayServiceEndpoints(config, {
+    account: params.account,
+    resource: params.resource,
+    service_fqn: params.service_fqn,
+  }, options);
+
+  const finalUrl = appendQuery(String(params.url), params.query);
+  ensureHttps(finalUrl, config.requireHttps !== false);
+  if (!endpointPayloadContainsUrl(endpointData.endpoints, String(params.url))) {
+    throw new Error("The requested URL is not present in pay_get_service_endpoints for this service/resource.");
+  }
+
+  const payBinary = resolvePayBinary(config);
+  const method = String(params.method || "GET").toUpperCase();
+  const args = ["curl"];
+  if (params.account || config.defaultAccount) {
+    args.push("--account", String(params.account || config.defaultAccount));
+  }
+  args.push("--request", method);
+
+  const headers = params.headers && typeof params.headers === "object" ? params.headers : {};
+  for (const [key, value] of Object.entries(headers)) {
+    args.push("--header", `${key}: ${String(value)}`);
+  }
+
+  if (params.json_body !== undefined) {
+    const hasContentType = Object.keys(headers).some((key) => key.toLowerCase() === "content-type");
+    if (!hasContentType) {
+      args.push("--header", "content-type: application/json");
+    }
+    args.push("--data", JSON.stringify(params.json_body));
+  } else if (params.text_body !== undefined) {
+    args.push("--data", String(params.text_body));
+  }
+
+  args.push(finalUrl);
+  const { stdout, stderr } = await runPayCommand(payBinary, args, options);
+  const trimmed = stdout.trim();
+  let responseBody = trimmed;
+  if (params.parse_json_response !== false) {
+    try {
+      responseBody = JSON.parse(trimmed);
+    } catch {
+      responseBody = trimmed;
+    }
+  }
+  return {
+    method,
+    purpose: String(params.purpose),
+    request_url: finalUrl,
+    service_fqn: String(params.service_fqn),
+    resource: String(params.resource),
+    response: responseBody,
+    raw_response_text: trimmed,
+    warnings: nonEmptyLines(stderr),
+  };
+}

package/.openclaw/extensions/pay-bridge/dist/index.js

@@ -0,0 +1,196 @@
+import {
+  executePayApiRequest,
+  getPayServiceEndpoints,
+  getPayStatus,
+  getPayWalletInfo,
+  searchPayServices,
+} from "./core.mjs";
+
+const PLUGIN_ID = "pay-bridge";
+
+function asContent(data) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(data, null, 2),
+      },
+    ],
+  };
+}
+
+function resolvePluginConfig(api) {
+  const globalConfig = api?.config ?? {};
+  const pluginEntry = globalConfig?.plugins?.entries?.[PLUGIN_ID];
+  return pluginEntry?.config ?? globalConfig?.config ?? {};
+}
+
+function registerTool(api, definition) {
+  api.registerTool({
+    name: definition.name,
+    description: definition.description,
+    parameters: definition.parameters,
+    returns: {
+      type: "object",
+      additionalProperties: true,
+    },
+    async execute(_id, params = {}) {
+      const config = resolvePluginConfig(api);
+      let result;
+      if (definition.name === "pay_status") {
+        result = await getPayStatus(config, { cwd: process.cwd() });
+      } else if (definition.name === "pay_wallet_info") {
+        result = await getPayWalletInfo(config, { cwd: process.cwd() });
+      } else if (definition.name === "pay_search_services") {
+        result = await searchPayServices(config, params, { cwd: process.cwd() });
+      } else if (definition.name === "pay_get_service_endpoints") {
+        result = await getPayServiceEndpoints(config, params, { cwd: process.cwd() });
+      } else if (definition.name === "pay_api_request") {
+        result = await executePayApiRequest(config, params, { cwd: process.cwd() });
+      } else {
+        throw new Error(`Unsupported pay-bridge tool: ${definition.name}`);
+      }
+      return asContent(result);
+    },
+  });
+}
+
+const toolDefinitions = [
+  {
+    name: "pay_status",
+    description:
+      "Check whether the local pay.sh CLI is installed and whether a pay wallet/account is configured. Use this before any paid API workflow.",
+    parameters: {
+      type: "object",
+      properties: {},
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "pay_wallet_info",
+    description:
+      "Show pay wallet/account status. This wallet is separate from the AgentLayer execution wallet and is only for pay.sh API payments.",
+    parameters: {
+      type: "object",
+      properties: {},
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "pay_search_services",
+    description:
+      "Search the pay.sh skills catalog for paid APIs. Prefer this instead of guessing URLs manually.",
+    parameters: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: "Search text for service names, descriptions, or endpoint paths.",
+        },
+        category: {
+          type: "string",
+          description: "Optional category filter such as ai_ml, maps, data, compute, search, crypto_finance.",
+        },
+        account: {
+          type: "string",
+          description: "Optional pay account override.",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "pay_get_service_endpoints",
+    description:
+      "List the discoverable endpoints for a pay.sh service/resource pair and return their gateway URLs. Use the returned URL with pay_api_request.",
+    parameters: {
+      type: "object",
+      properties: {
+        service_fqn: {
+          type: "string",
+          description: "Fully qualified pay service name, for example solana-foundation/google/language.",
+        },
+        resource: {
+          type: "string",
+          description: "Resource name inside the service, for example entities or jobs.",
+        },
+        account: {
+          type: "string",
+          description: "Optional pay account override.",
+        },
+      },
+      required: ["service_fqn", "resource"],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "pay_api_request",
+    description:
+      "Call a paid API through the local pay.sh CLI using a URL returned by pay_get_service_endpoints. Requires explicit user_confirmed=true and keeps the pay wallet separate from AgentLayer execution wallets.",
+    optional: true,
+    parameters: {
+      type: "object",
+      properties: {
+        service_fqn: {
+          type: "string",
+          description: "Fully qualified pay service name used to validate the request URL.",
+        },
+        resource: {
+          type: "string",
+          description: "Resource name used to validate the request URL.",
+        },
+        url: {
+          type: "string",
+          description: "Exact HTTPS gateway URL returned by pay_get_service_endpoints.",
+        },
+        method: {
+          type: "string",
+          description: "HTTP method such as GET or POST.",
+        },
+        headers: {
+          type: "object",
+          additionalProperties: { type: "string" },
+          description: "Optional HTTP headers.",
+        },
+        query: {
+          type: "object",
+          additionalProperties: true,
+          description: "Optional query parameters to append to the URL.",
+        },
+        json_body: {
+          description: "Optional JSON request body.",
+        },
+        text_body: {
+          type: "string",
+          description: "Optional raw text request body. Do not provide with json_body.",
+        },
+        account: {
+          type: "string",
+          description: "Optional pay account override.",
+        },
+        parse_json_response: {
+          type: "boolean",
+          description: "If true, attempt to parse the response body as JSON.",
+        },
+        purpose: {
+          type: "string",
+          description: "Short user-facing reason for this paid API call.",
+        },
+        user_confirmed: {
+          type: "boolean",
+          description: "Must be true for paid API requests.",
+        },
+      },
+      required: ["service_fqn", "resource", "url", "method", "purpose", "user_confirmed"],
+      additionalProperties: false,
+    },
+  },
+];
+
+export default function registerPayBridgePlugin(api) {
+  api?.logger?.info?.("[pay-bridge] registering pay.sh OpenClaw plugin");
+  for (const definition of toolDefinitions) {
+    registerTool(api, definition);
+  }
+  api?.logger?.info?.(`[pay-bridge] registered ${toolDefinitions.length} pay tools`);
+}

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

@@ -1,11 +1,49 @@
 {
-  "name": "pay-bridge",
-  "version": "0.1.0",
-  "private": true,
+  "name": "@agentlayertech/pay-bridge-plugin",
+  "version": "0.1.15",
+  "description": "OpenClaw plugin bridge for the local pay.sh CLI.",
   "type": "module",
+  "license": "SEE LICENSE IN ../../../LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lopushok9/Agent-Layer.git",
+    "directory": ".openclaw/extensions/pay-bridge"
+  },
+  "bugs": {
+    "url": "https://github.com/lopushok9/Agent-Layer/issues"
+  },
+  "homepage": "https://github.com/lopushok9/Agent-Layer/tree/main/.openclaw/extensions/pay-bridge#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "index.ts",
+    "core.mjs",
+    "dist/",
+    "openclaw.plugin.json",
+    "README.md",
+    "skills/"
+  ],
   "openclaw": {
     "extensions": [
       "./index.ts"
-    ]
-  }
+    ],
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.3.24-beta.2",
+      "minGatewayVersion": "2026.3.24-beta.2"
+    },
+    "build": {
+      "openclawVersion": "2026.3.24-beta.2",
+      "pluginSdkVersion": "2026.3.24-beta.2"
+    }
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "pay",
+    "payments"
+  ]
 }

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## Unreleased
 
+- Added ClawHub-publishable OpenClaw plugin package metadata for
+  `.openclaw/extensions/agent-wallet` and `.openclaw/extensions/pay-bridge`,
+  including required `openclaw.compat`, `openclaw.build`, and
+  `runtimeExtensions` fields for native `openclaw plugins install clawhub:...`
+  installs.
+- Added a reproducible OpenClaw plugin package build/check script at
+  `scripts/manage_openclaw_plugin_packages.mjs` to generate published runtime
+  JS artifacts under `.openclaw/extensions/*/dist/`.
+- Updated the `agent-wallet` OpenClaw bridge to auto-check the packaged runtime
+  path at `~/.openclaw/agent-wallet-runtime/current/agent-wallet` before local
+  workspace fallbacks, so a ClawHub-installed plugin can ride on top of the
+  existing npm runtime installer.
+- Documented the dual-install model: keep `npx @agentlayer.tech/wallet install`
+  for runtime/bootstrap, and use `openclaw plugins install clawhub:...` for the
+  native OpenClaw plugin packages.
+- Added a GitHub Actions workflow at `.github/workflows/clawhub-plugins.yml`
+  that can dry-run ClawHub publishes on pull requests and publish both OpenClaw
+  plugin packages on `v*` tags or manual dispatch.
+
 ## v0.1.14 - 2026-05-13
 
 - Added a separate `.openclaw/extensions/pay-bridge/` plugin that keeps