Crate nostr

Rust implementation of the Nostr protocol.

Nostr

Description

Rust implementation of Nostr protocol.

You may be interested in:

• nostr-sdk if you want to write a typical Nostr client or bot
• nostr-database if you need a database for your Nostr app (native or web)

Getting started

[dependencies]
nostr = "0.26"

use nostr::prelude::*;

fn main() -> Result<()> {
    // Generate new random keys
    let my_keys = Keys::generate();

    // or use your already existing
    //
    // From HEX or Bech32
    // let my_keys = Keys::from_sk_str("hex-or-bech32-secret-key")?;

    // Show bech32 public key
    let bech32_pubkey: String = my_keys.public_key().to_bech32()?;
    println!("Bech32 PubKey: {}", bech32_pubkey);

    let metadata = Metadata::new()
        .name("username")
        .display_name("My Username")
        .about("Description")
        .picture(Url::parse("https://example.com/avatar.png")?)
        .banner(Url::parse("https://example.com/banner.png")?)
        .nip05("username@example.com")
        .lud16("yuki@getalby.com")
        .custom_field("custom_field", "my value");

    let event: Event = EventBuilder::set_metadata(&metadata).to_event(&my_keys)?;

    // New text note
    let event: Event = EventBuilder::new_text_note("Hello from Nostr SDK", []).to_event(&my_keys)?;

    // New POW text note
    let event: Event = EventBuilder::new_text_note("My first POW text note from Nostr SDK", []).to_pow_event(&my_keys, 20)?;

    // Convert client nessage to JSON
    let json = ClientMessage::new_event(event).as_json();
    println!("{json}");

    Ok(())
}

More examples can be found in the examples/ directory.

WASM

This crate supports the wasm32 targets.

On macOS you need to install llvm:

brew install llvm
LLVM_PATH=$(brew --prefix llvm)
AR="${LLVM_PATH}/bin/llvm-ar" CC="${LLVM_PATH}/bin/clang" cargo build --target wasm32-unknown-unknown

NOTE: Currently nip03 feature not support WASM.

Embedded

This crate support no_std environments.

Check the example in the embedded/ directory.

Crate Feature Flags

The following crate feature flags are available:

Feature	Default	Description
std	Yes	Enable std library
alloc	No	Needed to use this library in no_std context
blocking	No	Needed to use NIP-05 and NIP-11 features in not async/await context
all-nips	Yes	Enable all NIPs
nip03	No	Enable NIP-03: OpenTimestamps Attestations for Events
nip04	Yes	Enable NIP-04: Encrypted Direct Message
nip05	Yes	Enable NIP-05: Mapping Nostr keys to DNS-based internet identifiers
nip06	Yes	Enable NIP-06: Basic key derivation from mnemonic seed phrase
nip11	Yes	Enable NIP-11: Relay Information Document
nip44	Yes	Enable NIP-44: Encrypted Payloads (Versioned)
nip46	Yes	Enable NIP-46: Nostr Connect
nip47	Yes	Enable NIP-47: Nostr Wallet Connect

Supported NIPs

Supported	NIP
✅	01 - Basic protocol flow description
✅	02 - Contact List and Petnames
✅	03 - OpenTimestamps Attestations for Events
✅	04 - Encrypted Direct Message
✅	05 - Mapping Nostr keys to DNS-based internet identifiers
✅	06 - Basic key derivation from mnemonic seed phrase
✅	09 - Event Deletion
✅	10 - Conventions for clients’ use of e and p tags in text events
✅	11 - Relay Information Document
✅	12 - Generic Tag Queries
✅	13 - Proof of Work
✅	14 - Subject tag in text events
❌	15 - Nostr Marketplace
✅	16 - Event Treatment
✅	18 - Reposts
✅	19 - bech32-encoded entities
✅	20 - Command Results
✅	21 - URI scheme
✅	23 - Long-form Content
✅	25 - Reactions
✅	26 - Delegated Event Signing
❌	27 - Text Note References
✅	28 - Public Chat
✅	30 - Custom Emoji
❌	31 - Dealing with Unknown Events
❌	32 - Labeling
✅	36 - Sensitive Content
✅	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
✅	50 - Keywords filter
✅	51 - Lists
✅	53 - Live Activities
✅	56 - Reporting
✅	57 - Lightning Zaps
✅	58 - Badges
✅	65 - Relay List Metadata
✅	78 - Arbitrary custom app data
❌	89 - Recommended Application Handlers
✅	90 - Data Vending Machine
✅	94 - File Metadata
✅	98 - HTTP Auth
❌	99 - Classified Listings

State

This library is in an ALPHA state, things that are implemented generally work but the API will change in breaking ways.

License

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

Donations

⚡ Tips: https://getalby.com/p/yuki

⚡ Lightning Address: yuki@getalby.com

Re-exports

• pub extern crate alloc;
• pub use self::event::tag::ExternalIdentity;
• pub use self::event::tag::HttpMethod;
• pub use self::event::tag::Identity;
• pub use self::event::tag::ImageDimensions;
• pub use self::event::tag::Marker;
• pub use self::event::tag::RelayMetadata;
• pub use self::event::tag::Report;
• pub use self::event::tag::Tag;
• pub use self::event::tag::TagIndexValues;
• pub use self::event::tag::TagIndexes;
• pub use self::event::tag::TagKind;
• pub use self::event::Event;
• pub use self::event::EventBuilder;
• pub use self::event::EventId;
• pub use self::event::Kind;
• pub use self::event::MissingPartialEvent;
• pub use self::event::PartialEvent;
• pub use self::event::UnsignedEvent;
• pub use self::key::Keys;
• pub use self::message::Alphabet;
• pub use self::message::ClientMessage;
• pub use self::message::Filter;
• pub use self::message::FiltersMatchEvent;
• pub use self::message::GenericTagValue;
• pub use self::message::RawRelayMessage;
• pub use self::message::RelayMessage;
• pub use self::message::SubscriptionId;
• pub use self::nips::nip19::FromBech32;
• pub use self::nips::nip19::ToBech32;
• pub use self::types::Contact;
• pub use self::types::Metadata;
• pub use self::types::Timestamp;
• pub use self::types::UncheckedUrl;
• pub use self::util::JsonUtil;
• pub use self::util::SECP256K1;
• pub use bip39;
• pub use bitcoin;
• pub use bitcoin::bech32;
• pub use bitcoin::hashes;
• pub use bitcoin::secp256k1;
• pub use negentropy;
• pub use serde_json;
• pub use url_fork as url;

Modules

• event
  Event
• key
  Keys
• message
  Messages
• nips
  NIPs
• prelude
  Prelude
• types
  Types
• util
  Util

Structs

• Url
  A parsed URL record.

Functions

• git_hash_version
  Git Hash

Type Aliases

• Result
  Result