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-connect: Nostr Connect (NIP46) client and signer
• nwc: Nostr Wallet Connect (NWC) client

Getting started

use std::num::NonZeroU8;

use nostr::prelude::*;

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

    // Or use your already existing (from hex or bech32)
    let keys = Keys::parse("hex-or-bech32-secret-key")?;

    // Convert public key to bech32
    println!("Public key: {}", keys.public_key().to_bech32()?);

    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("pay@yukikishimoto.com")
        .custom_field("custom_field", "my value");

    let event: Event = EventBuilder::metadata(&metadata).finalize(&keys)?;

    // New text note
    let event: Event = EventBuilder::text_note("Hello from rust-nostr").finalize(&keys)?;

    // New POW text note
    let difficulty: NonZeroU8 = NonZeroU8::new(16).unwrap();
    let unsigned: UnsignedEvent = EventBuilder::text_note("POW text note from rust-nostr").finalize_unsigned(keys.public_key);
    let unsigned: UnsignedEvent = unsigned.mine(&SingleThreadPow, difficulty)?;
    let event: Event = unsigned.finalize(&keys)?;

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

    Ok(())
}

More examples can be found in the examples/ directory.

Crate Feature Flags

The following crate feature flags are available:

WASM

This crate supports the wasm32-unknown-unknown and wasm32-wasip2 targets. The other WASM targets may be supported bur are not tested.

wasm32-wasip2

To compile for wasm32-wasip2 you need to:

• Download the WASI SDK from https://github.com/WebAssembly/wasi-sdk
• Extract it and set the WASI_SDK environment variable
• Set the CC_wasm32_wasip2="$WASI_SDK/bin/clang", AR_wasm32_wasip2="$WASI_SDK/bin/llvm-ar" and CFLAGS_wasm32_wasip2="--sysroot=$WASI_SDK/share/wasi-sysroot" environment variables
• Build!

Example (note, links and version may be outdated):

# 1. Download and extract the WASI SDK
wget https://github.com/WebAssembly/wasi-sdk/releases/download/wasi-sdk-29/wasi-sdk-29.0-x86_64-linux.tar.gz
tar xvf wasi-sdk-29.0-x86_64-linux.tar.gz

# 2. Set the path variable (adjust if you extracted it somewhere else)
export WASI_SDK="$(pwd)/wasi-sdk-29.0-x86_64-linux"

# 3. Export the environment variables that the 'cc' crate looks for
# This tells the build script specifically which compiler to use for this target
export CC_wasm32_wasip2="$WASI_SDK/bin/clang"
export AR_wasm32_wasip2="$WASI_SDK/bin/llvm-ar"
export CFLAGS_wasm32_wasip2="--sysroot=$WASI_SDK/share/wasi-sysroot"

# 4. Now run your build command
cargo build --target wasm32-wasip2

wasm32-unknown-unknown

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

The other platforms should work out of the box.

Embedded

This crate support no_std environments.

Check the example in the embedded/ directory.

Changelog

All notable changes to this library are documented in the CHANGELOG.md.

State

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

Donations

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