Nostr

May 1, 2026 · View on GitHub

Project structure

The project is split up into several crates:

nostr: Rust implementation of Nostr protocol
Signers
- nostr-browser-signer: Nostr Browser signer implementation (NIP-07)
- nostr-browser-signer-proxy: Proxy for using the Nostr Browser signer (NIP-07) in native applications
- nostr-connect: Nostr Connect (NIP-46)
nostr-database: Events database traits
- nostr-memory: In-memory events database
- nostr-lmdb: LMDB storage backend
- nostr-ndb: nostrdb storage backend
- nostr-sqlite: SQLite storage backend
nostr-gossip: Gossip traits
- nostr-gossip-memory: In-memory gossip database
- nostr-gossip-sqlite: SQLite storage for gossip
Remote File Storage implementations:
- nostr-blossom: A library for interacting with the Blossom protocol
nostr-keyring: Nostr Keyring
nostr-relay-builder: Build your own custom nostr relay
nostr-sdk: A full-featured SDK for building high-performance and reliable nostr applications
nwc: Nostr Wallet Connect (NWC) client (NIP-47)

Note: this repository contains the Rust codebase. There are several other projects (i.e., bindings, CLI, etc.) which are maintained in other repositories https://rust-nostr.org/projects.

Embedded

nostr crate can be used in no_std environments. Check the example in the embedded/ directory.

Book

Learn more about rust-nostr at https://rust-nostr.org.

Supported NIPs

The table below lists which NIPs have implementations somewhere in this workspace. Some features are behind crate flags or only available when using a specific crate (e.g., signer integrations).

✅ means “implemented and tested behind the relevant feature flag”, ❌ means “not available anywhere in this repo yet”.

Supported	NIP
✅	01 - Basic protocol flow description
✅	02 - Follow List
✅	03 - OpenTimestamps Attestations for Events
✅	04 - Encrypted Direct Message
✅	05 - Mapping Nostr keys to DNS-based internet ids
✅	06 - Basic key derivation from mnemonic seed phrase
✅	07 - `window.nostr` capability for web browsers
❌	08 - Handling Mentions
✅	09 - Event Deletion
✅	10 - Use of `e` and `p` tags in text events
✅	11 - Relay Information Document
✅	13 - Proof of Work
✅	14 - Subject tag in text events
✅	15 - Nostr Marketplace
✅	17 - Private Direct Messages
✅	18 - Reposts
✅	19 - bech32-encoded entities
✅	21 - URI scheme
✅	22 - Comment
✅	23 - Long-form Content
✅	24 - Extra metadata fields and tags
✅	25 - Reactions
✅	26 - Delegated Event Signing
❌	27 - Text Note References
✅	28 - Public Chat
❌	29 - Relay-based Groups
✅	30 - Custom Emoji
✅	31 - Dealing with Unknown Events
✅	32 - Labeling
✅	34 - `git` stuff
✅	35 - Torrents
✅	36 - Sensitive Content
❌	37 - Draft Events
✅	38 - User Statuses
✅	39 - External Identities in Profiles
✅	40 - Expiration Timestamp
✅	42 - Authentication of clients to relays
✅	44 - Encrypted Payloads (Versioned)
✅	45 - Event Counts
✅	46 - Nostr Connect
✅	47 - Wallet Connect
✅	48 - Proxy Tags
✅	49 - Private Key Encryption
✅	50 - Search Capability
✅	51 - Lists
❌	52 - Calendar Events
✅	53 - Live Activities
❌	54 - Wiki
-	55 - Android Signer Application
✅	56 - Reporting
✅	57 - Lightning Zaps
✅	58 - Badges
✅	59 - Gift Wrap
✅	60 - Cashu Wallet
❌	61 - Nutzaps
✅	62 - Request to Vanish
❌	64 - Chess (PGN)
✅	65 - Relay List Metadata
❌	66 - Relay Discovery and Liveness Monitoring
❌	68 - Picture-first feeds
❌	69 - P2P Order events
✅	70 - Protected Events
❌	71 - Video Events
❌	72 - Moderated Communities
✅	73 - External Content IDs
❌	75 - Zap Goals
✅	77 - Negentropy Syncing
✅	78 - Arbitrary custom app data
✅	7D - Threads
❌	84 - Highlights
❌	86 - Relay Management API
❌	87 - Ecash Mint Discoverability
✅	88 - Polls
❌	89 - Recommended Application Handlers
✅	90 - Data Vending Machine
❌	92 - Media Attachments
✅	94 - File Metadata
✅	98 - HTTP Auth
❌	99 - Classified Listings
✅	A0 - Voice Messages
✅	B0 - Web Bookmarks
✅	B7 - Blossom
✅	C0 - Code Snippets
✅	C7 - Chats

State

These libraries are in ALPHA state, things that are implemented generally work but the API will change in breaking ways.

rust-nostr is free and open-source. This means we do not earn any revenue by selling it. Instead, we rely on your financial support. If you actively use any of the rust-nostr libs/software/services, then please donate.

License

This project is distributed under the MIT software license - see the LICENSE file for details