lightning-wallet-mcp 1.5.2 → 1.5.3

package/dist/index.js

@@ -581,7 +581,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         // ==========================================
         {
             name: 'get_info',
-            description: 'Get service information including version, status, limits, and supported features.',
+            description: 'Get service information including version, status, limits, and supported features. No API key required — works before registering.',
             inputSchema: {
                 type: 'object',
                 properties: {},
@@ -590,7 +590,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         },
         {
             name: 'decode_invoice',
-            description: 'Decode a BOLT11 invoice without paying it. Returns amount, description, expiry, and destination.',
+            description: 'Decode a BOLT11 invoice without paying it. Returns amount, description, expiry, and destination. No API key required — works before registering.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1353,7 +1353,13 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             }
             case 'decode_invoice': {
                 const parsed = DecodeInvoiceSchema.parse(args ?? {});
-                const result = await session.requireClient().decodeInvoice(parsed.bolt11);
+                // Invoice decoding is a public endpoint — fall back to an
+                // unauthenticated request so agents can inspect invoices before
+                // registering / configuring a key.
+                const decodeClient = session.getClient();
+                const result = decodeClient
+                    ? await decodeClient.decodeInvoice(parsed.bolt11)
+                    : await (0, lightning_faucet_js_1.getPublicDecodedInvoice)(parsed.bolt11);
                 return {
                     content: [
                         {

package/dist/lightning-faucet.d.ts

@@ -566,4 +566,14 @@ export declare function getPublicInfo(): Promise<{
     supportedFeatures: string[];
     rawResponse: ApiResponse;
 }>;
+export declare function getPublicDecodedInvoice(bolt11: string): Promise<{
+    amountSats: number;
+    description: string;
+    paymentHash: string;
+    destination: string;
+    expiresAt: string;
+    isExpired: boolean;
+    createdAt?: string;
+    rawResponse: ApiResponse;
+}>;
 export {};

package/dist/lightning-faucet.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LightningFaucetClient = void 0;
 exports.registerOperator = registerOperator;
 exports.getPublicInfo = getPublicInfo;
+exports.getPublicDecodedInvoice = getPublicDecodedInvoice;
 const pre_payment_hook_js_1 = require("./pre-payment-hook.js");
 const bolt11_js_1 = require("./bolt11.js");
 const API_BASE_URL = process.env.LIGHTNING_WALLET_API_URL || 'https://lightningfaucet.com/ai-agents/api';
@@ -953,3 +954,33 @@ async function getPublicInfo() {
         rawResponse: result,
     };
 }
+// Public invoice decode (no API key needed — the backend just parses the invoice)
+async function getPublicDecodedInvoice(bolt11) {
+    const response = await fetch(API_BASE_URL, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ action: 'decode_invoice', invoice: bolt11 }),
+    });
+    if (!response.ok) {
+        throw new Error(`Request failed (HTTP ${response.status})`);
+    }
+    const result = (await response.json());
+    if (!result.success) {
+        throw new Error(result.error || 'Unknown API error');
+    }
+    const amountSats = result.amount_sats || parseInt(result.num_satoshis || '0', 10);
+    const timestamp = result.timestamp ? parseInt(result.timestamp, 10) : 0;
+    const expiry = result.expiry ? parseInt(result.expiry, 10) : 3600;
+    const expiresAt = result.expires_at || new Date((timestamp + expiry) * 1000).toISOString();
+    const isExpired = result.is_expired ?? (timestamp + expiry < Date.now() / 1000);
+    return {
+        amountSats,
+        description: result.description || '',
+        paymentHash: result.payment_hash || '',
+        destination: result.destination || '',
+        expiresAt,
+        isExpired,
+        createdAt: timestamp ? new Date(timestamp * 1000).toISOString() : undefined,
+        rawResponse: result,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightning-wallet-mcp",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "mcpName": "io.github.lightningfaucet/lightning-wallet-mcp",
   "description": "Lightning wallet for AI agents. MCP server + CLI. Works with Claude Code, OpenClaw, Cursor, and any agent framework.",
   "main": "dist/index.js",