Nostr Wallet Connect (NWC) is an open protocol to connect lightning wallets to apps. NWC allows for sustained interaction between bitcoin lightning wallets and apps. Once an app connection is created, the app can request payments through a Nostr relay.
In this article we explain everything you need to know about NWC, how to use it securely and how to build with it.
Introduction
Web3 and decentralized technologies promised users a world where interacting with applications would be seamless, and paying for goods and services would be just as slick and secure.
So far, it's all been marketing hype, and what's worse, many of these wallets and apps don't even natively support the primary asset in the space, Bitcoin.
They're all focusing on the second best, and if you know anything about the crypto space, you'll know there is no second best.
Bitcoin wallets have improved over the years in terms of UX and security, and eventually, those improvements led to Bitcoin and Lightning-based apps requiring an easier connection.
LN-Auth and Lightning Addresses have become the standard. Still, they do have their limitations, and that's where Nostr Wallet Connect has emerged as a lesser-known innovation that's slowly changing how Bitcoiners interact with digital platforms and applications.
Understanding Nostr: The Foundation
Before diving into Nostr Wallet Connect specifically, it's important to understand what Nostr is.
Nostr is a separate protocol from Bitcoin; it stands for "Notes and Other Stuff Transmitted by Relays" and is a simple, open protocol designed to create a censorship-resistant global communications and social network.
Initially developed as an alternative to centralized social media platforms, Nostr operates on a network of distributed relay servers rather than a centralized database.
Key aspects of Nostr include:
- Decentralization: No central server or authority controls the network
- Public-key cryptography: Users are identified by their wallet, ensuring secure authentication that doesn't require you to reveal private information.
- Relay servers: Messages are transmitted through these servers, which anyone can operate
- Simple protocol: The intentionally minimalist design makes it accessible and adaptable
What is Nostr Wallet Connect?
Nostr Wallet Connect (NWC) is a free and open-source protocol built on top of Nostr that enables secure connections between Lightning wallets and applications.
It serves as a communication layer that allows Lightning-enabled applications to interact with Lightning wallets without requiring direct access to private keys or sensitive wallet information.
It even allows users to set limitations on their connection, so you can customise your experience for every app you connect to your Lightning wallet.
For example, if you're a power user on one app, you can set a larger budget allocation since you know you'll be making larger payments regularly, while some new app you're just testing can have a smaller budget and cap on payment requests.
At its core, Nostr Wallet Connect is solving a critical problem in the Lightning Network ecosystem: How to allow applications to request payments or other Lightning actions from wallets without compromising security or creating a fragmented user experience.
Offering a standardized connection, NWC provides a layer of compatibility between Lightning apps and wallets so developers don't need to continue support for various wallets, and users can switch between apps easily and spend their Satoshis with the same 1-click experience.
How Nostr Wallet Connect Works
The mechanics of Nostr Wallet Connect involve several components working together:
1. Connection Establishment
When a user wants to connect their Lightning wallet to an application:
- The wallet generates a unique connection string (sometimes called a "connection URL" or "pairing string")
- This string contains encrypted information including a shared secret and relay information
- The user shares this string with the application
- The application uses this string to establish a secure communication channel with the wallet
2. Secure Communication Channel
Once connected:
- All communication happens over the Nostr network using encrypted messages
- The application and wallet communicate via Nostr events
- The shared secret ensures that only the intended parties can decrypt the messages
- The relay servers transmit these messages but cannot read their contents
3. Request-Response Flow
When an application needs to perform a Lightning action:
- The application sends a request event over Nostr to the wallet
- The wallet receives the request and presents it to the user for approval
- After user approval, the wallet performs the requested action
- The wallet sends a response event back to the application with the result
- All of this happens without the application ever accessing private keys
Key Features of Nostr Wallet Connect
- Send Payments Initiate single payments, batch transactions, or even automate recurring payments with minimal code.
- Receive Payments Display payment requests and receive funds in real time. Great for tipping, in-app purchases, or donations.
- Wallet Balance Query and display the current balance of a connected wallet within your app.
- Payment History Pull a list of incoming and outgoing payments for transparency and tracking.
- Payment Verification Check the status of payments—pending, completed, or failed—programmatically.
Enhanced Security
NWC significantly improves security compared to traditional approaches:
- No private key exposure: Applications never have access to the user's private keys
- User control: Each transaction requires explicit user approval
- Encrypted communication: All sensitive data is encrypted end-to-end
- Limited permissions: Applications can be restricted to specific actions
Improved User Experience
From a user perspective, NWC offers several benefits:
- Consistent experience: Users interact with their preferred wallet interface
- Single connection: Connect once and use across multiple sessions
- Cross-platform compatibility: Works across devices and platforms
- Simplified onboarding: No need to create separate accounts for each application
Developer Benefits
For developers building Lightning-enabled applications:
- Reduced liability: No need to handle sensitive key material
- Simplified implementation: Focus on application logic rather than wallet functionality
- Broader compatibility: Support multiple wallets without custom integrations
- Standardized approach: Common protocol for all Lightning interactions
Real-World Applications
Nostr Wallet Connect is being adopted across various use cases:
Lightning Web Applications
Web applications can now offer Lightning functionality without implementing wallet features:
- Online stores accepting Lightning payments
- Content platforms with pay-per-view models
- Subscription services using recurring Lightning payments
- Gaming platforms with in-game microtransactions
Nostr Wallet Connect offers SDKs that make it easier for developers to add functionality to their applications.
- Javascript
- React Native (Expo) (Showcase)
- Rust
- Dart
- Flutter
What Are Mobile Applications Using NWC For?
Mobile apps can leverage external wallets:
- Social media apps with tipping features
- Location-based services with payment options
- Marketplace applications with escrow capabilities
- Loyalty programs using Lightning for rewards
Nostr Clients
Nostr social applications can incorporate Lightning features:
- Zapping posts (sending Lightning tips to content creators)
- Paid messaging or premium content
- Pay-to-access communities
- Lightning-powered reputation systems
Nostr Wallet Ecosystem continues expansion and becomes a standard for connecting bitcoin wallets to apps: We have 3 new NWC wallets, 3 wallet interfaces, 2 messengers, 4 finance & payment tools, 2 hardware products (!) and 1 developer module
Let's see NWC ecosystem map v1.3🧵👇 pic.twitter.com/U2l6xAIFt0
— Nostr Wallet Connect (@nwc_dev) April 11, 2025
Growing Ecosystem
The ecosystem around NWC continues to advance not only in support of different apps and wallets but also in new features and business models.
Over the next few years, we should see:
- More wallets implementing NWC support
- Developer tools and libraries simplifying integration
- Standardization efforts ensuring compatibility
- Business models built specifically around NWC capabilities
- Proposals for Bitcoin on-chain and side-chain transactions or multi-currency payments with Taproot Assets.
Broader Adoption
While NWC started as a way to make zaps easier to use across various Nostr clients, both mobile and desktop, we're seeing increasing adoption in other parts of the Bitcoin ecosystem, too.
- E-commerce platforms & nostr based marketplace clients
- Circular economies
- Payment tools and gateways like Flash and ZapplePay
- Games like Zappy Bird
- Open-source funding models like Geyser
Connect With Nostr & Bitcoin
Nostr Wallet Connect significantly advances how we interact with Lightning Network applications. Providing a secure, standardized method for applications to communicate with wallets removes significant barriers to Lightning adoption while enhancing security and user experience.
For users, it means greater control over their funds and a more seamless experience. For developers, it offers a path to Lightning integration without the complexities and liabilities of handling sensitive key material. And for the broader ecosystem, it represents another step toward a more interconnected, decentralized digital economy.
As the Lightning Network continues to grow and evolve, Nostr Wallet Connect stands as an example of how thoughtful protocol design can solve real problems while staying true to the principles of decentralization, security, and user sovereignty that define the cryptocurrency space.