1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
|
// NIP-57 Lightning zaps — pay an npub / lightning address / lnurl over
// Lightning, attaching a signed zap request so the recipient's server posts a
// public zap receipt. This feature only does the *resolution* half (target →
// LNURL params → signed request → bolt11); the actual payment reuses the swaps
// feature's Boltz submarine flow via the `startLnPay` hook, so there's one
// tested LN pay/review/confirm/success path.
//
// Routing (see features/index.js order): a bolt11 is caught by swaps first; an
// npub is caught by ark first (an instant free Ark zap) when Ark is available,
// and only reaches here otherwise — plus ark's "no Ark address" screen hands
// off to us explicitly via the lnZapNpub hook. Lightning addresses and lnurls
// land here directly.
import { t } from '../i18n.js';
import { npubOf } from '../nostr.js';
import { parseZapTarget, zapTargetFromProfile, fetchPayParams, buildZapRequest, requestInvoice } from '../lnurl.js';
export function zapsFeature(ctx) {
const { h, ui, render, wallet, blankSend, parseAmount, getUnit, unitTag, hook, toast, fmtAmount, unitLabel } = ctx;
// Lightning payment has to be possible for a zap to make sense.
const canPay = () => !wallet.watchOnly && !!hook('canLnPay');
const shortNpub = (npub) => (npub && npub.length > 16 ? npub.slice(0, 12) + '…' + npub.slice(-6) : npub);
// Kick off resolution of a parsed target. `display` is what we show as the
// recipient until a profile name arrives.
function begin(target, display) {
ui.arkZap = null; ui.arkZapped = null; // in case we were handed off from ark
ui.sendError = '';
const z = (ui.zap = { status: 'resolving', target, name: display, address: target.address || null, amount: '', comment: '' });
render();
resolve(z).catch((e) => { if (ui.zap === z) { z.status = 'error'; z.error = e.message; render(); } });
}
async function resolve(z) {
let target = z.target;
// An npub needs a profile lookup to find its lud16/lud06.
if (target.kind === 'npub') {
const profile = await wallet.nostrProfile(target.pk);
if (profile && profile.name) z.name = profile.name;
const lnTarget = zapTargetFromProfile(profile, target.pk);
if (!lnTarget) { z.status = 'error'; z.error = t('lnZapNoAddress'); render(); return; }
z.target = target = { ...lnTarget, eventId: target.eventId || null }; // keep the note being zapped
z.address = lnTarget.address || z.address;
}
const params = await fetchPayParams(target.url);
if (ui.zap !== z) return; // user navigated away
z.params = params;
z.status = 'ready';
render();
}
// One-tap zap at the user's default amount: resolve, invoice, pay through
// the ark seam (its quote + retries included), and report by toast — the
// whole flow without a single screen.
async function autoZap(target, sats) {
const profile = await wallet.nostrProfile(target.pk);
const lnTarget = zapTargetFromProfile(profile, target.pk);
if (!lnTarget) throw new Error(t('lnZapNoAddress'));
const t2 = { ...lnTarget, eventId: target.eventId || null };
const p = await fetchPayParams(t2.url);
const msat = sats * 1000;
if (msat < p.minSendable || msat > p.maxSendable) {
throw new Error(t('lnZapRange', {
min: Math.ceil(p.minSendable / 1000).toLocaleString(),
max: Math.floor(p.maxSendable / 1000).toLocaleString(),
}));
}
let zapRequest = null;
if (p.allowsNostr && t2.pk && wallet.nostrSign) {
zapRequest = buildZapRequest({
amountMsat: msat, relays: wallet.nostrRelays(), lnurlBech32: t2.lnurlBech32,
recipientPk: t2.pk, eventId: t2.eventId || null, comment: '',
signFn: (partial) => wallet.nostrSign(partial),
});
}
const invoice = await requestInvoice(p, { amountMsat: msat, zapRequest, lnurlBech32: t2.lnurlBech32 });
await hook('arkPayInvoice', invoice, { maxAmountSat: sats + 50 });
toast('⚡ ' + t('zapSentShort', { n: fmtAmount(sats) + ' ' + unitLabel() }));
render();
}
async function confirm() {
const z = ui.zap;
if (!z || z.status !== 'ready') return;
const sats = parseAmount(z.amount, getUnit());
const p = z.params;
if (!sats || sats <= 0) { z.error = t('enterValidAmtForN', { n: 1 }); return render(); }
const msat = sats * 1000;
const capSat = Math.min(Math.floor(p.maxSendable / 1000), hook('lnSpendableSat') ?? Infinity);
if (msat < p.minSendable || sats > capSat) {
z.error = t('lnZapRange', { min: Math.ceil(p.minSendable / 1000).toLocaleString(), max: capSat.toLocaleString() });
return render();
}
z.error = ''; z.status = 'invoicing'; render();
try {
// Attribute a real zap only when the server supports it and we know the
// recipient's nostr key; otherwise fall back to a plain LNURL-pay.
let zapRequest = null;
const canZap = p.allowsNostr && z.target.pk && wallet.nostrSign;
if (canZap) {
zapRequest = buildZapRequest({
amountMsat: msat, relays: wallet.nostrRelays(), lnurlBech32: z.target.lnurlBech32,
recipientPk: z.target.pk, eventId: z.target.eventId || null, comment: z.comment,
signFn: (partial) => wallet.nostrSign(partial),
});
}
const invoice = await requestInvoice(p, { amountMsat: msat, zapRequest, lnurlBech32: z.target.lnurlBech32, comment: z.comment });
const meta = { name: z.name, address: z.address, pk: z.target.pk || null, comment: canZap ? z.comment : '', isZap: !!zapRequest };
ui.zap = null;
// Hand the bolt11 to the swaps feature's pay flow (review → confirm).
hook('startLnPay', invoice, meta);
render();
} catch (e) {
z.status = 'ready'; z.error = e.message; render();
}
}
function zapView() {
const z = ui.zap;
if (!z) return null;
const back = () => { ui.zap = null; ui.sendError = ''; ui.send = blankSend(); render(); };
// Resolution is a background step, not a screen: the send form stays put
// and shows one inline line (resolvingNote below) until we can render
// something the user can act on.
if (z.status === 'resolving') {
// twin of ark's skeleton: identical shape, so the handoff is invisible
return h('div', { class: 'card col', style: 'gap:12px' },
h('h3', {}, '⚡ ' + t('zapTitle')),
(z.target && z.target.pk && hook('profileChip', z.target.pk, 'lg'))
|| h('div', { class: 'small muted break' }, z.name || z.address || ''),
h('div', { class: 'row gap6', style: 'align-items:center;padding:6px 0' },
h('span', { class: 'spinner sm' }),
h('span', { class: 'small muted' }, t('zapFinding'))),
h('button', { class: 'btn-ghost btn-block', onClick: back }, t('back')));
}
if (z.status === 'invoicing') {
return h('div', { class: 'card col', style: 'align-items:center;gap:14px;padding:32px 14px' },
h('span', { class: 'spinner' }),
h('p', { class: 'muted', style: 'margin:0' }, t('lnZapRequesting')));
}
if (z.status === 'error') {
return h('div', { class: 'card col', style: 'gap:12px' },
h('h3', {}, '⚡ ' + t('zapTitle')),
(z.target && z.target.pk && hook('profileChip', z.target.pk, 'lg')) || h('div', { class: 'small muted', style: 'word-break:break-all' }, z.name || ''),
h('div', { class: 'notice err' }, z.error || t('lnZapFailed')),
h('button', { class: 'btn-ghost btn-block', onClick: back }, t('back')));
}
// ready: amount + optional comment. Their LNURL ceiling is meaningless
// past our own Spending balance — cap to the lower of the two, and when
// Spending can't even cover their minimum, say so instead of rendering
// an impossible range.
const p = z.params;
const ours = hook('lnSpendableSat');
const min = Math.ceil(p.minSendable / 1000);
const max = Math.min(Math.floor(p.maxSendable / 1000), ours != null ? ours : Infinity);
const broke = ours != null && (ours <= 0 || max < min);
const commentOk = p.allowsNostr || p.commentAllowed > 0;
// An amount Spending can't cover isn't a dead end when Savings can: the
// primary button turns into the door to the board panel, prefilled with
// what this payment needs (extra is one edit away).
const typedSats = parseAmount(z.amount, getUnit()) || 0;
const theirMaxSat = Math.floor(p.maxSendable / 1000);
const boardable = !!hook('arkReady') && ours != null;
const needsBoard = boardable && (broke || (typedSats > 0 && typedSats > ours && typedSats <= theirMaxSat));
return h('div', { class: 'card col', style: 'gap:12px' },
h('h3', {}, '⚡ ' + t('zapTitle')),
(z.target && z.target.pk && hook('profileChip', z.target.pk, 'lg')) || h('div', { class: 'small muted', style: 'word-break:break-all' }, z.name || z.address || ''),
h('div', { class: 'col gap6' },
h('div', { class: 'input-group' },
h('input', { type: 'number', min: '0', inputmode: 'decimal', placeholder: t('lnPayAmount'), value: z.amount,
onInput: (e) => { z.amount = e.target.value; render(); } }),
h('div', { style: 'display:flex;align-items:center' }, unitTag())),
broke
? h('div', { class: 'notice info' }, t('zapNoBalance'))
: h('div', { class: 'small faint' }, `Min ${min.toLocaleString()} · max ${max.toLocaleString()} sats`),
commentOk
? h('input', { type: 'text', class: 'mono-input', placeholder: t('arkZapCommentPh'), value: z.comment,
maxlength: p.allowsNostr ? '280' : String(p.commentAllowed || 280),
onInput: (e) => { z.comment = e.target.value; } })
: null,
h('div', { class: 'small faint' }, p.allowsNostr ? t('lnZapHintNostr') : t('lnZapHintPlain'))),
z.error ? h('div', { class: 'notice err' }, z.error) : null,
h('div', { class: 'row gap6' },
h('button', { class: 'btn-ghost', onClick: back }, t('back')),
needsBoard
? h('button', { class: 'btn-primary grow', onClick: () => hook('arkOfferBoard', typedSats || min) }, t('zapBoardBtn'))
: h('button', { class: 'btn-primary grow', onClick: confirm, disabled: broke }, t('arkZapBtn'))));
}
return {
id: 'zaps',
// A lightning address / lnurl (always), or an npub that Ark didn't claim.
matchSendText(text, typed) {
if (!canPay() || !ui.send || ui.send.recipients.length !== 1) return false;
const target = parseZapTarget(text);
if (!target) return false;
// npub with no nostr seam to look up a profile → can't resolve here.
if (target.kind === 'npub' && !wallet.nostrProfile) return false;
// A TYPED lightning address matches mid-keystroke (`[email protected]` before the
// user finishes `.com`), so never auto-advance while typing — the send
// form offers a zap button via sendFormNote instead. Pasted/scanned
// text is complete and advances immediately; npub/lnurl carry a bech32
// checksum and only ever match when complete.
if (typed && target.kind === 'lnaddr') return false;
const display = target.kind === 'npub' ? shortNpub(npubOf(target.pk) || text.trim()) : (target.address || text.trim());
begin(target, display);
return true;
},
// The typed-lightning-address affordance on the send form.
sendFormNote(a) {
if (!canPay() || !ui.send || ui.send.recipients.length !== 1) return null;
const target = parseZapTarget(a);
if (!target || target.kind === 'npub') return null;
const display = target.address || String(a || '').trim();
return h('button', {
type: 'button', class: 'btn-primary btn-block',
onClick: () => begin(target, display),
}, '⚡ ' + t('lnZapOffer', { addr: display }));
},
// The names feature resolves user@domain over DNS first (BIP-353) and
// lands here when the name has no DNS record — the classic LNURL path.
lnAddressFallback(text) {
if (!canPay() || !ui.send || ui.send.recipients.length !== 1) return false;
const target = parseZapTarget(text);
if (!target || target.kind === 'npub') return false;
begin(target, target.address || String(text).trim());
return true;
},
// True when an npub can be zapped over Lightning from this build/wallet —
// ark's "no Ark address" screen checks this before offering the fallback.
canLnZap() { return canPay() && !!wallet.nostrProfile; },
// Ark's "no Ark address published" screen offers a Lightning fallback,
// which lands here with the recipient's pubkey (and, when the zap was
// aimed at a note, its event id for the zap request's e tag).
lnZapNpub(pk, npub, eventId, autoSat) {
if (!canPay() || !wallet.nostrProfile) return false;
if (autoSat && hook('arkReady')) {
autoZap({ kind: 'npub', pk, eventId: eventId || null }, autoSat)
.catch((e) => toast('⚡ ' + e.message));
return true;
}
begin({ kind: 'npub', pk, eventId: eventId || null }, shortNpub(npub || npubOf(pk)));
return true;
},
sendView() { return zapView(); },
// Settings → Payments: the one-tap zap amount.
settingsCards() {
const cur = ctx.zapDefaultSat ? ctx.zapDefaultSat() : 0;
return [h('div', { class: 'card col', style: 'gap:8px' },
h('div', { class: 'row between', style: 'align-items:center;gap:10px' },
h('span', { class: 'small' }, '⚡ ' + t('zapDefaultLabel')),
h('div', { class: 'input-group', style: 'width:130px' },
h('input', { type: 'number', min: '1', value: cur || '', placeholder: '21',
style: 'text-align:right',
onInput: (e) => { const n = parseInt(e.target.value, 10); if (n > 0) ctx.setZapDefaultSat(n); } }),
h('span', { class: 'small muted', style: 'align-self:center;padding:0 6px' }, 'sats'))),
h('div', { class: 'small faint' }, t('zapDefaultHint')))];
},
};
}
|
