@getalby/cli 0.5.0 → 0.6.0

package/build/commands/discover.js

@@ -0,0 +1,24 @@
+import { discover } from "../tools/lightning/discover.js";
+import { handleError, output } from "../utils.js";
+export function registerDiscoverCommand(program) {
+    program
+        .command("discover")
+        .description("Search 402index.io for paid API services that accept bitcoin/lightning")
+        .option("-q, --query <text>", "Search query")
+        .option("-p, --protocol <protocol>", "Filter by protocol (L402, x402, MPP)")
+        .option("--health <status>", "Filter by health (healthy, degraded, down, unknown)", "healthy")
+        .option("-s, --sort <field>", "Sort by (reliability, latency, price, name)", "reliability")
+        .option("-l, --limit <number>", "Number of results", "10")
+        .action(async (options) => {
+        await handleError(async () => {
+            const result = await discover({
+                query: options.query,
+                protocol: options.protocol,
+                health: options.health,
+                sort: options.sort,
+                limit: parseInt(options.limit, 10),
+            });
+            output(result);
+        });
+    });
+}

package/build/index.js

@@ -22,6 +22,7 @@ import { registerRequestInvoiceFromLightningAddressCommand } from "./commands/re
 import { registerFetch402Command } from "./commands/fetch.js";
 import { registerConnectCommand } from "./commands/connect.js";
 import { registerAuthCommand } from "./commands/auth.js";
+import { registerDiscoverCommand } from "./commands/discover.js";
 const program = new Command();
 program
     .name("@getalby/cli")
@@ -32,7 +33,7 @@ program
     '    $ npx @getalby/cli connect "nostr+walletconnect://..."\n' +
     "    $ npx @getalby/cli get-balance\n" +
     "    $ npx @getalby/cli pay-invoice --invoice lnbc...")
-    .version("0.5.0")
+    .version("0.6.0")
     .option("-w, --wallet-name <name>", "Use a named wallet's connection secret (~/.alby-cli/connection-secret-<name>.key)")
     .option("-c, --connection-secret <string>", "NWC connection secret (nostr+walletconnect://...) or path to file containing it (preferred)")
     .option("-v, --verbose", "Print status messages to stderr")
@@ -77,6 +78,9 @@ registerRequestInvoiceFromLightningAddressCommand(program);
 // Register fetch command for payment-protected resources
 program.commandsGroup("HTTP 402 Payments (requires wallet connection):");
 registerFetch402Command(program);
+// Register service discovery
+program.commandsGroup("Service Discovery:");
+registerDiscoverCommand(program);
 // Register setup commands
 program.commandsGroup("Setup:");
 registerAuthCommand(program);

package/build/tools/lightning/discover.js

@@ -0,0 +1,51 @@
+export async function discover(params) {
+    const url = new URL("https://402index.io/api/v1/services");
+    const requestedLimit = params.limit ?? 10;
+    if (params.query)
+        url.searchParams.set("q", params.query);
+    if (params.protocol)
+        url.searchParams.set("protocol", params.protocol);
+    if (params.health)
+        url.searchParams.set("health", params.health);
+    if (params.sort)
+        url.searchParams.set("sort", params.sort);
+    // Filter to BTC (Lightning) services server-side
+    url.searchParams.set("payment_asset", "BTC");
+    url.searchParams.set("limit", String(requestedLimit));
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 5000);
+    let response;
+    try {
+        response = await fetch(url.toString(), { signal: controller.signal });
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new Error("Request to 402index.io timed out");
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!response.ok) {
+        throw new Error(`402index.io returned status ${response.status}: ${await response.text()}`);
+    }
+    const data = (await response.json());
+    return {
+        services: data.services.map((s) => ({
+            name: s.name,
+            description: s.description,
+            url: s.url,
+            protocol: s.protocol,
+            price_sats: s.price_sats,
+            price_usd: s.price_usd,
+            category: s.category,
+            provider: s.provider,
+            health_status: s.health_status,
+            reliability_score: s.reliability_score,
+            latency_p50_ms: s.latency_p50_ms,
+            http_method: s.http_method,
+        })),
+        total: data.total,
+    };
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@getalby/cli",
   "description": "CLI for Nostr Wallet Connect (NIP-47) with a few additional useful lightning tools",
   "repository": "https://github.com/getAlby/cli.git",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "main": "build/index.js",
   "bin": {