A high-performance and scalable nostr relay written in Rust.

• Most NIPs support
• Easy to use, no third-party service dependencies
• High performance, Events is stored in LMDB, Inspired by strfry
• Most configurations can be hot reloaded
• Scalability, can be used as a library to create custom relays

• NIP-01: Basic protocol flow description
• NIP-02: Contact list and petnames
• NIP-04: Encrypted Direct Message
• NIP-09: Event deletion
• NIP-11: Relay information document
• NIP-12: Generic tag queries
• NIP-13: Proof of Work
• NIP-15: End of Stored Events Notice
• NIP-16: Event Treatment
• NIP-20: Command Results
• NIP-22: Event created_at Limits
• NIP-25: Reactions
• NIP-26: Delegated Event Signing
• NIP-28: Public Chat
• NIP-33: Parameterized Replaceable Events
• NIP-40: Expiration Timestamp
• NIP-42: Authentication of clients to relays
• NIP-45: Counting results. experimental
• NIP-50: Keywords filter. experimental

The library nostr-relay implements a simple extension mechanism to intercept user messages for custom processing. rnostr is built on top of nostr-relay and implements several simple extensions. All extensions support configuration in the config file.

Custom relay and extensions.

Provide metrics url for prometheus scrape

NIP-42 Authentication, ip, auth pubkey and event pubkey whitelist blacklist

Limit event write frequency.

NIP-45 count results. When the query results are too large (millions) will trigger a slow query. setting.data.db_query_timeout.

NIP-50 Keywords filter. nostr-db implement a simple exact match pattern, case-insensitive, time-sorted full-text search. No performance optimization for multi-word queries, so it's experimental.

It reduces write concurrency and makes space usage significantly larger. So it is suitable for use in private or paid relay.

Now we only index the content of kind: 1 note event.

git clone https://github.com/rnostr/rnostr.git
cd rnostr
mkdir config
cp ./rnostr.example.toml ./config/rnostr.toml

Edit the ./config/rnostr.toml, remember to modify network.host to 0.0.0.0 for public access.

# Build
cargo build --release

# Show help
./target/release/rnostr relay --help

# Run with config hot reload
./target/release/rnostr relay -c ./config/rnostr.toml --watch

# Create data dir
mkdir ./data

docker run -it --rm -p 8080:8080 \
  --user=$(id -u) \
  -v $(pwd)/data:/rnostr/data \
  -v $(pwd)/config:/rnostr/config \
  --name rnostr rnostr/rnostr:latest

Build by self

docker build . -t rnostr/rnostr

# Build in China need to configure the mirror.
docker build . -t rnostr/rnostr --build-arg BASE=mirror_cn

See docker compose example

rnostr provides other commands such as import and export.

./target/release/rnostr --help

# Usage: rnostr <COMMAND>

# Commands:
#   import  Import data from jsonl file
#   export  Export data to jsonl file
#   bench   Benchmark filter
#   relay   Start nostr relay server
#   delete  Delete data by filter
#   help    Print this message or the help of the given subcommand(s)

# Options:
#   -h, --help     Print help
#   -V, --version  Print version