11 releases

0.4.7 Sep 7, 2024
0.4.5 Aug 29, 2024
0.4.4 Jun 9, 2024
0.4.3 Oct 9, 2023
0.2.0 Jul 9, 2023

#707 in Network programming

Download history 2/week @ 2024-07-02 30/week @ 2024-07-23 12/week @ 2024-07-30 166/week @ 2024-08-27 321/week @ 2024-09-03 42/week @ 2024-09-10 29/week @ 2024-09-17 18/week @ 2024-09-24 31/week @ 2024-10-01 1/week @ 2024-10-08

52 downloads per month

MIT/Apache

315KB
7.5K SLoC

Rnostr

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

Features

NIPs

  • 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
  • NIP-70: Protected Events

Extensions

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.

Metrics

Provide metrics url for prometheus scrape

Auth

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

Rate limiter

Limit event write frequency.

Count

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.

Usage

Prepare source and config


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 and run


# 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

Docker


# 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

Commands

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

Dependencies

~39–52MB
~842K SLoC