nostr-wallet-connect

Generate NWC connection strings, publish info events, and process encrypted wallet requests.

Updated Dec 31, 2025
One-click install
npx skills add https://github.com/PerceptLabs/mvmnt --skill nostr-wallet-connect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nostr-wallet-connect
Source: https://github.com/PerceptLabs/mvmnt/tree/main/skills/nostr-wallet-connect
Command: npx skills add https://github.com/PerceptLabs/mvmnt --skill nostr-wallet-connect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides production-ready patterns for implementing Nostr Wallet Connect (NWC) wallet services, including connection string generation, info events, request handling, and encrypted responses.

Core Features & Use Cases

  • Connection strings: Generate unique NWC connection URIs for clients to connect securely.
  • Info events & requests: Publish capabilities and listen for client requests per NIP-47.
  • Encryption & security: Support NIP-04/NIP-44 encryption with per-connection secrets and quotas.
  • Use Case: Example: A wallet service is deployed to enable clients to connect, request invoices, and receive encrypted responses over relays.

Quick Start

Install and configure a NWC wallet service, then generate a connection string and publish its info event to start handling requests.

Frequently Asked Questions about nostr-wallet-connect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement a Nostr Wallet Connect wallet service for NIP-47?

You can build an NWC wallet service by generating connection URIs, publishing info events, and listening for client requests over Nostr relays. Processing involves decrypting messages, executing wallet commands, and returning encrypted responses securely.

How does encryption work for Nostr Wallet Connect request and response processing?

Encryption for Nostr Wallet Connect uses NIP-04 or NIP-44 standards to secure messages. The service decrypts incoming client requests using per-connection secrets and encrypts wallet command responses before broadcasting them back across relays.

What is a Nostr Wallet Connect connection string and how do I generate it?

A Nostr Wallet Connect connection string is a unique URI that allows clients to securely connect to a wallet service. You generate these connection URIs to establish a secure link paired with specific capabilities and encryption secrets.

How do I handle NWC wallet commands and enforce quotas over relays?

Handling NWC wallet commands involves listening for requests on Nostr relays, decrypting the payload, and processing the specific command. Quotas and error handling are enforced during processing to ensure reliable and safe operation in real deployments.

Do I need to publish info events to use Nostr Wallet Connect securely?

Publishing info events is required for Nostr Wallet Connect to advertise service capabilities per NIP-47. By publishing these events to relays, clients can discover what commands the wallet service supports before initiating encrypted requests.