Nostr Wallet Connect (NWC) Açıklaması

Nostr Wallet Connect'ten önce her Nostr istemcisinin kendi cüzdan entegrasyonunu kurması ya da zap işlevselliğinden tamamen vazgeçmesi gerekiyordu. Bu durum iki kötü sonuç doğurdu: zap işlevini sunan istemciler bir cüzdan çalıştırmak zorunda kaldı; cüzdan çalıştırmak istemeyen istemciler ise zap'ı destekleyemedi.

NWC, cüzdanı istemciden ayırarak bunu çözdü. Cüzdan kendi başına bir uygulamadır; istemci harcama isteklerini Nostr üzerinden gönderir; herkes kazanır.

Yerleşik cüzdanı olmayan herhangi bir istemcide zap kullanıyorsanız, farkında olsanız da olmasanız NWC kullanıyorsunuz demektir. Bu kılavuz, bağlantı dizesinin ne yaptığını, limitlerinin neler olduğunu ve nasıl iptal edileceğini anlamanız için mekanizmayı açık hâle getirir.

Özet. NWC, bir Nostr istemcisinin Lightning cüzdanından fatura ödemesini istemesi için kullanılan bir protokoldür (NIP-47). Eşleştirme nostr+walletconnect://... gibi görünen bir dizedir. Bu dize, yapılandırılabilir bir bütçe dahilinde harcama izni verir. Her cüzdan, NWC destekli herhangi bir istemciyle NWC konuşabilir; bu nedenle eşleştirme tüm ekosistemde çalışır.

Hazır olduğunda, @nostr.blog adresini al →

NWC Öncesindeki Sorun

NWC öncesinde, zap desteği sunmak isteyen bir Nostr istemcisinin üç kötü seçeneği vardı.

Seçenek 1: Cüzdanı istemcinin içine gömmek. Lightning kanallarını yönetmek, saklama işlemlerini üstlenmek, bir cüzdan şirketi olmak. Çoğu istemci bu mühendislik yükünü kaldıramazdı.

Seçenek 2: Kullanıcıdan nsec'ini ve cüzdan kimlik bilgilerini istemek. Olayları istemci tarafında imzalamak ve fatura ödeme isteklerini doğrudan cüzdan API'sine göndermek. Bu, istemcinin cüzdanın API anahtarını görmesi anlamına geliyordu ki bu ciddi bir güvenlik kabusu oluşturuyordu.

Seçenek 3: Zap'ı desteklememek. Bazı istemciler bu yolu seçti ve bu onları daha az kullanışlı hâle getirdi.

NWC, Nostr'un kendisini sinyal kanalı olarak kullanarak cüzdanı istemciden ayırır. İstemci hiçbir zaman cüzdan kimlik bilgilerini görmez. Cüzdanın, istekleri almak dışında Nostr'a özgü herhangi bir şeyi bilmesine gerek yoktur.

Protokol Nasıl Çalışır

NWC, NIP-47'de tanımlanmıştır. Akış:

1. Cüzdan bir bağlantı dizesi oluşturur. Bir Nostr relay URL'si, cüzdanın dinlediği bir pubkey ve şifreleme için paylaşılan bir sır içerir.
2. Kullanıcı dizeyi istemciye yapıştırır. Ya da bir QR kod tarar. Her iki durumda da istemci artık isteklerin nereye gönderileceğini bilir.
3. İstemci, Nostr üzerinden şifreli harcama istekleri gönderir. "Bu faturayı 1000 sat için öde" şeklindeki istek, belirtilen relay'deki cüzdanın dinleme pubkey'ine şifreli bir event olarak gider.
4. Cüzdan isteği alır ve öder. Tutar bağlantının bütçesi dahilindeyse cüzdan faturayı hemen öder.
5. Cüzdan sonuçla yanıt verir. İstemciye şifreli Nostr event'i geri döner: ödeme başarılı ya da başarısız, işte kanıtı.

Her şey bir saniyenin altında gerçekleşir. İstemci Lightning'i hiçbir zaman doğrudan yönetmez; yalnızca Nostr ile konuşur. Cüzdanın Nostr sosyal özelliklerini anlamasına gerek yoktur; yalnızca harcama isteklerini dinler.

Bağlantı Dizesinin İçeriği

Tipik bir NWC dizesi:

nostr+walletconnect://abc123def456...?relay=wss://relay.example.com&secret=xyz789...

Üç bölüm.

Bir pubkey. Cüzdanın Nostr'daki dinleme kimliği. İstemci istekleri bu pubkey'e gönderir.

Bir relay. Cüzdanın dinlediği yer. İstemci ve cüzdan, mesaj alışverişi için her ikisi de bu relay'e bağlanır.

Bir sır. İstemci ile cüzdan arasındaki mesajları şifrelemek için kullanılır; böylece relay yalnızca şifreli metni görür.

Bu üç değer birlikte istemciye cüzdana harcama komutları gönderme izni verir. Relay posta kutusudur; pubkey adrestir; sır ise kilittir.

Bütçe ve İzinler

Her NWC bağlantısının, bağlantı oluşturulurken cüzdan tarafından belirlenen limitleri vardır.

• Ödeme başına maksimum tutar. Ayarladığınıza bağlı olarak genellikle 10.000 ila 100.000 sat. Daha fazla harcama yapmak için yeni bir onay gerekir.
• Gün/hafta/ay başına maksimum tutar. Belirli bir programa göre doldurulan dönel bütçe.
• Son kullanma tarihi. Bazı cüzdanlar bağlantıları belirli bir süre sonra otomatik olarak sona erdirir; diğerleri siz iptal edene kadar açık bırakır.
• İzin verilen yöntemler. Bazı cüzdanlar yalnızca "fatura öde" iznini vermenize, "bakiye sorgula" veya "işlemleri listele" iznini reddetmenize olanak tanır.

Bütçe sayesinde bir bağlantı dizesi sızdırılsa bile hasar sınırlıdır. Saldırgan cüzdanın tamamını boşaltamaz; yalnızca bütçe dahilinde harcama yapabilir; bu noktada cüzdan, siz limiti yükseltene ya da yeni bir bağlantı oluşturana kadar ek istekleri reddeder.

NWC'yi Adım Adım Kurma

Bir cüzdanı Nostr istemcisiyle eşleştiren tipik bir kullanıcı için somut akış.

1. Lightning cüzdanınızı açın. Wallet of Satoshi, Phoenix, Alby Hub, Zeus veya NWC destekli herhangi bir cüzdan.
2. NWC ayarlarını bulun. Ayarlar menüsünde "Connections," "Nostr Wallet Connect" veya "Apps" seçeneğini arayın. Her cüzdan bunu biraz farklı bir yere koyar.
3. Yeni bir bağlantı oluşturun. Hangi uygulama için olduğunu hatırlamak için bir ad verin. Bir bütçe belirleyin.
4. Oluşturulan NWC dizesini kopyalayın. Ya da bir QR kodu alın.
5. Nostr istemcinizi açın. Ayarlara gidin, "Lightning wallet" veya "Zap settings" seçeneğini bulun.
6. NWC dizesini yapıştırın veya QR'yi tarayın. İstemci bağlantıyı test eder.
7. Başarılı. Zap düğmeleri aktif hâle gelir; bir sonraki zapınız eşleştirilmiş cüzdan üzerinden gider.

Eşleştirme sonrasında istemci "connection failed" gösteriyorsa en yaygın neden, NWC dizesindeki relay'in istemcinin erişemediği bir relay olması ya da güvenlik duvarının WebSocket bağlantılarını engellemesidir.

Bu Neden Yerleşik Cüzdandan Daha İyidir

NWC'nin yerleşik cüzdanlara karşı üç gerçek avantajı.

Taşınabilirlik. Cüzdanı değiştirmeden Nostr istemcinizi değiştirebilirsiniz. Bakiyeniz, geçmişiniz ve kanallarınız olduğu yerde kalır; yeni istemci yalnızca yeni bir NWC bağlantısıyla aynı cüzdanla eşleşir.

Uzmanlaşma. Cüzdan geliştiricileri Lightning altyapısına odaklanır; istemci geliştiricileri sosyal kullanıcı deneyimine odaklanır. Her taraf kendi alanında daha iyi hâle gelir ve birlikte çalışabilirlik tüm kombinasyonlarda işe yarar.

Güvenlik sınırı. İstemci hiçbir zaman cüzdan kimlik bilgilerini görmez. Hatalı bir istemci en kötü ihtimalle yanlış faturalar gönderebilir; cüzdanı boşaltamaz veya tohum cümlesini dışa aktaramaz.

Yerleşik seçeneğin açıkça daha iyi olduğu tek durum, maksimum kolaylıkla başlamak isteyen kullanıcılar içindir. Entegre cüzdanlı bir istemci, kullanıcıyı harici cüzdan eşleştirmekten bir adım daha hızlı zap yapar hâle getirir. Bu nedenle nostr.blog kayıt sürecinde varsayılan olarak bir cüzdan bulunur ve kullanıcılar daha sonra tercih ederlerse NWC aracılığıyla harici cüzdanları eşleştirebilir.

NWC Bağlantısını İptal Etme

Bir cihazı kaybederseniz, bir istemciyi kullanmayı bırakırsanız veya kimlik bilgilerini döndürmek isterseniz bağlantıyı cüzdan tarafından iptal edin.

1. Cüzdanı açın.
2. Ayarlar listesinde bağlantıyı bulun.
3. İptal et veya sil'e dokunun.
4. Bağlantı dizesi artık çalışmaz; onu elinde bulunduran istemci bir sonraki istekte "unauthorized" yanıtı alır.

Bu anlıktır. GitHub deposuna sızdırabileceğiniz API anahtarlarının aksine, NWC bağlantıları saniyeler içinde sonlandırılabilir ve kalıcı oturum kalmaz. Bu anlamlı bir güvenlik özelliğidir.

Yaygın NWC Sorunları

"Connection timed out." NWC dizesindeki relay, ağınızdan erişilemiyor ya da cüzdan çevrimdışı. Cüzdan uygulamasının açık ve bağlı olduğunu kontrol edin; bazı cüzdanlar yanıt verebilmek için uygulamanın aktif olmasını gerektirir.

Geçerli bir faturaya rağmen "Payment failed." Cüzdanın kanallarında ödemeyi yönlendirmek için yeterli likidite olmayabilir. Bu, NWC'ye özgü değil, Lightning katmanına ilişkin bir sorundur. Farklı bir tutar veya farklı bir zaman deneyin.

"Permission denied." Bağlantının bütçesi tükendi, bağlantının süresi doldu ya da istek türü izin verilen yöntemler arasında değil. Cüzdanın bağlantı ayarlarını kontrol edin.

"Client cannot detect wallet." Yapıştırdıktan sonra istemci yanıt vermiyor. İstemciyi kapatıp yeniden açın; bazı istemciler bağlantı durumunu önbelleğe alır ve yalnızca başlatmada yeniden kontrol eder.

NWC Nereye Gidiyor

NIP-47 henüz nihai değil. 2026'daki aktif çalışmalar şunları kapsıyor:

• Daha zengin izinler. "Dönem başına X'e kadar harcayabilir"den daha ayrıntılı, alıcı veya tutar başına kurallar.
• Çoklu cüzdan yönlendirme. Birden fazla cüzdanla eşleştirilen bir istemci, bakiye, ücret veya rota bazında her ödeme için en iyisini seçer.
• Daha iyi hata raporlama. Ödemeler başarısız olduğunda istemcilerin anlamlı mesajlar gösterebilmesi için standartlaştırılmış hata kodları.
• Çevrimdışı cüzdan desteği. Mevcut NWC her iki tarafın da çevrimiçi olduğunu varsayar; taslaklar, cüzdan yeniden bağlandığında gerçekleşen kuyruğa alınmış isteklere izin veriyor.

Protokol, 2026'da günlük kullanım için yeterince kararlıdır ve gelişmeye devam edecektir. Bugün bir cüzdan eşleştirmek bir dakikalık bir işlemdir; mevcut tasarımda ilerleyen dönemde bozulacak hiçbir şey yoktur.