From 468932b1c3a70bc384bf9d123bf681cb2e7ce0d2 Mon Sep 17 00:00:00 2001
From: Adam Soltys <adam@coinos.io>
Date: Sun, 2 Aug 2026 09:04:52 -0700
Subject: Deliver incoming Lightning without depending on an operator float
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

A payment to an address settled on our node and then sat in a retry
queue because the float wallet that forwards it was empty — the money
was safe but invisible to the recipient. Delivery now has a second
route: ask the recipient's wallet for an invoice (CLINK) and pay it
over Lightning, which needs no float at all. The float path stays first
because it works while they're offline; the queue is now the last
resort rather than the only one.

Existing addresses never carried the wallet's offer key, so that route
was unavailable to them. The wallet now records what it published and
re-registers whenever the registrar is missing the current key.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 names/server.js | 28 +++++++++++++++++++++++-----
 1 file changed, 23 insertions(+), 5 deletions(-)

(limited to 'names/server.js')

diff --git a/names/server.js b/names/server.js
index 0005782..bd62f81 100644
--- a/names/server.js
+++ b/names/server.js
@@ -189,14 +189,32 @@ const arkParamOf = (uri) => {
   return m ? decodeURIComponent(m[1]) : null;
 };
 
-// Forward one settled offer payment; queue it on failure (empty float, etc).
+// Deliver a settled payment to the name's owner. Two ways, and we try the
+// one that works while they're asleep first:
+//   1. an arkoor send from the float — instant, free, needs no cooperation
+//   2. ask their wallet for an invoice and pay it over Lightning — needs no
+//      float at all, but only works while something of theirs is listening
+// Failing both, it queues and retries; nothing is ever dropped silently.
 async function forward(name, sat) {
   const rec = state.names[name];
   const dest = rec && arkParamOf(rec.uri);
-  if (!dest) { log(`forward: no ark destination for ${name}, dropping ${sat} sat`); return; }
-  if (!fwd) throw new Error('no forwarder wallet');
-  await fwd.send(dest, sat);
-  log(`forwarded ${sat} sat to ${name}`);
+  if (!dest && !rec?.offerPk) { log(`forward: nowhere to send ${sat} sat for ${name}`); return; }
+
+  if (dest && fwd && fwd.balance().spendableSat >= sat) {
+    await fwd.send(dest, sat);
+    log(`forwarded ${sat} sat to ${name}`);
+    return;
+  }
+
+  if (rec?.offerPk && ln) {
+    const pr = await requestInvoiceFromWallet(rec.offerPk, { amountSat: sat, description: `${name} payment` });
+    if (pr) {
+      await ln.pay(pr, { maxfeeSat: Math.max(2, Math.ceil(sat * 0.005)) });
+      log(`delivered ${sat} sat to ${name} over lightning (no float needed)`);
+      return;
+    }
+  }
+  throw new Error(fwd && dest ? 'insufficient float and the wallet is not listening' : 'no delivery route');
 }
 
 // NIP-57: a zap we invoiced is only "a zap" once we publish the receipt,
-- 
cgit v1.2.3