Nostr Wallet Connect (NWC) пояснення

До появи Nostr Wallet Connect кожен Nostr-клієнт мав або будувати власну інтеграцію гаманця, або взагалі відмовлятися від функції зарів. Це призводило до двох поганих наслідків: клієнти, що підтримували зари, були змушені самостійно запускати гаманець, а клієнти, які не хотіли цього робити, не могли підтримувати зари.

NWC вирішив цю проблему, розділивши гаманець і клієнт. Гаманець — це окремий застосунок; клієнт надсилає запити на витрати через сам Nostr; усі у виграші.

Якщо ви використовуєте зари у будь-якому клієнті без вбудованого гаманця, ви користуєтеся NWC, навіть якщо не замислюєтеся про це. Цей посібник розкриває механізм, щоб ви розуміли, що робить рядок підключення, які його обмеження і як його відкликати.

TL;DR. NWC — це протокол (NIP-47), що дозволяє Nostr-клієнту просити Lightning-гаманець сплачувати інвойси. Спарювання — це рядок, який виглядає як nostr+walletconnect://.... Рядок надає дозвіл на витрати до налаштовуваного бюджету. Будь-який гаманець може спілкуватися через NWC з будь-яким NWC-сумісним клієнтом, тому спарювання працює у всій екосистемі.

Коли будете готові, заберіть адресу @nostr.blog →

Проблема до NWC

До NWC Nostr-клієнт, що хотів підтримувати зари, мав три погані варіанти.

Варіант 1: Вбудувати гаманець у клієнт. Керувати Lightning-каналами, забезпечувати зберігання коштів, ставати компанією-гаманцем. Більшість клієнтів не могли дозволити собі таку інженерну роботу.

Варіант 2: Запитати у користувача його nsec і облікові дані гаманця. Підписувати події на стороні клієнта та надсилати запити на оплату інвойсів безпосередньо до API гаманця. Це означало, що клієнт бачив API-ключ гаманця, що є кошмаром з точки зору безпеки.

Варіант 3: Не підтримувати зари. Деякі клієнти обирали цей шлях, що робило їх менш корисними.

NWC відокремлює гаманець від клієнта, використовуючи сам Nostr як канал сигналізації. Клієнт ніколи не бачить облікових даних гаманця. Гаманцю не потрібно знати нічого специфічного для Nostr, окрім того, як отримувати запити.

Як працює протокол

NWC визначено у NIP-47. Схема роботи:

1. Гаманець генерує рядок підключення. Містить URL relay-сервера Nostr, pubkey, на якому слухає гаманець, і спільний секрет для шифрування.
2. Користувач вставляє рядок у клієнт. Або сканує QR-код. У будь-якому разі клієнт тепер знає, куди надсилати запити.
3. Клієнт надсилає зашифровані запити на витрати через Nostr. «Оплати цей інвойс за 1000 сат» відправляється у зашифрованій події на listening pubkey гаманця на вказаному relay.
4. Гаманець отримує запит і здійснює оплату. Якщо сума в межах бюджету підключення, гаманець негайно оплачує інвойс.
5. Гаманець відповідає з результатом. Зашифрована подія Nostr назад клієнту: оплата пройшла або не вдалася, ось підтвердження.

Весь процес відбувається менш ніж за секунду. Клієнт ніколи не працює з Lightning напряму; він просто спілкується з Nostr. Гаманцю не потрібно розуміти соціальні функції Nostr; він просто слухає запити на витрати.

Що містить рядок підключення

Типовий рядок NWC:

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

Три частини.

Pubkey. Ідентифікатор гаманця в Nostr для прослуховування запитів. Клієнт надсилає запити на цей pubkey.

Relay. Де слухає гаманець. Клієнт і гаманець обидва підключаються до цього relay для обміну повідомленнями.

Секрет. Використовується для шифрування повідомлень між клієнтом і гаманцем, щоб relay бачив лише зашифровані дані.

Разом ці три значення надають клієнту дозвіл надсилати команди витрат до гаманця. Relay — це поштова скринька; pubkey — це адреса; секрет — це замок.

Бюджет і дозволи

Кожне підключення NWC має обмеження, встановлені гаманцем під час створення підключення.

• Максимальна сума за один платіж. Зазвичай від 10 000 до 100 000 сат залежно від налаштувань. Для більших витрат потрібне нове підтвердження.
• Максимальна сума за день/тиждень/місяць. Поновлюваний бюджет, що поповнюється за розкладом.
• Термін дії. Деякі гаманці автоматично закривають підключення через певний час; інші залишають їх відкритими, доки їх не відкличуть.
• Дозволені методи. Деякі гаманці дозволяють надавати лише дозвіл «оплатити інвойс», забороняючи «переглянути баланс» або «переглянути транзакції».

Бюджет означає, що навіть якщо рядок підключення буде перехоплено, збитки обмежені. Зловмисник не зможе спустошити весь гаманець; він може витрачати лише до бюджету, після чого гаманець відмовляє в подальших запитах, поки ви не поповните ліміт або не згенеруєте нове підключення.

Налаштування NWC крок за кроком

Конкретна схема для типового користувача, який спаровує гаманець із Nostr-клієнтом.

1. Відкрийте ваш Lightning-гаманець. Wallet of Satoshi, Phoenix, Alby Hub, Zeus або будь-який гаманець із підтримкою NWC.
2. Знайдіть налаштування NWC. Шукайте «Connections», «Nostr Wallet Connect» або «Apps» у меню налаштувань. У кожному гаманці це знаходиться в трохи різному місці.
3. Створіть нове підключення. Дайте йому назву, щоб пам'ятати, для якого застосунку воно призначене. Встановіть бюджет.
4. Скопіюйте згенерований рядок NWC. Або отримайте QR-код.
5. Відкрийте ваш Nostr-клієнт. Перейдіть до налаштувань, знайдіть «Lightning wallet» або «Zap settings».
6. Вставте рядок NWC або скануйте QR. Клієнт перевіряє підключення.
7. Готово. Кнопки зару стають активними; ваш наступний зар пройде через спарений гаманець.

Якщо після спарювання клієнт показує «connection failed», найпоширенішою причиною є невідповідність relay (relay у рядку NWC недоступний для клієнта) або брандмауер, що блокує WebSocket-з'єднання.

Чому це краще за вбудований гаманець

Три реальні переваги NWC порівняно з вбудованими гаманцями.

Портативність. Ви можете змінювати Nostr-клієнти без зміни гаманця. Ваш баланс, історія та канали залишаються на місці; новий клієнт просто спаровується з тим самим гаманцем через нове підключення NWC.

Спеціалізація. Розробники гаманців зосереджуються на Lightning-інфраструктурі; розробники клієнтів — на соціальному UX. Кожна сторона вдосконалюється у своїй галузі, а сумісність працює між різними комбінаціями.

Межа безпеки. Клієнт ніколи не має облікових даних гаманця. Клієнт із помилками в гіршому разі може надіслати неправильні інвойси; він не може спустошити гаманець або експортувати сід-фразу.

Єдиний випадок, коли вбудований гаманець явно кращий, — це для користувачів, яким потрібне максимально зручне підключення без зайвих кроків. Клієнт із вбудованим гаманцем дозволяє користувачу розпочати відправляти зари на один крок швидше, ніж спарювання зовнішнього гаманця. Саме тому реєстрація на nostr.blog за замовчуванням включає гаманець, але користувачі можуть пізніше підключити зовнішні гаманці через NWC, якщо захочуть.

Відкликання підключення NWC

Якщо ви втратили пристрій, перестали користуватися клієнтом або хочете замінити облікові дані, відкличте підключення з боку гаманця.

1. Відкрийте гаманець.
2. Знайдіть підключення у списку налаштувань.
3. Натисніть «відкликати» або «видалити».
4. Рядок підключення більше не працює; будь-який клієнт, що його зберігає, отримає відповідь «unauthorized» на наступний запит.

Це миттєво. На відміну від API-ключів, які можна випадково злити до репозиторію GitHub, підключення NWC можна скасувати за секунди, і жодних активних сесій не залишається. Це важлива властивість безпеки.

Поширені проблеми з NWC

«Connection timed out.» Relay у рядку NWC недоступний із вашої мережі, або гаманець офлайн. Переконайтеся, що застосунок гаманця відкритий і підключений; деякі гаманці вимагають активного застосунку для відповіді на запити.

«Payment failed» попри дійсний інвойс. Каналам гаманця може бракувати ліквідності для маршрутизації платежу. Це проблема рівня Lightning, а не специфічна для NWC. Спробуйте іншу суму або зачекайте деякий час.

«Permission denied.» Бюджет підключення вичерпано, підключення закінчилося або тип запиту не входить до дозволених методів. Перевірте налаштування підключення у гаманці.

«Client cannot detect wallet.» Після вставки рядка клієнт зависає. Закрийте та знову відкрийте клієнт; деякі клієнти кешують стан підключення і перевіряють його лише під час запуску.

Куди розвивається NWC

NIP-47 ще не фінальний. Активна робота у 2026 році охоплює:

• Більш детальні дозволи. Детальніші, ніж «можна витрачати до X за період», із правилами для конкретних одержувачів або сум.
• Маршрутизація через кілька гаманців. Клієнт, спарений із кількома гаманцями, обирає найкращий для кожного платежу на основі балансу, комісії або маршруту.
• Краще звітування про помилки. Стандартизовані коди помилок, щоб клієнти могли показувати корисні повідомлення при невдалих платежах.
• Підтримка офлайн-гаманців. Поточний NWC передбачає, що обидві сторони онлайн; чернетки дозволяють ставити запити в чергу для виконання після повторного підключення гаманця.

Протокол достатньо стабільний для щоденного використання у 2026 році і продовжуватиме розвиватися. Спарювання гаманця сьогодні займає одну хвилину; нічого в поточній конструкції не зламається в майбутньому.