v0.8.1
Powered by

zaps — NIP-57 zap operations

Send and inspect Lightning zaps. The zap sub-command pays from a stored NWC wallet (see wallets add nwc); invoice only fetches a BOLT11 invoice and needs no wallet; receipts reads kind 9735 zap receipts.

ndk zaps <sub-command> [args]
Sub-command Description
invoice <lud16> <amountSats> Fetch a zap/lightning invoice (no payment). Zap-encoded when a signer and recipient --pubkey are available; --no-zap forces a plain LN invoice.
zap <lud16> <amountSats> Pay a zap using the default NWC sending wallet (or --wallet <id>). Waits for the zap receipt unless --no-receipt.
receipts <pubkey> List kind 9735 zap receipts for a recipient (filter with --event / --addressable).

Options

Option Description
--wallet <walletId> Override the NWC wallet used by zap
--comment <text> Zap comment / invoice memo
--pubkey <hex\|npub> Recipient pubkey (enables true zap encoding)
--event <id\|nevent> Zap a specific event
--addressable <aTag> Zap an addressable event (naddr)
--relays <url> (repeatable) Relays attached to the zap request
--no-zap invoice: force a plain LN invoice (skip zap encoding)
--no-receipt zap: don't wait for the zap receipt
--limit <n> receipts: max events (default 50)
--timeout <sec> Per-operation timeout (default 15)

Examples

# fetch a 21-sat zap invoice for a lud16 address
ndk zaps invoice me@example.com 21

# zap 1000 sats from the default NWC sending wallet,
# encoding a true zap with the active account as sender
ndk accounts login nsec nsec1...        # one-time
ndk wallets add nwc "nostr+walletconnect://..."
ndk zaps zap me@example.com 1000 --pubkey npub1...

# list zap receipts received by a pubkey (last hour)
ndk zaps receipts npub1... --limit 50

# zap a specific note
ndk zaps zap me@example.com 21 --pubkey npub1... --event nevent1...

© Copyright 2026. All rights reserved.