nostr

A Flutter library for Nostr implemented in Dart.

Dispute is a basic nostr client written in flutter with this library that will show you an implementation.

Getting started

flutter pub add nostr

NIPS

• x NIP-01 Basic protocol flow
• x NIP-02 Follow List and Petnames
• x NIP-05 DNS-based Internet Identifiers
• x NIP-09 Event Deletion Request
• x NIP-10 Text Note Threading
• x NIP-11 Relay Information Document
• x NIP-13 Proof of Work
• x NIP-17 Private Direct Messages
• x NIP-18 Reposts
• x NIP-19 Bech32-encoded Entities
• x NIP-20 Command Results
• x NIP-21 nostr: URI Scheme
• x NIP-22 Comments
• x NIP-23 Long-form Content
• x NIP-25 Reactions
• x NIP-27 Text Note References
• x NIP-28 Public Chat
• x NIP-29 Relay-based Groups
• x NIP-32 Labeling
• x NIP-38 User Statuses
• x NIP-40 Expiration Timestamp
• x NIP-42 Authentication
• x NIP-44 Encrypted Payloads (Versioned)
• ~ NIP-46 Nostr Connect — kind 24133 event envelope only. No bunker:// / nostrconnect:// URI parsing, no JSON-RPC method encoders. Bring your own.
• ~ NIP-47 Wallet Connect — kind 13194/2319x event envelopes only. No nostr+walletconnect:// URI parsing, no JSON-RPC method encoders.
• x NIP-50 Search Capability
• ~ NIP-51 Lists — create helpers for kinds 10000/10001/30000/30001 only. Other list kinds (10003-10102, 30002-30030, etc.) need to be built by hand using Event.from.
• x NIP-53 Live Activities
• x NIP-57 Lightning Zaps
• x NIP-58 Badges
• x NIP-59 Gift Wrap
• x NIP-65 Relay List Metadata
• x NIP-72 Moderated Communities
• x NIP-89 Application Handlers
• x NIP-94 File Metadata
• x NIP-98 HTTP Auth

Usage

import 'package:nostr/nostr.dart';

// Generate or import keys
final keys = Keys.generate();
print('Public key: ${keys.public}');
print('npub: ${keys.npub}');

// Create and sign an event
final event = Event.from(
  kind: 1,
  tags: [],
  content: 'Hello Nostr!',
  secretKey: keys.secret,
);

// Serialize for relay
print(event.serialize());

// Subscribe to events
final request = Request(
  subscriptionId: generateRandomHex(),
  filters: [const Filter(kinds: [1], limit: 10)],
);
print(request.serialize());

For more examples, see the example/ directory.