Create a Wallet
' +
+ 'An isolated wallet you pair to a single app, with its own Lightning Address.
' + + '' +
'
' +
'' +
'' +
@@ -143,7 +218,7 @@ function _nwcRenderWalletState() {
var pairId = "nwc-pairing-uri-" + Math.random().toString(36).substring(2, 8);
html += '
';
+ html += '';
}
html += '';
@@ -237,19 +312,30 @@ function _nwcRenderWalletState() {
}
var canCreate = !!state.domain && !state.busy;
- html += '
⚠ One-time pairing secret. Save it now — it will not be shown again.
';
if (created.pairing_qrcode) {
- html += 'Scan now in Zeus or copy the URI below.
Scan now in Zeus or copy the URI below.
Pairing URI
' +
'' + escHtml(created.pairing_uri || "Unavailable") + '
' +
- '' +
- '' +
+ var walletCount = (state.wallets || []).length;
+ html += '';
- if (state.domain) {
- html += '
";
host.innerHTML = html;
_attachCopyHandlers(host);
+ _nwcWireDomainLink();
var createBtn = document.getElementById("nwc-open-create-btn");
if (createBtn) {
@@ -375,7 +474,7 @@ async function _nwcCreateWallet() {
};
if (!name) {
- _nwcSetMessage("error", "Wallet Connection name is required.");
+ _nwcSetMessage("error", "Wallet name is required.");
_nwcRenderWalletState();
return;
}
@@ -459,7 +558,7 @@ async function _nwcDrainWallet(walletId) {
async function _nwcDeleteWallet(walletId) {
if (!_nwcModalState || _nwcModalState.busy || !walletId) return;
- if (!window.confirm("Delete this wallet connection? This removes the wallet alias from Wallet Connections.")) return;
+ if (!window.confirm("Delete this wallet connection? This removes the wallet alias from Lightning Wallet Connections.")) return;
_nwcBusy(true);
_nwcClearMessage();
_nwcRenderWalletState();
@@ -500,6 +599,8 @@ async function _nwcInitWalletFlow(unit, name, icon) {
async function openServiceDetailModal(unit, name, icon) {
if (!$credsModal) return;
+ var isNwc = _isNwcServiceUnit(unit);
+ _setCredsDialogWide(isNwc);
if ($credsTitle) {
$credsTitle.innerHTML = '';
if (icon) {
@@ -521,13 +622,24 @@ async function openServiceDetailModal(unit, name, icon) {
var url = "/api/service-detail/" + encodeURIComponent(unit);
if (icon) url += "?icon=" + encodeURIComponent(icon);
var data = await apiFetch(url);
+
+ // Two content buckets. For most services everything lands in `html` and is
+ // rendered as one column, exactly as before. For Lightning Wallet
+ // Connections the day-to-day wallet manager (html) is split away from the
+ // service plumbing — status, enable/disable, domain, ports, restart
+ // (setupHtml) — and the two are rendered as tabs so neither feels cramped.
var html = "";
+ var setupHtml = "";
+ function addSetup(chunk) {
+ if (isNwc) setupHtml += chunk;
+ else html += chunk;
+ }
// Section A: Description
if (data.description) {
- html += 'Lightning Address domain: ' + escHtml(state.domain) + '
'; - } else { - html += 'Domain required
';
+ if (!state.domain) {
+ html += 'Configure the Lightning Address domain in the Domain Diagnostic Checklist above before creating Wallet Connections. Use a unique hostname such as lightning.yourdomain.com.
' +
+ '⚠ Lightning Address domain required' +
+ '
';
}
if (!state.wallets || state.wallets.length === 0) {
- html += 'Set up a unique hostname such as lightning.yourdomain.com before creating wallets.
' +
+ '' +
+ 'No wallet connections yet. Create your first wallet connection to generate a one-time pairing secret.
'; + html += '' +
+ '' +
+ '
';
host.innerHTML = html;
+ _nwcWireDomainLink();
var openCreateBtn = document.getElementById("nwc-open-create-btn");
if (openCreateBtn) {
openCreateBtn.addEventListener("click", function() {
@@ -268,25 +354,38 @@ function _nwcRenderWalletState() {
state.wallets.forEach(function(wallet) {
var id = wallet.id || wallet.pubkey || "";
var addressId = "nwc-wallet-addr-" + Math.random().toString(36).substring(2, 8);
+ var pending = Number(wallet.pending_transactions || 0);
html += 'No wallets yet
' +
+ 'Create your first wallet to get a one-time pairing secret for an app, plus a reusable Lightning Address.
' + + '' +
- '' +
+ ''
- : "") +
- '' +
- '' +
+ ? '') +
'
';
});
html += "' + escHtml(wallet.name || "Wallet") + '
' +
- 'Alias
' + escHtml(wallet.alias || "") + '
' +
+ '
' +
(wallet.lightning_address
- ? '' + escHtml(wallet.name || "Wallet") + '
' +
+ '' +
+ '' + escHtml(_nwcFormatSats(wallet.balance_sats)) + ' sats' +
+ (pending > 0
+ ? '⏳ ' + escHtml(String(pending)) + ' pending'
+ : '') +
+ '
' +
+ 'Lightning Address
' + escHtml(wallet.lightning_address) + '
Balance
' + escHtml(String(wallet.balance_sats || 0)) + ' sats
Pending TX
' + escHtml(String(wallet.pending_transactions || 0)) + '
' +
+ '' +
+ '
'
+ : 'Lightning Address
' +
+ '' + escHtml(wallet.lightning_address) + '
' +
+ 'Alias
' +
+ '' + escHtml(wallet.alias || "") + '
' +
'' +
- '' +
- '' +
- '' +
+ '' +
+ '' +
+ '' +
+ '' +
'
' +
'' +
+ addSetup('
');
}
// Section B: Status
@@ -539,13 +651,13 @@ async function openServiceDetailModal(unit, name, icon) {
: (data.health || data.status);
var sc = statusClass(effectiveHealth);
var st = statusText(effectiveHealth, effectiveEnabled);
- html += '' +
'
';
+ '' + escHtml(data.description) + '
' + - '' +
+ addSetup('
');
// Section B2: BIP-110 live status (bip110 tile only)
if (icon === 'bip110' && data.bip110) {
@@ -587,15 +699,15 @@ async function openServiceDetailModal(unit, name, icon) {
domainActionHtml = '';
}
- html += '' +
'
';
+ 'Status
' +
'' +
'' +
'' + escHtml(st) + '' +
'
' +
- '' +
+ addSetup('
');
if (data.router_ports && data.router_ports.length > 0) {
var trimmedInternalIp = data.internal_ip ? String(data.internal_ip).trim() : "";
- html += '' +
'
';
+ 'Domain Diagnostic Checklist
' +
stepsHtml +
domainActionHtml +
- '' +
+ addSetup('
');
}
} else if (data.port_statuses && data.port_statuses.length > 0) {
// Non-domain services (e.g. SSH): show what to forward, plus a short
@@ -632,48 +744,57 @@ async function openServiceDetailModal(unit, name, icon) {
}
// Section E: Credentials & Links
- if (_isNwcServiceUnit(unit)) {
- html += '' +
'
';
+ 'Ports to Forward in Your Router
' +
renderPortForwardGuideHtml(data.router_ports, {
internalIp: trimmedInternalIp || null,
@@ -603,7 +715,7 @@ async function openServiceDetailModal(unit, name, icon) {
introClass: "svc-detail-port-note",
noteClass: "svc-detail-port-note",
}) +
- '' +
- '
Wallet Connections & Node Liquidity
';
+ if (isNwc) {
if (effectiveEnabled || data.enabled) {
- html += '' +
- '
' +
- '' +
+ html += '
' +
'
' +
- '' +
- '
' +
'Lightning Channel & Liquidity Guide
' + - 'How NWC & Lightning Addresses work on new nodes
' + + 'Your Lightning Wallets
' +
+ 'Each wallet is isolated: pair it to one app with a one-time secret, and share its Lightning Address to get paid.
' + '' +
- 'Your Alby Hub, NWC pairing keys, and Lightning Address endpoints (like name@yourdomain.com) are set up and working instantly. However, sending and receiving actual Bitcoin payments requires an operational Lightning node with active channels.' +
- '
' +
- '';
+ '';
} else {
- html += '
';
} else if (data.has_credentials && data.credentials && data.credentials.length > 0) {
html += '' +
- '
' +
- '1
' +
- '' +
- 'Outbound Liquidity (Sending)' +
- '' +
+ '
' +
- 'Required so apps connected via NWC can pay invoices and send funds.
' + + 'Loading wallets…
' +
+ '
' + + '' + + '' + + 'Lightning Channel & Liquidity Guide' + + 'Why a brand-new node can\'t send or receive yet' + + '' + + '
' + + '' +
+ '
' +
- '' +
+ 'Your wallets, pairing keys, and Lightning Address endpoints (like name@yourdomain.com) work the moment you create them. Moving actual bitcoin, though, needs a Lightning node with open channels.' +
+ '
' +
+ '
' +
+ '' +
+ '
' +
+ '1
' +
+ '' +
+ 'Outbound Liquidity (Sending)' +
+ '
' +
+ 'Required so connected apps can pay invoices and send funds.
' + + '' +
+ '
' +
+ '2
' +
+ '' +
+ 'Inbound Liquidity (Receiving)' +
+ '
' +
+ 'Required so your Lightning Address can receive payments from anyone.
' + + '' +
+ '
' +
'💧 The Plumbing Analogy: Channels are two-way water pipes. To pour water in (receive) or pump it out (send), you need open channels with liquidity on the right side.
' + + '' + '' +
- '
' +
- '2
' +
- '' +
- 'Inbound Liquidity (Receiving)' +
- '
' +
- 'Required so your Lightning Address can receive incoming payments from anyone.
' + - '' +
- '
' +
- '💧 The Plumbing Analogy: Think of channels like two-way water pipes. To pour water in (receive) or pump water out (send), you need open channels with liquidity on both sides.
' + - '' + - 'Create, verify, drain, and delete isolated NWC wallet connections without leaving the Hub.
' + - 'Loading wallet connections…
Wallet Connections is disabled. Enable this feature below, rebuild, then return here to create and manage NWC wallet connections.
'; + html += '' +
+ '' +
+ '
';
}
- html += 'Lightning Wallet Connections is turned off
' +
+ 'Enable it on the Service & Setup tab and rebuild, then come back here to create and manage wallets.
' + + '' + + '' +
'
');
}
if ((effectiveEnabled || data.enabled) && unit !== "phpfpm-nextcloud.service" && unit !== "phpfpm-wordpress.service") {
- html += 'Credentials & Access
' +
@@ -733,7 +854,7 @@ async function openServiceDetailModal(unit, name, icon) {
conflictsHtml = '\u26A0 Mutually exclusive with: ' + escHtml(conflictNames.join(", ")) + '
';
}
- html += '' +
+ addSetup('
';
+ '' +
'
' +
- '' + addonSectionTitle + '
' +
'' + escHtml(addonDesc) + '
' + conflictsHtml + @@ -741,19 +862,35 @@ async function openServiceDetailModal(unit, name, icon) { '' + addonStatusLabel + '' + '' + '' +
+ addSetup('
');
+ }
+
+ if (isNwc) {
+ // Land on Setup when the service is off or the domain still needs
+ // configuring — otherwise the Wallets tab is the useful default.
+ var domainReady = !!data.domain;
+ var startTab = (effectiveEnabled || data.enabled) && domainReady ? "wallets" : "setup";
+ html = _nwcTabsShellHtml({
+ walletsHtml: html,
+ setupHtml: setupHtml,
+ statusDotClass: sc,
+ statusLabel: st,
+ domain: data.domain || null,
+ activeTab: startTab
+ });
}
$credsBody.innerHTML = html;
+ if (isNwc) _nwcWireTabs();
_attachCopyHandlers($credsBody);
if (_isNwcServiceUnit(unit) && (effectiveEnabled || data.enabled)) {
await _nwcInitWalletFlow(unit, name, icon);
@@ -849,6 +986,7 @@ async function openServiceDetailModal(unit, name, icon) {
async function openCredsModal(unit, name, icon) {
if (!$credsModal) return;
+ _setCredsDialogWide(false);
if ($credsTitle) {
$credsTitle.innerHTML = '';
if (icon) {
diff --git a/modules/core/caddy.nix b/modules/core/caddy.nix
index 9b56f89..5f6d9e3 100755
--- a/modules/core/caddy.nix
+++ b/modules/core/caddy.nix
@@ -188,7 +188,7 @@ $HAVEN {
EOF
fi
- # ── Wallet Connections LNURL ──────────────────────
+ # ── Lightning Wallet Connections LNURL ──────────────────────
if [ -n "$LIGHTNING" ]; then
cat >> /run/caddy/Caddyfile <' +
'
';
+ 'Troubleshooting
' +
'If you\'re experiencing issues with this service, try restarting it.
' + '' + '' + - '