lightning-agent 0.3.1 → 0.3.3

package/README.md

@@ -1,8 +1,10 @@
 # ⚡ lightning-agent
 
-Lightning toolkit for AI agents. Payments, auth, escrow, and streaming micropayments.
+**Settle this transaction without a platform.**
 
-A SDK that gives AI agents the ability to transact, authenticate, escrow work, and stream content for sats — all over [Nostr Wallet Connect (NWC)](https://nwc.dev). No browser, no UI, no bank accounts. Connect to any NWC-compatible wallet (Alby Hub, Mutiny, etc.) and start building the agent economy.
+You can't transact without a payment rail. lightning-agent is the rail — payments, auth, escrow, and streaming micropayments over [Nostr Wallet Connect (NWC)](https://nwc.dev). No browser, no UI, no bank accounts, no Stripe. Connect to any NWC-compatible wallet (Alby Hub, Mutiny, etc.) and two agents can exchange value directly.
+
+Part of the constraint chain: [agent-discovery](https://github.com/jeletor/agent-discovery) (find) → [ai-wot](https://github.com/jeletor/ai-wot) (verify) → **lightning-agent** (pay) → [lightning-toll](https://github.com/jeletor/lightning-toll) (gate).
 
 ## Install
 

package/lib/auth.js

@@ -169,6 +169,18 @@ function createAuthServer(opts = {}) {
  * // Send sig + key back to the auth server
  */
 function signAuth(k1, privateKey) {
+  // Validate k1 is a 64-character hex string (32 bytes)
+  if (typeof k1 !== 'string' || !/^[0-9a-f]{64}$/i.test(k1)) {
+    throw new Error('k1 must be a 64-character hex string');
+  }
+
+  // Validate privateKey is valid hex when provided as string
+  if (typeof privateKey === 'string') {
+    if (!/^[0-9a-f]+$/i.test(privateKey) || privateKey.length === 0) {
+      throw new Error('privateKey must be a valid hex string');
+    }
+  }
+
   const privBuf = typeof privateKey === 'string'
     ? Buffer.from(privateKey, 'hex')
     : Buffer.from(privateKey);

package/lib/stream.js

@@ -415,14 +415,21 @@ function createStreamClient(wallet, opts = {}) {
 
                       // POST preimage back to provider
                       if (sessionId && payResult.preimage) {
-                        fetch(url, {
-                          method: 'POST',
-                          headers: { 'Content-Type': 'application/json' },
-                          body: JSON.stringify({
-                            sessionId,
-                            preimage: payResult.preimage
-                          })
-                        }).catch(() => {}); // Best effort
+                        try {
+                          const proofRes = await fetch(url, {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({
+                              sessionId,
+                              preimage: payResult.preimage
+                            })
+                          });
+                          if (!proofRes.ok) {
+                            console.error('Preimage POST failed:', proofRes.status);
+                          }
+                        } catch (postErr) {
+                          console.error('Preimage POST error:', postErr.message);
+                        }
                       }
                     } catch (err) {
                       // Payment failed — stream will pause

package/lib/wallet.js

@@ -90,9 +90,9 @@ function decodeBolt11(invoice) {
     amountSats,
     description,
     paymentHash,
-    network: hrp.startsWith('lntb') ? 'testnet' :
-             hrp.startsWith('lnbcrt') ? 'regtest' :
-             hrp.startsWith('lntbs') ? 'signet' : 'mainnet'
+    network: hrp.startsWith('lntbs') ? 'signet' :
+             hrp.startsWith('lntb') ? 'testnet' :
+             hrp.startsWith('lnbcrt') ? 'regtest' : 'mainnet'
   };
 }
 
@@ -265,12 +265,14 @@ class NWCWallet {
    * @param {number} [opts.timeoutMs] - Request timeout
    */
   async createInvoice(opts = {}) {
-    if (!opts.amountSats || opts.amountSats <= 0) {
+    // Accept both amountSats and amount for convenience
+    const sats = opts.amountSats || opts.amount;
+    if (!sats || sats <= 0) {
       throw new Error('amountSats is required and must be positive');
     }
 
     const params = {
-      amount: opts.amountSats * 1000, // NWC uses millisats
+      amount: sats * 1000, // NWC uses millisats
     };
     if (opts.description) params.description = opts.description;
     if (opts.expiry) params.expiry = opts.expiry;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightning-agent",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Lightning toolkit for AI agents. Payments, auth, escrow, and streaming micropayments.",
   "main": "lib/index.js",
   "bin": {