Nostr Wallet Connect (NWC) adalah protokol NIP-47 untuk mengendalikan dompet Lightning dari jauh melalui relay Nostr. Relay membawa pesan, bukan bitcoin itu sendiri; node pribadi maupun layanan kustodian dapat memakainya.
Aplikasi klien mengirim permintaan, layanan dompet memverifikasi lalu memanggil antarmuka pembayaran. NWC tidak menentukan siapa yang memegang kunci bitcoin. Node pribadi dan dompet kustodian dapat memakai protokol sama dengan kepercayaan dan pilihan pemulihan berbeda. [NWC — NIP-47: Core protocol] [NWC — Project overview]
URI koneksi memuat kunci publik layanan, relay, dan secret: kunci privat koneksi klien. Ini bukan seed dompet, tetapi memungkinkan penandatanganan permintaan yang diizinkan. QR atau salinannya dapat memberi akses kepada aplikasi lain. Kunci berbeda per koneksi mengurangi keterkaitannya. [NWC — NIP-47: Core protocol]
Peristiwa info publik mengumumkan kemampuan layanan; get_info mengembalikan metode untuk koneksi tertentu. Intinya meliputi pay_invoice, make_invoice, lookup_invoice, get_balance, dan get_info. Riwayat, keysend, dan notifikasi adalah ekstensi opsional. Periksa dukungan dan izin terpisah: nama metode bukan persetujuan pembayaran universal. [NWC — NIP-47: Core protocol] [NWC — Optional specifications] [NWC-02 — Notifications]
Info memakai kind 13194, permintaan 23194, respons 23195. Tag p menunjukkan pihak lain, tag e pada respons merujuk permintaan. Klien memeriksa tanda tangan, kunci layanan yang diharapkan, kaitan permintaan, dan result_type. Menerima peristiwa dari relay saja tidak membuktikan eksekusi. [NWC — NIP-47: Core protocol]
Jumlah dan biaya NIP-47 dalam msat; 1000 msat setara satu satoshi. Salah satuan mengubah jumlah seribu kali. pay_invoice berhasil mengembalikan preimage; respons gagal memuat error. Membuat invoice lewat make_invoice belum berarti lunas; lookup_invoice dapat memeriksa statusnya. [NWC — NIP-47: Core protocol]
Negosiasi kini mengutamakan nip44_v2; nip04 lama bertahan untuk kompatibilitas, dan tanpa tag encryption berarti mode lama. NIP-44 sendiri tidak memberikan forward secrecy. Relay dapat melihat jenis, tag, kunci koneksi, dan waktu. Kunci identitas utama pengguna sebaiknya tidak dipakai untuk koneksi NWC. [NWC — NIP-47: Core protocol] [Nostr — NIP-44: Encrypted payloads]
Permintaan dan respons NWC adalah peristiwa sementara. Relay tak tersedia atau layanan offline dapat kehilangan pesan; bisa juga hanya respons pembayaran yang sudah selesai yang hilang. Setelah timeout, periksa dahulu melalui lookup_invoice atau dompet. Diam bukan kegagalan pasti, dan permintaan baru bukan percobaan ulang yang otomatis aman. [NWC — NIP-47: Core protocol]
Layanan dapat membatasi metode, anggaran atau masa berlaku serta mencabut kunci koneksi. Batas harus ditegakkan layanan, bukan sekadar layar klien. Menghapus koneksi di aplikasi mungkin menyisakan izin pada dompet. Pencabutan memblokir pemakaian selanjutnya, tetapi tidak membatalkan pembayaran selesai. [NWC — NIP-47: Core protocol]
Untuk gambaran yang lebih utuh, baca entri ini bersama Nostr, Lightning Network, BOLT 11, Dompet, Kunci Privat, Satoshi. Entri ini juga dirujuk dari Nostr, BOLT 11.