@hpp-io/x402-mcp-bridge 0.0.1 → 0.0.2

package/dist/cli/channel.js

@@ -0,0 +1,330 @@
+/**
+ * hpp-x402-channel — inspect / manage local batch-settlement channels.
+ *
+ * Subcommands:
+ *
+ *   ls                          List all channels persisted under HPP_X402_HOME.
+ *   status <channelId>          Print full local channel context.
+ *   refund <url> [amount]       Cooperative refund — server co-signs, single
+ *                               multicall(claim + refund) onchain. Immediate.
+ *                               Omit `amount` for a full refund.
+ *   withdraw <url> [--finalize] Unilateral withdraw — server-free escape hatch.
+ *                               Without --finalize: initiateWithdraw onchain.
+ *                               With --finalize: finalizeWithdraw after
+ *                               the channel's withdrawDelay elapsed.
+ *
+ * Storage layout matches `FileClientChannelStorage`:
+ *   {HPP_X402_HOME or ~/.hpp-x402}/client/<channelId>.json
+ *
+ * Env required for mutating commands (refund, withdraw):
+ *   AGENT_PRIVATE_KEY   payer wallet (0x + 64 hex)
+ *   HPP_RPC_URL         e.g. https://sepolia.hpp.io/<key>
+ *   HPP_NETWORK         CAIP-2 (e.g. eip155:181228)
+ *   PAYER_SALT          optional — bytes32 hex used to derive channelId.
+ *                       Must match the salt the channel was opened with.
+ *                       Defaults to 0x00…0 (SDK default).
+ *
+ * Usage:
+ *   hpp-x402-channel ls
+ *   hpp-x402-channel status 0xe3fd…
+ *   hpp-x402-channel refund http://localhost:4021/paid/compute/hello-world
+ *   hpp-x402-channel refund http://localhost:4021/paid/compute/hello-world 5000
+ *   hpp-x402-channel withdraw http://localhost:4021/paid/compute/hello-world
+ *   hpp-x402-channel withdraw http://localhost:4021/paid/compute/hello-world --finalize
+ */
+import { homedir } from "node:os";
+import { resolve, join } from "node:path";
+import { readdir } from "node:fs/promises";
+import { FileClientChannelStorage } from "@x402/evm/batch-settlement/client/file-storage";
+import { BatchSettlementEvmScheme } from "@x402/evm/batch-settlement/client";
+import { toClientEvmSigner } from "@x402/evm";
+import { decodePaymentRequiredHeader } from "@x402/core/http";
+import { createPublicClient, createWalletClient, defineChain, http, parseAbi, } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+const STORAGE_ROOT = process.env.HPP_X402_HOME ?? resolve(homedir(), ".hpp-x402");
+const X402_BATCH_SETTLEMENT = "0x4020074e9dF2ce1deE5A9C1b5c3f541D02a10003";
+const CONTRACT_ABI = parseAbi([
+    "function channels(bytes32 channelId) view returns (uint128 balance, uint128 totalClaimed)",
+    "function pendingWithdrawals(bytes32 channelId) view returns (uint128 amount, uint40 initiatedAt)",
+    "function getChannelId((address payer, address payerAuthorizer, address receiver, address receiverAuthorizer, address token, uint40 withdrawDelay, bytes32 salt) config) view returns (bytes32)",
+    "function initiateWithdraw((address payer, address payerAuthorizer, address receiver, address receiverAuthorizer, address token, uint40 withdrawDelay, bytes32 salt) config, uint128 amount)",
+    "function finalizeWithdraw((address payer, address payerAuthorizer, address receiver, address receiverAuthorizer, address token, uint40 withdrawDelay, bytes32 salt) config)",
+]);
+function usage() {
+    console.error("Usage: hpp-x402-channel <ls|status|refund|withdraw> [args]");
+    console.error("  ls                                List local channels");
+    console.error("  status <channelId>                Show channel detail");
+    console.error("  refund <url> [amount]             Cooperative refund (server co-signs)");
+    console.error("  withdraw <url> [--finalize]       Unilateral withdraw (server-free)");
+    process.exit(1);
+}
+function reqEnv(name) {
+    const v = process.env[name];
+    if (!v || v.length === 0) {
+        console.error(`Missing env: ${name}`);
+        process.exit(2);
+    }
+    return v;
+}
+function loadSignerCtx() {
+    const key = reqEnv("AGENT_PRIVATE_KEY");
+    if (!/^0x[0-9a-fA-F]{64}$/.test(key)) {
+        console.error("AGENT_PRIVATE_KEY must be 0x + 64 hex chars");
+        process.exit(2);
+    }
+    const rpcUrl = reqEnv("HPP_RPC_URL");
+    const network = reqEnv("HPP_NETWORK");
+    if (!/^eip155:\d+$/.test(network)) {
+        console.error('HPP_NETWORK must match "eip155:<chainId>"');
+        process.exit(2);
+    }
+    const saltRaw = process.env.PAYER_SALT ?? `0x${"0".repeat(64)}`;
+    if (!/^0x[0-9a-fA-F]{64}$/.test(saltRaw)) {
+        console.error("PAYER_SALT must be 0x + 64 hex chars");
+        process.exit(2);
+    }
+    const salt = saltRaw;
+    const chainId = Number(network.split(":")[1]);
+    const account = privateKeyToAccount(key);
+    const chain = defineChain({
+        id: chainId,
+        name: `hpp-${chainId}`,
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        rpcUrls: { default: { http: [rpcUrl] } },
+    });
+    const publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
+    return { account, network, chainId, rpcUrl, salt, publicClient };
+}
+async function probeRequirements(url) {
+    const r = await fetch(url, { method: "GET" });
+    if (r.status !== 402) {
+        throw new Error(`probe expected 402, got ${r.status} (server may not advertise this URL)`);
+    }
+    const header = r.headers.get("PAYMENT-REQUIRED");
+    if (!header)
+        throw new Error("probe response missing PAYMENT-REQUIRED header");
+    const paymentRequired = decodePaymentRequiredHeader(header);
+    const requirements = paymentRequired.accepts.find((a) => a.scheme === "batch-settlement");
+    if (!requirements)
+        throw new Error("server does not advertise batch-settlement on this URL");
+    return requirements;
+}
+async function listChannelIds() {
+    const clientDir = join(STORAGE_ROOT, "client");
+    try {
+        const files = await readdir(clientDir);
+        return files
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => f.replace(/\.json$/, ""))
+            .sort();
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return [];
+        }
+        throw err;
+    }
+}
+async function cmdLs() {
+    const storage = new FileClientChannelStorage({ directory: STORAGE_ROOT });
+    const ids = await listChannelIds();
+    if (ids.length === 0) {
+        console.log(`(no channels under ${STORAGE_ROOT}/client/)`);
+        return;
+    }
+    console.log(`channels in ${STORAGE_ROOT}/client/:\n`);
+    for (const id of ids) {
+        const ctx = await storage.get(id);
+        if (!ctx)
+            continue;
+        const ch = ctx.channel;
+        if (!ch) {
+            console.log(`  ${id}  (no channel record)`);
+            continue;
+        }
+        const balance = String(ch.balance ?? "0");
+        const totalClaimed = String(ch.totalClaimed ?? "0");
+        const charged = String(ch.chargedCumulativeAmount ?? "0");
+        console.log(`  ${id}\n` +
+            `      balance: ${balance}  totalClaimed: ${totalClaimed}  chargedCumulative: ${charged}`);
+    }
+}
+async function cmdStatus(channelId) {
+    if (!/^0x[0-9a-fA-F]{64}$/.test(channelId)) {
+        console.error("channelId must be 0x + 64 hex chars");
+        process.exit(2);
+    }
+    const storage = new FileClientChannelStorage({ directory: STORAGE_ROOT });
+    const ctx = await storage.get(channelId.toLowerCase());
+    if (!ctx) {
+        console.error(`channel ${channelId} not found under ${STORAGE_ROOT}/client/`);
+        process.exit(3);
+    }
+    console.log(JSON.stringify(ctx, null, 2));
+}
+async function cmdRefund(url, amountArg) {
+    if (amountArg !== undefined && !/^\d+$/.test(amountArg)) {
+        console.error("amount must be a positive integer (atomic token units)");
+        process.exit(2);
+    }
+    const { account, salt, publicClient } = loadSignerCtx();
+    const signer = toClientEvmSigner(account, publicClient);
+    // Persistent client storage so this CLI can recover a channel created
+    // by another bridge process (Claude Desktop / OpenClaw stdio).
+    const storage = new FileClientChannelStorage({ directory: STORAGE_ROOT });
+    const scheme = new BatchSettlementEvmScheme(signer, { salt, storage });
+    console.log(`refunding channel for ${url}${amountArg ? ` (amount=${amountArg})` : " (full drain)"}…`);
+    const settle = await scheme.refund(url, amountArg !== undefined ? { amount: amountArg } : undefined);
+    if (!settle.success) {
+        console.error(`refund failed: ${settle.errorReason ?? "unknown"} ${settle.errorMessage ?? ""}`);
+        process.exit(4);
+    }
+    console.log(`refund tx: ${settle.transaction}`);
+    const extra = settle.extra
+        ?.channelState;
+    if (extra) {
+        console.log("post-refund channel state:");
+        console.log(JSON.stringify(extra, null, 2));
+    }
+}
+async function cmdWithdraw(url, finalize) {
+    const { account, publicClient, chainId, rpcUrl, salt } = loadSignerCtx();
+    const signer = toClientEvmSigner(account, publicClient);
+    const storage = new FileClientChannelStorage({ directory: STORAGE_ROOT });
+    const scheme = new BatchSettlementEvmScheme(signer, { salt, storage });
+    const requirements = await probeRequirements(url);
+    const channelConfig = scheme.buildChannelConfig(requirements);
+    // viem walletClient for the direct onchain writes (initiate / finalize).
+    const chain = defineChain({
+        id: chainId,
+        name: `hpp-${chainId}`,
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        rpcUrls: { default: { http: [rpcUrl] } },
+    });
+    const walletClient = createWalletClient({
+        chain,
+        transport: http(rpcUrl),
+        account: account,
+    });
+    if (!finalize) {
+        // initiateWithdraw — amount = onchain balance - charged. Conservative,
+        // safe against server claiming up to charged during the delay window.
+        // Derive channelId via the contract's view (avoid depending on SDK
+        // internal `computeChannelId` whose export path is unstable).
+        const channelId = (await publicClient.readContract({
+            address: X402_BATCH_SETTLEMENT,
+            abi: CONTRACT_ABI,
+            functionName: "getChannelId",
+            args: [channelConfig],
+        }));
+        const [balance, _totalClaimed] = (await publicClient.readContract({
+            address: X402_BATCH_SETTLEMENT,
+            abi: CONTRACT_ABI,
+            functionName: "channels",
+            args: [channelId],
+        }));
+        // Read local charged-cumulative from storage.
+        const local = await storage.get(channelId.toLowerCase());
+        const charged = BigInt(local?.chargedCumulativeAmount ?? "0");
+        const withdrawAmount = balance - charged;
+        if (withdrawAmount <= 0n) {
+            console.error(`nothing to withdraw — balance(${balance}) <= chargedCumulative(${charged})`);
+            process.exit(5);
+        }
+        console.log(`initiateWithdraw amount=${withdrawAmount} (balance ${balance} - charged ${charged})`);
+        const txHash = await walletClient.writeContract({
+            account: account,
+            chain,
+            address: X402_BATCH_SETTLEMENT,
+            abi: CONTRACT_ABI,
+            functionName: "initiateWithdraw",
+            args: [channelConfig, withdrawAmount],
+        });
+        const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+        if (receipt.status !== "success") {
+            console.error(`initiateWithdraw tx reverted: ${txHash}`);
+            process.exit(6);
+        }
+        console.log(`initiate tx: ${txHash}`);
+        const [pendAmount, pendInitAt] = (await publicClient.readContract({
+            address: X402_BATCH_SETTLEMENT,
+            abi: CONTRACT_ABI,
+            functionName: "pendingWithdrawals",
+            args: [channelId],
+        }));
+        const block = await publicClient.getBlock();
+        const readyAt = pendInitAt + channelConfig.withdrawDelay;
+        const eta = readyAt - Number(block.timestamp);
+        console.log(`pendingWithdrawals: amount=${pendAmount}  initiatedAt=${pendInitAt}`);
+        console.log(`finalize available in ~${eta}s (at block.timestamp >= ${readyAt}). Re-run with --finalize.`);
+        return;
+    }
+    // finalize ----------------------------------------------------------------
+    console.log("finalizeWithdraw…");
+    const txHash = await walletClient.writeContract({
+        account: account,
+        chain,
+        address: X402_BATCH_SETTLEMENT,
+        abi: CONTRACT_ABI,
+        functionName: "finalizeWithdraw",
+        args: [channelConfig],
+    });
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    if (receipt.status !== "success") {
+        console.error(`finalizeWithdraw tx reverted: ${txHash} (delay not yet elapsed, or amount overshot)`);
+        process.exit(6);
+    }
+    console.log(`finalize tx: ${txHash}`);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const subcmd = args[0];
+    switch (subcmd) {
+        case "ls":
+            await cmdLs();
+            break;
+        case "status":
+            if (!args[1]) {
+                console.error("status requires a channelId argument");
+                usage();
+            }
+            await cmdStatus(args[1]);
+            break;
+        case "refund":
+            if (!args[1]) {
+                console.error("refund requires a <url> argument");
+                usage();
+            }
+            await cmdRefund(args[1], args[2]);
+            break;
+        case "withdraw": {
+            if (!args[1]) {
+                console.error("withdraw requires a <url> argument");
+                usage();
+            }
+            const finalize = args.includes("--finalize");
+            await cmdWithdraw(args[1], finalize);
+            break;
+        }
+        case "topup":
+            console.error("topup is not yet implemented (needs ERC-3009 deposit signing flow). " +
+                "See https://github.com/hpp-io/noosphere-x402-server/issues/9");
+            process.exit(64);
+            break;
+        case "--help":
+        case "-h":
+        case undefined:
+            usage();
+        default:
+            console.error(`unknown subcommand: ${subcmd}`);
+            usage();
+    }
+}
+main().catch((err) => {
+    console.error("hpp-x402-channel fatal:", err.message ?? err);
+    if (process.env.LOG_LEVEL === "debug" && err instanceof Error && err.stack) {
+        console.error(err.stack);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=channel.js.map

package/dist/cli/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/cli/channel.ts"],"names":[],"mappings":"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"}

package/dist/cli/install-claude.d.ts

@@ -1,24 +1,6 @@
+import { type InstallEnv, type InstallResult } from "./install-mcp-host.js";
 export declare function configPath(): string;
-export interface InstallEnv {
-    DELEGATE_PRIVATE_KEY: string;
-    SAFE_ADDRESS: string;
-    ALLOWANCE_MODULE_ADDRESS: string;
-    USDCE_ADDRESS: string;
-    RESOURCE_SERVER_URL: string;
-    HPP_RPC_URL: string;
-    HPP_NETWORK: string;
-    LOG_LEVEL?: string;
-}
-export interface InstallResult {
-    configPath: string;
-    backupPath: string | null;
-    changed: boolean;
-    preservedEntries: string[];
-}
-/**
- * Merge an `hpp-x402` server entry into the host config and write it.
- * `command`/`args` default to launching the published bridge via npx.
- */
+export type { InstallEnv, InstallResult };
 export declare function installClaudeDesktop(env: InstallEnv, opts?: {
     force?: boolean;
     bridgeAbsPath?: string;

package/dist/cli/install-claude.js

@@ -1,13 +1,13 @@
 /**
  * Merge an `hpp-x402` MCP server entry into the user's
- * claude_desktop_config.json. Importable function (used by setup CLI
- * with --install-claude) and a standalone bin entry.
+ * claude_desktop_config.json. Importable from the setup CLI
+ * (--install-claude flag).
  *
- * Preserves all other mcpServers entries; backs up the original.
+ * The merge logic is shared with OpenClaw — see install-mcp-host.ts.
  */
-import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync, } from "node:fs";
-import { resolve, dirname } from "node:path";
+import { resolve } from "node:path";
 import { homedir, platform } from "node:os";
+import { installMcpHost, } from "./install-mcp-host.js";
 const ENTRY_NAME = "hpp-x402";
 export function configPath() {
     const p = platform();
@@ -19,64 +19,13 @@ export function configPath() {
     }
     return resolve(homedir(), ".config/Claude/claude_desktop_config.json");
 }
-/**
- * Merge an `hpp-x402` server entry into the host config and write it.
- * `command`/`args` default to launching the published bridge via npx.
- */
 export function installClaudeDesktop(env, opts = {}) {
-    const path = configPath();
-    let existing = {};
-    if (existsSync(path)) {
-        existing = JSON.parse(readFileSync(path, "utf8"));
-    }
-    else {
-        mkdirSync(dirname(path), { recursive: true });
-    }
-    const command = opts.bridgeAbsPath ? "node" : "npx";
-    const args = opts.bridgeAbsPath
-        ? [opts.bridgeAbsPath]
-        : ["-y", "@hpp-io/x402-mcp-bridge"];
-    const entry = {
-        command,
-        args,
-        env: {
-            DELEGATE_PRIVATE_KEY: env.DELEGATE_PRIVATE_KEY,
-            SAFE_ADDRESS: env.SAFE_ADDRESS,
-            ALLOWANCE_MODULE_ADDRESS: env.ALLOWANCE_MODULE_ADDRESS,
-            USDCE_ADDRESS: env.USDCE_ADDRESS,
-            RESOURCE_SERVER_URL: env.RESOURCE_SERVER_URL,
-            HPP_RPC_URL: env.HPP_RPC_URL,
-            HPP_NETWORK: env.HPP_NETWORK,
-            LOG_LEVEL: env.LOG_LEVEL ?? "info",
-        },
-    };
-    const mcpServers = (existing.mcpServers ??= {});
-    const prior = mcpServers[ENTRY_NAME];
-    if (prior && JSON.stringify(prior) === JSON.stringify(entry)) {
-        return {
-            configPath: path,
-            backupPath: null,
-            changed: false,
-            preservedEntries: Object.keys(mcpServers).filter((k) => k !== ENTRY_NAME),
-        };
-    }
-    if (prior && !opts.force) {
-        throw new Error(`existing hpp-x402 entry differs; pass force:true (or --force in CLI) to overwrite`);
-    }
-    mcpServers[ENTRY_NAME] = entry;
-    const merged = { ...existing, mcpServers };
-    let backupPath = null;
-    if (existsSync(path)) {
-        const ts = new Date().toISOString().replace(/[:.]/g, "-");
-        backupPath = path + "." + ts + ".bak";
-        copyFileSync(path, backupPath);
-    }
-    writeFileSync(path, JSON.stringify(merged, null, 2) + "\n", "utf8");
-    return {
-        configPath: path,
-        backupPath,
-        changed: true,
-        preservedEntries: Object.keys(mcpServers).filter((k) => k !== ENTRY_NAME),
-    };
+    return installMcpHost({
+        configPath: configPath(),
+        entryName: ENTRY_NAME,
+        env,
+        force: opts.force,
+        bridgeAbsPath: opts.bridgeAbsPath,
+    });
 }
 //# sourceMappingURL=install-claude.js.map

package/dist/cli/install-claude.js.map

@@ -1 +1 @@
-{"version":3,"file":"install-claude.js","sourceRoot":"","sources":["../../src/cli/install-claude.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install-claude.js","sourceRoot":"","sources":["../../src/cli/install-claude.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EACL,cAAc,GAGf,MAAM,uBAAuB,CAAC;AAE/B,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,+DAA+D,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,mCAAmC,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,2CAA2C,CAAC,CAAC;AACzE,CAAC;AAID,MAAM,UAAU,oBAAoB,CAClC,GAAe,EACf,OAAoD,EAAE;IAEtD,OAAO,cAAc,CAAC;QACpB,UAAU,EAAE,UAAU,EAAE;QACxB,SAAS,EAAE,UAAU;QACrB,GAAG;QACH,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/install-mcp-host.d.ts

@@ -0,0 +1,35 @@
+export interface InstallEnv {
+    DELEGATE_PRIVATE_KEY: string;
+    SAFE_ADDRESS: string;
+    ALLOWANCE_MODULE_ADDRESS: string;
+    USDCE_ADDRESS: string;
+    RESOURCE_SERVER_URL: string;
+    HPP_RPC_URL: string;
+    HPP_NETWORK: string;
+    LOG_LEVEL?: string;
+}
+export interface InstallResult {
+    configPath: string;
+    backupPath: string | null;
+    changed: boolean;
+    preservedEntries: string[];
+}
+export interface InstallOptions {
+    configPath: string;
+    entryName: string;
+    env: InstallEnv;
+    force?: boolean;
+    bridgeAbsPath?: string;
+    /**
+     * JSON key path where MCP servers live. Defaults to `["mcpServers"]`
+     * (Claude Desktop). OpenClaw uses `["mcp", "servers"]`.
+     */
+    serversKeyPath?: string[];
+}
+/**
+ * Merge an `<entryName>` MCP server entry into the host config and write it.
+ * Preserves all other entries; backs up the original if it exists.
+ * `command`/`args` default to launching the published bridge via npx;
+ * pass `bridgeAbsPath` for a local checkout.
+ */
+export declare function installMcpHost(opts: InstallOptions): InstallResult;

package/dist/cli/install-mcp-host.js

@@ -0,0 +1,82 @@
+/**
+ * Generic JSON-config merge for MCP hosts.
+ *
+ * Both Claude Desktop and OpenClaw store their MCP server registry as
+ * `{ mcpServers: { <name>: { command, args, env } } }` JSON. The merge
+ * logic is identical — only the file path differs. This module owns
+ * that logic; `install-claude.ts` / `install-openclaw.ts` are thin
+ * wrappers that pass the right path.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync, } from "node:fs";
+import { dirname } from "node:path";
+function getOrCreateNested(root, keyPath) {
+    let cur = root;
+    for (const k of keyPath) {
+        if (typeof cur[k] !== "object" || cur[k] === null)
+            cur[k] = {};
+        cur = cur[k];
+    }
+    return cur;
+}
+/**
+ * Merge an `<entryName>` MCP server entry into the host config and write it.
+ * Preserves all other entries; backs up the original if it exists.
+ * `command`/`args` default to launching the published bridge via npx;
+ * pass `bridgeAbsPath` for a local checkout.
+ */
+export function installMcpHost(opts) {
+    const { configPath, entryName, env, force, bridgeAbsPath, serversKeyPath = ["mcpServers"], } = opts;
+    let existing = {};
+    if (existsSync(configPath)) {
+        existing = JSON.parse(readFileSync(configPath, "utf8"));
+    }
+    else {
+        mkdirSync(dirname(configPath), { recursive: true });
+    }
+    const command = bridgeAbsPath ? "node" : "npx";
+    const args = bridgeAbsPath
+        ? [bridgeAbsPath]
+        : ["-y", "@hpp-io/x402-mcp-bridge"];
+    const entry = {
+        command,
+        args,
+        env: {
+            DELEGATE_PRIVATE_KEY: env.DELEGATE_PRIVATE_KEY,
+            SAFE_ADDRESS: env.SAFE_ADDRESS,
+            ALLOWANCE_MODULE_ADDRESS: env.ALLOWANCE_MODULE_ADDRESS,
+            USDCE_ADDRESS: env.USDCE_ADDRESS,
+            RESOURCE_SERVER_URL: env.RESOURCE_SERVER_URL,
+            HPP_RPC_URL: env.HPP_RPC_URL,
+            HPP_NETWORK: env.HPP_NETWORK,
+            LOG_LEVEL: env.LOG_LEVEL ?? "info",
+        },
+    };
+    const servers = getOrCreateNested(existing, serversKeyPath);
+    const prior = servers[entryName];
+    if (prior && JSON.stringify(prior) === JSON.stringify(entry)) {
+        return {
+            configPath,
+            backupPath: null,
+            changed: false,
+            preservedEntries: Object.keys(servers).filter((k) => k !== entryName),
+        };
+    }
+    if (prior && !force) {
+        throw new Error(`existing ${entryName} entry differs; pass force:true (or --force in CLI) to overwrite`);
+    }
+    servers[entryName] = entry;
+    let backupPath = null;
+    if (existsSync(configPath)) {
+        const ts = new Date().toISOString().replace(/[:.]/g, "-");
+        backupPath = configPath + "." + ts + ".bak";
+        copyFileSync(configPath, backupPath);
+    }
+    writeFileSync(configPath, JSON.stringify(existing, null, 2) + "\n", "utf8");
+    return {
+        configPath,
+        backupPath,
+        changed: true,
+        preservedEntries: Object.keys(servers).filter((k) => k !== entryName),
+    };
+}
+//# sourceMappingURL=install-mcp-host.js.map

package/dist/cli/install-mcp-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-mcp-host.js","sourceRoot":"","sources":["../../src/cli/install-mcp-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCpC,SAAS,iBAAiB,CACxB,IAA6B,EAC7B,OAAiB;IAEjB,IAAI,GAAG,GAA4B,IAAI,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/D,GAAG,GAAG,GAAG,CAAC,CAAC,CAA4B,CAAC;IAC1C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAoB;IACjD,MAAM,EACJ,UAAU,EACV,SAAS,EACT,GAAG,EACH,KAAK,EACL,aAAa,EACb,cAAc,GAAG,CAAC,YAAY,CAAC,GAChC,GAAG,IAAI,CAAC;IAET,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/C,MAAM,IAAI,GAAG,aAAa;QACxB,CAAC,CAAC,CAAC,aAAa,CAAC;QACjB,CAAC,CAAC,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;IAEtC,MAAM,KAAK,GAAG;QACZ,OAAO;QACP,IAAI;QACJ,GAAG,EAAE;YACH,oBAAoB,EAAE,GAAG,CAAC,oBAAoB;YAC9C,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,wBAAwB,EAAE,GAAG,CAAC,wBAAwB;YACtD,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,mBAAmB,EAAE,GAAG,CAAC,mBAAmB;YAC5C,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,MAAM;SACnC;KACF,CAAC;IAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEjC,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO;YACL,UAAU;YACV,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,KAAK;YACd,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;SACtE,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,YAAY,SAAS,kEAAkE,CACxF,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IAE3B,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1D,UAAU,GAAG,UAAU,GAAG,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC;QAC5C,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAE5E,OAAO;QACL,UAAU;QACV,UAAU;QACV,OAAO,EAAE,IAAI;QACb,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;KACtE,CAAC;AACJ,CAAC"}

package/dist/cli/install-openclaw.d.ts

@@ -0,0 +1,7 @@
+import { type InstallEnv, type InstallResult } from "./install-mcp-host.js";
+export declare function configPath(): string;
+export declare function installOpenClaw(env: InstallEnv, opts?: {
+    force?: boolean;
+    bridgeAbsPath?: string;
+    configPathOverride?: string;
+}): InstallResult;

package/dist/cli/install-openclaw.js

@@ -0,0 +1,28 @@
+/**
+ * Merge an `hpp-x402` MCP server entry into the user's OpenClaw config.
+ *
+ * OpenClaw stores its MCP gateway config as JSON at
+ *   ~/.openclaw/openclaw.json    (default)
+ *
+ * If a project / corp setup uses a non-default location, callers can
+ * pass `configPathOverride` to point at it directly. The merge logic
+ * is shared with Claude Desktop — see install-mcp-host.ts.
+ */
+import { resolve } from "node:path";
+import { homedir } from "node:os";
+import { installMcpHost, } from "./install-mcp-host.js";
+const ENTRY_NAME = "hpp-x402";
+export function configPath() {
+    return resolve(homedir(), ".openclaw/openclaw.json");
+}
+export function installOpenClaw(env, opts = {}) {
+    return installMcpHost({
+        configPath: opts.configPathOverride ?? configPath(),
+        entryName: ENTRY_NAME,
+        env,
+        force: opts.force,
+        bridgeAbsPath: opts.bridgeAbsPath,
+        serversKeyPath: ["mcp", "servers"],
+    });
+}
+//# sourceMappingURL=install-openclaw.js.map

package/dist/cli/install-openclaw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-openclaw.js","sourceRoot":"","sources":["../../src/cli/install-openclaw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EACL,cAAc,GAGf,MAAM,uBAAuB,CAAC;AAE/B,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,yBAAyB,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,GAAe,EACf,OAAiF,EAAE;IAEnF,OAAO,cAAc,CAAC;QACpB,UAAU,EAAE,IAAI,CAAC,kBAAkB,IAAI,UAAU,EAAE;QACnD,SAAS,EAAE,UAAU;QACrB,GAAG;QACH,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,cAAc,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;KACnC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/keychain.d.ts

@@ -0,0 +1 @@
+export {};