nostr_core_dart 是一个用于在 Flutter 或 Dart 应用程序中实现 Nostr 协议核心功能的库。Nostr 是一个去中心化的、基于事件的协议，用于构建抗审查的社交网络和其他应用。

安装

首先，你需要在 pubspec.yaml 文件中添加 nostr_core_dart 作为依赖项：

dependencies:
  nostr_core_dart: ^0.1.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

基本用法

1. 创建密钥对

在 Nostr 中，每个用户都有一个公钥和私钥。你可以使用 nostr_core_dart 来生成密钥对。

import 'package:nostr_core_dart/nostr_core_dart.dart';

void main() {
  final keyPair = KeyPair.generate();
  print('Public Key: ${keyPair.publicKey}');
  print('Private Key: ${keyPair.privateKey}');
}

2. 创建事件

Nostr 中的事件（Event）是协议的核心。你可以创建一个事件并对其进行签名。

import 'package:nostr_core_dart/nostr_core_dart.dart';

void main() {
  final keyPair = KeyPair.generate();
  
  final event = Event(
    kind: 1,  // 事件类型，1 表示文本消息
    content: 'Hello, Nostr!',  // 事件内容
    pubkey: keyPair.publicKey,  // 公钥
    created_at: DateTime.now().millisecondsSinceEpoch ~/ 1000,  // 时间戳
  );

  event.sign(keyPair.privateKey);  // 使用私钥对事件进行签名

  print('Event ID: ${event.id}');
  print('Event Signature: ${event.sig}');
}

3. 验证事件

你可以验证事件的签名是否有效。

import 'package:nostr_core_dart/nostr_core_dart.dart';

void main() {
  final keyPair = KeyPair.generate();
  
  final event = Event(
    kind: 1,
    content: 'Hello, Nostr!',
    pubkey: keyPair.publicKey,
    created_at: DateTime.now().millisecondsSinceEpoch ~/ 1000,
  );

  event.sign(keyPair.privateKey);

  final isValid = event.verify();
  print('Is Event Valid? $isValid');
}

4. 与其他节点交互

你可以将事件发布到 Nostr 网络中的其他节点，或者从其他节点订阅事件。

import 'package:nostr_core_dart/nostr_core_dart.dart';

void main() async {
  final keyPair = KeyPair.generate();
  
  final event = Event(
    kind: 1,
    content: 'Hello, Nostr!',
    pubkey: keyPair.publicKey,
    created_at: DateTime.now().millisecondsSinceEpoch ~/ 1000,
  );

  event.sign(keyPair.privateKey);

  final relay = Relay('wss://relay.nostr.example');  // 替换为实际的 Nostr 中继地址
  await relay.connect();

  await relay.publish(event);

  relay.subscribe([], (event) {
    print('Received Event: ${event.content}');
  });

  // 保持连接
  await Future.delayed(Duration(seconds: 10));
  await relay.disconnect();
}

高级用法

1. 处理不同的事件类型

Nostr 支持多种事件类型，你可以根据事件的 kind 字段来处理不同类型的事件。

import 'package:nostr_core_dart/nostr_core_dart.dart';

void main() async {
  final relay = Relay('wss://relay.nostr.example');
  await relay.connect();

  relay.subscribe([], (event) {
    switch (event.kind) {
      case 1:
        print('Text Note: ${event.content}');
        break;
      case 2:
        print('Recommend Relay: ${event.content}');
        break;
      // 处理其他事件类型
      default:
        print('Unknown Event Kind: ${event.kind}');
    }
  });

  await Future.delayed(Duration(seconds: 10));
  await relay.disconnect();
}

2. 使用过滤器订阅事件

你可以使用过滤器来订阅特定的事件。

import 'package:nostr_core_dart/nostr_core_dart.dart';

void main() async {
  final relay = Relay('wss://relay.nostr.example');
  await relay.connect();

  final filter = Filter(
    kinds: [1],  // 只订阅文本消息
    authors: ['some_public_key'],  // 只订阅特定作者
  );

  relay.subscribe([filter], (event) {
    print('Filtered Event: ${event.content}');
  });

  await Future.delayed(Duration(seconds: 10));
  await relay.disconnect();
}