lightning-wallet-mcp 1.0.5 → 1.1.0

package/README.md

@@ -1,9 +1,9 @@
-# Lightning Wallet MCP Server
+# Lightning Wallet
 
 [![npm version](https://img.shields.io/npm/v/lightning-wallet-mcp.svg)](https://www.npmjs.com/package/lightning-wallet-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**Give your AI agent a Bitcoin wallet.** This MCP server enables AI agents to send and receive Bitcoin via the Lightning Network. The first step toward true AI economic autonomy.
+**Give your AI agent a Bitcoin wallet.** MCP server + CLI. Works with Claude Code, OpenClaw, Cursor, and any agent framework.
 
 > **Note:** This package was previously published as `lightning-faucet-mcp`. The functionality is identical.
 
@@ -33,11 +33,45 @@
 - **Webhook Notifications** - Get notified instantly when payments arrive
 - **Full Observability** - Analytics, exports, and detailed status tracking
 
-## Quick Start
+## Two Ways to Use
 
-### Option 1: Self-Registration (No Account Needed)
+### CLI (Any Agent Framework)
 
-The MCP server can register itself! Just configure Claude Code without an API key:
+For CLI-first agents (OpenClaw, Pi, KiloCode, or any agent with Bash access):
+
+```bash
+npm install -g lightning-wallet-mcp
+```
+
+This installs the `lw` command:
+
+```bash
+# Register and save your API key
+export LIGHTNING_WALLET_API_KEY=$(lw register --name "My Bot" | jq -r '.api_key')
+
+# Check balance
+lw balance | jq '.balance_sats'
+
+# Pay an L402 API
+lw pay-api "https://lightningfaucet.com/api/l402/fortune"
+
+# Create and fund an agent
+lw create-agent "Research Bot" --budget 5000
+lw fund-agent 1 1000
+
+# Check identity
+lw whoami
+```
+
+Output is JSON by default (pipe to `jq`). Use `--human` for readable output.
+
+Run `lw help` for all commands.
+
+### MCP Server (Claude Code, Cursor, Windsurf)
+
+For MCP-native clients, configure as an MCP server:
+
+**Option A: Self-Registration**
 
 ```json
 {
@@ -52,9 +86,7 @@ The MCP server can register itself! Just configure Claude Code without an API ke
 
 Then ask Claude: *"Register a new Lightning Wallet operator account"*
 
-Claude will use `register_operator` to create an account, then `set_operator_key` to activate it.
-
-### Option 2: Pre-configured API Key
+**Option B: Pre-configured API Key**
 
 1. Get an API key at [lightningfaucet.com/ai-agents](https://lightningfaucet.com/ai-agents/)
 2. Configure Claude Code (`~/.claude/settings.json`):
@@ -155,6 +187,52 @@ Claude will use `register_operator` to create an account, then `set_operator_key
 - `budget_warning` - 80% of budget consumed
 - `test` - Manual test event
 
+## CLI Reference
+
+All commands output JSON to stdout. Errors go to stderr with exit code 1.
+
+| Command | Description |
+|---------|-------------|
+| `lw register [--name "name"]` | Create operator account, prints API key |
+| `lw whoami` | Current identity (operator or agent) |
+| `lw balance` | Balance in satoshis |
+| `lw info` | Service status and capabilities |
+| `lw deposit <amount>` | Generate deposit invoice |
+| `lw withdraw <invoice>` | Withdraw to external wallet |
+| `lw pay <invoice>` | Pay BOLT11 invoice `[--max-fee <sats>]` |
+| `lw pay-api <url>` | Pay L402/X402 API `[--method GET] [--body "{}"] [--max-sats 1000]` |
+| `lw decode <invoice>` | Decode BOLT11 invoice |
+| `lw create-agent <name>` | Create agent `[--budget <sats>]` |
+| `lw fund-agent <id> <amount>` | Transfer sats to agent |
+| `lw list-agents` | List all agents |
+| `lw transactions` | Recent transactions `[--limit 10] [--offset 0]` |
+| `lw help` | Show all commands |
+
+### Agent Workflow Example (Bash)
+
+```bash
+# 1. Register (one-time)
+export LIGHTNING_WALLET_API_KEY=$(lw register --name "My Agent" | jq -r '.api_key')
+
+# 2. Fund the account (pay the invoice with any Lightning wallet)
+lw deposit 10000 | jq -r '.bolt11'
+
+# 3. Create an agent with a budget
+AGENT=$(lw create-agent "Worker" --budget 5000)
+AGENT_ID=$(echo $AGENT | jq -r '.agent_id')
+AGENT_KEY=$(echo $AGENT | jq -r '.agent_api_key')
+
+# 4. Fund the agent
+lw fund-agent $AGENT_ID 2000
+
+# 5. Switch to agent context and make payments
+export LIGHTNING_WALLET_API_KEY=$AGENT_KEY
+lw pay-api "https://api.example.com/data" --max-sats 100
+
+# 6. Check what happened
+lw transactions --limit 5
+```
+
 ## Paid API Protocols: L402 + X402
 
 Lightning Wallet MCP supports two HTTP 402 payment protocols:
@@ -448,7 +526,10 @@ All payment responses include `platform_fee_sats`, `routing_fee_sats`, and `tota
 
 ## Changelog
 
-### v1.1.0 (2026-02-06)
+### v1.1.0 (2026-02-16)
+- **CLI interface:** New `lw` command for CLI-first agents (OpenClaw, Pi, KiloCode, any Bash agent)
+- **Same package, two interfaces:** `npm install -g lightning-wallet-mcp` gives you both MCP server and CLI
+- **JSON-first output:** All CLI commands output JSON to stdout, errors to stderr
 - **X402 support:** Automatic fallback to X402 (USDC on Base) when L402 is not available
 - **Protocol auto-detection:** `pay_l402_api` detects L402 or X402 from 402 response headers
 - **Response fields:** `payment_protocol` and `usdc_amount` included when X402 is used

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Lightning Wallet CLI
+ *
+ * CLI interface for AI agents that extend themselves via Bash.
+ * Same API, same backend as the MCP server — just a different interface.
+ *
+ * Usage: lw <command> [options]
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/cli.js

@@ -0,0 +1,397 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Lightning Wallet CLI
+ *
+ * CLI interface for AI agents that extend themselves via Bash.
+ * Same API, same backend as the MCP server — just a different interface.
+ *
+ * Usage: lw <command> [options]
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const lightning_faucet_js_1 = require("./lightning-faucet.js");
+const VERSION = '1.1.0';
+// --- Helpers ---
+function getApiKey() {
+    const key = process.env.LIGHTNING_WALLET_API_KEY || process.env.LIGHTNING_FAUCET_API_KEY;
+    if (!key) {
+        error('No API key found. Set LIGHTNING_WALLET_API_KEY or run: lw register');
+    }
+    return key;
+}
+function getClient() {
+    return new lightning_faucet_js_1.LightningFaucetClient(getApiKey());
+}
+function error(message) {
+    const out = JSON.stringify({ error: message });
+    process.stderr.write(message + '\n');
+    process.stdout.write(out + '\n');
+    process.exit(1);
+}
+function output(data, human) {
+    if (human) {
+        process.stdout.write(formatHuman(data) + '\n');
+    }
+    else {
+        process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+    }
+}
+function formatHuman(data, indent = 0) {
+    if (data === null || data === undefined)
+        return 'null';
+    if (typeof data !== 'object')
+        return String(data);
+    const prefix = '  '.repeat(indent);
+    if (Array.isArray(data)) {
+        if (data.length === 0)
+            return '(none)';
+        return data.map((item, i) => `${prefix}[${i}] ${formatHuman(item, indent + 1)}`).join('\n');
+    }
+    const obj = data;
+    const lines = [];
+    for (const [key, val] of Object.entries(obj)) {
+        if (typeof val === 'object' && val !== null) {
+            lines.push(`${prefix}${key}:`);
+            lines.push(formatHuman(val, indent + 1));
+        }
+        else {
+            lines.push(`${prefix}${key}: ${val}`);
+        }
+    }
+    return lines.join('\n');
+}
+function parseArgs(argv) {
+    const command = argv[0] || 'help';
+    const positional = [];
+    const flags = {};
+    for (let i = 1; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next && !next.startsWith('--')) {
+                flags[key] = next;
+                i++;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { command, positional, flags };
+}
+// --- Commands ---
+async function cmdRegister(positional, flags) {
+    const name = flags.name || positional[0] || undefined;
+    const result = await (0, lightning_faucet_js_1.registerOperator)(name);
+    return {
+        operator_id: result.operatorId,
+        api_key: result.apiKey,
+        recovery_code: result.recoveryCode,
+        hint: `export LIGHTNING_WALLET_API_KEY=${result.apiKey}`,
+    };
+}
+async function cmdWhoami() {
+    const client = getClient();
+    const result = await client.whoami();
+    const out = {
+        type: result.type,
+        id: result.id,
+        name: result.name,
+        balance_sats: result.balanceSats,
+    };
+    if (result.agentCount !== undefined)
+        out.agent_count = result.agentCount;
+    if (result.budgetLimitSats !== undefined)
+        out.budget_limit_sats = result.budgetLimitSats;
+    if (result.operatorId !== undefined)
+        out.operator_id = result.operatorId;
+    return out;
+}
+async function cmdBalance() {
+    const client = getClient();
+    const result = await client.checkBalance();
+    return { balance_sats: result.balanceSats };
+}
+async function cmdPay(positional, flags) {
+    const invoice = positional[0];
+    if (!invoice)
+        error('Usage: lw pay <bolt11_invoice>');
+    const client = getClient();
+    const maxFee = flags['max-fee'] ? parseInt(flags['max-fee'], 10) : undefined;
+    const result = await client.payInvoice(invoice, maxFee);
+    return {
+        preimage: result.preimage,
+        amount_sats: result.amountSats,
+        routing_fee_sats: result.routingFeeSats,
+        platform_fee_sats: result.platformFeeSats,
+        total_cost: result.totalCost,
+        payment_hash: result.paymentHash,
+        new_balance: result.newBalance,
+    };
+}
+async function cmdPayApi(positional, flags) {
+    const url = positional[0];
+    if (!url)
+        error('Usage: lw pay-api <url> [--method GET] [--body "{}"] [--max-sats 1000]');
+    const client = getClient();
+    const method = flags.method || 'GET';
+    const body = flags.body;
+    const maxSats = flags['max-sats'] ? parseInt(flags['max-sats'], 10) : 1000;
+    const result = await client.l402Pay(url, method, body === undefined ? undefined : body, maxSats);
+    const out = {
+        data: result.data,
+        status_code: result.statusCode,
+        amount_paid: result.amountPaid,
+        fee: result.fee,
+        payment_hash: result.paymentHash,
+    };
+    if (result.paymentProtocol)
+        out.payment_protocol = result.paymentProtocol;
+    if (result.usdcAmount)
+        out.usdc_amount = result.usdcAmount;
+    return out;
+}
+async function cmdCreateAgent(positional, flags) {
+    const name = positional[0] || flags.name;
+    if (!name)
+        error('Usage: lw create-agent <name> [--budget <sats>]');
+    const client = getClient();
+    const budget = flags.budget ? parseInt(flags.budget, 10) : undefined;
+    const result = await client.createAgent(name, undefined, budget);
+    return {
+        agent_id: result.agentId,
+        agent_api_key: result.agentApiKey,
+        name: result.name,
+    };
+}
+async function cmdFundAgent(positional) {
+    const agentId = positional[0];
+    const amount = positional[1];
+    if (!agentId || !amount)
+        error('Usage: lw fund-agent <agent_id> <amount_sats>');
+    const client = getClient();
+    const result = await client.fundAgent(parseInt(agentId, 10), parseInt(amount, 10));
+    return {
+        amount_transferred: result.amountTransferred,
+        new_operator_balance: result.newOperatorBalance,
+        new_agent_balance: result.newAgentBalance,
+    };
+}
+async function cmdListAgents() {
+    const client = getClient();
+    const result = await client.listAgents();
+    return result.agents.map(a => ({
+        id: a.id,
+        name: a.name,
+        balance_sats: a.balanceSats,
+        is_active: a.isActive,
+    }));
+}
+async function cmdDeposit(positional) {
+    const amount = positional[0];
+    if (!amount)
+        error('Usage: lw deposit <amount_sats>');
+    const client = getClient();
+    const result = await client.getDepositInvoice(parseInt(amount, 10));
+    return {
+        bolt11: result.bolt11,
+        payment_hash: result.paymentHash,
+        expires_at: result.expiresAt,
+        payment_url: result.paymentUrl,
+        qr_url: result.qrUrl,
+    };
+}
+async function cmdWithdraw(positional) {
+    const invoice = positional[0];
+    if (!invoice)
+        error('Usage: lw withdraw <bolt11_invoice>');
+    const client = getClient();
+    const result = await client.withdraw(invoice);
+    return {
+        amount_sats: result.amountSats,
+        routing_fee_sats: result.routingFeeSats,
+        platform_fee_sats: result.platformFeeSats,
+        total_cost: result.totalCost,
+        payment_hash: result.paymentHash,
+        new_balance: result.newBalance,
+    };
+}
+async function cmdTransactions(flags) {
+    const client = getClient();
+    const limit = flags.limit ? parseInt(flags.limit, 10) : 10;
+    const offset = flags.offset ? parseInt(flags.offset, 10) : 0;
+    const result = await client.getTransactions(limit, offset);
+    return {
+        transactions: result.transactions.map(tx => ({
+            type: tx.type,
+            amount_sats: tx.amountSats,
+            fee_sats: tx.feeSats,
+            memo: tx.memo,
+            payment_hash: tx.paymentHash,
+            timestamp: tx.timestamp,
+            balance_after: tx.balanceAfter,
+        })),
+        total: result.total,
+        has_more: result.hasMore,
+    };
+}
+async function cmdInfo() {
+    const client = getClient();
+    const result = await client.getInfo();
+    return {
+        version: result.version,
+        api_version: result.apiVersion,
+        status: result.status,
+        max_payment_sats: result.maxPaymentSats,
+        min_payment_sats: result.minPaymentSats,
+        supported_features: result.supportedFeatures,
+    };
+}
+async function cmdDecode(positional) {
+    const invoice = positional[0];
+    if (!invoice)
+        error('Usage: lw decode <bolt11_invoice>');
+    const client = getClient();
+    const result = await client.decodeInvoice(invoice);
+    return {
+        amount_sats: result.amountSats,
+        description: result.description,
+        payment_hash: result.paymentHash,
+        destination: result.destination,
+        expires_at: result.expiresAt,
+        is_expired: result.isExpired,
+        created_at: result.createdAt,
+    };
+}
+function cmdHelp() {
+    const help = `Lightning Wallet CLI v${VERSION}
+https://lightningfaucet.com/ai-agents
+
+Give your AI agent a Bitcoin wallet. Works with any agent framework.
+
+USAGE
+  lw <command> [options]
+
+SETUP
+  register [--name "name"]        Create operator account, prints API key
+  export LIGHTNING_WALLET_API_KEY=<key>   Set API key (after register)
+
+COMMANDS
+  whoami                          Show current identity (operator or agent)
+  balance                         Check balance in satoshis
+  info                            Service status and capabilities
+  deposit <amount>                Generate deposit invoice (sats)
+  withdraw <invoice>              Withdraw to external wallet
+
+  pay <invoice>                   Pay a BOLT11 invoice [--max-fee <sats>]
+  pay-api <url>                   Pay L402/X402 API (auto-detect protocol)
+                                    [--method GET] [--body "{}"] [--max-sats 1000]
+  decode <invoice>                Decode BOLT11 invoice without paying
+
+  create-agent <name>             Create agent [--budget <sats>]
+  fund-agent <id> <amount>        Transfer sats to agent
+  list-agents                     List all agents
+
+  transactions                    Recent transactions [--limit 10] [--offset 0]
+  help                            Show this help
+
+OUTPUT
+  Default: JSON (pipe to jq for parsing)
+  --human                         Human-readable output
+
+EXAMPLES
+  # Register and save key
+  export LIGHTNING_WALLET_API_KEY=$(lw register --name "My Bot" | jq -r '.api_key')
+
+  # Check balance
+  lw balance | jq '.balance_sats'
+
+  # Pay an L402 API
+  lw pay-api "https://lightningfaucet.com/api/l402/fortune"
+
+  # Create and fund an agent
+  lw create-agent "Research Bot" --budget 5000
+  lw fund-agent 1 1000
+
+DOCS
+  https://lightningfaucet.com/ai-agents/docs
+  https://github.com/lightningfaucet/lightning-wallet-mcp`;
+    process.stdout.write(help + '\n');
+}
+// --- Main ---
+async function main() {
+    const args = process.argv.slice(2);
+    const { command, positional, flags } = parseArgs(args);
+    const human = flags.human === true || flags.pretty === true;
+    try {
+        let result;
+        switch (command) {
+            case 'register':
+                result = await cmdRegister(positional, flags);
+                break;
+            case 'whoami':
+                result = await cmdWhoami();
+                break;
+            case 'balance':
+                result = await cmdBalance();
+                break;
+            case 'pay':
+                result = await cmdPay(positional, flags);
+                break;
+            case 'pay-api':
+                result = await cmdPayApi(positional, flags);
+                break;
+            case 'create-agent':
+                result = await cmdCreateAgent(positional, flags);
+                break;
+            case 'fund-agent':
+                result = await cmdFundAgent(positional);
+                break;
+            case 'list-agents':
+                result = await cmdListAgents();
+                break;
+            case 'deposit':
+                result = await cmdDeposit(positional);
+                break;
+            case 'withdraw':
+                result = await cmdWithdraw(positional);
+                break;
+            case 'transactions':
+                result = await cmdTransactions(flags);
+                break;
+            case 'info':
+                result = await cmdInfo();
+                break;
+            case 'decode':
+                result = await cmdDecode(positional);
+                break;
+            case 'help':
+            case '--help':
+            case '-h':
+                cmdHelp();
+                return;
+            case 'version':
+            case '--version':
+            case '-v':
+                process.stdout.write(VERSION + '\n');
+                return;
+            default:
+                process.stderr.write(`Unknown command: ${command}\n\n`);
+                cmdHelp();
+                process.exit(1);
+        }
+        output(result, human);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`Error: ${message}\n`);
+        process.stdout.write(JSON.stringify({ error: message }) + '\n');
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "lightning-wallet-mcp",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "mcpName": "io.github.lightningfaucet/lightning-wallet-mcp",
-  "description": "MCP server for Lightning Wallet - enables AI agents to send and receive Bitcoin via Lightning Network",
+  "description": "Lightning wallet for AI agents. MCP server + CLI. Works with Claude Code, OpenClaw, Cursor, and any agent framework.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "lightning-wallet-mcp": "dist/index.js"
+    "lightning-wallet-mcp": "dist/index.js",
+    "lw": "dist/cli.js"
   },
   "scripts": {
     "build": "tsc",
@@ -22,7 +23,10 @@
     "l402",
     "payments",
     "lightning-faucet-mcp",
-    "wallet"
+    "wallet",
+    "cli",
+    "openai",
+    "agent-framework"
   ],
   "author": "Lightning Faucet",
   "license": "MIT",