2020117-agent 0.4.3 → 0.4.5

package/dist/cashu.d.ts

@@ -45,6 +45,22 @@ export declare function decodeCashuToken(tokenStr: string): {
  * Encode proofs back into a portable token string.
  */
 export declare function encodeCashuToken(mintUrl: string, proofs: Proof[]): string;
+/**
+ * Melt proofs back into a Lightning invoice — converts Cashu back to Lightning.
+ * Returns the payment preimage and any change proofs.
+ */
+export declare function meltProofs(mintUrl: string, proofs: Proof[], invoice: string): Promise<{
+    preimage: string;
+    change: Proof[];
+}>;
+/**
+ * Estimate total cost to melt (invoice amount + fee_reserve) for a given invoice.
+ */
+export declare function estimateMeltFee(mintUrl: string, invoice: string): Promise<{
+    amount: number;
+    fee: number;
+    total: number;
+}>;
 /**
  * Request a mint quote — returns a Lightning invoice to pay for minting tokens.
  */

package/dist/cashu.js

@@ -60,6 +60,31 @@ export function decodeCashuToken(tokenStr) {
 export function encodeCashuToken(mintUrl, proofs) {
     return getEncodedTokenV4({ mint: mintUrl, proofs });
 }
+/**
+ * Melt proofs back into a Lightning invoice — converts Cashu back to Lightning.
+ * Returns the payment preimage and any change proofs.
+ */
+export async function meltProofs(mintUrl, proofs, invoice) {
+    const wallet = await getWallet(mintUrl);
+    const meltQuote = await wallet.createMeltQuote(invoice);
+    const amountNeeded = meltQuote.amount + meltQuote.fee_reserve;
+    const total = proofs.reduce((s, p) => s + p.amount, 0);
+    if (total < amountNeeded) {
+        throw new Error(`Need ${amountNeeded} sats (invoice ${meltQuote.amount} + fee ${meltQuote.fee_reserve}) but only have ${total}`);
+    }
+    const { send, keep } = await wallet.send(amountNeeded, proofs, { includeFees: true });
+    const result = await wallet.meltProofs(meltQuote, send);
+    const change = [...keep, ...(result.change || [])];
+    return { preimage: result.quote.payment_preimage || '', change };
+}
+/**
+ * Estimate total cost to melt (invoice amount + fee_reserve) for a given invoice.
+ */
+export async function estimateMeltFee(mintUrl, invoice) {
+    const wallet = await getWallet(mintUrl);
+    const quote = await wallet.createMeltQuote(invoice);
+    return { amount: quote.amount, fee: quote.fee_reserve, total: quote.amount + quote.fee_reserve };
+}
 /**
  * Request a mint quote — returns a Lightning invoice to pay for minting tokens.
  */

package/dist/session.js

@@ -43,12 +43,17 @@ for (const arg of process.argv.slice(2)) {
         case '--mint':
             process.env.CASHU_MINT_URL = val;
             break;
+        case '--nwc':
+            process.env.NWC_URI = val;
+            break;
     }
 }
 import { SwarmNode, topicFromKind } from './swarm.js';
 import { queryProviderSkill } from './p2p-customer.js';
 import { walletPayInvoice, walletGetBalance, hasApiKey } from './api.js';
-import { decodeCashuToken, sendCashuToken, createMintQuote, claimMintQuote } from './cashu.js';
+import { decodeCashuToken, sendCashuToken, createMintQuote, claimMintQuote, meltProofs, estimateMeltFee } from './cashu.js';
+import { parseNwcUri, nwcGetBalance, nwcPayInvoice, nwcMakeInvoice } from './nwc.js';
+import { loadSovereignKeys } from './nostr.js';
 import { randomBytes } from 'crypto';
 import { createServer } from 'http';
 import { createInterface } from 'readline';
@@ -60,6 +65,11 @@ const BUDGET = Number(process.env.BUDGET_SATS) || 500;
 const PORT = Number(process.env.SESSION_PORT) || 8080;
 const CASHU_TOKEN = process.env.CASHU_TOKEN || '';
 const MINT_URL = process.env.CASHU_MINT_URL || 'https://8333.space:3338';
+// Load NWC URI: --nwc flag > .2020117_keys nwc_uri > none
+let nwcParsed = null;
+const nwcUri = process.env.NWC_URI
+    || loadSovereignKeys(process.env.AGENT)?.nwc_uri
+    || null;
 // Mutable Cashu wallet state (loaded from CASHU_TOKEN at startup)
 let cashuState = null;
 const TICK_INTERVAL_MS = 60_000;
@@ -184,23 +194,43 @@ function setupMessageHandler() {
                     break;
                 }
                 if (msg.bolt11) {
-                    // Invoice mode: pay bolt11 via wallet
+                    // Invoice mode: pay bolt11 via NWC direct or platform API
                     log(`Paying invoice: ${amount} sats...`);
-                    const payResult = await walletPayInvoice(msg.bolt11);
-                    if (payResult.ok) {
-                        state.totalSpent += amount;
-                        log(`Paid ${amount} sats (total: ${state.totalSpent}, ~${estimatedMinutesLeft()} min left)`);
-                        state.node.send(state.socket, {
-                            type: 'session_tick_ack',
-                            id: msg.id,
-                            session_id: state.sessionId,
-                            preimage: payResult.preimage,
-                            amount,
-                        });
+                    if (nwcParsed) {
+                        try {
+                            const { preimage } = await nwcPayInvoice(nwcParsed, msg.bolt11);
+                            state.totalSpent += amount;
+                            log(`Paid ${amount} sats via NWC (total: ${state.totalSpent}, ~${estimatedMinutesLeft()} min left)`);
+                            state.node.send(state.socket, {
+                                type: 'session_tick_ack',
+                                id: msg.id,
+                                session_id: state.sessionId,
+                                preimage,
+                                amount,
+                            });
+                        }
+                        catch (e) {
+                            warn(`NWC invoice payment failed: ${e.message} — ending session`);
+                            endSession();
+                        }
                     }
                     else {
-                        warn(`Invoice payment failed: ${payResult.error} — ending session`);
-                        endSession();
+                        const payResult = await walletPayInvoice(msg.bolt11);
+                        if (payResult.ok) {
+                            state.totalSpent += amount;
+                            log(`Paid ${amount} sats (total: ${state.totalSpent}, ~${estimatedMinutesLeft()} min left)`);
+                            state.node.send(state.socket, {
+                                type: 'session_tick_ack',
+                                id: msg.id,
+                                session_id: state.sessionId,
+                                preimage: payResult.preimage,
+                                amount,
+                            });
+                        }
+                        else {
+                            warn(`Invoice payment failed: ${payResult.error} — ending session`);
+                            endSession();
+                        }
                     }
                 }
                 else if (cashuState) {
@@ -664,6 +694,32 @@ async function endSession() {
         }
         log(`Session ended. Total: ${state.totalSpent} sats for ${duration}s.`);
     }
+    // Refund remaining Cashu proofs back to NWC wallet
+    if (cashuState && cashuState.proofs.length > 0 && nwcParsed) {
+        const remaining = cashuState.proofs.reduce((s, p) => s + p.amount, 0);
+        if (remaining >= 3) {
+            log(`Refunding ${remaining} sats Cashu → NWC wallet...`);
+            try {
+                // Probe: create 1-sat invoice to discover melt fee_reserve + swap fee
+                const probe = await nwcMakeInvoice(nwcParsed, 1000, 'fee-probe');
+                const { fee } = await estimateMeltFee(cashuState.mintUrl, probe.bolt11);
+                // fee = melt fee_reserve; +1 for Cashu internal swap fee
+                const refundAmount = remaining - fee - 1;
+                if (refundAmount < 1) {
+                    warn(`Remaining ${remaining} sats < melt fee (${fee} sats), cannot refund`);
+                }
+                else {
+                    const { bolt11 } = await nwcMakeInvoice(nwcParsed, refundAmount * 1000, '2020117-session refund');
+                    const { preimage } = await meltProofs(cashuState.mintUrl, cashuState.proofs, bolt11);
+                    cashuState.proofs = [];
+                    log(`Refunded ${refundAmount} sats (fee: ${fee}, preimage: ${preimage?.slice(0, 16)}...)`);
+                }
+            }
+            catch (e) {
+                warn(`Refund failed: ${e.message} — ${remaining} sats lost`);
+            }
+        }
+    }
     // Close HTTP proxy
     if (state.httpServer) {
         state.httpServer.close();
@@ -743,8 +799,24 @@ async function main() {
             warn(`Cashu token (${tokenAmount} sats) is less than budget (${BUDGET} sats)`);
         }
     }
+    else if (nwcUri) {
+        // NWC direct: pay provider invoices via Lightning — no Cashu needed
+        nwcParsed = parseNwcUri(nwcUri);
+        const { balance_msats } = await nwcGetBalance(nwcParsed);
+        const balance = Math.floor(balance_msats / 1000);
+        if (balance <= 0) {
+            warn('NWC wallet balance is 0.');
+            await node.destroy();
+            process.exit(1);
+        }
+        if (balance < BUDGET) {
+            warn(`NWC wallet balance (${balance} sats) < budget (${BUDGET} sats)`);
+        }
+        paymentMethod = 'invoice';
+        log(`Payment: NWC direct (balance: ${balance} sats, pay-per-tick via Lightning)`);
+    }
     else if (hasApiKey()) {
-        // Auto-mint Cashu tokens via NWC wallet
+        // Platform API fallback: auto-mint Cashu tokens via platform wallet proxy
         const balance = await walletGetBalance();
         if (balance <= 0) {
             warn('Wallet balance is 0. Cannot auto-mint Cashu tokens.');
@@ -754,17 +826,14 @@ async function main() {
         const mintAmount = Math.min(balance, BUDGET);
         log(`Wallet balance: ${balance} sats — minting ${mintAmount} sats from ${MINT_URL}`);
         try {
-            // 1. Request mint quote (Lightning invoice)
             const { quote, invoice } = await createMintQuote(MINT_URL, mintAmount);
             log(`Mint quote: ${quote} (invoice: ${invoice.slice(0, 30)}...)`);
-            // 2. Pay the invoice via platform NWC wallet
-            log('Paying mint invoice via NWC wallet...');
+            log('Paying mint invoice via platform wallet...');
             const payResult = await walletPayInvoice(invoice);
             if (!payResult.ok) {
                 throw new Error(`Payment failed: ${payResult.error}`);
             }
             log(`Invoice paid (preimage: ${payResult.preimage?.slice(0, 16)}...)`);
-            // 3. Claim minted proofs
             log('Claiming minted tokens...');
             const token = await claimMintQuote(MINT_URL, mintAmount, quote);
             const { mint, proofs } = decodeCashuToken(token);
@@ -782,7 +851,8 @@ async function main() {
     else {
         warn('No payment method available.');
         warn('  Option 1 (default): --cashu-token=cashuA... (Cashu eCash token)');
-        warn('  Option 2: --agent=NAME (auto-mints Cashu via NWC wallet)');
+        warn('  Option 2: --nwc="nostr+walletconnect://..." (NWC direct wallet)');
+        warn('  Option 3: --agent=NAME (auto-mints via platform API)');
         await node.destroy();
         process.exit(1);
     }
@@ -807,6 +877,33 @@ async function main() {
         state.satsPerMinute = ackResp.sats_per_minute;
         log(`Provider adjusted rate: ${ackResp.sats_per_minute} sats/min`);
     }
+    // Provider may override payment method (e.g. no Lightning Address → force cashu)
+    if (ackResp.payment_method && ackResp.payment_method !== paymentMethod) {
+        if (ackResp.payment_method === 'cashu' && paymentMethod === 'invoice' && nwcParsed) {
+            // Provider doesn't support invoice — fall back to NWC-minted Cashu
+            log(`Provider requires Cashu — minting via NWC...`);
+            try {
+                const { balance_msats } = await nwcGetBalance(nwcParsed);
+                const balance = Math.floor(balance_msats / 1000);
+                const mintAmount = Math.min(balance, BUDGET);
+                const { quote, invoice } = await createMintQuote(MINT_URL, mintAmount);
+                const { preimage } = await nwcPayInvoice(nwcParsed, invoice);
+                const token = await claimMintQuote(MINT_URL, mintAmount, quote);
+                const { mint, proofs } = decodeCashuToken(token);
+                cashuState = { mintUrl: mint, proofs };
+                paymentMethod = 'cashu';
+                log(`Minted ${proofs.reduce((s, p) => s + p.amount, 0)} sats Cashu — fallback ready`);
+            }
+            catch (e) {
+                warn(`Cashu fallback mint failed: ${e.message}`);
+                await node.destroy();
+                process.exit(1);
+            }
+        }
+        else {
+            paymentMethod = ackResp.payment_method;
+        }
+    }
     log(`Session started: ${state.sessionId}`);
     log(`Billing: ${state.satsPerMinute} sats/min via ${paymentMethod}`);
     // 6. Start HTTP proxy

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "2020117-agent",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "2020117 agent runtime — API polling + Hyperswarm P2P + Sovereign Nostr mode + Cashu/Lightning payments",
   "type": "module",
   "bin": {